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

视频管理

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 

【功能说明】

设置远端用户视图渲染模式,镜像模式

【请求参数】
【返回参数】
  • 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;

【功能说明】

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

【请求参数】

【返回参数】
  • 0:方法调用成功。
  • >0:方法调用失败。具体请参见HWRtcErrorCode。

相关文档