翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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 クライアントライブラリ**
- **Windows**
- **ブラウザ:** Mozilla Firefox / **サポートバージョン:** 75 以降 / **注意事項:**
- **ブラウザ:** Google Chrome / **サポートバージョン:** 78 以降 / **注意事項:**
- **ブラウザ:** Chromium ベースの Edge / **サポートバージョン:** 79 以降 / **注意事項:**
- **ブラウザ:** Chromium ベースの Electron / **サポートバージョン:** 7 以降 / **注意事項:** Chrome バージョン 78 以降。
- **ブラウザ:** Opera / **サポートバージョン:** 66 以降 / **注意事項:**
- ** macOS **
- **ブラウザ:** Mozilla Firefox / **サポートバージョン:** 75 以降 / **注意事項:**
- **ブラウザ:** Google Chrome / **サポートバージョン:** 78 以降 / **注意事項:**
- **ブラウザ:** Chromium ベースの Edge / **サポートバージョン:** 79 以降 / **注意事項:**
- **ブラウザ:** Chromium ベースの Electron / **サポートバージョン:** / **注意事項:**
- **ブラウザ:** Safari / **サポートバージョン:** 13 以降 / **注意事項:**
- **ブラウザ:** Opera / **サポートバージョン:** 66 以降 / **注意事項:**
- **iOS**
- **ブラウザ:** Mozilla Firefox / **サポートバージョン:** 10 以降 / **注意事項:** 音声と動画のみ。コンテンツ共有はできません。
- **ブラウザ:** Google Chrome / **サポートバージョン:** 78 以降 / **注意事項:** 音声と動画のみ。コンテンツ共有はできません。
- **ブラウザ:** Safari / **サポートバージョン:** 13 以降 / **注意事項:** 音声と動画のみ。コンテンツ共有はできません。
- **ブラウザ:** WKWebView / **サポートバージョン:** 14.3 以降 / **注意事項:** 音声と動画のみ。コンテンツ共有はできません。
- **Android**
- **ブラウザ:** Google Chrome / **サポートバージョン:** 10 以降 / **注意事項:** 音声と動画のみ。コンテンツ共有はできません。
- **ブラウザ:** Samsung / **サポートバージョン:** 12 以降 / **注意事項:** 音声と動画のみ。コンテンツ共有はできません。
- **ブラウザ:** Chromium WebView / **サポートバージョン:** 5 以降 / **注意事項:** 音声と動画のみ。コンテンツ共有はできません。
- **Ubuntu LTS 16.04 以降**
- **ブラウザ:** Google Chrome
- **サポートバージョン:** 78 以降
- **注意事項:**
**iOS 用 Amazon Chime SDK クライアントライブラリ**
+ iOS バージョン 13 以降
**Android 用 Amazon Chime SDK クライアントライブラリ**
+ Android OS バージョン 5 以降、ARM および ARM64 アーキテクチャ