View a markdown version of this page

Amazon Chime SDK を使用する - Amazon Chime SDK

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

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 ポリシーなど、Amazon Chime SDK で使用される AmazonChimeSDK 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 の動画解像度をサポートします。iOSAndroidWindows 用の 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 エンドポイントとクォータ」を参照してください。

注記

サービスクォータは API エンドポイントごとに設定されます。サービスクォータの引き上げをリクエストする際は、必ず、アプリケーションで使用するすべての API エンドポイントで引き上げをリクエストしてください。

Amazon Chime SDK のシステム要件

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

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

オペレーティングシステム ブラウザ サポートバージョン 注意事項

Windows

Mozilla Firefox

最新の 3 つのバージョン

Google Chrome

最新の 3 つのバージョン

Chromium ベースの Edge

最新の 3 つのバージョン

Chromium ベースの Electron

最新の 3 つのバージョン

Electron は最新の 3 つの安定メジャーバージョンをサポートし、それぞれに偶数の Chromium リリースを追跡します。Electron ウェブサイトの「Electron リリース」を参照してください。

Opera

最新の 3 つのバージョン

macOS

Mozilla Firefox

最新の 3 つのバージョン

Google Chrome

最新の 3 つのバージョン

Chromium ベースの Edge

最新の 3 つのバージョン

Chromium ベースの Electron

最新の 3 つのバージョン

Electron は最新の 3 つの安定メジャーバージョンをサポートし、それぞれに偶数の Chromium リリースを追跡します。Electron ウェブサイトの「Electron リリース」を参照してください。

Safari

最新の 3 つのバージョン

Opera

最新の 3 つのバージョン

iOS

Mozilla Firefox

最新の 3 つのバージョン

音声と動画のみ。コンテンツ共有はできません。

Google Chrome

最新の 3 つのバージョン

音声と動画のみ。コンテンツ共有はできません。

Safari

最新の 3 つのバージョン

音声と動画のみ。コンテンツ共有はできません。

WKWebView

14.3 以降

音声と動画のみ。コンテンツ共有はできません。

Android

Google Chrome

最新の 3 つのバージョン

音声と動画のみ。コンテンツ共有はできません。

サムスン・インターネット

12 以降

音声と動画のみ。コンテンツ共有はできません。

Chromium WebView

5 以降

音声と動画のみ。コンテンツ共有はできません。

Ubuntu LTS 16.04 以降

Google Chrome

最新の 3 つのバージョン

iOS 用 Amazon Chime SDK クライアントライブラリ
  • iOS バージョン 13 以降

Android 用 Amazon Chime SDK クライアントライブラリ
  • Android OS バージョン 5 以降、ARM および ARM64 アーキテクチャ