机器人管理

提示

机器人信息托管功能需要升级 SDK 至 5.32.0 及以上版本。

机器人信息同步完成通知

SDK 建立连接后，需要先与服务器进行机器人列表同步，并在同步完成后向业务层派发 Events.ROBOTS_SYNCED 事件。

JavaScript

RongIMLib.addEventListener(Events.ROBOTS_SYNCED, (code) => {
  // 机器人信息同步结果
  if (code === ErrorCode.SUCCESS) {
    console.log('同步完成');
  } else {
    console.log('同步失败');
  }
});

当机器人列表同步失败时，业务层调用 getAllRobots 和 getRobotById 接口时，SDK 仍会主动触发同步，并在结果中返回从服务器获取的机器人数据。因此，业务层无需过度关注同步失败问题。

获取应用下的机器人列表

通过调用 getAllRobots 接口可获取应用下的全部机器人列表。机器人数据结构请参考 IRobotInfo 接口声明。

接口

JavaScript

RongIMLib.getAllRobots()

示例代码

JavaScript

RongIMLib.getAllRobots().then((res) => {
  if (res.isOk) {
    console.log('机器人列表获取成功：', res.data);
  } else {
    console.log('机器人列表获取失败：', res.code);
  }
});

获取指定机器人信息

通过调用 getRobotById 接口获取指定机器人信息。机器人数据结构请参考 IRobotInfo 接口声明。

接口

JavaScript

RongIMLib.getRobotById(robotId)

参数说明

参数	类型	必填	说明
robotId	string	是	机器人 ID

示例代码

JavaScript

const robotId = 'robotId'; // 请替换为实际的机器人 ID
RongIMLib.getRobotById(robotId).then((res) => {
  if (res.isOk) {
    console.log('机器人数据获取成功：', res.data);
  } else {
    console.log('机器人数据获取失败：', res.code);
  }
});