测试设备

直到您 启动您的 它只能与指定的测试设备通信。这样，您就可以 在内部测试代理，同时防止意外抢先体验 最终用户。

如要与 RBM 代理通信，测试设备需要启用 RCS。注意事项 某些 Android 设备默认没有启用 RCS。您可以 请检查设备的 RCS 状态，并在必要时启用 RCS：为您的设备配置 “信息”和“Carrier Services”应用。

设备启用 RCS 后，您可以发送测试人员 请求来邀请设备测试代理。部署 设备接受请求后，就可以接收并回复来自 未启动的代理。

一个代理每天可以发送 20 个测试人员请求，最多总共 200 个 测试。如果您通过 RBM API 添加测试人员，并在发送更多 超过 200 个请求，RBM 平台会返回 429 RESOURCE_EXHAUSTED 响应。

注意 ：启动代理后，代理可以与任何已启用 RCS 的通信 而不仅仅是测试设备。

检查设备的 RCS 状态

1. 在“信息”应用中，前往“信息”设置。
2. 点按 RCS 消息功能。如果您找不到“RCS 消息”，请点按聊天功能。

3. 找到状态值。

   如果状态为已连接，则表示您设备上的 RCS 处于启用状态。

后续步骤

如果您的设备已启用 RCS，您就可以发送测试人员 请求。如果设备上的 RCS 处于停用状态，您需要执行以下操作： 请先在设备上启用 RCS，然后才能开始测试 RBM 代理。

在设备上启用 RCS

如需在 Android 设备上启用 RCS，请在“信息”应用中开启 RCS 消息功能。

后续步骤

在设备上启用 RCS 后，您就可以发送测试人员 请求。

发送测试人员请求

如要邀请支持 RCS 的设备成为测试人员，您需要发送测试人员请求。 如果设备接受该请求，您的代理就可以发送消息、事件和 向设备发出请求

如果设备未启用 RCS，尚未回复测试人员的请求，或者 拒绝请求，您的代理会收到 403 PERMISSION_DENIED 错误。

选项 1：通过 Business Communications 开发者控制台发送测试人员请求

1. 打开 Business Communications Developer（商业通信开发者） 控制台 使用您的 RBM Google 账号登录，然后点击您的代理。
2. 在左侧导航栏中，点击设备。
3. 在添加测试设备部分，输入设备的电话号码，然后点击添加。

测试设备列表详细说明了您所提交的每台设备的测试人员请求状态 邀请以测试代理。

方法 2：使用 RBM API 发送测试人员请求

以下代码会发送测试人员请求。如需了解格式设置和值选项，请参阅 phones.testers。

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('[phone]', function(response) {
   console.log(response);
});

此代码摘自 RBM 示例代理。

Java

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Register the device as a tester
   rbmApiHelper.registerTester("[phone]");
} catch(Exception e) {
   e.printStackTrace();
}

此代码摘自 RBM 示例代理。

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
rbm_service.invite_tester('[phone]')

此代码摘自 RBM 示例代理。

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
rbmApiHelper.RegisterTester("[phone]");

此代码摘自 RBM 示例代理。

后续步骤

设备接受测试人员请求后，就会被指定为用于测试 您的代理。您可以发送 messages、 事件，以及 功能检查 测试代理的功能和工作流。

移除测试设备

移除测试设备后，该设备将无法再接收来自以下服务的消息： 未发布的代理RBM 平台不会删除由您的 传送给测试设备或存储在测试设备上的代理。

1. 打开 Business Communications Developer（商业通信开发者） 控制台 使用您的 RBM Google 账号登录，然后点击您的代理。
2. 在左侧导航栏中，点击设备。
3. 在 Test device list 中找到相应设备，然后点击 菜单。
4. 点击移除设备。