本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 使用 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` 放置在主持活动会议的一组媒体服务上。 **媒体服务组** 主持活动会议的媒体服务组。 **媒体置放** 一组代表媒体服务组的区域化 URLs 。与会者通过其客户端与媒体服务组连接，发送和接收实时音频和视频，并共享屏幕。 **与会者** 由唯一 `AttendeeId` 标识的会议参与者。与会者可以使用 Amazon Chime SDK 客户端库构建的客户端应用程序自由加入和离开会议。 **加入令牌** 分配给每位与会者的唯一令牌。与会者使用加入令牌与媒体服务组进行身份验证。 ## Amazon Chime SDK 的架构 下表描述了 Amazon Chime SDK 架构的不同组件如何协同工作，从而为会议和与会者、音频、视频和内容共享提供支持。 **会议和与会者** 当服务器应用程序创建 Amazon Chime SDK 会议时，该会议将分配给特定地区的媒体服务。服务中的主机负责在与会者客户端之间安全传输实时媒体。为每位创建的与会者分配唯一加入令牌，这是一种不透明密钥，您的服务器应用程序必须将其安全传输给有权代表与会者加入会议的客户端。每个客户端都使用加入令牌与媒体服务组进行身份验证。客户端结合使用 WebSockets 安全和数据报传输层安全 (DTLS) 来安全地向媒体服务组发送信号，并通过媒体服务组向其他与会者发送和接收媒体。 ** 音频** 媒体服务混合每位与会者的音频，然后在从混音中减去自己的音频后，发送给每位接收者。Amazon Chime 以设备和浏览器支持的最高速率 SDKs 采样音频，最高可达 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** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/meetings-sdk.html) **适用于 iOS 的 Amazon Chime SDK 客户端库** + iOS 版本 13 及更高版本 **适用于 Android 的 Amazon Chime SDK 客户端库** + 安卓操作系统版本 5 及更高版本、ARM 和 ARM64 架构 # Amazon Chime SDK 可用的 AWS 区域 下表列出了 Amazon Chime 软件开发工具包服务的功能以及提供每项服务的 AWS 区域。 **注意** 标有星号 (**\$1**) 的区域必须在您的 AWS 账户中启用。 AWS 默认情况下会屏蔽这些区域。有关启用区域的更多信息，请参阅《[账户*管理参考》中的 “指定您的AWS 账户*可以使用的 AWS 区域](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html)”。 **Topics** + [控制台区域](#sdk-console-regions) + [调用分析区域](#call-analytics-regions) + [会议区域](#sdk-meeting-regions) + [媒体管道区域](#sdk-media-pipelines) + [消息收发区域](#sdk-messaging-regions) + [语音区域](#voice-regions) ## 控制台区域 您可以使用 Amazon Chime SDK 控制台配置资源并了解有关 Amazon Chime SDK 服务的更多信息。 | **AWS 区域** | **控制台** | | --- | --- | | 亚太地区（首尔） | 是 | | 亚太地区（新加坡） | 是 | | 亚太地区（悉尼） | 是 | | 亚太地区（东京）(ap-northeast-1) | 是 | | 加拿大（中部）(ca-central-1) | 是 | | 欧洲地区（法兰克福）(eu-central-1) | 是 | | 欧洲地区（爱尔兰）(eu-west-1) | 是 | | 欧洲（伦敦）(eu-west-2) | 是 | | 美国东部（弗吉尼亚州北部）(us-east-1) | 是 | | 美国西部（俄勒冈州）(us-west-2) | 是 | ## 调用分析区域 下表列出了可用于分析、转录和通话录音的 AWS 区域。 | **AWS 区域** | **语音分析** | **转录** | **通话录音** | | --- | --- | --- | --- | | 美国东部（弗吉尼亚州北部）(us-east-1) | 支持 | 是 | 是 | | 美国西部（俄勒冈州）(us-west-2) | 支持 | 是 | 是 | | 欧洲地区（法兰克福）(eu-central-1) | 否 | 是 | 是 | ## 会议区域 Amazon Chime SDK 会议具有*控制区域*和*媒体区域*。控制区域提供用于创建、更新和删除会议的 API 终端节点。控制区域还可用于接收和处理 [了解 Amazon Chime SDK 会议生命周期事件](using-events.md)。 媒体区域主持实际会议，客户可连接到您的媒体区域。您可以在调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) API 时指定媒体区域。 控制区域可以在同一 AWS 分区中的任何媒体区域中创建会议。但是，您只能在用于创建会议的控制区域中更新会议。 有关选择控件和媒体区域的更多信息，请参阅 [使用 Amazon Chime SDK 会议的会议区域](chime-sdk-meetings-regions.md)。 下表列出了提供控件、媒体或控件及媒体的区域。 | **AWS 区域** | **会议控制** | **会议媒体** | | --- | --- | --- | | 非洲（开普敦）(af-south-1)**\$1** | 是\$1 | 是 | | 亚太地区（孟买）(ap-south-1) | 支持 | 是 | | 亚太地区（首尔）(ap-northeast-2) | 支持 | 是 | | 亚太地区（新加坡）(ap-southeast-1) | 支持 | 是 | | 亚太地区（悉尼）(ap-southeast-2) | 支持 | 是 | | 亚太地区（东京）(ap-northeast-1) | 支持 | 是 | | 加拿大（中部）(ca-central-1) | 支持 | 是 | | 欧洲地区（法兰克福）(eu-central-1) | 支持 | 是 | | 欧洲地区（爱尔兰）(eu-west-1) | | 是 | | 欧洲（伦敦）(eu-west-2) | 支持 | 是 | | 欧洲地区（米兰）(eu-south-1)**\$1** | | 是 | | 欧洲地区（巴黎）（eu-west-3） | | 是 | | 欧洲地区（斯德哥尔摩）(eu-north-1) | | 是 | | 以色列（特拉维夫）(il-central-1)**\$1** | 是**\$1** | 是 | | 南美洲（圣保罗）（sa-east-1） | | 是 | | 美国东部（俄亥俄州）(us-east-2) | | 是 | | 美国东部（弗吉尼亚州北部）(us-east-1) | 支持 | 是 | | 美国西部（北加利福尼亚）(us-west-1) | | 是 | | 美国西部（俄勒冈州）(us-west-2) | 支持 | 是 | | AWS GovCloud (美国东部) (us-gov-east-1) | 支持 | 是 | | AWS GovCloud (美国西部) (us-gov-west-1) | 支持 | 是 | **\$1** 您必须在 AWS 账户中启用这些区域。有关更多信息，请参阅*AWS 一般参考*中的[启用区域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。 **\$1\$1** 在该区域使用会议控制的会议只能在该区域托管媒体。 **注意** 要在 AWS GovCloud （美国）地区创建会议，您必须使用中的控制区域 GovCloud。此外，中的控制区域 GovCloud 只能在 AWS GovCloud （美国）区域举行会议。 ## 媒体管道区域 Amazon Chime SDK 媒体管道具有*控制区域*和*媒体区域*。控制区域提供用于创建和删除媒体管道的媒体管道 API 终端节点。您还可以使用控制区域接收和处理[媒体管道事件](media-pipe-events.md)。 媒体区域运行您的媒体管道，系统会自动选择与会议相同的媒体区域。 您可以使用控制区域在任何数据区域中创建媒体管道。媒体管道可以在任何会议媒体区域加入会议。 | **AWS 区域** | **控件** | **媒体** | | --- | --- | --- | | 非洲（开普敦）(af-south-1)**\$1** | | 是 | | 亚太地区（孟买）(ap-south-1) | 支持 | 是 | | 亚太地区（首尔）(ap-northeast-2) | 支持 | 是 | | 亚太地区（新加坡）(ap-southeast-1) | 支持 | 是 | | 亚太地区（悉尼）(ap-southeast-2) | 支持 | 是 | | 亚太地区（东京）(ap-northeast-1) | 支持 | 是 | | 加拿大（中部）(ca-central-1) | 支持 | 是 | | 欧洲地区（法兰克福）(eu-central-1) | 支持 | 是 | | 欧洲地区（爱尔兰）(eu-west-1) | | 是 | | 欧洲（伦敦）(eu-west-2) | 支持 | 是 | | 欧洲地区（米兰）(eu-south-1)**\$1** | | 是 | | 欧洲地区（巴黎）（eu-west-3） | | 是 | | 欧洲地区（斯德哥尔摩）(eu-north-1) | | 是 | | 南美洲（圣保罗）（sa-east-1） | | 是 | | 美国东部（俄亥俄州）(us-east-2) | | 是 | | 美国东部（弗吉尼亚州北部）(us-east-1) | 支持 | 是 | | 美国西部（北加利福尼亚）(us-west-1) | | 是 | | 美国西部（俄勒冈州）(us-west-2) | 支持 | 是 | **\$1** 您必须在 AWS 账户中启用这些区域。有关更多信息，请参阅*AWS 一般参考*中的[启用区域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。 ## 消息收发区域 Amazon Chime SDK 消息收发具有*控制区域*和*数据区域*。控制区域公开消息收发的 API 终端节点，而数据区域存储消息。如果您使用 Amazon Kinesis 流式传输消息数据或渠道流 AWS Lambda 函数，则它们应位于控制区域。 | **AWS 区域** | **控件** | **数据** | | --- | --- | --- | | 欧洲地区（法兰克福）(eu-central-1) | 支持 | 是 | | 美国东部（弗吉尼亚州北部）(us-east-1) | 支持 | 是 | ## 语音区域 Amazon Chime SDK SIP（会话启动协议）功能具有 *API 区域*、*媒体区域*和 *PSTN 区域*。API 区域提供用于创建和配置 SIP 功能的 API 终端节点。媒体区域包含 Amazon Chime SDK 语音连接器和 SIP 媒体应用程序。PSTN 区域帮助客户将本地电话系统连接至公共电话网络。此外，PSTN 区域还支持电话号码配置和管理。 | **AWS 区域** | **API** | **媒体** | **PSTN** | | --- | --- | --- | --- | | 亚太地区（首尔）(ap-northeast-2) | 支持 | 是 | | | 亚太地区（新加坡）(ap-southeast-1) | 支持 | 是 | | | 亚太地区（悉尼）(ap-southeast-2) | 支持 | 是 | | | 亚太地区（东京）(ap-northeast-1) | 支持 | 是 | | | 加拿大（中部）(ca-central-1) | 支持 | 是 | | | 欧洲地区（法兰克福）(eu-central-1) | 支持 | 是 | | | 欧洲地区（爱尔兰）(eu-west-1) | 支持 | 是 | | | 欧洲（伦敦）(eu-west-2) | 支持 | 是 | | | 美国东部（弗吉尼亚州北部）(us-east-1) | 支持 | 是 | 是**\$1** | | 美国西部（俄勒冈州）(us-west-2) | 支持 | 是 | 是**\$1** | **\$1** 有关特定 AWS 地区电话号码可用性的信息，请参阅 [Amazon Chime SDK 定价](https://aws.amazon.com/chime/chime-sdk/pricing/)页面。 # 了解 Amazon Chime SDK 客户端库 使用 Amazon Chime SDK 构建实时会议客户端之前，必须将您的客户端应用程序与 Amazon Chime SDK 客户端库集成。以下客户端库可供使用： + [适用于 Android 的 Amazon Chime SDK 客户端库](https://github.com/aws/amazon-chime-sdk-android) — Kotlin 库，可用于在受支持的 Android 设备上构建 Amazon Chime SDK 应用程序。 + [适用于 C\$1\$1 的 Amazon Chime SDK 信令客户端库](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp) — C\$1\$1 库，可用于在嵌入式设备上设置与 Amazon Chime SDK 会议的信令连接。 + [适用于 iOS 的 Amazon Chime SDK 客户端库](https://github.com/aws/amazon-chime-sdk-ios) — Swift 库，可用于在受支持的 iOS 设备上构建 Amazon Chime SDK 应用程序。 + 适用于 JavaScript ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)) 的 [Amazon Chime SDK 客户端库](https://github.com/aws/amazon-chime-sdk-js) — 一个包含 TypeScript 类型定义的 JavaScript 库，可帮助您在支持 WebRTC 的浏览器中构建 Amazon Chime 软件开发工具包应用程序。 + [适用于 Windows 的 Amazon Chime SDK 客户端库](https://github.com/aws/amazon-chime-sdk-cpp)。可用于在受支持的设备上构建 Amazon Chime SDK 应用程序的 C\$1\$1 库。 要了解如何将您的客户端应用程序与 Amazon Chime SDK 集成，请参阅客户端库 `README.md` 文件中的操作。使用演示学习如何为您的应用程序构建特定的媒体组件。 # 了解如何使用 Amazon Chime SDK 语音连接器进行 SIP 集成 将兼容 SIP 的语音基础设施与 Amazon Chime SDK 语音连接器集成以进行 SIP 语音呼叫。您必须使用 `us-east-1` 或 `us-east-2` 区域。您必须具有 IP 专用小交换机 (PBX)、会话边界控制器 (SBC) 或其他具有互联网访问权限且支持会话启动协议 (SIP) 的语音基础设施。有关更多信息，请参阅 *Amazon Chime SDK 管理员指南*中的[开始前的准备工作](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq)。 **集成您的语音基础设施** 1. 在您的 AWS 账户下创建 Amazon Chime SDK 语音连接器。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[创建 Amazon Chime SDK 语音连接器](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon)。 1. 编辑您的 Amazon Chime SDK 语音连接器设置，允许从您的语音基础设施呼叫 AWS。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[编辑 Amazon Chime SDK 语音连接器](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon)。 1. 对于**终止设置**，选择**已启用**。 1. 对于**允许列表**，选择**新建**。 1. 输入内部 SIP 基础设施的 IP 地址的 CIDR 表示法。这允许您的基础设施访问 Amazon Chime SDK 语音连接器。例如，要允许来自 IP 地址 `10.24.34.0` 的流量，将 CIDR 表示法 `10.24.34.0/32` 列入许可名单。 1. 选择 **添加**。 1. 对于 **Calling plan (呼叫计划)**，选择要为其添加呼叫计划的国家/地区。 1. 根据需要编辑任何其他设置，然后选择**保存**。 1. 在 Amazon Chime SDK 控制台的**语音连接器**下，查看 Amazon Chime SDK 语音连接器的**出站主机名**。例如，.vo *abcdef1ghij2klmno3pqr4* iconconnector.chime.aws。 1. 要使用 Amazon Chime SDK 加入会议，通过 SIP URI 向 Amazon Chime SDK 语音连接器的**出站主机名**发送 SIP 请求。使用 SIP URI 中的电话号码 **\$117035550122**。设置 `transport` 参数，使用 TLS 协议。最后，使用通过调用生成的唯一加入令牌 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html)API 操作。有关更多信息，请参阅以下示例。 **Example 示例：SIP 请求** 以下示例显示用于向 Amazon Chime SDK 语音连接器发送 SIP 请求的 SIP URI 的内容。 ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` 以下示例显示加入 Amazon Chime SDK 会议的示例 SIP 邀请消息。 ``` INVITE sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token SIP/2.0 Via: SIP/2.0/TLS IPaddress:12345;rport;branch=branch;alias Max-Forwards: 70 From: sip:+12065550100@IPaddress;tag=tag To: sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;X-chime-join-token=join-token Contact: Call-ID: a1234567-89b0-1c2d-e34f-5gh678j9k2lm CSeq: 6214 INVITE Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, timer, norefersub Session-Expires: 1800 Min-SE: 90 Content-Type: application/sdp Content-Length: 991 v=0 o=- 3775321410 3775321410 IN IP4 IPaddress s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4000 RTP/SAVP 0 3 8 9 125 101 c=IN IP4 IPaddress b=TIAS:96000 a=rtcp:4001 IN IP4 IPaddress a=sendrecv a=rtpmap:0 PCMU/8000 a=rtpmap:3 GSM/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:9 G722/8000 a=rtpmap:125 opus/48000/2 a=fmtp:125 useinbandfec=1 a=rtpmap:101 telephone-event/8000 a=fmtp:101 0-16 a=crypto:1 AEAD_AES_256_GCM inline:EXAMPLE a=crypto:2 AEAD_AES_256_GCM_8 inline:EXAMPLE a=crypto:3 AES_256_CM_HMAC_SHA1_80 inline:EXAMPLE a=crypto:4 AES_256_CM_HMAC_SHA1_32 inline:EXAMPLE a=crypto:5 AES_CM_128_HMAC_SHA1_80 inline:EXAMPLE a=crypto:6 AES_CM_128_HMAC_SHA1_32 inline:EXAMPLE ``` **注意** Amazon Chime SDK 只能识别 E.164 格式的电话号码。确保 `From` 标头中有 E.164 格式的电话号码。 # 了解 Amazon Chime SDK 事件通知 Amazon Chime SDK 支持向亚马逊 EventBridge、亚马逊简单队列服务 (SQS) 和亚马逊简单通知服务 (SNS) Simple Notification Service (SNS) 发送会议活动通知。 **注意** Amazon Chime SDK 会议命名空间默认使用 `ChimeSDKMeetings` 端点。传统的 Chime 命名空间使用单个终端节点。有关命名空间和端点的更多信息，请参阅本指南前文中的[迁移到 Amazon Chime SDK 会议命名空间](meeting-namespace-migration.md)。 ## 将通知发送到 EventBridge 您可以向发送 Amazon Chime 软件开发工具包事件通知。 EventBridge*有关将 Amazon Chime 软件开发工具包与配合使用的详细信息 EventBridge，请参阅《亚马逊 [Chime 软件开发工具包管理员指南》中的 “自动使用亚马逊 Chime 软件开发工具包” EventBridge ](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk)。*有关信息 EventBridge，请参阅 [Amazon EventBridge 用户指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/)。 ## 向 Amazon SQS 和 Amazon SNS 发送通知 您可以使用 *Amazon Chime SDK API 参考*中的 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) API 将 Amazon Chime SDK 会议事件通知发送到每个会议的一个 Amazon SQS 队列和一个 Amazon SNS 主题。这可以帮助减少通知延迟。有关 Amazon SQS 权限的更多信息，请参阅 [Amazon 简单队列服务开发人员指南](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/)。有关 Amazon SNS 的更多信息，请参阅 [Amazon Simple Notification Service 开发人员指南](https://docs.aws.amazon.com/sns/latest/dg/)。 发送到亚马逊 SQS 和亚马逊 SNS 的通知包含的信息与 Amazon Chime SDK 发送到的通知相同。 EventBridgeAmazon Chime SDK 支持向用于创建会议的 API 区域中的队列和主题发送会议事件通知。事件通知可能未按发生顺序传递。 ## 授予 Amazon Chime SDK 访问 Amazon SQS 和 Amazon SNS 的权限 在 Amazon Chime SDK 通过 Amazon SQS 队列或 Amazon SNS 主题向您发送通知之前，您必须授予 Amazon Chime SDK 向队列或主题的 Amazon 资源名称 (ARN) 发布消息的权限。为此，请将一个 AWS Identity and Access Management (IAM) 策略附加到队列或主题，以授予对 Amazon Chime SDK 的相应权限。有关更多信息，请参阅《Amazon Simple Queue Service 开发人员指南》**中的 [Amazon SQS 中的身份识别与访问管理](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html)以及《Amazon Simple Notification Service 开发人员指南》**中的 [Amazon SNS 访问控制示例案例](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html)。 **注意** 您的亚马逊 SQS 队列或亚马逊 SNS 主题必须使用与您的 Amazon Chime SDK API 终端节点 AWS 相同的区域。 **Example 允许 Amazon Chime SDK 将事件发布到 Amazon SQS 队列** 以下示例 IAM policy 授予 Amazon Chime SDK 向指定的 Amazon SQS 队列发布会议活动通知的权限。请注意 `aws:SourceArn` 和 `aws:SourceAccount` 的条件语句。他们解决了潜在的[混淆代理](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)问题。 + 创建以下策略时，您可以使用 `aws:SourceArn` 或 `aws:SourceAccount`。您不需要同时使用这两种方法。 + 这些示例使用 `ChimeSDKMeetings` 命名空间及相应的终端节点。如果使用 `Chime` 命名空间，则必须使用 `chime.amazonaws.com` 终端节点。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "sqs:SendMessage", "sqs:GetQueueUrl" ], "Resource": "arn:aws:sqs:us-east-1:111122223333:queueName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` 此示例显示了一项 Amazon SNS 策略，允许 Amazon Chime SDK 向您的 SNS 主题发送会议事件通知。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` 如果为服务器端加密 (SSE) 启用 Amazon SQS 队列，则必须执行额外步骤。将 IAM 策略附加到关联 AWS KMS 密钥，该策略授予 Amazon Chime SDK 执行加密添加到队列的数据所需的 AWS KMS 操作的权限。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` **Example 允许 Amazon Chime SDK 将事件发布到 Amazon SNS 主题** 以下示例 IAM policy 授予 Amazon Chime SDK 向指定的 Amazon SNS 主题发布会议事件通知的权限。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` # 从 Amazon Chime 命名空间迁移 Amazon Chime 软件开发工具包在一组终端 APIs 节点上公开。尽管您可以直接向终端节点发出 HTTPS 请求，但许多客户在其应用程序中使用 AWS SDK 来调用该服务 APIs。 AWS SDK 有不同的语言版本，它通过封装请求签名和重试逻辑来简化 API 调用。S AWS DK 包括每个服务端点的命名空间。 首次启动时，Amazon Chime SDK 会与 Amazon Chime 应用程序共享一个终端节点。因此，解决方案使用 AWS 软件开发工具包中的`Chime`命名空间来调用 Amazon Chime 应用程序和 Amazon Chime 软件开发工具包。 APIs Amazon Chime SDK 现在为每项子服务（例如会议和 PSTN 音频）提供专用的端点。每个端点均可通过 AWS SDK 中的专用命名空间寻址。 以下主题列出了服务、命名空间和终端节点，并描述了如何在代码和 CLI AWS 中使用它们。 **Topics** + [终端节点、命名空间和 CLI 命令](#endpoint-namespace-cli) + [每项服务的迁移帮助](#help-per-service) + [API 映射](#name-end-map) ## 终端节点、命名空间和 CLI 命令 下表列出了专用 Amazon Chime SDK 命名空间、终端节点和 CLI 命令。这些链接可提供每项服务的更多信息。 | 终端节点 | AWS SDK 名称空间 | AWS SDK CLI | | --- | --- | --- | | [identity-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) | Chime SDKIdentity | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html) | | [media-pipelines-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) | 钟声管道 SDKMedia | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html) | | [meetings-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) | Chime SDKMeetings | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html) | | [messaging-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) | Chime SDKMessaging | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html) | | [voice-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) | Chime SDKVoice | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html) | ## 每项服务的迁移帮助 所有客户都应考虑使用专用的亚马逊 Chime 软件开发工具包终端节点来访问最新的 Amazon Chime 软件开发工具包功能 APIs和区域。 AWS 如果您将共享终端节点与 `Chime` 命名空间一起使用，请在迁移之前参阅以下迁移指南了解技术差异。 + [迁移到 Amazon Chime 命 SDKIdentity 名空间](identity-namespace-migration.md) + [迁移到 Amazon Chim SDKMedia e Pipelines 命名空间](migrate-pipelines.md) + [迁移到 Amazon Chime 命 SDKMeetings 名空间](meeting-namespace-migration.md) + [迁移到 Amazon Chime 命 SDKMessaging 名空间](messaging-namespace-migration.md) + [迁移到 Amazon Chime 命 SDKVoice 名空间](voice-namespace-migration.md) ## API 映射 下表列出了`Chime`命名空间 APIs 中的及其相应的专用命名空间和。 APIs有些专用实例 APIs 与不同 `Chime` APIs，表中指出了这些实例。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** API 已被另一个名称的 API 所取代。 **\$1 **API 不再可用。