
# 辅流管理
 #### startRemoteAuxiliaryStreamView
```
- (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)streamView streamType:(HWRtcStreamType)streamType;
```
【**功能说明**】
当远端开启屏幕共享，本地接收到远端屏幕共享开启并通过[onUserAuxiliaryStreamAvailable](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section2291635192111)回调得到消息后，设置屏幕辅流窗口视图并开始选看（发起辅流选看）。
【**请求参数** 】
- streamView：视图信息，具体请参见[HWRtcVideoCanvas](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section1528903020214)。
- streamType：编码类型，具体请参见[HWRtcStreamType](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section14391195354014)。具体设置请参见[表57 不同分辨率下帧率和码率的推荐值](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__table15806112155510)。
 
【**返回参数**】
- 0：方法调用成功。
- \> 0：方法调用失败。具体请参见[HWRtcErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.html)。
![](https://support.huaweicloud.com/csdk-rtc/public_sys-resources/caution_3.0-zh-cn.png)
- 收到[onUserAuxiliaryStreamAvailable](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section2291635192111)消息后，获取对应的userId。
- 多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。
 
 #### stopRemoteAuxiliaryStreamView
```
- (int)stopRemoteAuxiliaryStreamView:(NSString *)userid;
```
【**功能说明**】
停止选看辅流视图。
【**请求参数**】
userid：远端用户的唯一标识。对应[onUserAuxiliaryStreamAvailable](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section2291635192111)返回的共享用户标识
【**返回参数**】
- 0：方法调用成功。
- \> 0：方法调用失败。具体请参见[HWRtcErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.html)。
![](https://support.huaweicloud.com/csdk-rtc/public_sys-resources/caution_3.0-zh-cn.png)
收到[onUserAuxiliaryStreamAvailable](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section2291635192111)消息后，如果选看的远端屏幕辅流不可用，则必须调用stopRemoteAuxiliaryStreamView关闭。
 #### updateRemoteAuxiliaryStreamRenderMode
```
- (int)updateRemoteAuxiliaryStreamRenderMode:(NSString *)userid displayMode(HWRtcVideoDisplayMode)displayMode mirrorMode:(HWRtcVideoMirrorType)mirrorMode;
```
【**功能说明**】
设置辅流视图显示模式。
【**请求参数** 】
- displayMode：显示模式，默认模式为HWRtcVideoDisplayModeFit，具体请参见[HWRtcVideoDisplayMode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section7141345144014)。
- userid：远端用户的唯一标识。
- mirrorMode：镜像模式，默认模式为HWRtcVideoMirrorTypeDisable，具体请参见[HWRtcVideoMirrorType](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section1211744520368)。
 
【**返回参数** 】
- 0：方法调用成功。
- \> 0：方法调用失败。具体请参见[HWRtcErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.html)。
 
 #### setRemoteAuxiliaryStreamViewRotation
```
- (int)setRemoteAuxiliaryStreamViewRotation:(HWRtcVideoRotation)rotation userid:(NSString *_Nonnull)userid;
```
【**功能说明**】
设置辅流视图角度。
【**请求参数** 】
- rotation：视图角度，默认角度为HWRtcVideoRotation0，具体请参见[HWRtcVideoRotation](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section1813016311205)。
- userid：远端用户的唯一标识。
 
【**返回参数** 】
- 0：方法调用成功。
- \> 0：方法调用失败。具体请参见[HWRtcErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.html)。
 
 #### setAuxiliaryVideoEncoderConfig
```
- (int)setAuxiliaryVideoEncoderConfig:(HWRtcVideoAuxiliarEncParam *_Nonnull)encParam;
```
【**功能说明**】
设置辅流的编码能力。
【**请求参数**】
encParam：编码参数设置。具体参考[HWRtcVideoAuxiliarEncParam](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section13226184192310)；
【**返回参数** 】
- 0：成功。
- \> 0：方法调用失败。具体请参见[HWRtcErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.html)。
 
 #### setAuxiliaryVideoEncodeSmooth
```
- (int)setAuxiliaryVideoEncodeSmooth:(BOOL)enable;
```
【**功能说明**】
设置是否开启辅流的流畅度优先。
【**请求参数**】
enable：YES表示辅流分辨率为720P；NO表示辅流分辨率为1080P。
【**返回参数** 】
- 0：成功。
- \> 0：方法调用失败。具体请参见[HWRtcErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.html)。
 
![](https://support.huaweicloud.com/csdk-rtc/public_sys-resources/caution_3.0-zh-cn.png)
- 如果手机分辨率不超过1080p，不可以设置为NO。
- 开启后，辅流发流分辨率为720p，否则发流分辨率为1080p。默认不开启。
 
 #### pushAuxExternalVideoFrame
```
- (int)pushAuxExternalVideoFrame:(HWRtcVideoFrame * _Nonnull)videoFrame;
```
【**功能说明**】
推送辅流数据到SDK。
【**请求参数**】
videoFrame：具体参考[HWRtcVideoFrame](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section199816620273)。
【**返回参数** 】
- 0：方法调用成功。
- \> 0：方法调用失败。具体请参见[HWRtcErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.html)
 
