视频管理
startRemoteStreamView
-(int)startRemoteStreamView:(HWRtcVideoCanvas *)remote streamType:(HWRtcStreamType)streamType disableAdjustRes:(BOOL)disableAdjustRes;
【功能说明】
设置远端用户窗口,并开启收流。
- remote:远端预览视图,具体请参见HWRtcVideoCanvas。
- streamType:视频分辨率,具体请参见HWRtcStreamType。
- disableAdjustRes:禁用分辨率自适应,默认关闭。YES表示关闭,NO表示开启。若关闭,在网络环境较差情况下可能会出现卡顿现象。
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
选看当前未选看用户,或者选看用户的流类型发生变化时,会触发回调onFirstRemoteVideoDecoded。
stopRemoteStreamView
- (int)stopRemoteStreamView:(NSString*)userId;
【功能说明】
关闭远端用户的显示视图,并停止收流。
【请求参数】
userId:远端用户的唯一标识。
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
updateRemoteRenderMode
- (int)updateRemoteRenderMode:(NSString *)userId displayMode:(HWRtcVideoDisplayMode)displayMode mirrorMode:(HWRtcVideoMirrorType)mirrorMode
【功能说明】
设置远端用户视图渲染模式,镜像模式
- displayMode:视图显示模式,具体请参见HWRtcVideoDisplayMode。
- userId:远端用户的唯一标识。
- mirrorMode:镜像模式,具体请参见HWRtcVideoMirrorType。
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
pullRemoteVideo
- (int)pullRemoteVideo:(NSString *)userId pull:(BOOL)pull;
【功能说明】
开启、关闭指定远端的视频流。
【请求参数】
- userId:远端用户的userid,唯一标识。
- pull:YES表示订阅,NO表示取消订阅。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
pullAllRemoteVideo
- (int)pullAllRemoteVideo:(BOOL)pull;
【功能说明】
开启、关闭当前所有远端用户的视频流。
【请求参数】
pull:YES表示取消订阅,NO表示订阅。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
- 取消订阅所有远端用户视频流接收后,同时也会取消接收新加入用户的视频流。
- 开启订阅所有远端用户视频流接收后,同时也会开启接收新加入用户的视频流。
- 默认开启订阅所有远端用户视频流接收。
setupRemoteView
- (int)setupRemoteView:(HWRtcVideoCanvas * _Nonnull)view;
【功能说明】
设置远端流视图,该接口不影响收流。
【请求参数】
view:远端视图,具体请参见HWRtcVideoCanvas。view为nil时,表示关闭远端视图。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
setRemoteVideoAdjustResolution
- (int)setRemoteVideoAdjustResolution:(BOOL)enable;
【功能说明】
设置是否开启远端流分辨率自适应。默认开启自适应。
【请求参数】
enable:YES表示启动自适应,NO表示关闭自适应。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
setPriorRemoteVideoStreamType
- (int)setPriorRemoteVideoStreamType:(HWRtcVideoStreamType)type;
【功能说明】
大小流模式,设置所有订阅的远端视频流类型。默认订阅大流,优先应用setRemoteVideoStreamType接口设置的用户流类型。
【请求参数】
type:视频流类型。指大流、小流,具体请参见HWRtcVideoStreamType。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
setRemoteVideoStreamType
- (int)setRemoteVideoStreamType:(NSString *)userId type:(HWRtcVideoStreamType)type;
【功能说明】
大小流模式,设置指定选看用户的视频流类型。在通过新选看接口发起选看时调用。
【请求参数】
- userId:远端用户唯一标识。
- type:视频流类型。指大流、小流,具体请参见HWRtcVideoStreamType。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HWRtcErrorCode。
setRemoteViewRotation
- (int)setRemoteViewRotation:(NSString *)userId rotation:(HWRtcVideoRotation)rotation;
【功能说明】
设置远端流视图的旋转角度。
【请求参数】
- userId:用户ID。
- rotation:旋转角度信息(0°,90°,270°),具体请参见HWRtcVideoRotation。
- 0:方法调用成功。
- >0:方法调用失败。具体请参见HWRtcErrorCode。
setRemoteViewOrientation
- (int)setRemoteViewOrientation:(NSString *)userId orientation:(HWRtcVideoOrientaion)orientation;
【功能说明】
设置远端流视图方向(横竖屏)。
【请求参数】
- userId:用户ID。
- orientation:方向(横竖屏),具体请参见HWRtcVideoOrientaion。
- 0:方法调用成功。
- >0:方法调用失败。具体请参见HWRtcErrorCode。