renewAuthorization 更新签名
3.4.3.5 视频管理
setPriorRemoteVideoStreamType
public abstract int setPriorRemoteVideoStreamType(HRTCVideoStreamType type);
【功能说明】
大小流模式,设置所有订阅的远端视频流类型。默认订阅大流,优先应用 setRemoteVideoStreamType接口设置的用户流类型。
【请求参数】
type:订阅的视频流类型,分为大流和小流,具体请参见HRTCVideoStreamType。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
pullRemoteVideo
public abstract int pullRemoteVideo(String userId, boolean pull);
【功能说明】
开启、关闭指定远端用户的视频流。
【请求参数】
● userId:远端用户的userId,唯一标识。
● pull:true表示开始接收,false表示关闭接收。
【返回参数】
● 0:成功。
● > 0:失败。具体请参见客户端错误码。
setupRemoteView
public abstract int setupRemoteView(String userId, SurfaceView view);
【功能说明】
设置远端流视图,该接口不影响收流。
【请求参数】
● userId:远端用户的唯一标识。
● view:远端窗口视图,view为null时,解除窗口绑定。
【返回参数】
● 0:成功。
● > 0:失败。具体请参见客户端错误码。
startRemoteStreamView
public abstract int startRemoteStreamView(String userId, SurfaceView view, HRTCStreamType streamType, boolean disableAdjustRes);
【功能说明】
开始订阅远端视频流,并设置远端窗口。
【请求参数】
● userId:用户ID。
● view:远端窗口视图。
● streamType:流类型,具体请参见HRTCStreamType。
● disableAdjustRes:禁用分辨率自适应的标志。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
stopRemoteStreamView
public abstract int stopRemoteStreamView(String userId);
【功能说明】
停止订阅远端视频流,并关闭远端窗口。
【请求参数】
userId:用户ID。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
pullAllRemoteVideo
public abstract int pullAllRemoteVideo(boolean pull);
【功能说明】
批量开启、关闭当前所有远端用户的视频流。
【请求参数】
pull:true表示开启接收,false表示关闭接收, 默认开启接收。
【返回参数】
● 0:成功。
● > 0:失败。具体请参见客户端错误码。
setRemoteVideoStreamType
public abstract int setRemoteVideoStreamType(String userId, HRTCVideoStreamType type);
【功能说明】
大小流模式,设置指定订阅的远端视频流类型。
【请求参数】
● userId:远端用户唯一标识。
● type:订阅的视频流类型,分为大流和小流,具体请参见
HRTCVideoStreamType。
updateRemoteRenderMode
public abstract int updateRemoteRenderMode(String userId, HRTCVideoDisplayMode displayMode, HRTCVideoMirrorType mirrorMode);
【功能说明】
设置远端窗口渲染模式。
【请求参数】
● userId:用户ID。
● displayMode:渲染模式,具体请参见HRTCVideoDisplayMode。
● mirrorMode:镜像模式,具体请参见HRTCVideoMirrorType 。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
setRemoteVideoAdjustResolution
public abstract int setRemoteVideoAdjustResolution(boolean enable);
【功能说明】
设置是否开启远端流分辨率自适应。默认开启自适应。
【请求参数】
enable:是否开启分辨率自适应。默认开启。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
startAllRemoteView
public abstract int startAllRemoteView(List<HRTCVideoRemoteView> viewInfoList);
【功能说明】
批量设置远端流视图。
【请求参数】
viewInfoList:订阅的视图信息,主要包括该视图的句柄、流类型、用户ID、是否自适 应等,具体请参见HRTCVideoRemoteView。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
3.4.3.6 辅流管理
startRemoteAuxiliaryStreamView
public abstract int startRemoteAuxiliaryStreamView(String userId, SurfaceView view);
【功能说明】
开始订阅辅流。
【请求参数】
● userId:用户ID。
● view:窗口视图。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
注意
● 收到onUserAuxiliaryStreamAvailable通知后,获取对应的userId。
● 多辅流场景下,一个用户只能同时订阅一条辅流。即当前正在订阅用户A的辅 流,需要订阅另一个用户B的辅流时,需要调用
startRemoteAuxiliaryStreamView停止订阅用户A的辅流后,才能订阅用户B
的辅流。stopRemoteAuxiliaryStreamView
public abstract int stopRemoteAuxiliaryStreamView(String userId);
【功能说明】
停止订阅辅流。
【请求参数】
userId:用户ID。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
setRemoteAuxiliaryStreamViewRotation
public abstract int setRemoteAuxiliaryStreamViewRotation(String userId, HRTCRotationType rotation);
【功能说明】
设置辅流角度。
【请求参数】
● userId:用户ID。
● rotation:辅流角度,默认值为HRTC_ROTATION_TYPE_0,具体请参见
HRTCRotationType。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。
updateRemoteAuxiliaryStreamRenderMode
public abstract int updateRemoteAuxiliaryStreamRenderMode(String userId, HRTCVideoDisplayMode displayMode, HRTCVideoMirrorType mirrorMode);
【功能说明】
设置辅流渲染模式。
【请求参数】
● userId:用户ID。
● displayMode:渲染模式,默认值为HRTC_VIDEO_DISPLAY_MODE_FIT,具体请 参见HRTCVideoDisplayMode。
● mirrorMode:镜像模式,默认值为HRTC_VIDEO_MIRROR_TYPE_DISABLE,具体 请参见HRTCVideoMirrorType。
【返回参数】
● 0:成功。
● >0:失败。具体请参见客户端错误码。