Amazon Chime SDK ミーティング名前空間への移行 - Amazon Chime SDK
移行すべき理由移行する前に名前空間の相違点

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

Amazon Chime SDK ミーティング名前空間への移行

Amazon Chime SDK ミーティング名前空間は、Amazon Chime SDK ミーティングのリソースを作成および管理する API 専用の場所です。この名前空間を使用すると、任意の AWS リージョンの Amazon Chime SDK ミーティング API エンドポイントをアドレス指定できます (そのリージョンでそれらのエンドポイントを利用できる場合)。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「利用できるリージョン」を参照してください。

Amazon Chime 名前空間を使用する既存のアプリケーションでは、最新の API と機能を使用するために、専用の名前空間への移行を計画する必要があります。

移行すべき理由

以下の理由から、Amazon Chime SDK ミーティング名前空間に移行することをお勧めします。

API エンドポイントの選択

Amazon Chime SDK ミーティング名前空間は、API エンドポイントを利用できる任意のリージョンの API エンドポイントを使用できる唯一の API 名前空間です。us-east-1 以外の API エンドポイントを使用する場合は、Amazon Chime SDK ミーティング名前空間を使用する必要があります。

Amazon Chime SDK 会議で AWS リージョンを使用する方法の詳細については、このガイドの「会議リージョン」を参照してください。

会議 API の更新と新規追加

Amazon Chime SDK ミーティング名前空間の会議 API のみを追加または更新します。

移行する前に

移行する前に、名前空間の相違点に注意してください｡ 以下の表では、名前空間の一覧と説明を示しています。

Amazon Chime SDK ミーティング名前空間 Amazon Chime 名前空間
AWS SDK 名前空間 ChimeSDKMeetings Chime
リージョン 複数 us-east-1 のみ
エンドポイント https://meetings-chime.region.amazonaws.com https://service.chime.aws.amazon.com
サービスプリンシパル meetings.chime.amazonaws.com chime.amazonaws.com
API 会議用の API のみ 会議用の API と Amazon Chime のその他の部分
CreateMeeting ExternalMeetingId と MediaRegion は必須です。 ExternalMeetingId および MediaRegion はオプションです。
CreateMeetingWithAttendees ExternalMeetingId と MediaRegion は必須です。 ExternalMeetingId および MediaRegion はオプションです。
ListMeetings 利用不可 利用可能
ExternalMeetingId 検証にはパターンマッチングが含まれます 利用可能
ExternalUserId 検証にはパターンマッチングが含まれます 利用可能
会議タグ APIs TagResource, UntagResource, ListTagsForResource TagMeeting, UntagMeeting, ListMeetingTags
参加者タグ 利用不可 利用可能
エコーリダクション 利用可能 利用不可
ライブ文字起こし言語識別 利用可能 利用不可
参加者の機能 利用可能 利用不可
メディアレプリケーション 利用可能 利用不可
AppKeys および TenantIds 利用可能 利用不可
メディアパイプライン メディアパイプラインは、Amazon Chime SDK ミーティング名前空間で複数のリージョンをサポートします。詳細については、「ChimeSdkMediaPipelines 名前空間への移行」を参照してください。 us-east-1 エンドポイント経由で利用可能
SIP メディアアプリケーション JoinChimeMeeting アクションに MeetingId は必須 JoinChimeMeeting アクションに MeetingId は不要

SIP の直接統合

 利用不可 利用可能

名前空間の相違点

以下のセクションでは、Amazon Chime 名前空間と Amazon Chime SDK Meetings 名前空間の相違点について説明します。

Amazon Chime SDK 名前空間では Chime という正式名を使用します。Amazon Chime SDK ミーティング名前空間では、ChimeSDKMeetings という正式な名前を使用します。名前の正確な形式はプラットフォームによって異なります。

例えば、Node.js の AWS SDK を使用して会議を作成する場合は、コード行を使用して名前空間に対処します。

const chimeMeetings = AWS.Chime();

Amazon Chime 会議 SDK に移行するには、この行のコードを新しい名前空間とエンドポイントリージョンで更新します。

