实现自定义消息发送和接收功能_视频直播(LIVE)-阿里云帮助中心

ARTC SDK提供自定义消息的发送和接收能力，实现在传输音视频数据的同时再发送自定义的实时消息数据。本文介绍自定义消息发送和接收的实现原理和示例代码。

实现原理

主播角色可以发送和接收消息，观众角色仅支持接收消息。

示例代码

开启自定义消息通道

说明

默认不开启，必须通过如下接口开启自定义消息通道。
该接口在创建引擎后，入会前和入会后都可以调用。

Android示例代码：

param = "{\"data\":{\"enablePubDataChannel\":true" + ",\"enableSubDataChannel\":true}}";
mAliRtcEngine.setParameter(param);

iOS示例代码：

NSString* parameter = [NSString stringWithFormat:@"{\"data\":{\"enablePubDataChannel\":true,\"enableSubDataChannel\":true}}"];
[self.engine setParameter:parameter];

Windows示例代码

char * param = "{\"data\":{\"enablePubDataChannel\":true,\"enableSubDataChannel\":true}}";
mAliRtcEngine->SetParameter(param);

发送自定义消息

Android示例代码：

AliRtcEngine.AliRtcDataChannelMsg msg = new AliRtcEngine.AliRtcDataChannelMsg();
msg.type = AliRtcEngine.AliRtcDataMsgType.AliEngineDataMsgCustom;
/* data可以是任意数据(文字、图片等) */
msg.data =  xxxx;
mAliRtcEngine.sendDataChannelMsg(msg);

iOS示例代码：

AliRtcDataChannelMsg* msg = [[AliRtcDataChannelMsg alloc] init];
msg.type = AliRtcDataMsgCustom;
/* data可以是任意数据(文字、图片等) */
msg.data = xxxxx;
[self.engine sendDataChannelMessage:msg];

Windows示例代码：

AliEngineDataChannelMsg msg;
msg.type = AliEngineDataChannelCustom;
/* data可以是任意数据(文字、图片等) */
msg.data =  data;
msg.dataLen = dataLength;
mAliRtcEngine->SendDataChannelMessage(msg);

接收自定义消息

通过监听回调接收自定义的消息。

Android示例代码：

public void onDataChannelMsg(String uid, AliRtcEngine.AliRtcDataChannelMsg msg) {
    /* TODO:编写自定义消息的处理 */
}

iOS示例代码：

- (void)onDataChannelMessage:(NSString *_Nonnull)uid controlMsg:(AliRtcDataChannelMsg*_Nonnull)controlMsg {
	/* TODO:编写自定义消息的处理 */
}

Windows示例代码：

public:
virtual void OnDataChannelMessage(const char* uid, const AliEngineDataChannelMsg& msg) override {
    /* TODO:编写自定义消息的处理 */
}