翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 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 Voice Connector を使用した 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 アカウント。 + AWS マネージド AmazonChimeSDK ポリシーなど、Amazon Chime SDK で使用される **AmazonChimeSDK** Chime API アクションへのアクセス許可を付与するポリシーを持つ IAM ロール。詳細については、「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 ミーティングが作成されると、ミーティングは地域固有のメディアサービスに割り当てられます。サービスのホストには、参加者のクライアント間でリアルタイムメディアを安全に転送する責任があります。作成された各参加者には、一意の参加トークン (不透明な秘密鍵) が割り当てられます。サーバーアプリケーションでは、参加者に代わって、会議への参加を許可されたクライアントにこのトークンを安全に転送する必要があります。各クライアントでは参加トークンを使用してメディアサービスグループとの認証を行います。クライアントでは、安全な WebSocket 接続と Datagram Transport Layer Security (DTLS) を組み合わせて使用し、メディアサービスグループに安全に信号を送り、メディアサービスグループを介して他の参加者とメディアを送受信します。 ** 音声** メディアサービスでは各参加者の音声をミックスし、ミックスから各自の音声を差し引いた後、ミックスを各受信者に送信します。Amazon Chime SDK では、デバイスとブラウザでサポートされている最高レート (最大 48kHz) で音声をサンプリングします。音声のエンコードには Opus コーデックを使用します。デフォルトのビットレートは 32kbps で、ステレオでは最大 128kbps、モノラルでは最大 64kbps まで上げることができます。 **動画** メディアサービスは、パブリッシュおよびサブスクライブモデルを使用する選択的転送ユニット (SFU) として機能します。各参加者は 1 つの動画ソースを公開でき、1 回の会議につき最大 25 本の動画を同時に公開できます。JavaScript 用の Amazon Chime SDK クライアントライブラリでは、サイマルキャストなしでは毎秒 30 フレーム、サイマルキャストを使用する場合は毎秒 15 フレームで最大 1280x720 の動画解像度をサポートします。[iOS](sdk-for-ios.md)、[Android](sdk-for-android.md)、[Windows](client-lib-windows.md) 用の Amazon Chime SDK クライアントライブラリでは、最大 1280x720 および毎秒 30 フレームの動画解像度がサポートされていますが、実際のフレームレートと解像度は Amazon Chime SDK によって自動的に管理されます。 動画サイマルキャストがアクティブな場合、各動画ストリームは 2 つの異なる解像度とビットレートで送信されます。帯域幅に制約があるクライアントは、低いビットレートのストリームを自動的にサブスクライブします。動画のエンコードとデコードでは、パフォーマンスを向上させるためにハードウェアアクセラレーション (利用可能な場合) を使用します。 **データメッセージ** 会議の参加者は、音声および動画コンテンツに加えて、それぞれ最大 2 KB のリアルタイムなデータメッセージを相互に送信できます。メッセージを使用して、ホワイトボード、チャット、リアルタイムの絵文字リアクション、アプリケーション固有のフロアコントロールシグナリングなどのカスタム会議機能を実装できます。 **コンテンツ共有** クライアントアプリケーションでは、スクリーンキャプチャやメディアファイルなどの音声および動画コンテンツを共有できます。コンテンツ共有では、毎秒 15 フレームで最大 1280x720 の録画済みコンテンツ動画と、64 kbps で最大 48 kHz の音声がサポートされます。コンテンツ共有用のスクリーンキャプチャは 1 秒あたり最大 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 で作成されたアプリケーションには、以下のシステム要件が適用されます。 **サポートされているブラウザ、JavaScript 用の Amazon Chime SDK クライアントライブラリ** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/chime-sdk/latest/dg/meetings-sdk.html) **iOS 用 Amazon Chime SDK クライアントライブラリ** + iOS バージョン 13 以降 **Android 用 Amazon Chime SDK クライアントライブラリ** + Android OS バージョン 5 以降、ARM および ARM64 アーキテクチャ # Amazon Chime SDK で利用可能な AWS リージョン 次の表に、Amazon Chime SDK サービスの特徴と、各サービスを提供する AWS リージョンを示します。 **注記** アスタリスク (**\$1**) が付いたリージョンは、 AWS アカウントで有効にする必要があります。 は、デフォルトでそれらのリージョンを AWS ブロックします。リージョンの有効化の詳細については、[「 アカウント管理リファレンス」の「アカウントで使用できる AWS リージョンを指定する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html)」を参照してください。 *AWS * **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\$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** | Yes**\$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 Voice Connector と 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) – サポートされている Android デバイスで Amazon Chime SDK アプリケーションを構築するのに役立つ Kotlin ライブラリ。 + [C\$1\$1 用 Amazon Chime SDK シグナリングクライアントライブラリ](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp) – 組み込みデバイスの Amazon Chime SDK ミーティングへのシグナリング接続をセットアップするのに役立つ C\$1\$1 ライブラリ。 + [iOS 用 Amazon Chime SDK クライアントライブラリ](https://github.com/aws/amazon-chime-sdk-ios) – サポートされている iOS デバイスで Amazon Chime SDK アプリケーションを構築するのに役立つ Swift ライブラリ。 + [JavaScript 用 Amazon Chime SDK クライアントライブラリ](https://github.com/aws/amazon-chime-sdk-js) ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)) — WebRTC 対応ブラウザで Amazon Chime SDK アプリケーションを構築するのに役立つ、TypeScript 型定義を含む JavaScript ライブラリ。 + [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 Voice Connector を使用した SIP 統合について SIP 対応の音声インフラストラクチャを Amazon Chime SDK Voice Connector と統合して、SIP 音声通話を行うことができます。`us-east-1` または `us-east-2` リージョンを使用する必要があります。IP Private Branch Exchange (PBX)、Session Border Controller (SBC)、あるいは Session Initiation Protocol (SIP) をサポートしているインターネットアクセスのある他の音声インフラストラクチャを用意する必要があります。詳細については、「Amazon Chime SDK 管理者ガイド」の「[開始する前に](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq)」を参照してください。 **音声インフラストラクチャを統合するには** 1. AWS アカウントで Amazon Chime SDK Voice Connector を作成します。詳細については、「Amazon Chime SDK 管理者ガイド」の「[Amazon Chime Voice Connector の作成](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon)」を参照してください。 1. Amazon Chime SDK Voice Connector 設定を編集して、音声インフラストラクチャから AWSへの呼び出しを許可します。詳細については、「Amazon Chime SDK 管理者ガイド」の「[Amazon Chime Voice Connector 設定の編集](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon)」を参照してください。 1. **[終了設定]** で、**[有効]** を選択します。 1. **[許可リスト]** で、**[新規]** を選択します。 1. 内部 SIP インフラストラクチャの IP アドレスの CIDR 表記を入力します。これにより、ご使用のインフラストラクチャで Amazon Chime SDK Voice Connector にアクセスできるようになります。例えば、IP アドレス `10.24.34.0` からのトラフィックを許可するには、CIDR 表記 `10.24.34.0/32` を許可リストに登録します。 1. **[追加]** を選択します。 1. [**Calling plan (通話プラン)**] で、通話プランに追加する 1 つ以上の国を選択します。 1. 必要に応じて他の設定を編集し、**[保存]** を選択します。 1. Amazon Chime SDK コンソールで、**[音声コネクタ]** の下に Amazon Chime SDK Voice Connector の **[アウトバウンドホスト名]** が表示されます。例: *abcdef1ghij2klmno3pqr4*.voiceconnector.chime.aws. 1. Amazon Chime SDK を使用して会議に参加するには、SIP URI を使用して Amazon Chime SDK Voice Connector の**アウトバウンドホスト名**に 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) アクションを呼び出して、生成された一意の参加トークンを使用します。詳細については、次の例を参照してください。 **Example 例: SIP リクエスト** 次の例は、Amazon Chime SDK Voice Connector に SIP リクエストを出すために使用する SIP URI のコンテンツを示しています。 ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` 以下の例は、Amazon Chime SDK ミーティングに参加するための SIP INVITE メッセージのサンプルを示しています。 ``` 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 は、Amazon EventBridge、Amazon Simple Queue Service (SQS)、および Amazon Simple Notification Service (SNS) への会議イベント通知の送信をサポートしています。 **注記** デフォルトの Amazon Chime SDK ミーティング名前空間は、`ChimeSDKMeetings` エンドポイントを使用します。従来の Chime 名前空間は、1 つのエンドポイントを使用します。名前空間とエンドポイントの詳細については、このガイドの前半にある「[Amazon Chime SDK ミーティング名前空間への移行](meeting-namespace-migration.md)」を参照してください。 ## EventBridge に通知を送信する Amazon Chime SDK イベント通知を EventBridge に送信できます。EventBridge での Amazon Chime SDK の使用の詳細については、「Amazon Chime SDK Administrator Guide」の「[Automating the Amazon Chime SDK with 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 ミーティングイベント通知を、会議ごとに 1 つの Amazon SQS キューと 1 つの Amazon SNS トピックに送信できます。これにより、通知のレイテンシーを低減できます。Amazon SQS の詳細については、「[Amazon Simple Queue Service Developer Guide](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/)」を参照してください。Amazon SNS の詳細については、[Amazon Simple Notification Service デベロッパーガイド](https://docs.aws.amazon.com/sns/latest/dg/) を参照してください。 Amazon SQS および Amazon SNS に送信される通知には、Amazon Chime SDK が EventBridge に送信する通知と同じ情報が含まれています。Amazon Chime SDK は、会議の作成に使用された API リージョンのキューとトピックへの会議イベント通知の送信をサポートします。イベント通知は、発生順とは異なる順序で配信される場合があります。 ## Amazon Chime SDK に Amazon SQS と Amazon SNS へのアクセスを許可する Amazon Chime SDK が Amazon SQS キューまたは Amazon SNS トピックを介して通知を送信できるようにするには、キューまたはトピックの Amazon リソースネーム (ARN) にメッセージを発行するためのアクセス許可を Amazon Chime SDK に付与する必要があります。これを行うには、Amazon Chime SDK に適切なアクセス許可を付与する AWS Identity and Access Management (IAM) ポリシーをキューまたはトピックにアタッチします。詳細については、「Amazon Simple Queue Service 開発者ガイド」の「[Amazon SQS での Identity and Access Management](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)」を参照してください。 **注記** Amazon SQS キューまたは Amazon SNS トピックは、Amazon Chime SDK API エンドポイントと同じ AWS リージョンを使用する必要があります。 **Example Amazon Chime SDK が Amazon SQS キューにイベントを発行することを許可する** 次の IAM ポリシーの例は、指定した Amazon SQS キューに会議イベント通知を発行するためのアクセス許可を Amazon Chime SDK に付与します。`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 Chime SDK が会議イベント通知を SNS トピックに送信することを許可する 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 SQS キューでサーバー側の暗号化 (SSE) が有効になっている場合は、追加のステップを実行する必要があります。Amazon Chime SDK にキューに追加されたデータの暗号化に必要な AWS KMS アクションへのアクセス許可を付与する IAM ポリシーを、関連付けられた 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 ポリシーの例は、指定した Amazon SNS トピックに会議イベント通知を発行するためのアクセス許可を Amazon Chime SDK に付与します。 **** ``` { "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 SDK は、一連のエンドポイントで API を公開します。HTTPS リクエストをエンドポイントに対して直接行うこともできますが、多くのお客様はアプリケーション内で AWS SDK を使用してサービス API を呼び出します。 AWS SDK はさまざまな言語で使用でき、リクエストの署名と再試行ロジックをカプセル化することで API コールを簡素化します。 AWS SDK には、各サービスエンドポイントの名前空間が含まれています。 最初に発表されたときには、Amazon Chime SDK は Amazon Chime アプリケーションと 1 つのエンドポイントを共有していました。その結果、ソリューションは AWS SDK で `Chime`名前空間を使用して Amazon Chime アプリケーションと Amazon Chime SDK 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) | ChimeSDKIdentity | [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) | ChimeSDKMediaPipelines | [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) | ChimeSDKMeetings | [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) | ChimeSDKMessaging | [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) | ChimeSDKVoice | [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) | ## 各サービスの移行ヘルプ すべてのお客様は、最新の Amazon Chime SDK 機能、APIs、および AWS リージョンにアクセスするために、専用の Amazon Chime SDK エンドポイントを使用することを検討する必要があります。`Chime` 名前空間で共有エンドポイントを使用している場合、以下の移行ガイドを参照すると、移行前に技術的な違いを理解するのに役立ちます。 + [Amazon Chime SDK Identity 名前空間への移行](identity-namespace-migration.md) + [Amazon Chime SDK メディアパイプライン名前空間への移行](migrate-pipelines.md) + [Amazon Chime SDK ミーティング名前空間への移行](meeting-namespace-migration.md) + [Amazon Chime SDK メッセージング名前空間への移行](messaging-namespace-migration.md) + [Amazon Chime SDK Voice 名前空間への移行](voice-namespace-migration.md) ## API マッピング 次の表は、`Chime` 名前空間の API と、それに対応する専用の名前空間と API のリストです。専用 API の一部は `Chime` API と異なっており、表にはそれらのインスタンスが示されています。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** API は別の名前の API に置き換えられました。 **\$1** API は使用できなくなりました。