com.pano.rtc.api.RtcMessageService接口 参考

RtcMessageService, 消息服务核心接口。 更多...

类
interface	Callback
	RtcMessageService，在使用RtcMessageService之前必须要设置回调以获取事件通知。 更多...

Public 成员函数
QResult	setCallback (Callback callback)
	设置消息服务的回调。 更多...
QResult	setProperty (String name, byte[] value)
	设置或更属性 更多...
QResult	sendMessage (long userId, byte[] data)
	发送消息给指定用户。 更多...
QResult	broadcastMessage (byte[] data, boolean sendBack)
	广播消息。 更多...
QResult	publish (String topic, byte[] data, int requestId)
	发布一个主题。 更多...
QResult	subscribe (String topic)
	订阅一个主题。 更多...
QResult	unsubscribe (String topic)
	取消订阅一个主题。 更多...

详细描述

RtcMessageService, 消息服务核心接口。

成员函数说明

broadcastMessage()

QResult com.pano.rtc.api.RtcMessageService.broadcastMessage	(	byte[]	data,
		boolean	sendBack
	)

广播消息。

参数

data	二进制形式的消息数据。
sendBack	是否回发消息。

返回

• OK: 成功
• 其他: 失败

注解

发送消息的调用频率上限为每 3 秒 150 次。 请确保二进制消息大小不超过 4 KB。

publish()

QResult com.pano.rtc.api.RtcMessageService.publish	(	String	topic,
		byte[]	data,
		int	requestId
	)

发布一个主题。

参数

topic	主题标识。
data	主题数据。
requestId	请求标识。发布消息失败通过 onPublishTopicMessageFailed 返回。

返回

• OK: 成功
• 其他: 失败

注解

发送消息的调用频率上限为每 3 秒 150 次。 请确保二进制消息大小不超过 4 KB。

sendMessage()

QResult com.pano.rtc.api.RtcMessageService.sendMessage	(	long	userId,
		byte[]	data
	)

发送消息给指定用户。

参数

userId	用户标识。
data	二进制形式的消息数据。

返回

• OK: 成功。
• 其他: 失败。

注解

发送消息的调用频率上限为每 3 秒 150 次。 请确保二进制消息大小不超过 4 KB。

setCallback()

QResult com.pano.rtc.api.RtcMessageService.setCallback

(

Callback

callback

)

设置消息服务的回调。

参数

callback

回调。

返回

• OK: 成功。
• 其他: 失败。

setProperty()

QResult com.pano.rtc.api.RtcMessageService.setProperty	(	String	name,
		byte[]	value
	)

设置或更属性

参数

name	属性名字。
value	属性值。如果 value 为空，或者 length 为0，则此属性会被删除

返回

• OK: 调用成功
• others: 调用失败

subscribe()

QResult com.pano.rtc.api.RtcMessageService.subscribe

(

String

topic

)

订阅一个主题。

参数

topic

主题标识。

返回

• OK: 成功
• 其他: 失败

unsubscribe()

QResult com.pano.rtc.api.RtcMessageService.unsubscribe

(

String

topic

)

取消订阅一个主题。

参数

topic

主题标识。

返回

• OK: 成功
• 其他: 失败

---

该接口的文档由以下文件生成:

• RtcMessageService.java