General

Q: What is the Amazon Chime SDK?

The Amazon Chime SDK is a collection of client software development kits that use resources in your AWS account to make it easy to add collaborative audio calling, video calling, and screen share features to your web or mobile applications. Customers can now use the same infrastructure services that power Amazon Chime online meetings in their own applications.

Q: How do I use the Amazon Chime SDK with meetings in my application?

Your server application will use the AWS SDK to manage the lifecycle of meeting sessions and control how they are accessed. The Amazon Chime SDK for iOS, Android, or JavaScript is embedded into your client application to build a custom meeting experience. The Amazon Chime SDK includes methods to connect the client applications to cloud meeting sessions, manage microphone and camera selection, and control meeting features.

Q: What browsers does the Amazon Chime SDK for JavaScript support?

The following browsers are supported for applications created using the Amazon Chime SDK for JavaScript:

  • WKWebView for iOS (14.3 and later) also supported for audio and video only (no content sharing)
  • Mozilla Firefox (version 75 and later), for macOS and Windows
  • Mozilla Firefox for iOS (10.0 and later) also supported for audio and video only (no content sharing)
  • Google Chrome (version 78 and later), for macOS, Windows, and Ubuntu LTS 16.04 and later
  • Google Chrome for Android and iOS (10.0 and later) also supported for audio and video only (no content sharing)
  • Chromium-based Edge (version 79 and later), for macOS and Windows
  • Chromium-based Electron (Electron 7 and later, with Chromium version 78 and later)
  • Safari (version 12, audio and video only, no content sharing), for macOS
  • Safari (version 12.1.1 and later, audio and video only, no content sharing), for iOS
  • Safari (version 13 and later, content sharing with screen capture requires turning on the Develop, Experimental Features, Screen Capture feature in the browser), for macOS
  • Opera (version 66 and later), for macOS and Windows
  • Samsung Internet (version 12 and later, no content sharing), for Android

Q: What operating system versions do the Amazon Chime SDKs for iOS and Android support?

The Amazon Chime SDK for iOS is supported for applications on iOS 10 and above.

The Amazon Chime SDK for Android is supported for applications on Android 5.0 (API Level 21) and above.

Q: Do I need to use the Amazon Chime application to use the Amazon Chime SDK?

No. The Amazon Chime SDK works independently of any Amazon Chime administrator accounts, and it does not affect meetings hosted on Amazon Chime. Instead, the Amazon Chime SDK provides builder tools for developers to use to build their own meeting applications.

Q: Can I join my Amazon Chime SDK meeting from the Amazon Chime application?

No. The Amazon Chime application can only join meetings created or scheduled by the Amazon Chime application, and cannot join a meeting created for use with the Amazon Chime SDK.

Q: Are there sample Amazon Chime SDK applications that I can use as a starting point?

Yes. The Amazon Chime SDKs are available in the GitHub repositories linked below:

Q: Do I need an AWS account to use the Amazon Chime SDK?

Yes. You must have an AWS account to create meeting sessions that will be used by your application to connect audio, video, and screen sharing.

Q: Are there sample Amazon Chime SDK applications that I can use as a starting point?

Yes. The Amazon Chime SDKs are available in the GitHub repositories linked below. See the README for each repository for information about building and running the included demo application and additional code examples.

Amazon Chime SDK for JavaScript https://github.com/aws/amazon-chime-sdk-js
Amazon Chime SDK for iOS https://github.com/aws/amazon-chime-sdk-ios
Amazon Chime SDK for Android https://github.com/aws/amazon-chime-sdk-android

Q: What programming languages does Amazon Chime SDK support?

The Amazon Chime SDK for JavaScript is suitable for implementing in a web application and can be used from JavaScript or TypeScript applications.

The Amazon Chime SDK for iOS provides Swift APIs and can be used from Swift or Objective-C applications for iOS.

The Amazon Chime SDK for Android provides Kotlin APIs and can be used from Kotlin or Java applications for Android.

Q: In which regions can I use the Amazon Chime SDK?

