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: 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.

Meetings

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

The Amazon Chime SDK meetings API endpoints are hosted in the US East (Northern Virginia), US West (Oregon), Europe (Frankfurt) and Asia Pacific (Singapore) AWS Regions. These API endpoints allow you to create meetings in other AWS regions. For more information, refer to the Meeting Regions section in the Amazon Chime SDK Developer Guide.

Q: Are Amazon Chime SDK meetings available in AWS GovCloud (US)?

Yes. The Amazon Chime SDK meetings API endpoints and media regions are available in AWS GovCloud (US) Regions.  For more information, refer to the Available Regions section in the Amazon Chime SDK Developer Guide.

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. 

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 supports mono and stereo audio at the highest sample rate supported by the device and browser, up to a maximum of 48kHz. Audio is encoded with bitrates up to 128kbps stereo / 64kbps mono using the Opus codec. The Amazon Chime SDKs for iOS and Android support mono audio up to 48kHz, with bitrates up to 64kbps using the Opus codec.

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 stereo audio up to 48kHz at 128kbps (64kbps mono). 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. Alternatively, you can configure APIs to capture individual video tile streams, with a separate combined meeting audio or stream, or capture only the combined meeting audio with no video. You can also use SourceConfiguration to select specific attendee video streams to capture, and do not need to capture all individual video streams.

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: What features of Amazon Transcribe can I use with live transcription?

Live transcription provides access to the following Amazon Transcribe features with in the StartMeetingTranscription API:

 
Q: What features of Amazon Transcribe Medical can I use with live transcription?
 
 
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.  

Q: Can I buy Amazon Voice Focus seperately to help improve the quality of audio collected outside of an Amazon Chime SDK meeting? 

Yes. Amazon Vocie Focus is available as an Amazon Machine Image (AMI) which can be used outside of the Amazon Chime SDK for synchronous workloads to help reduce noise in real-time speech capture and streaming, or for asynchronous workloads such as enhancing archived speech recordings. For more information, please contact us. 

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.

Q. How am I billed for the PSTN Audio call recording feature usage?

You are billed by the minute for the time that call recording is enabled on a particular call leg, regardless of whether you pause recording.  If you choose to transcribe your recordings using Amazon Transcribe, standard Amazon Transcribe pricing applies.

Q. Do I have to always record the entire call?

With call recording, you have a choice to record the entire call or only specific parts of the call, or not to record anything at all. Depending on your use case, you can choose to record inbound and/or outbound audio tracks of one or several call parties, commonly referred to as “call legs”. You can also start, stop, pause, and resume the recording of each call leg at the specified times during the call.

Q. Can I control when to start, stop, pause, and resume the recording for just a portion of the call?

You can start and, subsequently, stop call recording at any point in time during the call; upon hanging up, the recording is stopped automatically. Please note that for each call leg you can start and stop the recording only once within the duration of the call. If you need to interrupt the recording of a call leg for some period of time and then continue the recording again, you must use pause and resume actions. The PauseCallRecording action pauses recording of a call leg. Pausing does not stop the call recording process or change the length of the call; instead, a brief tone is played when the pause is started and silence is recorded for the duration of the pause. You can pause and resume the recording multiple times for the duration of the same call leg.

Q. What is captured in the call recording file if the recording was paused?

Each time you pause call recording, a brief tone is played when the pause is started and silence is recorded for the duration of the pause.

Q: What type of call recordings audio files do I get?

The calls are recorded in the open WAV format. If you choose to record both incoming and outgoing tracks of a call leg, it will result in a stereo recording; if you record only the incoming or the outgoing track then you will get a mono recording.

Q. How many recording files do I get per call?

You will have one WAV file per recorded call leg. Here are a few examples. (a) For an IVR call, where there is only one leg to record, you will get 1 media recording WAV file. (b) For a contact center call with one agent-to-agent transfer with agent call leg recording, there will be two agent-side call legs and you will get 2 media recording WAV files. (c) For a contact center call with only the caller’s leg recorded you will get 1 media recording file regardless of the number of transfers on the call center side.

Q. How can I find my recordings?

The call recording destination is recorded in the CDR (Call Detail Record). For all recording files written to your Amazon S3 bucket, the file name and the S3 object metadata will contain identifers such as call id and transaction id, which you can use to identify the recordings for further processing.

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 perform 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