更新时间:2024-10-23 GMT+08:00
分享

辅流管理

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)

功能说明

设置远端辅流视图方向(横竖屏)。

请求参数

返回参数
  • 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

相关文档