The Amazon Chime API endpoints are hosted in the United States (Northern Virginia) region. These API endpoints allow you to create meeting sessions in other AWS regions. Visit the AWS Service Region Table for the list of available regions.

Meetings

Q: What are scaling limitations of a meeting?

The Amazon Chime SDK allows you to create meeting sessions that can host up to 250 audio attendees, with 25 video streams, and two shared content streams. The number of video streams may be adjusted by submitting a support request.

Q: How many meetings can I have at the same time?

By default, each AWS account is limited to 250 simultaneous Amazon Chime SDK meeting sessions. The simultaneous meeting limit can be adjusted by submitting a request through the AWS Console – Service Quotas.

Q: What audio sharing specifications are supported by the Amazon Chime SDK?

The Amazon Chime SDK for JavaScript samples audio at the highest sample rate supported by the device and browser, up to a maximum of 48kHz. Audio is encoded using the Opus codec, with a default bitrate of 32kbps, which can be increased to up to 64kbps. The Amazon Chime SDKs for iOS and Android sample audio at a rate of 16kHz and encodes using the Opus codec at 32kbps.

Q: What video specifications are supported by the Amazon Chime SDK?

The Amazon Chime SDK for JavaScript supports video resolutions up to 1280x720 at 30 frames per second without simulcast, and 15 frames per second with simulcast. The Amazon Chime SDK for iOS and Android support video resolutions up to 1280x720 and 15 frames per second, however the actual framerate and resolution is automatically managed by the Amazon Chime SDK.

When active, video simulcast sends each video stream in two different resolutions and bitrates. Clients which are bandwidth constrained automatically subscribe to the lower bitrate stream. Video encoding and decoding uses hardware acceleration where available to improve performance.

Q: What content share specifications are supported by the Amazon Chime SDK?

Content sharing supports pre-recorded content video up to 1920x1080 at 30 frames per second, and audio up to 48kHz at 64kbps. Screen capture for content sharing is at the resolution of the screen or window being captured, and up to 30 frames per second, but may be limited by the capabilities of the device and browser.

Q: What media capture options are supported and how can I switch from the default behavior for the media capture pipeline?

The media capture pipeline with the Amazon Chime SDK provides the ability to capture a single stream of the active speaker video along with the combined meeting audio. By request, you can instead capture individual video tile streams, with a separate combined meeting audio or stream, or capture only the combined meeting audio with no video. The video may be adjusted by submitting a support request.

Q: What languages does live transcription support?

Amazon Chime live transcription works with any of the languages with streaming support from Amazon Transcribe and Amazon Transcribe Medical.

Q: Can I use live transcription with Amazon Transcribe vocabulary filtering?

Yes. Learn more about Amazon Transcribe vocabulary filtering

Q: Can I use live transcription with Amazon Transcribe custom vocabularies?

Yes. Learn more about Amazon Transcribe custom vocabularies.

Q: Can I use live transcription with Amazon Transcribe Medical in dictation mode?

Yes. Learn move about Amazon Transcribe Medical dictation mode

Q: Can I use live transcription with Amazon Transcribe Medical in conversation mode?

Yes. Learn move about Amazon Transcribe Medical conversation mode.

Q: When using live transcription, can I choose the region for Amazon Transcribe and Amazon Transcribe Medical?

Yes. When initiating live transcription, you choose the AWS region of Amazon Transcribe or Amazon Transcribe Medical. Alternatively, you can have Amazon Chime select the region for you. For more information on selecting the region for live transcription refer to Choosing transcription options in the Amazon Chime Developer Guide. To check which AWS regions Amazon Transcribe and Amazon Transcribe Medical are available in, refer to the AWS Regional Services table.

Meetings Billing & Pricing

Q: How is the Amazon Chime SDK priced?

There is no direct charge to create a meeting session or attendee join tokens. You are charged $0.0017 for each minute that each attendee is joined to your meeting session from a client using Amazon Chime SDK, with audio, video, or content share.

Q: How is live transcription priced?

Live transcription uses one stream to Amazon Transcribe for the duration of the meeting transcription. Standard Amazon Transcribe and Amazon Transcribe Medical costs apply.  

