翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Chime SDK メッセージングの概念について Amazon Chime SDK メッセージングを効果的に使用するには、以下の用語および概念を理解する必要があります。 **AppInstance** Amazon Chime SDK メッセージングを使用するには、最初に AppInstance を作成する必要があります。AppInstance には AppInstanceUser およびチャネルが含まれます。通常、アプリケーション用に 1 つの AppInstance を作成します。 AWS アカウントは複数の AppInstances を持つことができます。メッセージ保持およびストリーミング設定などのアプリケーションレベルの設定は AppInstance レベルで行います。AppInstance は、以下の形式の一意の ARN によって識別されます: `arn:aws:chime:region:aws_account_id:app-instance/app_instance_id`。 **AppInstanceUser** AppInstanceUser は、メッセージの送信、チャネルの作成、チャネルへの参加などを行うエンティティです。通常、`AppInstanceUser` とアプリケーションユーザーの 1 対 1 のマッピングを作成します。また、`AppInstanceUser` を作成してバックエンドサービスに接続することもできます。これにより、ユーザーはメッセージがバックエンドサービスから送信されたものであることを識別できます。ARN (`arn:aws:chime:region:aws_account_id:app-instance/app_instance_id/user/app_instance_user_id` など) によって識別される AppInstanceUser。`app_instance_user_id` を制御し、ベストプラクティスとして、アプリケーションが既に持っている ID を再利用します。 **チャネル** チャネルに `AppInstanceUser` を追加すると、そのユーザーはメンバーになり、メッセージを送受信できるようになります。チャネルは、すべてのユーザーが自分自身をメンバーとして追加できるパブリックにすることも、チャネルのモデレーターだけがメンバーを追加できるプライベートにすることもできます。チャネルメンバーを非表示にすることもできます。非表示になっているメンバーは会話を観察できますが、メッセージを送信することはできず、チャネルメンバーシップには追加されません。 **SubChannel** Elastic チャネルのメンバーは、SubChannel と呼ばれる論理コンテナに分割されます。AppInstanceUser を Elastic チャネルに追加すると、ユーザーは SubChannel のメンバーになり、その特定の SubChannel のメッセージを送受信できるようになります。チャネルメンバーシップおよびメッセージは SubChannel レベルです。つまり、ある SubChannel のメンバーが送信したメッセージは、別の SubChannel のメンバーによって受信されません。メンバーは、チャネルの伸縮性をサポートし、エンゲージメントを促進するために、さまざまな SubChannel に移管されます。 **UserMessage** チャネルに属している `AppInstanceUser` はユーザーメッセージを送受信できます。`AppInstanceUser` はメッセージを `STANDARD` または `CONTROL` メッセージを送信できます。`STANDARD` メッセージには 4 KB のデータおよび 1 KB のメタデータを含めることができます。`CONTROL` メッセージには 30 バイトのデータしか含めることができません。メッセージは `PERSISTENT` または `NON_PERSISTENT` にすることができます。チャネル履歴から `PERSISTENT` メッセージを取得できます。`NON_PERSISTENT` メッセージは、現在 Amazon Chime SDK メッセージングに接続しているチャネルメンバーのみに表示されます。 **システムメッセージ** Amazon Chime SDK は、メンバーがチャネルに参加または退出するなどのイベントに応じてシステムメッセージを生成します。