辅流管理
setRemoteAuxiliaryStreamViewRotation
virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation)
【功能说明】
设置远端辅流视图旋转角度。
【请求参数】
- userId:用户ID。
- rotation:旋转角度信息(0°,90°,270°),具体请参见HRTCVideoRotation。
- 0:方法调用成功。
- >0:方法调用失败。具体请参见HRTCErrorCode。
setRemoteAuxiliaryStreamViewOrientation
virtual int setRemoteAuxiliaryStreamViewOrientation(const char *userId, HRTCVideoOrientation orientation)
【功能说明】
设置远端辅流视图方向(横竖屏)。
【请求参数】
- userId:用户ID。
- orientation:方向(横竖屏),具体请参见HRTCVideoOrientation。
- 0:方法调用成功。
- >0:方法调用失败。具体请参见HRTCErrorCode。
startRemoteAuxiliaryStreamView
virtual int startRemoteAuxiliaryStreamView(const char* userId, view_t view)
【功能说明】
当远端开启辅流,本地接收到远端辅流开启onUserAuxiliaryStreamAvailable消息后,设置辅流流窗口视图(发起辅流选看)。
【请求参数】
- userId:远端用户的唯一标识。
- view :窗口句柄。
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
- 收到onUserAuxiliaryStreamAvailable消息后,获取对应的userId。
- 多辅流场景,一个用户同时只能订阅一条辅流;当前正在订阅用户A的辅流,需要订阅另一个用户B的辅流时,需要先停止订阅用户A的辅流,再订阅用户B的辅流。
stopRemoteAuxiliaryStreamView
virtual int stopRemoteAuxiliaryStreamView(const char* userId)
【功能说明】
关闭屏幕辅流窗口视图(停止辅流选看)。
【请求参数】
userId:远端用户的唯一标识。对应onUserAuxiliaryStreamAvailable返回的共享用户标识。
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
收到onUserAuxiliaryStreamAvailable消息后,如果选看的远端辅流不可用,则必须调用stopRemoteAuxiliaryStreamView关闭。
updateRemoteAuxiliaryStreamRenderMode
virtual int updateRemoteAuxiliaryStreamRenderMode(const char* userId, HRTCVideoDisplayMode displayMode, HRTCVideoMirrorType mirrorMode)
【功能说明】
设置辅流视图渲染模式。
【请求参数】
- userId:远端用户的唯一标识。
- displayMode:视图显示模式 。具体请参见HRTCVideoDisplayMode,默认RTC_VIDEO_DISPLAY_FIT,通过扩边的方式保持宽高比。
- mirrorMode:镜像模式。具体请参见HRTCVideoMirrorType。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。