You need to enable JavaScript to run this app.
导航
实时音视频
  • 文档首页
    • /实时音视频/实时信令/实时信令开发指南/客户端与业务服务器通信
客户端与业务服务器通信
最近更新时间：2025.10.16 10:06:06首次发布时间：2022.09.16 15:44:38
复制全文
我的收藏
有用
有用
无用
无用

你可以在客户端和业务服务器发送、接收文本信息或二进制消息。通过调用接口，主动发送消息。消息发送成功后，目标客户端会接收到包含消息的回调，服务端会接收到来自 RTC 服务器的 HTTP/HTTPS POST 请求。

前提条件

  1. 已开通实时音视频服务。
  2. 已集成 RTC SDK 或 RTS SDK。

    注意

    建议不要混用 RTC SDK 和 RTS SDK。

  3. 已通过 login 接口成功登录 RTS 服务。

参考 跑通 RTS 快速开始 Demo 实现前置步骤。

客户端向业务服务器发送消息

客户端可以向业务服务器发送文本或二进制消息。可用于客户端向业务服务器同步状态、上报数据等场景。

  1. 通过 setServerParams 设置业务服务器参数，包括业务服务器地址和签名。其中，签名将用于构建 HTTP/HTTPS POST 请求，该请求包含了消息内容。RTC 不会校验签名内容，因此，签名应按照业务服务器的要求生成。
  2. 通过 sendServerMessage 或 sendServerBinaryMessage 发送文本消息或二进制消息。

RTC SDK 向业务服务器发送消息

客户端接口AndroidiOSmacOSWindowsLinuxWebElectronFlutter
设置业务服务器参数setServerParamssetServerParams:url:setServerParams:url:setServerParamssetServerParams:url:setServerParamssetServerParamssetServerParams
客户端给业务服务器发送文本消息（P2Server）sendServerMessagesendServerMessage:sendServerMessage:sendServerMessagesendServerMessagesendServerMessagesendServerMessagesendServerMessage
客户端给业务服务器发送二进制消息（P2Server）sendServerBinaryMessagesendServerBinaryMessage:sendServerBinaryMessage:sendServerBinaryMessagesendServerBinaryMessagesendServerBinaryMessagesendServerBinaryMessagesendServerBinaryMessage

RTS SDK 向业务服务器发送消息

客户端接口AndroidiOSWeb
设置业务服务器参数setServerParamssetServerParams:url:setServerParams
客户端给业务服务器发送文本消息（P2Server）sendServerMessagesendServerMessage:sendServerMessage
客户端给业务服务器发送二进制消息（P2Server）sendServerBinaryMessagesendServerBinaryMessage:sendServerBinaryMessage

服务端接收消息

客户端通过上述接口成功发送消息后，业务服务器将通过来自 RTC 服务器的 HTTP/HTTPS POST 请求收到消息，示例如下：

注意：RTC 服务器向业务服务器发送的 POST 请求，其请求头中不携带 content-type: application/json，业务服务器在接收回调时需要注意适配处理。

{"message":"xxxx","binary":false,"signature":"00160af4c8dcb758d00ce35adb3EQD24BQDeruMYfoMjmEDAGh5ZiAARgps6T5ZgcTz9bw5DewuRkzxBmTgnGEk+ZBv3mW5n58="}

以上示例所含字段解释如下：

字段名含义类型合法性
message消息内容string/
binary是否二进制bool非空
signature签名是在客户端调用 setServerParams 时设置的。你可以使用发送用户的用户 ID、 AppID 等信息生成签名，用于业务服务器校验。string非空

业务服务器向客户端发送消息

业务服务器可以向已登录或已进房的用户发送消息。可用于业务服务器向客户端同步状态、广播公告等场景。

业务服务器向客户端发送房间内点对点消息

业务服务器可以通过 SendRoomUnicast 或 BatchSendRoomUnicast 接口向 RTC 房间内指定用户发送文本或二进制消息，已进房的 RTC 用户可以通过以下回调接收消息。

注意

RTS SDK 不支持接收服务端发送的房间内点对点消息。

