Merge pull request #97 from haoxiuwen/doc-shengwang

haoxiuwen · web-flow · commit b093089b14e6 · 2025-02-19T13:50:14.000+08:00
Modify Error 208 for SDKs
diff --git a/docs/docs/sdk/android/error.md b/docs/docs/sdk/android/error.md
@@ -33,7 +33,7 @@ Android 中错误码的类为 `Error`。
 | 205    |      USER_ILLEGAL_ARGUMENT      | 用户参数不正确：例如，创建用户或更新用户属性时，用户 ID 为空或无效。 |
 | 206    |    USER_LOGIN_ANOTHER_DEVICE    | 用户在其他设备登录：如果未开启多设备登录，则在其他设备登录会将当前登录设备踢下线，用户会在当前设备收到该错误。 |
 | 207    |          USER_REMOVED           | 用户已被注销：当前的登录用户 ID 从[声网控制台](https://console.shengwang.cn/overview)删除会收到该错误。 |
-| 208    |         USER_REG_FAILED         | 用户注册失败：例如，注册用户之前未开启开放注册功能等原因。 |
+| 208    |         USER_REG_FAILED         | 用户注册失败，你需要在[声网控制台注册用户](login.html#用户注册)或[调用 RESTful API 注册](/server-side/account_system.html#注册用户)。 |
 | 209    |    USER_UPDATEINFO_FAILED       | 更新推送配置错误：例如，用户更新推送昵称或设置免打扰配置时失败。  |
 | 210    |     USER_PERMISSION_DENIED      | 用户无权限：例如，如果用户被添加到黑名单后，发送消息时会提示该错误。其他报错情况包括用户修改其他用户发出的消息、修改其他用户设置的群成员属性以及普通群成员试图解散子区（仅子区所在群组的群主和群管理员有权解散子区）。|
 | 211    |   USER_BINDDEVICETOKEN_FAILED   | 绑定设备 token 失败。  |
diff --git a/docs/docs/sdk/android/login.md b/docs/docs/sdk/android/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 主动登录
 
 1. **用户 ID + token** 是更加安全的登录方式。
diff --git a/docs/docs/sdk/android/product_group_overview.md b/docs/docs/sdk/android/product_group_overview.md
@@ -93,7 +93,7 @@
 | 变更群主               | 群主可以将群组的所有权转让给指定的组成员。所有权转移后，群主成为普通群成员。 |
 | 添加/移除/获取群管理员 | 群主可以添加成员到群组管理员列表，将管理员移出该列表。所有群成员均可获取群组下的管理员列表。 |
 | 群组白名单             | 群主和管理员可以将群成员加入或移出白名单。白名单中的群成员可以在全员禁言状态下发送群消息。仅群主和群管理员可以获取群组白名单列表。 |
-| 群组黑名单             | 群主和群管理员可以将群成员加入或移出黑名单，黑名单中的成员将被移出群且无法再次加入群。仅群主和群管理员可以获取群组白名单列表。 |
+| 群组黑名单             | 群主和群管理员可以将群成员加入或移出黑名单，黑名单中的成员将被移出群且无法再次加入群。仅群主和群管理员可以获取群组黑名单列表。 |
 | 群组禁言               | - 群主和管理员可以将群成员加入或移出禁言列表，禁言列表中的成员无法发送群消息，但可以接收群消息。<br/> - 仅群主和群管理员可以获取群组禁言列表。<br/> - 群主和管理员可以开启或关闭全员禁言。开启全员禁言后，仅群组、管理员和白名单中的成员可以发送群消息。|
 | 管理群成员的自定义属性 | 支持设置群成员自定义属性和获取单个群成员的自定义属性。群主可修改所有群成员的自定义属性，其他群成员只能修改自己的自定义属性。 |
 
diff --git a/docs/docs/sdk/android/quickstart.md b/docs/docs/sdk/android/quickstart.md
@@ -192,6 +192,8 @@ ChatClient.getInstance().init(context, options);
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ### 3. 登录账号
 
 使用如下代码实现用户登录：
diff --git a/docs/docs/sdk/applet/login.md b/docs/docs/sdk/applet/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 登录方式
 
 1. **用户 ID + token** 是更加安全的登录方式。
diff --git a/docs/docs/sdk/flutter/login.md b/docs/docs/sdk/flutter/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 主动登录
 
 1. **用户 ID + token** 是更加安全的登录方式。使用 token 登录时需要处理 token 过期的问题，比如在每次登录时更新 token 等机制。
diff --git a/docs/docs/sdk/flutter/quickstart.md b/docs/docs/sdk/flutter/quickstart.md
@@ -269,6 +269,8 @@ void _initSDK() async {
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ### 添加登录
 
 在 `_signIn` 方法中添加登录代码。
diff --git a/docs/docs/sdk/harmonyos/error.md b/docs/docs/sdk/harmonyos/error.md
@@ -32,7 +32,7 @@ HarmonyOS 中错误码的类为 `ChatError`。
 | 205    |      USER_ILLEGAL_ARGUMENT      | 用户参数不正确：例如，创建用户或更新用户属性时，用户 ID 为空或无效。 |
 | 206    |    USER_LOGIN_ANOTHER_DEVICE    | 用户在其他设备登录：如果未开启多设备登录，则在其他设备登录会将当前登录设备踢下线，用户会在当前设备收到该错误。 |
 | 207    |          USER_REMOVED           | 用户已被注销：当前的登录用户 ID 从[声网控制台](https://console.shengwang.cn/overview)删除会收到该错误。 |
-| 208    |         USER_REG_FAILED         | 用户注册失败：例如，注册用户之前未开启开放注册功能等原因。 |
+| 208    |         USER_REG_FAILED         | 用户注册失败，你需要在[声网控制台注册用户](login.html#用户注册)或[调用 RESTful API 注册](/server-side/account_system.html#注册用户)。 |
 | 209    |    USER_UPDATEINFO_FAILED       | 更新推送配置错误：例如，用户更新推送昵称或设置免打扰配置时失败。  |
 | 210    |     USER_PERMISSION_DENIED      | 用户无权限：例如，如果用户被添加到黑名单后，发送消息时会提示该错误。其他报错情况包括用户修改其他用户发出的消息、修改其他用户设置的群成员属性以及普通群成员试图解散子区（仅子区所在群组的群主和群管理员有权解散子区）。|
 | 213    |    USER_BIND_ANOTHER_DEVICE     | 用户已在其他设备登录：在单设备登录场景中，默认情况下，后登录的设备会踢掉当前设备的登录。若设置为先登录的设备优先，则后登录设备登录失败并提示该错误。 |
diff --git a/docs/docs/sdk/harmonyos/login.md b/docs/docs/sdk/harmonyos/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 主动登录
 
 **用户 ID + token** 是更加安全的登录方式。
diff --git a/docs/docs/sdk/harmonyos/quickstart.md b/docs/docs/sdk/harmonyos/quickstart.md
@@ -143,6 +143,8 @@ ChatClient.getInstance().init(context, options);
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ### 3. 登录账号
 
 使用如下代码实现用户登录：
diff --git a/docs/docs/sdk/ios/error.md b/docs/docs/sdk/ios/error.md
@@ -35,7 +35,7 @@ iOS 的错误码只有当操作出错的时候才会有返回值，否则返回
 | 205    |     AgoraChatErrorUserIllegalArgument      | 用户参数不正确：例如，创建用户或更新用户属性时，用户 ID 为空或无效。 |
 | 206    |   AgoraChatErrorUserLoginOnAnotherDevice   | 用户在其他设备登录：如果未开启多设备登录，则在其他设备登录会将当前登录设备踢下线，用户会在当前设备收到该错误。 |
 | 207    |         AgoraChatErrorUserRemoved          | 用户已被注销：当前的登录用户 ID 从[声网控制台](https://console.shengwang.cn/overview)删除会收到该错误。|
-| 208    |      AgoraChatErrorUserRegisterFailed      | 用户注册失败：例如，注册用户之前未开启开放注册功能等原因。 |
+| 208    |      AgoraChatErrorUserRegisterFailed      | 用户注册失败，你需要在[声网控制台注册用户](login.html#用户注册)或[调用 RESTful API 注册](/server-side/account_system.html#注册用户)。 |
 | 209    |   AgoraChatErrorUpdateApnsConfigsFailed    | 更新推送配置错误：例如，用户更新推送昵称或设置免打扰配置时失败。 |
 | 210    |     AgoraChatErrorUserPermissionDenied     | 用户无权限：例如，如果用户被添加到黑名单后，发送消息时会提示该错误。其他报错情况包括用户修改其他用户发出的消息、修改其他用户设置的群成员属性以及普通群成员试图解散子区（仅子区所在群组的群主和群管理员有权解散子区）。 |
 | 211    |  AgoraChatErrorUserBindDeviceTokenFailed   | 绑定设备 token 失败。                    |
diff --git a/docs/docs/sdk/ios/login.md b/docs/docs/sdk/ios/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 主动登录
 
 1. **用户 ID + token** 是更加安全的登录方式。
diff --git a/docs/docs/sdk/ios/quickstart.md b/docs/docs/sdk/ios/quickstart.md
@@ -94,6 +94,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 5. 登录账号
 
 利用创建的用户 ID 和密码登录即时通讯 IM。
diff --git a/docs/docs/sdk/react-native/login.md b/docs/docs/sdk/react-native/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 主动登录
 
 通过用户 ID 和 token 进行登录。使用 token 登录时需要处理 token 过期的问题，比如在每次登录时更新 token 等机制。
diff --git a/docs/docs/sdk/react-native/quickstart.md b/docs/docs/sdk/react-native/quickstart.md
@@ -94,6 +94,8 @@ cd ios && pod install && cd ..
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 实现发送和接收单聊消息
 
 建议使用 `visual studio code` 打开文件夹 `quick_start_demo`，打开文件 `App.js`，删除全部内容，并添加如下内容:
diff --git a/docs/docs/sdk/unity/error.md b/docs/docs/sdk/unity/error.md
@@ -54,7 +54,7 @@ SDKClient.Instance.Login(username, passwd,
 | 205    | USER_ILLEGAL_ARGUMENT                 | 用户参数不正确：比如创建用户 ID 时不符合格式要求， 或者更新用户属性时用户参数为空等。 |
 | 206    | USER_LOGIN_ANOTHER_DEVICE             | 用户在其他设备登录：如果未开启多设备登录，则在其他设备登录会将当前登录设备踢下线，用户会在当前设备收到该错误。 |
 | 207    | USER_REMOVED                          | 用户已被注销：当前的登录用户 ID 从[声网控制台](https://console.shengwang.cn/overview)删除会收到该错误。 |
-| 208    | USER_REG_FAILED                       | 用户注册失败：例如，注册用户之前未开启开放注册功能等原因。|
+| 208    | USER_REG_FAILED                       | 用户注册失败，你需要在[声网控制台注册用户](login.html#用户注册)或[调用 RESTful API 注册](/server-side/account_system.html#注册用户)。|
 | 210    | USER_PERMISSION_DENIED                | 用户无权限：例如，如果用户被添加到黑名单后，发送消息时会提示该错误。其他报错情况包括用户修改其他用户发出的消息、修改其他用户设置的群成员属性以及普通群成员试图解散子区（仅子区所在群组的群主和群管理员有权解散子区）。|
 | 213    |    USER_BIND_ANOTHER_DEVICE     | 用户已在其他设备登录：在单设备登录场景中，默认情况下，后登录的设备会踢掉当前设备的登录。若设置为先登录的设备优先，则后登录设备登录失败并提示该错误。 |
 | 214    | USER_LOGIN_TOO_MANY_DEVICES           | 用户登录设备数超过限制：该错误在多设备自动登录场景中且打开不踢掉其他设备上的登录的开关时超过登录设备数量的限制才会出现。例如，用户最多可同时登录 4 台设备， A（开启了自动登录）、B、C 和 D。最初，用户在这四个设备上均为登录状态，但由于网络连接原因登出了设备 A，然后手动登录了设备 E。这种情况下，设备 A 的网络恢复正常时会自动登录，这时登录失败且提示该错误。|
diff --git a/docs/docs/sdk/unity/login.md b/docs/docs/sdk/unity/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 主动登录
 
 1. **用户 ID + token** 是更加安全的登录方式。
diff --git a/docs/docs/sdk/unity/quickstart.md b/docs/docs/sdk/unity/quickstart.md
@@ -130,6 +130,8 @@ SDKClient.Instance.InitWithOptions(options);
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ### 5. 登录账号
 
 在 `SignInAction` 方法尾部添加以下代码，使用账号登录即时通讯系统，示例代码如下：
diff --git a/docs/docs/sdk/web/login.md b/docs/docs/sdk/web/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 登录方式
 
 1. **用户 ID + token** 是更加安全的登录方式。
diff --git a/docs/docs/sdk/web/quickstart.md b/docs/docs/sdk/web/quickstart.md
@@ -86,6 +86,8 @@ quickstart<br>
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ### 4. 实现用户界面
 
 `index.html` 的内容如下。
diff --git a/docs/docs/sdk/windows/error.md b/docs/docs/sdk/windows/error.md
@@ -54,7 +54,7 @@ SDKClient.Instance.Login(username, passwd,
 | 205    | USER_ILLEGAL_ARGUMENT                 | 用户参数不正确：比如创建用户 ID 时不符合格式要求， 或者更新用户属性时用户参数为空等。 |
 | 206    | USER_LOGIN_ANOTHER_DEVICE             | 用户在其他设备登录：如果未开启多设备登录，则在其他设备登录会将当前登录设备踢下线，用户会在当前设备收到该错误。 |
 | 207    | USER_REMOVED                          | 用户已被注销：当前的登录用户 ID 从[声网控制台](https://console.shengwang.cn/overview)删除会收到该错误。 |
-| 208    | USER_REG_FAILED                       | 用户注册失败：例如，注册用户之前未开启开放注册功能等原因。|
+| 208    | USER_REG_FAILED                       | 用户注册失败，你需要在[声网控制台注册用户](login.html#用户注册)或[调用 RESTful API 注册](/server-side/account_system.html#注册用户)。|
 | 210    | USER_PERMISSION_DENIED                | 用户无权限：例如，如果用户被添加到黑名单后，发送消息时会提示该错误。其他报错情况包括用户修改其他用户发出的消息、修改其他用户设置的群成员属性以及普通群成员试图解散子区（仅子区所在群组的群主和群管理员有权解散子区）。|
 | 213    |    USER_BIND_ANOTHER_DEVICE     | 用户已在其他设备登录：在单设备登录场景中，默认情况下，后登录的设备会踢掉当前设备的登录。若设置为先登录的设备优先，则后登录设备登录失败并提示该错误。 |
 | 214    | USER_LOGIN_TOO_MANY_DEVICES           | 用户登录设备数超过限制：该错误在多设备自动登录场景中且打开不踢掉其他设备上的登录的开关时超过登录设备数量的限制才会出现。例如，用户最多可同时登录 4 台设备， A（开启了自动登录）、B、C 和 D。最初，用户在这四个设备上均为登录状态，但由于网络连接原因登出了设备 A，然后手动登录了设备 E。这种情况下，设备 A 的网络恢复正常时会自动登录，这时登录失败且提示该错误。|
diff --git a/docs/docs/sdk/windows/login.md b/docs/docs/sdk/windows/login.md
@@ -34,6 +34,8 @@
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ## 主动登录
 
 1. **用户 ID + token** 是更加安全的登录方式。
diff --git a/docs/docs/sdk/windows/quickstart.md b/docs/docs/sdk/windows/quickstart.md
@@ -110,6 +110,8 @@ SDKClient.Instance.InitWithOptions(options);
 
 ![img](/images/android/user_token.png)
 
+在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 [Token 鉴权文档](/server-side/token_authentication.html#搭建-app-server-生成-token)。
+
 ### 5. 登录账号
 
 在 `SignIn_Click` 函数尾部添加以下代码，用于使用账号登录即时通讯系统，示例代码如下：
