补充说明
补充说明
聊天消息转发规则说明
关联逻辑: sendMessage
, TK.EVENT_TYPE.roomTextMessage
- 聊天消息1秒内的数据如果超过100条,则丢弃100条之后的聊天消息(老师和助教不丢弃,可以收到完整的聊天消息),例如:1秒内收到150条数据,除了老师和助教外,其它人只收到前100条数据,下1s收到90条数据,则所有人都能收到这90条数据。
大房间(大规模房间)模式说明
关联逻辑:TK.EVENT_TYPE.roomModeChanged
, getUser
, getUsers
, getRoomUsers
, getRoomUserNum
-
大房间模式启用条件:
- 人数超过100人【注:人数一旦超过100人,则切换为大房间模式,一旦启动大房间模式则不再更改房间模式,即:人数小于100人也不会切换回常规模式】
- 房间类型为 直播房间、大直播房间、云直播房间,则初始就是大房间模式
-
大房间模式下不通知用户加入/离开的消息(即
TK.EVENT_TYPE.roomParticipantJoin
和TK.EVENT_TYPE.roomParticipantLeave
不再派发),因此大房间模式下,所有人的用户列表是不完整的,所以getUsers
和getUser
接口的调用需要根据实际需求调用,建议大房间模式下使用getRoomUsers
和getRoomUserNum
来获取指定用户和人数。【注:在台上的人一定存在用户列表中,因此可以使用getUser
接口取到台上的用户】 -
大房间模式下,如果
changeUserProperty
的toId为TK.MSG_TO_ALLUSER
或者TK.MSG_TO_ALLEXCEPTSENDER
,那么没有上台的用户的用户属性改变只转发给调用者(即调用changeUserProperty
者)、被操作者(即被改变属性的用户),如果是上台的用户(即发布音频/视频的用户)的用户属性被改变则根据toId转发给指定用户。 -
大房间模式,不建议除了老师和助教外的人发送toId为
TK.MSG_TO_ALLUSER
(或者TK.MSG_TO_ALLEXCEPTSENDER
)的信令,如答题业务:老师发起答题后,学生进行答题,则学生提交的答题不建议发给所有人,建议只发给老师(助教)TK.MSG_TO_ALLSUPERUSERS
。 -
大房间模式,不建议改变台下用户的用户属性,建议只改变台上用户的用户属性
多视频模式说明
关联逻辑: publishVideo
, unpublishVideo
, playVideo
, unplayVideo
, getVideoProfile
, setVideoProfile
, setLocalVideoMirror
-
多视频模式启用条件:
init
方法配置了tk_multistream
配置项为true -
多视频模式功能:能够发布/播放多个摄像头的视频
-
多视频模式和单视频模式的区别:
- 多视频模式可以发布/播放多个摄像头视频
setDevices
设置的videoinput
在多视频模式下为设置主摄像头,设置主摄像头就是将音频关联到主摄像头上,摄像头在多视频模式下不存在切换问题,因此该接口切换的videoinput
是切换主摄像头(即:切换音频关联的摄像头)