# IVS 聊天用戶端傳訊 SDK
<a name="chat-sdk"></a>

Amazon 互動影片服務 (IVS) 聊天用戶端傳訊開發套件適用於使用 Amazon IVS 建置應用程式的開發人員。此開發套件的設計目的是利用 Amazon IVS 架構和 Amazon IVS 聊天功能，並推出改良後的新版功能。作為原生開發套件，其設計目的是將對您的應用程式和使用者存取應用程式的裝置的效能影響降至最低。

## 平台需求：
<a name="chat-sdk-platform-requirements"></a>

### 桌面瀏覽器
<a name="chat-desktop-browsers"></a>


| 瀏覽器 | 支援的版本 | 
| --- | --- | 
| Chrome | 兩個主要版本 (目前版本和最新的先前版本) | 
| Edge | 兩個主要版本 (目前版本和最新的先前版本) | 
| Firefox | 兩個主要版本 (目前版本和最新的先前版本) | 
| Opera | 兩個主要版本 (目前版本和最新的先前版本) | 
| Safari | 兩個主要版本 (目前版本和最新的先前版本) | 

### 行動裝置瀏覽器
<a name="chat-mobile-browsers"></a>


| 瀏覽器 | 支援的版本 | 
| --- | --- | 
| 適用於 Android 的 Chrome | 兩個主要版本 (目前版本和最新的先前版本) | 
| 適用於 Android 的 Firefox | 兩個主要版本 (目前版本和最新的先前版本) | 
| 適用於 Android 的 Opera | 兩個主要版本 (目前版本和最新的先前版本) | 
| 適用於 Android 的 WebView | 兩個主要版本 (目前版本和最新的先前版本) | 
| Samsung Internet | 兩個主要版本 (目前版本和最新的先前版本) | 
| 適用於 iOS 的 Safari | 兩個主要版本 (目前版本和最新的先前版本) | 

### 原生平台
<a name="chat-native-platforms"></a>


| 平台 | 支援的版本 | 
| --- | --- | 
| Android | 5.0 版和更新版本 | 
| iOS |  13.0 版和更新版本  | 

## 支援
<a name="chat-sdk-support"></a>

如果聊天室發生錯誤或其他問題，請透過 IVS Chat API 判斷聊天室專屬的識別碼是否正確 )請參閱 [ListRooms](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/API_ListRooms.html))。

將此聊天室的識別碼提供給 AWS Support。使用它，他們就可以取得資訊來協助您對問題進行疑難排解。

**注意：**關於可用版本以及已修正的問題，請參閱 [Amazon IVS 聊天功能版本備註](release-notes.md)。如果適當，請在聯絡支援部門之前，先更新您的開發套件版本，並查看是否可以解決您的問題。

### 版本控制
<a name="chat-sdk-support-versioning"></a>

Amazon IVS 聊天用戶端傳訊 SDK 使用[語意版本控制](https://semver.org/)。

對於此討論，假設：
+ 最新版本為 4.1.3 版。
+ 先前主要版本的最新版本為 3.2.4 版。
+ 版本 1.x 的最新版本為 1.5.6 版。

回溯相容的新功能會新增為最新版本的次要版本。在這種情況下，下一組新功能將被新增為 4.2.0 版。

回溯相容的次要錯誤修正會新增為最新版本的修補程式版本。在這裡，下一組小錯誤修復將被新增為 4.1.4 版。

回溯相容、主要錯誤修正的處理方式不同；它們會新增至多個版本：
+ 最新版本的修補程式版本。在這裡，它為 4.1.4 版。
+ 先前次要版本的修補程式版本。在這裡，它為 3.2.5 版。
+ 最新版 1.x 版本的修補程式版本。在這裡，它為 1.5.7 版。

主要錯誤修正由 Amazon IVS 產品團隊定義。典型範例包括重要的安全更新以及客戶所需的其他精選修正。

**備註：**在上面的範例中，發布的版本在不跳過任何數字的情況下遞增 (例如，從 4.1.3 到 4.1.4)。實際上，一個或多個修補程式編號可能會保持在內部並且不需要發行，因此發行的版本可能會從 4.1.3 增加到 4.1.6。

此外，在 2023 年底或發行 3.x 之前，將支援 1.x 版，以較晚者為準。

## Amazon IVS 聊天功能開發套件
<a name="chat-sdk-chat-apis"></a>

伺服器端 (不由開發套件管理) 有兩個 API，每個 API 都有自己負責的部分：
+ **資料平面** — 此 [IVS Chat 傳訊 API](https://docs.aws.amazon.com//ivs/latest/chatmsgapireference/welcome.html) 是一種 WebSockets API，主要由以字符型身分驗證方案驅動的前端應用程式 (iOS、Android、macOS 等) 使用。透過先前產生的聊天字符，即可使用此 API 與現有的聊天室連線。

  *Amazon IVS 聊天用戶端傳訊 SDK 僅與資料平面有關。開發套件會假設您已經透過後端產生聊天字符。擷取這些字符的工作應由前端應用程式管理，而非由開發套件管理。*
+ **控制平面** — 此 [IVS Chat 控制平面 API](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/Welcome.html) 為您自己的*後端應用程式*提供了一個介面，使用此介面可管理和建立聊天室以及加入聊天室的使用者。可將這個平面視為應用程式聊天體驗 (由*您自己的後端*管理) 的管理面板。有些控制平面操作負責建立*聊天權杖*，資料平面需對這些權杖進行身分驗證，通過驗證者才能進入聊天室。

  **重要事項：***IVS Chat 用戶端傳訊開發套件不會呼叫任何控制平面操作。您必須設定後端才能為您自己建立聊天字符。您的前端應用程式必須與後端通訊才能擷取此聊天字符。*