测试设备

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

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

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

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

检查设备的 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('+12223334444', 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("+12223334444");
} 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('+12223334444')
此代码摘自 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("+12223334444");
此代码摘自 RBM 示例代理

后续步骤

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

移除测试设备

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

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