跳到主要内容

与 IM 业务集成

您可以将 CallPlus 集成到基于 IMLib SDK 的应用程序中，为用户提供使用通话和聊天服务的无缝体验。

在会话页面插入通话结束消息​

应用程序可以在通话结束时返回聊天视图，并在会话页面中展示通话结束的消息。

为便于与 IMLib SDK 集成，从 2.1.1 版本开始，CallPlus SDK 可在通话结束时返回一个 IM 消息对象 IRCCallPlusReceivedSummaryMessage，其中包含消息内容对象 RCCallPlusSummaryMessageContent。应用程序可以通过调用 IMLib SDK 的接口直接将该消息内容对象插入到会话中。

获取通话结束消息​

注意

CallPlus SDK 暂仅支持在一对一通话（通话类型为 RCCallPlusType.SINGLE）结束时返回用于展示通话记录的消息内容。暂不支持多人通话。

通话正常、异常结束，或在未接听时挂断，CallPlus SDK 会触发 ICallPlusEventListener 的 onReceivedCallPlusSummaryMessage 回调方法，可在该回调方法中获取到通话结束的消息内容对象。

如果被叫时用户不在线，CallPlus SDK 会在下次成功连接 IM 后立即获取离线时产生的 RCCallPlusSummaryMessageContent。为了确保 CallPlus SDK 可在 IM 连接成功后立即获取到这些消息，请在 IM 连接之前调用 setCallPlusEventListener 注册监听器。

typescript
// callPlus 业务层监听事件增加 onReceivedCallPlusSummaryMessage
callPlusClient.setCallPlusEventListener({
  /**
   * 收到通话结束的消息记录，可用于在 IM 聊天界面插入通话结束消息
   * 仅单聊可收到
   * 触发时机：
   * 1. 单聊在线通话结束后
   * 2. 离线时收到单聊呼叫，通话结束后，重新连接 IM 在线时
   * @param message 通话记录的消息体
   * @param message.messageType 通话结束消息类型，为 RC:CallPlusMiss
   * @param message.senderUserId 为通话发起者
   * @param message.targetId 为单聊中对方的 userId
   * @param message.messageDirection 如果本端是呼叫发起者，消息方向则为发送，反之为接收
   * @param message.content IRCCallPlusSummaryMessageContent，内部包含通话的 callId、通话发起者、通话对方 userId、通话媒体类型、通话开始时间、通话结束时间、通话挂断原因
   * @since 2.1.1
   */
  onReceivedCallPlusSummaryMessage(message: IRCCallPlusReceivedSummaryMessage) {
    console.log(message);
  }
});

在 Electron IMLib V5 中插入通话结束消息​

收到通话结束消息时，您可以将 RCCallPlusSummaryMessageContent 通过 insertMessage 方法插入到本地会话中，并自行刷新 UI。

在 ICallPlusEventListener 的 onReceivedCallPlusSummaryMessage 回调方法中获取 IRCCallPlusReceivedSummaryMessage 对象中包含的 RCCallPlusSummaryMessageContent，在本地会话页面中插入一条通话结束消息。插入消息示例代码：

typescript
onReceivedCallPlusSummaryMessage(message: IRCCallPlusReceivedSummaryMessage) {
  const { conversationType, targetId } = message;

  const conversation = {
    conversationType,
    targetId,
  };

  RongIMLib.electronExtension.insertMessage(conversation, message).then(res => {
    if (res.code === RongIMLib.ErrorCode.SUCCESS) {
      // 消息插入成功，返回 IAReceivedMessage 类型的消息数据
      console.log('消息插入成功', res.data)
    } else {
      console.log('消息插入失败', res.code, res.msg)
    }
  });
}
最后于 更新