客户端回调AndroidiOSmacOSWindowsLinuxWebElectronFlutterUnity
接收到业务服务器发送的房间内点对点文本消息内容onUserMessageReceivedrtcRoom:onUserMessageReceived:message:rtcRoom:onUserMessageReceived:message:onUserMessageReceivedonUserMessageReceivedonUserMessageReceivedonUserMessageReceivedonUserMessageReceivedOnUserMessageReceivedEventHandler
接收到业务服务器发送的房间内点对点二进制消息内容onUserBinaryMessageReceivedrtcRoom:onUserBinaryMessageReceived:message:rtcRoom:onUserBinaryMessageReceived:message:onUserBinaryMessageReceivedonUserBinaryMessageReceivedonUserBinaryMessageReceivedonUserBinaryMessageReceivedonUserBinaryMessageReceived无

业务服务器向客户端发送房间外点对点消息

业务服务器可以通过 SendUnicast 接口向房间外指定用户发送文本或二进制消息，已登录用户可以通过以下回调接收消息。

RTC SDK 收到房间外点对点消息

客户端回调AndroidiOSmacOSWindowsLinuxWebElectronFlutter
接收到业务服务器发送的房间外点对点文本消息内容onUserMessageReceivedOutsideRoomrtcEngine:onUserMessageReceivedOutsideRoom:message:rtcEngine:onUserMessageReceivedOutsideRoom:message:onUserMessageReceivedOutsideRoomonUserMessageReceivedOutsideRoomonUserMessageReceivedOutsideRoomonUserMessageReceivedOutsideRoomonUserMessageReceivedOutsideRoom
接收到业务服务器发送的房间外点对点二进制消息内容onUserBinaryMessageReceivedOutsideRoomrtcEngine:onUserBinaryMessageReceivedOutsideRoom:message:rtcEngine:onUserBinaryMessageReceivedOutsideRoom:message:onUserBinaryMessageReceivedOutsideRoomonUserBinaryMessageReceivedOutsideRoomonUserBinaryMessageReceivedOutsideRoomonUserBinaryMessageReceivedOutsideRoomonUserBinaryMessageReceivedOutsideRoom

RTS SDK 收到点对点消息

客户端回调AndroidiOSWeb
接收到业务服务器发送的点对点文本消息内容onMessageReceivedrtsEngine:onMessageReceived:message:onMessageReceived
接收到业务服务器发送的点对点二进制消息内容onBinaryMessageReceivedrtsEngine:onBinaryMessageReceived:message:onBinaryMessageReceived

服务端房间内广播消息

业务服务器可以通过 SendBroadcast 接口向客户端发送房间内文本或二进制广播消息，已进房用户可以通过以下回调接收消息。

说明

用户通过 joinRoom 进入房间之后，才能收到房间内广播消息。

RTC SDK 收到房间内广播消息

客户端回调AndroidiOSmacOSWindowsLinuxWebElectronFlutterUnity
接收到业务服务器发送的房间内文本广播消息内容onRoomMessageReceivedrtcRoom:onRoomMessageReceived:message:rtcRoom:onRoomMessageReceived:message:onRoomMessageReceivedonRoomMessageReceivedonRoomMessageReceivedonRoomMessageReceivedonRoomMessageReceivedOnRoomMessageReceivedEventHandler
接收到业务服务器发送的房间内二进制广播消息内容onRoomBinaryMessageReceivedrtcRoom:onRoomBinaryMessageReceived:message:rtcRoom:onRoomBinaryMessageReceived:message:onRoomBinaryMessageReceivedonRoomBinaryMessageReceivedonRoomBinaryMessageReceivedonRoomBinaryMessageReceivedonRoomBinaryMessageReceived无

RTS SDK 收到房间内广播消息

客户端回调AndroidiOSWeb
接收到业务服务器发送的房间内文本广播消息内容onRoomMessageReceivedrtsRoom:onRoomMessageReceived:message:onMessageReceived
接收到业务服务器发送的房间内二进制广播消息内容onRoomBinaryMessageReceivedrtsRoom:onRoomBinaryMessageReceived:message:onBinaryMessageReceived