测试设备

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

如要与 RBM 代理通信，测试设备需要启用 RCS。请注意，某些 Android 设备默认未启用 RCS。您可以检查设备的 RCS 状态，并根据需要通过为“信息”和“运营商服务”应用的预发布版本配置启用 RCS。

设备启用 RCS 后，您可以发送测试人员请求来邀请设备测试您的代理。设备接受请求后，就可以接收和响应未暂停的代理发来的消息。

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

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

检查设备的 RCS 状态

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

3. 找到 Status 值。

   如果状态为已连接，RCS 将在您的设备上启用。

后续步骤

如果您的设备启用了 RCS，您就可以发送测试人员请求了。如果您设备上的 RCS 处于非活跃状态，您需要先在设备上启用 RCS，然后才能开始使用 RCS 代理对其进行测试。

在您的设备上启用 RCS

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

后续步骤

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

发送测试人员请求

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

如果设备未启用 RCS、未响应测试人员的请求，或拒绝了请求，则代理在尝试与设备通信时会收到 403 PERMISSION_DENIED 错误。

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

1. 打开 Business Communications 开发者控制台，使用您的 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('../libs/rbm_api_helper');

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

此代码摘录自 RBM 示例代理。

Java

import com.google.rbm.samples.lib.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 示例代理。

后续步骤

设备接受测试人员的请求后，该设备即为您的代理的指定测试设备。您可以向设备发送消息、事件和功能检查，以测试代理的功能和工作流。

移除测试设备

移除测试设备后，该设备将无法再接收来自未发布代理的消息。RBM 平台不会删除代理所发送的消息，这些消息将传输给测试设备或存储在测试设备上。

1. 打开 Business Communications 开发者控制台，使用您的 RBM Google 帐号登录，然后点击您的代理。
2. 在左侧导航栏中，点击设备。
3. 在测试设备列表中找到该设备，然后点击该列表项的 菜单。
4. 点击移除设备。