Amazon Chime の使用 SDK - Amazon Chime SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Chime の使用 SDK

Amazon Chime を使用してSDK、オーディオとビデオを送受信し、コンテンツ共有を許可するリアルタイムメディアアプリケーションを構築します。Amazon Chime は、Amazon Chime 管理者アカウントとは独立してSDK動作し、Amazon Chime でホストされる会議には影響しません。代わりに、Amazon Chime SDKには、独自の会議アプリケーションを構築するために使用するビルダーツールが用意されています。

Amazon Chime を使用するための前提条件 SDK

Amazon Chime を使用するには、以下SDKが必要です。

  • プログラムする機能。

  • AWS アカウント。

  • AWS マネージドポリシーなどSDK、Amazon Chime で使用される Amazon Chime APIアクションへのアクセス許可を付与するAmazonChimeSDKポリシーを持つIAMロール。詳細については、「Amazon Chime 管理者ガイド」の「Amazon Chime の での作業IAMSDK方法」および「ユーザーに Amazon 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 と Datagram Transport Layer Security (DTLS) の組み合わせを使用して、メディアサービスグループに安全に通知し、メディアサービスグループを介して他の参加者との間でメディアを送受信します。

音声

メディアサービスでは各参加者の音声をミックスし、ミックスから各自の音声を差し引いた後、ミックスを各受信者に送信します。Amazon Chime サンプルSDKsオーディオは、デバイスとブラウザがサポートする最高レートで、最大 48 までですkHz。音声のエンコードには Opus コーデックを使用します。デフォルトのビットレートは 32kbps で、ステレオでは最大 128kbps、モノラルでは最大 64kbps まで上げることができます。

動画

メディアサービスは、パブリッシュおよびサブスクライブモデルを使用して選択的転送ユニット (SFU) として機能します。各参加者は 1 つの動画ソースを公開でき、1 回の会議につき最大 25 本の動画を同時に公開できます。の Amazon Chime SDKクライアントライブラリ JavaScript は、サイマルキャストなしで 30 フレーム/秒で最大 1280x720 のビデオ解像度をサポートし、サイマルキャストで 15 フレーム/秒をサポートします。iOSAndroid 、および Windows 用の Amazon Chime SDKクライアントライブラリは、最大 1280x720 および 30 フレーム/秒のビデオ解像度をサポートしていますが、実際のフレームレートと解像度は Amazon Chime によって自動的に管理されますSDK。

動画サイマルキャストがアクティブな場合、各動画ストリームは 2 つの異なる解像度とビットレートで送信されます。帯域幅に制約があるクライアントは、低いビットレートのストリームを自動的にサブスクライブします。動画のエンコードとデコードでは、パフォーマンスを向上させるためにハードウェアアクセラレーション (利用可能な場合) を使用します。

データメッセージ

会議の参加者は、音声および動画コンテンツに加えて、それぞれ最大 2 KB のリアルタイムなデータメッセージを相互に送信できます。メッセージを使用して、ホワイトボード、チャット、リアルタイムの絵文字リアクション、アプリケーション固有のフロアコントロールシグナリングなどのカスタム会議機能を実装できます。

コンテンツ共有

クライアントアプリケーションでは、スクリーンキャプチャやメディアファイルなどの音声および動画コンテンツを共有できます。コンテンツ共有は、1 秒あたり 15 フレームで最大 1280x720 の録音済みコンテンツビデオと、64 kbps kHz で最大 48 のオーディオをサポートします。コンテンツ共有用のスクリーンキャプチャは 1 秒あたり最大 15 フレームまでサポートされていますが、デバイスとブラウザの処理能力によって制限される場合があります。

Amazon Chime のクォータ SDK

Amazon Chime SDKサービスのクォータについては、「」を参照してください AWS 全般のリファレンス。詳細については、「」の「Amazon Chime SDKエンドポイントとクォータ」を参照してくださいAWS 全般のリファレンス

注記

サービスクォータはAPIエンドポイントごとです。サービスクォータの引き上げをリクエストする場合は、アプリケーションが使用するすべてのAPIエンドポイントの引き上げをリクエストしてください。

Amazon Chime SDKシステム要件

Amazon Chime で作成されたアプリケーションには、次のシステム要件が適用されますSDK。

でサポートされているブラウザ、Amazon Chime SDKクライアントライブラリ JavaScript

オペレーティングシステム ブラウザ サポートバージョン メモ

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 アーキテクチャ