const chimeMeetings = AWS.ChimeSDKMeetings({ region: "eu-central-1" });

Amazon Chime 名前空間は、us-east-1 リージョンの API エンドポイントのみをアドレス指定します。Amazon Chime SDK ミーティング名前空間は、任意のリージョンの Amazon Chime SDK ミーティング API エンドポイントをアドレス指定できます (そのリージョンでそれらのエンドポイントを利用できる場合)。会議リージョンの最新リストについては、本ガイドの「利用できるリージョン」を参照してください。

Amazon Chime SDK ミーティング名前空間は、Amazon Chime 名前空間とは異なる API エンドポイントを使用します。

会議を変更するために使用できるのは、会議の作成に使用したエンドポイントだけです。つまり、EU-CENTRAL-1 のエンドポイントで作成された会議は、EU-CENTRAL-1 でのみ変更できます。また、Chime 名前空間で作成された会議を、US-EAST-1 の ChimeSDKMeetings 名前空間を使用してアドレス指定することはできません。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。

Amazon Chime SDK ミーティング名前空間は、新しいサービスプリンシパル meetings.chime.amazonaws.com を使用します。サービスへのアクセスを許可する SQS、SNS またはその他の IAM アクセスポリシーがある場合は、それらのポリシーを更新して新しいサービスプリンシパルへのアクセスを許可する必要があります。

Amazon Chime SDK ミーティング名前空間には、会議を作成および管理するための API のみが含まれています。Amazon Chime 名前空間には、会議用および Amazon Chime サービスのその他の部分用の API が含まれています。

Amazon Chime SDK ミーティング名前空間では、 CreateMeetingおよび CreateMeetingWithAttendees APIsには ExternalMeetingId および MediaRegionフィールドを指定する必要があります。

Amazon Chime SDK ミーティング名前空間は、ExternalMeetingId および ExternalUserId に使用できる値に対して追加の検証を実施します。

Amazon Chime SDK ミーティング名前空間には機械学習ベースのエコーリダクション機能が備わっており、ローカルのラウドスピーカーから発生するノイズや音が会議の音声に入らないように取り除くのに役立ちます。詳細については、 GitHub 「」のガイドを参照してください。

Amazon Chime SDK ミーティング名前空間では、会議の参加者が音声、動画、コンテンツを送受信する機能をきめ細かく制御できます。

Amazon Chime SDK ミーティング名前空間には、プライマリ会議をレプリカ会議にリンクするメディアレプリケーション機能が備わっており、最大 10,000 人が同時にリアルタイムセッションに参加できます。レプリカセッションに接続した参加者は、プライマリセッションに接続したプレゼンターのメディアを受け取りますが、これらの参加者をプライマリ会議の参加者に昇格させることもできます。詳細については、本ガイドの「メディアレプリケーションの使用」を参照してください。

Amazon Chime SDK ミーティング名前空間は、特定の Amazon Chime SDK ミーティングに対するネットワークからのアクセスを制限する方法を提供します。詳細については、本ガイドの「 AppKeys と TenantIDsの使用」を参照してください。

Amazon Chime SDK メディアパイプラインは、Amazon Chime SDK ミーティング名前空間または Amazon Chime 名前空間のどちらを使用したかにかかわらず、どの会議エンドポイントによって作成された会議でも動作します。メディアパイプラインリージョンの最新リストについては、「利用できるリージョン」を参照してください。

Amazon Chime SDK SIP メディアアプリケーションは、Amazon Chime SDK ミーティング名前空間または Amazon Chime 名前空間のどちらを使用したかにかかわらず、どの会議エンドポイントによって作成された会議でも動作します。Amazon Chime SDK ミーティング名前空間を使用して作成された会議で SIP メディアアプリケーションを使用する場合、JoinChimeMeeting アクションには MeetingId パラメータが必要です。

会議名前空間には、Chime 名前空間にはない API が増え続けています。Amazon Chime SDK の使用を開始する場合は、会議名前空間を使用して最新の機能にアクセスしてください。