翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Chime SDK メッセージングでのメッセージングデータのストリーミング
メッセージおよびチャネルイベントなどのデータをストリーム形式で受信するように AppInstance を設定できます。その後、そのデータにリアルタイムで対応することができます。現在、Amazon Chime SDK メッセージングは Kinesis ストリームのみをストリームの送信先として受け付けています。この機能で Kinesis ストリームを使用するには、以下の前提条件を満たす必要があります。
-
Kinesis ストリームは、 と同じ AWS アカウントに存在する必要があります
AppInstance。 -
ストリームは
AppInstanceと同じリージョンに存在する必要があります。 -
ストリーム名には
chime-messaging-で始まるプレフィックスが付きます。 -
少なくとも 2 つのシャードを設定する必要があります。各シャードは 1 秒あたり最大 1 MB のデータを受信できるため、それに応じてストリームをスケールしてください。
-
サーバー側の暗号化 (SSE) を有効にします。
Kinesis ストリームを設定するには
-
前のセクションの前提条件を使用して 1 つ以上の Kinesis ストリームを作成し、ARN を取得します。呼び出し元が Amazon Chime のアクセス許可に加えて Kinesis のアクセス許可を持っていることを確認してください。
次の例は、 CLI AWS を使用して 2 つのシャードを持つ Kinesis ストリームを作成する方法と、SSE を有効にする方法を示しています。
aws kinesis create-stream --stream-namechime-messaging-unique-name--shard-count2aws kinesis start-stream-encryption --stream-namechime-messaging-unique-name--encryption-type KMS --key-id "alias/aws/kinesis" -
PutMessagingStreamingConfigurations API を呼び出してストリーミングを設定します。
2 つのデータタイプの一方または両方を設定でき、同じストリームまたは別々のストリームを選択できます。
次の例は、 CLI AWS を使用して
ChannelMessageおよびChannelデータ型をストリーミングappinstanceするように を設定する方法を示しています。aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arnapp_instance_arn\ --streaming-configurations DataType=ChannelMessage,ResourceArn=kinesis_data_stream_arnaws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arnapp_instance_arn\ --streaming-configurations DataType=Channel,ResourceArn=kinesis_data_stream_arnデータタイプには以下のスコープがあります。
DataType生成されたイベントタイプ CREATE_CHANNEL_MESSAGEREDACT_CHANNEL_MESSAGEUPDATE_CHANNEL_MESSAGEDELETE_CHANNEL_MESSAGECREATE_CHANNELCREATE_SUB_CHANNELUPDATE_CHANNELDELETE_CHANNELUPDATE_CHANNEL_EXPIRATION_SETTINGSDELETE_SUB_CHANNELCREATE_CHANNEL_MEMBERSHIPDELETE_CHANNEL_MEMBERSHIPCREATE_CHANNEL_BANDELETE_CHANNEL_BANCREATE_CHANNEL_MODERATORDELETE_CHANNEL_MODERATOR -
設定した Kinesis ストリームからデータの読み取りを開始します。
注記
ストリーミングを設定する前に送信されたイベントは、Kinesis ストリームには送信されません。
[Data format] (データ形式)
Kinesis は、EventType および Payload のフィールドを含む JSON 形式のレコードを出力します。ペイロード形式は EventType によって異なります。以下の表は、イベントタイプおよびそれに対応するペイロード形式を示しています。
| EventType | ペイロード形式 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|