更新时间: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

相关文档