本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Amazon Chime SDK
您可以使用 Amazon Chime SDK 构建用于发送和接收音频和视频并允许内容共享的实时媒体应用程序。Amazon Chime SDK 独立于任何 Amazon Chime 管理员账户运行，并且不会影响在 Amazon Chime 上托管的会议。相反，Amazon Chime SDK 可提供生成器工具，用于构建自己的会议应用程序。
**Topics**
+ [使用 Amazon Chime SDK 的先决条件](#mtg-prereqs)
+ [Amazon Chime SDK 的概念](#mtg-glossary)
+ [Amazon Chime SDK 的架构](#mtg-arch)
+ [Amazon Chime SDK 的限额](#mtg-limits)
+ [Amazon Chime SDK 系统要求](#mtg-browsers)
+ [Amazon Chime SDK 可用的 AWS 区域](sdk-available-regions.md)
+ [了解 Amazon Chime SDK 客户端库](mtgs-sdk-client-lib.md)
+ [了解如何使用 Amazon Chime SDK 语音连接器进行 SIP 集成](mtgs-sdk-cvc.md)
+ [了解 Amazon Chime SDK 事件通知](mtgs-sdk-notifications.md)
+ [从 Amazon Chime 命名空间迁移](migrate-from-chm-namespace.md)
## 使用 Amazon Chime SDK 的先决条件
使用 Amazon Chime SDK 需要具备以下条件：
+ 编程能力。
+ 一个 AWS 账户。
+ **一个 IAM 角色，其策略用于授予访问亚马逊 Chime 软件开发工具包所使用的 Amazon Chime API 操作的权限，例如 AWS 托管 SDK 策略。AmazonChime**有关更多信息，请参阅 *Amazon Chime SDK 管理员指南*中的 [Amazon Chime 如何与 IAM 配合使用](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html)和[允许用户访问 Amazon Chime SDK 操作](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk)。
+ 对于大多数使用案例，您还需满足以下条件：
+ **服务器应用程序** — 管理会议和与会者资源，并将这些资源提供给客户端应用程序。服务器应用程序是在 AWS 账户中创建的，并且必须有权访问前面提到的 IAM 角色。
+ **客户端应用程序** — 从服务器应用程序接收会议和与会者信息，并使用该信息建立媒体连接。
## Amazon Chime SDK 的概念
以下术语和概念可帮助您了解如何使用 Amazon Chime SDK。
**会议**
由唯一 `MeetingId` 标识的短暂资源。将 `MeetingId` 放置在主持活动会议的一组媒体服务上。
**媒体服务组**
主持活动会议的媒体服务组。
**媒体置放**
一组代表媒体服务组的区域化 URL。与会者通过其客户端与媒体服务组连接，发送和接收实时音频和视频，并共享屏幕。
**与会者**
由唯一 `AttendeeId` 标识的会议参与者。与会者可以使用 Amazon Chime SDK 客户端库构建的客户端应用程序自由加入和离开会议。
**加入令牌**
分配给每位与会者的唯一令牌。与会者使用加入令牌与媒体服务组进行身份验证。
## Amazon Chime SDK 的架构
下表描述了 Amazon Chime SDK 架构的不同组件如何协同工作，从而为会议和与会者、音频、视频和内容共享提供支持。
**会议和与会者**
当服务器应用程序创建 Amazon Chime SDK 会议时，该会议将分配给特定地区的媒体服务。服务中的主机负责在与会者客户端之间安全传输实时媒体。为每位创建的与会者分配唯一加入令牌，这是一种不透明密钥，您的服务器应用程序必须将其安全传输给有权代表与会者加入会议的客户端。每个客户端都使用加入令牌与媒体服务组进行身份验证。客户端结合使用 WebSockets 安全和数据报传输层安全 (DTLS) 来安全地向媒体服务组发送信号，并通过媒体服务组向其他与会者发送和接收媒体。
** 音频**
媒体服务混合每位与会者的音频，然后在从混音中减去自己的音频后，发送给每位接收者。Amazon Chime SDK 以设备和浏览器支持的最高速率采样音频，最高可达 48kHz。我们使用 Opus 编解码器对音频进行编码，默认比特率为 32kbps，可以将其增加至最高 128kbps 的立体声和 64kbps 的单声道。
**视频**
媒体服务使用发布和订阅模式用作选择性转发单元 (SFU)。每位与会者可以发布一个视频源，每次会议最多可同时发布 25 个视频。适用于的 Amazon Chime SDK 客户端库 JavaScript 支持高达 1280x720 的视频分辨率，不带联播，每秒 30 帧，联播，支持每秒 15 帧的视频分辨率。适用于 [iOS](sdk-for-ios.md)、[Android](sdk-for-android.md) 和 [Windows](client-lib-windows.md) 的 Amazon Chime SDK 客户端库支持最高 1280 x 720 的视频分辨率和每秒 30 帧的帧率，但是实际的帧率和分辨率由 Amazon Chime SDK 自动管理。
激活后，视频联播会以两种不同的分辨率和比特率发送每个视频流。带宽受限的客户端会自动订阅较低比特率的视频流。视频编码和解码在可用情况下使用硬件加速来提高性能。
**数据消息**
除了音频和视频内容外，与会者还可以互相发送每条最大 2KB 的实时数据消息。您可以使用消息来实现自定义会议功能，例如白板、聊天、实时表情符号反应以及特定于应用程序的楼层控制信号。
**内容共享**
客户端应用程序可以共享音频和视频内容，例如屏幕截图或媒体文件。内容共享支持预先录制视频/音频内容。视频：最高 1280 x 720 分辨率、每秒 15 帧；音频：最高 48kHz、比特率为 64kbps。最多支持每秒 15 帧的内容共享屏幕截图，但可能会受到设备和浏览器功能的限制。
## Amazon Chime SDK 的限额
Amazon Chime SDK 服务的限额记录在 AWS 一般参考中。有关更多信息，请参阅 *AWS 一般参考* 中的 [Amazon Chime SDK 终端节点和限额](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html)。
**注意**
服务限额视每个 API 终端节点而定。请求增加服务限额时，务必在应用程序使用的所有 API 终端节点上申请增加限额。
## Amazon Chime SDK 系统要求
以下系统要求适用于使用 Amazon Chime SDK 创建的应用程序。
**支持的浏览器，适用于 Amazon Chime 软件开发工具包的客户端库 JavaScript**
- **Windows**
- **浏览器:** Mozilla Firefox / **支持的版本:** 75 及更高版本 / **注意:**
- **浏览器:** Google Chrome / **支持的版本:** 78 及更高版本 / **注意:**
- **浏览器:** Chromium-based 边缘 / **支持的版本:** 79 及更高版本 / **注意:**
- **浏览器:** Chromium-based 电子 / **支持的版本:** 7 及更高版本 / **注意:** Chrome 版本 78 及更高版本。
- **浏览器:** Opera / **支持的版本:** 66 及更高版本 / **注意:**
- ** macOS **
- **浏览器:** Mozilla Firefox / **支持的版本:** 75 及更高版本 / **注意:**
- **浏览器:** Google Chrome / **支持的版本:** 78 及更高版本 / **注意:**
- **浏览器:** Chromium-based 边缘 / **支持的版本:** 79 及更高版本 / **注意:**
- **浏览器:** Chromium-based 电子 / **支持的版本:** / **注意:**
- **浏览器:** Safari / **支持的版本:** 13 及更高版本 / **注意:**
- **浏览器:** Opera / **支持的版本:** 66 及更高版本 / **注意:**
- **iOS**
- **浏览器:** Mozilla Firefox / **支持的版本:** 10 及更高版本 / **注意:** 仅限音频和视频，无共享内容。
- **浏览器:** Google Chrome / **支持的版本:** 78 及更高版本 / **注意:** 仅限音频和视频，无共享内容。
- **浏览器:** Safari / **支持的版本:** 13 及更高版本 / **注意:** 仅限音频和视频，无共享内容。
- **浏览器:** WKWebView / **支持的版本:** 14.3 及更高版本 / **注意:** 仅限音频和视频，无共享内容。
- **Android**
- **浏览器:** Google Chrome / **支持的版本:** 10 及更高版本 / **注意:** 仅限音频和视频，无共享内容。
- **浏览器:** 三星 / **支持的版本:** 12 及更高版本 / **注意:** 仅限音频和视频，无共享内容。
- **浏览器:** 铬 WebView / **支持的版本:** 5 及更高版本 / **注意:** 仅限音频和视频，无共享内容。
- **Ubuntu LTS 16.04 及更高版本**
- **浏览器:** Google Chrome
- **支持的版本:** 78 及更高版本
- **注意:**
**适用于 iOS 的 Amazon Chime SDK 客户端库**
+ iOS 版本 13 及更高版本
**适用于 Android 的 Amazon Chime SDK 客户端库**
+ Android OS 版本 5 及更高版本、ARM 和 ARM64 架构