# IVS chat 客户端消息收发 SDK
<a name="chat-sdk"></a>

Amazon Interactive Video Services（IVS）Chat 客户端消息收发 SDK 适用于使用 Amazon IVS 构建应用程序的开发人员。此 SDK 旨在利用 Amazon IVS 架构，并将与 Amazon IVS Chat 一起查看更新。作为本机 SDK，它旨在最大限度地减少对应用程序以及用户有权访问应用程序所在设备的性能影响。

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

### 桌面浏览器
<a name="chat-desktop-browsers"></a>


| 浏览器 | 受支持的版本 | 
| --- | --- | 
| Chrome | 两个主要版本（当前版本和最新版本） | 
| 边缘 | 两个主要版本（当前版本和最新版本） | 
| 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)）。

与 Amazon Support 共享此聊天室标识符。利用它可获得有助于解决问题的信息。

**注意：**请参阅 [Amazon IVS 聊天功能发布说明](release-notes.md)了解可用版本和已修复问题。如果合适，请在联系支持部门之前更新您的 SDK 版本，看看这是否解决了您的问题。

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

Amazon IVS Chat 客户端消息收发 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。

此外，版本 1.x 将一直受支持，直到 2023 年底或 3.x 发布时，以较迟者为准。

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

在服务器端（并非由 SDK 托管），存在两个 API，每个 API 都有自己的职责：
+ **数据面板** - [IVS Chat 消息收发 API](https://docs.aws.amazon.com//ivs/latest/chatmsgapireference/welcome.html) 是一个 WebSocket API，旨在供由基于令牌的身份验证方案提供支持的前端应用程序（iOS、Android、macOS 等）使用。通过之前生成的聊天令牌，您可以使用此 API 连接到现有的聊天室。

  *Amazon IVS Chat 客户端消息收发 SDK 仅与数据面板有关。SDK 假设您已经通过后端生成聊天令牌。假设这些令牌的检索由前端应用程序而不是 SDK 进行托管。*
+ **控制面板** - [IVS Chat 控制面板 API](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/Welcome.html) 为您自己的*后端应用程序*提供了一个界面，用于管理和创建聊天室以及加入聊天室的用户。您可以将此界面视为应用程序聊天功能（由*您自己的后端*进行托管）的管理面板。有些控制面板操作负责创建数据面板对聊天室进行身份验证所需的*聊天令牌*。

  **重要提示：***IVS 聊天功能客户端消息收发 SDK 不调用任何控制面板操作。必须设置后端才能创建聊天令牌。前端应用程序必须与后端通信才能检索此聊天令牌。*