辅流管理

setRemoteAuxiliaryStreamViewRotation

virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation)

【功能说明】

设置远端辅流视图旋转角度。

【请求参数】

• userId：用户ID。
• rotation：旋转角度信息（0°，90°，270°），具体请参见HRTCVideoRotation。默认为0°。

setRemoteAuxiliaryStreamViewOrientation

virtual int setRemoteAuxiliaryStreamViewOrientation(const char *userId, HRTCVideoOrientation orientation)

【功能说明】

设置远端辅流视图方向（横竖屏）。

【请求参数】

• userId：用户ID。
• orientation：方向（横竖屏），具体请参见HRTCVideoOrientation。

startRemoteAuxiliaryStreamView

virtual int startRemoteAuxiliaryStreamView(const char* userId, view_t view)

【功能说明】

当远端开启辅流，本地接收到远端辅流开启onUserAuxiliaryStreamAvailable消息后，设置辅流流窗口视图（发起辅流选看）。

【请求参数】

• userId：远端用户的唯一标识。
• view ：窗口句柄。

• 收到onUserAuxiliaryStreamAvailable消息后，获取对应的userId。
• 多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。

stopRemoteAuxiliaryStreamView

virtual int stopRemoteAuxiliaryStreamView(const char* userId)

【功能说明】

关闭屏幕辅流窗口视图（停止辅流选看）。

【请求参数】

userId：远端用户的唯一标识。对应onUserAuxiliaryStreamAvailable返回的共享用户标识。

收到onUserAuxiliaryStreamAvailable消息后，如果选看的远端辅流不可用，则必须调用stopRemoteAuxiliaryStreamView关闭。

updateRemoteAuxiliaryStreamRenderMode

virtual int updateRemoteAuxiliaryStreamRenderMode(const char* userId, HRTCVideoDisplayMode  displayMode, HRTCVideoMirrorType mirrorMode)

【功能说明】

设置辅流视图渲染模式。

【请求参数】

• userId：远端用户的唯一标识。
• displayMode：视图显示模式 。具体请参见HRTCVideoDisplayMode，默认RTC_VIDEO_DISPLAY_FIT，通过扩边的方式保持宽高比。
• mirrorMode：镜像模式。具体请参见HRTCVideoMirrorType。默认为HRTC_VIDEO_MIRROR_TYPE_DISABLE。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

setAuxiliaryVideoEncodeSmooth

virtual int setAuxiliaryVideoEncodeSmooth(bool enable)

【功能说明】

设置是否开启辅流的流畅度优先（降低辅流选看分辨率）。

【请求参数】

enable：true表示辅流分辨率为720p，false表示辅流分辨率为1080p。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

开启后，辅流发流分辨率为720p，否则发流分辨率为1080p。默认不开启。

setAuxiliaryVideoEncoderConfig

virtual int setAuxiliaryVideoEncoderConfig(HRTCVideoAuxiliaryEncParam &encoderParams)

【功能说明】

设置辅流编码参数。

【请求参数】

encoderParams：需要设置的辅流编码参数，包括宽、高、帧率、码率，具体请参见HRTCVideoAuxiliaryEncParam。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

使用该接口设置辅流编码参数，目前策略会根据获取的区域宽高比对设置的宽高进行调整，使得用户设置的宽高比与获取宽高比保持一致，这样用户实际收流分辨率与设置分辨率有可能不同。