翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Chime SDK を使用する
Amazon Chime SDK は、音声と動画を送受信し、コンテンツを共有できるリアルタイムなメディアアプリケーションを構築するために使用します。Amazon Chime SDK は Amazon Chime 管理者アカウントとは独立して動作し、Amazon Chime でホストされる会議には影響を及ぼしません。代わりに、Amazon Chime SDK には、独自の会議アプリケーションの構築に使用するビルダーツールが用意されています。
トピック
Amazon Chime SDK の前提条件
Amazon Chime SDK を使用するには、以下が必要です。
プログラムする機能。
AWS アカウント。
AWS マネージド AmazonChimeSDK SDK ポリシーなど、Amazon Chime SDK によって使用される Amazon Chime API アクションにアクセスするためのアクセス許可を付与するポリシーを持つ IAM ロール。詳細については、「Amazon Chime SDK 管理者ガイド」の「Amazon Chime で IAM が機能するしくみ」および「Amazon 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、Android、Windows 用の Amazon Chime SDK クライアントライブラリでは、最大 1280x720 および毎秒 30 フレームの動画解像度がサポートされていますが、実際のフレームレートと解像度は Amazon Chime SDK によって自動的に管理されます。
動画サイマルキャストがアクティブな場合、各動画ストリームは 2 つの異なる解像度とビットレートで送信されます。帯域幅に制約があるクライアントは、低いビットレートのストリームを自動的にサブスクライブします。動画のエンコードとデコードでは、パフォーマンスを向上させるためにハードウェアアクセラレーション (利用可能な場合) を使用します。
- データメッセージ
会議の参加者は、音声および動画コンテンツに加えて、それぞれ最大 2 KB のリアルタイムなデータメッセージを相互に送信できます。メッセージを使用して、ホワイトボード、チャット、リアルタイムの絵文字リアクション、アプリケーション固有のフロアコントロールシグナリングなどのカスタム会議機能を実装できます。
- コンテンツ共有
-
クライアントアプリケーションでは、スクリーンキャプチャやメディアファイルなどの音声および動画コンテンツを共有できます。コンテンツ共有では、毎秒 15 フレームで最大 1280x720 の録画済みコンテンツ動画と、64 kbps で最大 48 kHz の音声がサポートされます。コンテンツ共有用のスクリーンキャプチャは 1 秒あたり最大 15 フレームまでサポートされていますが、デバイスとブラウザの処理能力によって制限される場合があります。
Amazon Chime SDK サービスクォータ
注記
サービスクォータは API エンドポイントごとに設定されます。サービスクォータの引き上げをリクエストする際は、必ず、アプリケーションで使用するすべての API エンドポイントで引き上げをリクエストしてください。
この表には、Amazon Chime SDK 会議で利用できるリソースとクォータが一覧表示されています。
| リソース | クォータ | 引き上げ可能 |
|---|---|---|
アクティブな会議 |
250 |
Yes |
|
会議ごとの参加者 |
250 |
No |
|
会議ごとの音声ストリーム |
250 |
No |
|
会議ごとに公開される動画ストリーム |
25 |
はい (最大 250) |
|
参加者ごとにサブスクライブされる動画ストリーム |
25 |
No |
|
会議ごとのコンテンツ共有 |
2 |
No |
| プライマリ会議ごとのレプリカ会議 | 4 | はい (最大 40) |
会議ごとのアクティブなメディアキャプチャパイプライン |
1 |
No |
アカウントごとのアクティブなメディアキャプチャパイプライン |
us-east-1 エンドポイントでは 100、その他のエンドポイントでは 10 |
Yes |
|
API レート |
1 秒あたり 10 回のリクエスト (RPS)、バーストは 20 RPS。 |
はい、ただし間接的 注記アクティブな会議のクォータを増やすと、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 アーキテクチャ
