# 屏幕共享
 #### startScreenShare
```
- (int)startScreenShare;
```
【**功能说明**】
开启屏幕共享功能。
【**请求参数**】
无
【**返回参数** 】
- 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)
- 目前可支持多路辅流共享，若需开启多辅流，请[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)联系技术支持处理。
- 共享成功后会触发[onScreenShareStarted](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section596575961613)回调。
- 开启成功，远端会触发[onUserAuxiliaryStreamAvailable](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section2291635192111)通知，可据此发起辅流选看。
 
 #### startScreenShareWithAppGroup
```
- (int)startScreenShareWithAppGroup:(NSString *)appGroup;
```
【**功能说明**】
开启屏幕共享功能。
【**请求参数**】
appGroup：NSString 数据类型，需要传入appGroup ID。
【**返回参数** 】
- 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)
- 只支持iPhone。
- 需要先调用[setAuxiliaryVideoEncoderConfig](https://support.huaweicloud.com/csdk-rtc/rtc_05_0058.html#rtc_05_0058__section54941958102419)接口，设置编码参数。
- 目前可支持多路辅流共享，若需开启多辅流，请[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)联系技术支持处理。
- 共享成功后会触发[onScreenShareStarted](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section596575961613)回调。
- 开启成功，远端会触发[onUserAuxiliaryStreamAvailable](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html#rtc_05_0065__section2291635192111)。
 
 #### stopScreenShare
```
- (int)stopScreenShare;
```
【**功能说明**】
关闭屏幕共享功能。
【**请求参数**】
无
【**返回参数** 】
- 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)。
- 关闭成功，本端会触发onScreenRecordFinished。
 
 #### getScreenShareSources
```
- (NSArray<HWRtcScreenShareSourceInfo *> *)getScreenShareSources;
```
【**功能说明**】
获取资源共享列表。
【**请求参数**】
无
【**返回参数**】
当前可共享的资源列表。具体请参见[HWRtcScreenShareSourceInfo](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section19576174993317)。
![](https://support.huaweicloud.com/csdk-rtc/public_sys-resources/caution_3.0-zh-cn.png)
只支持macOS。
 #### setScreenShareTarget
```
- (int)setScreenShareTarget:(HWRtcScreenShareParam *)param;
```
【**功能说明**】
设置共享对象。
【**请求参数**】
param：共享对象的具体信息。具体请参见[HWRtcScreenShareParam](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html#rtc_05_0082__section915912510363)。
【**返回参数** 】
- 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)
- 只支持macOS。
- 如果共享对象为桌面类型，则对象名称sourceName不能为空或空字符串，该名称可从[getScreenShareSources]接口获取。
- 如设置的rect为NSRect(0,0,0,0)，则会根据共享的id和名称取得相应对象的默认区域作为共享范围。
 
#### adjustAudioShareVolume
```
- (int)adjustAudioShareVolume:(unsigned int)volume;
```
【**功能说明**】
设置软增益调整采集的系统声音的音量
【**请求参数**】
- volume：音量值 \[0 , 100\]
【**返回参数**】
- 0：方法调用成功。
- \> 0：方法调用失败。具体请参见[HRTCErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0125.html)。
 
#### setShareComputerScreen
```
- (int)setShareComputerScreen:(BOOL)enable;
```
【**功能说明**】
设置"声音共享子开关"。当开启媒体共享时，通过该接口可以控制"声音共享"功能的开关。该子开关默认为"关"，并且与 startScreenShare 无调用顺序限制。
【**请求参数**】
- enable：true表示开启，false表示关闭。
【**返回参数**】
- 0：方法调用成功。
- \> 0：方法调用失败。具体请参见[HRTCErrorCode](https://support.huaweicloud.com/csdk-rtc/rtc_05_0125.html)。