视频管理

setupRemoteView

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

【功能说明】

设置远端流渲染视图（新选看接口），该接口不影响收流。

【请求参数】

• userId：远端用户的唯一标识。
• view：窗口句柄，view为NULL时，解除窗口绑定并结束选看。

【返回参数】

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

updateRemoteRenderMode

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

【功能说明】

设置远端用户视图渲染模式。

【返回参数】

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

setRemoteVideoStreamType

virtual int setRemoteVideoStreamType(const char *userId, HRTCVideoStreamType type)

【功能说明】

大小流模式，设置指定选看用户的视频流类型。在通过新选看接口发起选看时调用。

【请求参数】

• userId：远端用户唯一标识。
• type：视频流类型。指大流、小流，具体请参见HRTCVideoStreamType。

【返回参数】

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

setPriorRemoteVideoStreamType

virtual int setPriorRemoteVideoStreamType(HRTCVideoStreamType type)

【功能说明】

大小流模式，设置所有订阅的远端视频流类型。默认订阅大流，优先使用setRemoteVideoStreamType接口设置的用户流类型。

【请求参数】

type：视频流类型。指大流、小流，具体请参见HRTCVideoStreamType。

【返回参数】

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

pullRemoteVideo

virtual int pullRemoteVideo(const char* userId, bool pull)

【功能说明】

开启/关闭接收指定远端用户的视频流。只能加入房间后调用。

【请求参数】

• userId: 远端用户的userId，唯一标识。
• pull：true表示开启接收，false表示关闭接收。

【返回参数】

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

pullAllRemoteVideo

virtual int pullAllRemoteVideo(bool mute)

【功能说明】

开启/关闭接收当前房间所有远端用户的视频流。

【请求参数】

mute：true表示关闭接收，false表示开启接收， 默认开启接收。

【返回参数】

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

startRemoteStreamView

virtual int startRemoteStreamView(const char* userId, view_t view, HRTCStreamType streamType, bool disableAdjustRes)

【功能说明】

设置远端用户渲染视图，并开启收流（选看）。

【返回参数】

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

该接口为选看的旧接口，通过该接口和updateRemoteRenderMode完成一次完整的选看流程。新的完成选看功能拆分为三个接口：setupRemoteView、pullRemoteVideo和setRemoteVideoStreamType接口，将设置渲染模式、窗口句柄、选看的流类型拆分并增加pullRemoteVideo收流控制接口，以实现更细化的选看流程控制（将窗口绑定和收流控制分开）。您可以根据需要选择调用不同的接口组合以实现视频选看。

stopRemoteStreamView

virtual int stopRemoteStreamView(const char* userId)

【功能说明】

关闭远端用户的渲染视图，并停止收流（停止选看）。

【请求参数】

userId：远端用户的唯一标识。

【返回参数】

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

新选看建议通过setupRemoteView接口设置窗口句柄为空来停止选看。

setRemoteVideoAdjustResolution

virtual int setRemoteVideoAdjustResolution(bool enable)

【功能说明】

设置是否开启远端流分辨率自适应。默认开启自适应。

【请求参数】

enable：是否开启自适应。默认开启。

【返回参数】

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