更新时间:2023-10-26 GMT+08:00
分享

辅流管理

startRemoteAuxiliaryStreamView

- (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)streamView streamType:(HWRtcStreamType)streamType;

【功能说明】

当远端开启屏幕共享,本地接收到远端屏幕共享开启并通过onUserAuxiliaryStreamAvailable回调得到消息后,设置屏幕辅流窗口视图并开始选看(发起辅流选看)。

【请求参数】

【返回参数】

  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HWRtcErrorCode。
  • 收到onUserAuxiliaryStreamAvailable消息后,获取对应的userId。
  • 多辅流场景,一个用户同时只能订阅一条辅流;当前正在订阅用户A的辅流,需要订阅另一个用户B的辅流时,需要先停止订阅用户A的辅流,再订阅用户B的辅流。

stopRemoteAuxiliaryStreamView

- (int)stopRemoteAuxiliaryStreamView:(NSString *)userid;

【功能说明】

停止选看辅流视图。

【请求参数】

userid:远端用户的唯一标识。对应onUserAuxiliaryStreamAvailable返回的共享用户标识

【返回参数】

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

收到onUserAuxiliaryStreamAvailable消息后,如果选看的远端屏幕辅流不可用,则必须调用stopRemoteAuxiliaryStreamView关闭。

updateRemoteAuxiliaryStreamRenderMode

- (int)updateRemoteAuxiliaryStreamRenderMode:(NSString *)userid displayMode(HWRtcVideoDisplayMode)displayMode mirrorMode:(HWRtcVideoMirrorType)mirrorMode;

【功能说明】

设置辅流视图显示模式。

【请求参数】
  • displayMode:显示模式,默认模式为HWRtcVideoDisplayModeFit,具体请参见HWRtcVideoDisplayMode。
  • userid:远端用户的唯一标识。
  • mirrorMode:镜像模式,默认模式为HWRtcVideoMirrorTypeDisable,具体请参见HWRtcVideoMirrorType。
【返回参数】
  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HWRtcErrorCode。

setRemoteAuxiliaryStreamViewRotation

- (int)setRemoteAuxiliaryStreamViewRotation:(HWRtcVideoRotation)rotation userid:(NSString *_Nonnull)userid;

【功能说明】

设置辅流视图角度。

【请求参数】
  • rotation:视图角度,默认角度为HWRtcVideoRotation0,具体请参见HWRtcVideoRotation。
  • userid:远端用户的唯一标识。
【返回参数】
  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HWRtcErrorCode。

setAuxiliaryVideoEncoderConfig

- (int)setAuxiliaryVideoEncoderConfig:(HWRtcVideoAuxiliarEncParam *_Nonnull)encParam;

【功能说明】

设置辅流的编码能力。

【请求参数】

encParam:编码参数设置。具体参考HWRtcVideoAuxiliarEncParam;

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

setAuxiliaryVideoEncodeSmooth

- (int)setAuxiliaryVideoEncodeSmooth:(BOOL)enable;

【功能说明】

设置是否开启辅流的流畅度优先。

【请求参数】

enable:YES表示辅流分辨率为720P;NO表示辅流分辨率为1080P。

【返回参数】
  • 0:成功。
  • > 0:方法调用失败。具体请参见HWRtcErrorCode。
  • 如果手机分辨率不超过1080p,不可以设置为NO。
  • 开启后,辅流发流分辨率为720p,否则发流分辨率为1080p。默认不开启。

pushAuxExternalVideoFrame

- (int)pushAuxExternalVideoFrame:(HWRtcVideoFrame * _Nonnull)videoFrame;

【功能说明】

推送辅流数据到SDK。

【请求参数】

videoFrame:具体参考HWRtcVideoFrame。

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

相关文档