# IVS Chat Client Messaging SDK
<a name="chat-sdk"></a>

Amazon Interractive Video Searvice (IVS) Chat Client Messaging SDK は、Amazon IVS を使用してアプリケーションを構築するデベロッパー向けのものです。この SDK は、Amazon IVS アーキテクチャを活用するように設計されており、Amazon IVS Chat と更新されます。ネイティブの SDK として、アプリケーションおよびユーザーがアプリケーションにアクセスするデバイスに対してパフォーマンスへの影響を最小限に抑えるように設計されています。

## プラットフォームの要件
<a name="chat-sdk-platform-requirements"></a>

### デスクトップブラウザ
<a name="chat-desktop-browsers"></a>


| ブラウザ | サポートされているバージョン | 
| --- | --- | 
| Chrome | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| Edge | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| Firefox | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| Opera | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| Safari | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 

### モバイルブラウザ
<a name="chat-mobile-browsers"></a>


| ブラウザ | サポートされているバージョン | 
| --- | --- | 
| Chrome for Android | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| Android 向け Firefox | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| Android 向け Opera | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| WebView Android | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| サムスン・インターネット | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 
| iOS 向け Safari | 2 つのメジャーバージョン (最新バージョンと 1 つ前のバージョン) | 

### ネイティブプラットフォーム
<a name="chat-native-platforms"></a>


| プラットフォーム | サポートされているバージョン | 
| --- | --- | 
| Android | 5.0 以降 | 
| iOS |  13.0 以降  | 

## サポート
<a name="chat-sdk-support"></a>

チャットルームのエラーやその他の問題が発生した場合は、IVS チャット API を介してチャットルームの識別子を特定します ([LisListRooms](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/API_ListRooms.html) を参照)。

このチャットルームの識別子を AWS サポートに伝えます。それにより、サポートはトラブルシューティングに役立つ情報を入手できます。

**注意:** 利用可能なバージョンと修正済みの問題については、「[Amazon IVS Chat Release Notes](release-notes.md)」を参照してください。必要な場合、サポートに連絡する前にお使いの SDK のバージョンを更新し、問題が解決するかどうか確認してください。

### バージョニング
<a name="chat-sdk-support-versioning"></a>

Amazon IVS Chat Client Messaging SDK は、[セマンティックバージョニング](https://semver.org/)を使用しています。

以下の解説は、次を前提としています。
+ 最新リリースは 4.1.3。
+ 1 つ前のメジャーバージョンの最新リリースは 3.2.4。
+ バージョン 1.x の最新リリースは 1.5.6.

最新バージョンのマイナーリリースとして、下位互換性のある新機能が追加されています。この場合、次回の新機能のセットは、バージョン 4.2.0 として追加されます。

下位互換性のあるマイナーなバグ修正が、最新バージョンのパッチリリースとして追加されています。ここでは、次回のマイナーなバグ修正のセットは、バージョン 4.1.4 として追加されます。

下位互換性のあるメジャーなバグ修正は異なる方法で処理されます。これらはいくつかのバージョンに追加されています。
+ 最新バージョンのパッチリリース。こちらは、バージョン 4.1.4 です。
+ 1 つ前のマイナーバージョンのパッチリリース。こちらは、バージョン 3.2.5 です。
+ 最新バージョン 1.x リリースのパッチリリース。こちらは、バージョン 1.5.7 です。

メジャーなバグ修正は、Amazon IVS 製品チームによって定義されています。典型的な例に、重要なセキュリティ更新のほか、お客様に必要な選別された修正があります。

**注:** 上記の例では、リリースされたバージョンの数字は、連番でインクリメントされています(4.1.3 → 4.1.4、など)。実際は、1 つ以上のパッチ番号が内部に残り、リリースされないままになることもあります。そのため、リリースされたバージョンは 4.1.3 から (例えば) 4.1.6 に増えることもあります。

また、バージョン 1.x は 2023 年末まで、または 3.x がリリースされるまでのいずれか遅い方までサポートされます。

## Amazon IVS Chat API
<a name="chat-sdk-chat-apis"></a>

サーバー側 (SDK によって管理されていない) には 2 つの API があり、それぞれに次の役割があります。
+ **データプレーン** - [IVS チャットメッセージ API](https://docs.aws.amazon.com//ivs/latest/chatmsgapireference/welcome.html) は、トークンベースの認証スキームによって駆動されるフロントエンドアプリケーション (iOS、Android、macOS など) で使用するように設計された WebSocket API です。以前に生成されたチャットトークンを使用して、この API を使用して既存のチャットルームに接続します。

  Amazon IVS Chat Client Messaging SDK はデータプレーンのみに関係します。SDK は、バックエンドですでにチャットトークンを生成していることを前提としています。これらのトークンの取得は、SDK ではなくフロントエンドアプリケーションによって管理されることを前提としています。
+ **コントロールプレーン** - [IVS チャットコントロールプレーン API](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/Welcome.html) は独自の*バックエンドアプリケーション*にインターフェイスを提供して、チャットルームとそこに参加するユーザーを管理および作成します。これは、独自のバックエンドによって管理されるアプリのチャットエクスペリエンスの管理パネルと考えてください。データプレーンがチャットルームに認証を行うために必要な*チャットトークン*を作成するコントロールプレーンオペレーションがあります。

  **重要:** *IVS Chat Client Messaging SDK は、コントロールプレーンオペレーションを呼び出しません。チャットトークンを作成するには、バックエンドを設定する必要があります。このチャットトークンを取得するには、フロントエンドアプリケーションがバックエンドと通信する必要があります。*