PSTN Audio

Q: Which countries can I make calls to when using PSTN Audio in the Amazon Chime SDK?

To connect attendees to a meeting session using a telephone, you can make calls from your meeting application to over 115 countries. Please see our pricing page for the most up to date list of countries.

Q: Which countries does the Amazon Chime SDK PSTN Audio have telephone numbers for?

Please see our pricing page for the list of countries where Amazon Chime SDK PSTN Audio is currently available.

Q: Can I keep my existing Direct Inward Dial (DID) and toll-free phone numbers?

Yes. You can port most DID and toll-free numbers to the service for those countries where Amazon Chime SDK PSTN Audio is available.

Q: If I have an on-premises phone system, can I use Amazon Chime Voice Connector with PSTN audio voice applications?

Yes, you can provision a Voice Connector to your on-premises phone system and configure a rule to route calls to the PSTN Audio application that you build. Incoming calls over a Voice Connector can be routed to another Voice Connector, an Amazon Chime SDK meeting, or a PSTN phone number.

PSTN Audio Billing & Pricing

Q: How will I be billed when I use the PSTN audio feature?

When you use the PSTN audio feature, you will be billed for the following (as applicable):

  • Incoming or outgoing PSTN calling usage – Please see our pricing page for the most up to date rates.
  • Monthly phone number rental – Please see our pricing page for the most up to date rates.
If the incoming our outgoing calling leg is an Amazon Chime Voice Connector SIP trunk, you will not be charged usage for that call leg.

Q: Are the dial in, dial out, and phone number prices the same in the US-East (N. Virginia) and US-West (Oregon) regions?

Yes. Pricing is the same across both regions, however taxes vary by AWS region for US customers. Please see our pricing page for the most up to date information.

Q: If I use Amazon Chime Voice Connector to dial in to a meeting from your on-premises phone system, how much will it cost?

You only pay the PSTN Audio Application usage fee (plus the cost to connect to the Chime SDK meeting) of $0.002/minute, AWS Lambda invocation fees, and monthly phone number fees. There is no Amazon Chime Voice Connector per minute fee for these types of calls (see Amazon Chime SDK pricing).

Messaging

Q: Which Amazon Chime SDKs support messaging?

The Amazon Chime AWS SDK and JavaScript SDK are used together to support messaging in your applications. The Amazon Chime Javascript SDK is used to manage websockets from your client-side application. The AWS SDK is used to per form all other operations, including managing messaging resources, sending messages, and retrieving message history. Use React UI components to accelerate the development of your user experience.

Q: In which regions can I use messaging in the Amazon Chime SDK?

The Amazon Chime messaging API endpoints are hosted in the United States (Northern Virginia) region. The Amazon Chime messaging storage is located in the United States (Northern Virginia) region.

Q: What are scaling limitations?

We have limits in place for new customers called out in our documentation. If you need these limits increased, please submit a support ticket.

Messaging Billing & Pricing

Q: How is the Amazon Chime SDK for messaging priced?

Messaging is pay-per-use with rates for sending messages, message delivery, and message storage, allowing you to scale as needed. More details are available on our pricing page.

Q: How is storage cost calculated for the Amazon Chime SDK for messaging?

The volume of storage billed in a month is based on the average storage used throughout the month. We measure your storage usage in "TimedStorage-ByteHrs," which are added up at the end of the month to generate your monthly charges. Storage size is measured based on the number of objects stored. Each standard channel message is counted as 4KB. Each control message is 30 bytes. All other objects, including channels, AppInstances, channel memberships, user bans, and read timestamps, are 1KB each.

Standard Product Icons (Features) Squid Ink
Check out the Amazon Chime SDK features page

Learn more about Amazon Chime SDK features

Learn more 
Sign up for a free account
Contact us

Contact us and let us provide you with a personalized demo.

Contact us 
Next-Steps-Icon_Chime_Free-Trial_B
Check Amazon Chime SDK Pricing

Learn more about Amazon Chime SDK pricing

Learn more