屏幕共享

若用户只在应用内共享画面与声音，可以调用 startScreenCaptureInApp 接口开启屏幕共享。也可调用 broadcastFinished 接口回调屏幕共享结束通知，若屏幕采集失败可接收到失败的原因。

ZegoScreenCaptureConfig *config = [[ZegoScreenCaptureConfig alloc] init];
config.captureVideo = true;
config.captureAudio = true;
// 可选参数，设置视频的采集区域，必须在原始的视频数据之内，单位为像素（px）
config.cropRect = CGRectMake(x, y, width, height);
[ZegoExpressEngine.sharedEngine startScreenCaptureInApp:config];

ZegoScreenCaptureConfig *config = [[ZegoScreenCaptureConfig alloc] init];
config.captureVideo = true;
config.captureAudio = true;
// 可选参数，设置视频的采集区域，必须在原始的视频数据之内，单位为像素（px）
config.cropRect = CGRectMake(x, y, width, height);
[ZegoExpressEngine.sharedEngine startScreenCaptureInApp:config];

跨应用屏幕共享是由 iOS 系统通过 Extension 扩展进程进行录制的，所以需要再额外创建扩展进程，并启动。具体请参考如下实现步骤：

1 新建 Broadcast Upload Extension

1. 使用 Xcode 打开项目工程文件，在菜单栏中依次点击 “File > New > Target..."。

   

2. 在弹出的窗口中选择 iOS 页的 “Broadcast Upload Extension” 后，单击 “Next”。

   

3. 在弹出的对话框中的 “Product Name” 一栏填写 “Broadcast Upload Extension” 的名字，例如 “ScreenShare”。选择 “Team”、“Language” 等信息后，单击 “Finish” 。

创建完成后，您会在项目中看到该 Extension 的文件夹，结构类似如下，该文件夹用于存放屏幕共享功能的实现代码：

2 设置 Extension

1. 确保 Extension 的 “Info.plist” 文件中，将 “RPBroadcastProcessMode” 设置为 “RPBroadcastProcessModeSampleBuffer”。
2. 在 Extension 中导入 ZEGO Express SDK，详情请参考 快速开始 - 集成 中的 “导入 SDK”。

3 开始屏幕共享

若用户需要共享整个系统的画面与声音，可以调用 startScreenCapture 接口开启屏幕共享。

ZegoScreenCaptureConfig *config = [[ZegoScreenCaptureConfig alloc] init];
config.captureVideo = true;
config.captureAudio = true;
// 可选参数，设置视频的采集区域，必须在原始的视频数据之内，单位为 像素（px）
config.cropRect = CGRectMake(x, y, width, height);
[ZegoExpressEngine.sharedEngine startScreenCapture:config];

ZegoScreenCaptureConfig *config = [[ZegoScreenCaptureConfig alloc] init];
config.captureVideo = true;
config.captureAudio = true;
// 可选参数，设置视频的采集区域，必须在原始的视频数据之内，单位为 像素（px）
config.cropRect = CGRectMake(x, y, width, height);
[ZegoExpressEngine.sharedEngine startScreenCapture:config];

4 启动 Extension 扩展进程

有两种启动方式，请根据需要选择实现。

5 获取屏幕数据

1. 系统通过 broadcastStartedWithSetupInfo 回调通知 Extension 已开始录制屏幕，您需要在该回调中，调用 ZegoReplayKitExt 类中的 setupWithDelegate 接口创建数据传输通道：

   [ZegoReplayKitExt.sharedInstance setupWithDelegate:self];

   [ZegoReplayKitExt.sharedInstance setupWithDelegate:self];

2. 在 processSampleBuffer 系统回调中，通过 ZegoReplayKitExt 类中的 sendSampleBuffer 接口发送给 ZEGO Express SDK。

   [ZegoReplayKitExt.sharedInstance sendSampleBuffer:sampleBuffer withType:sampleBufferType];

   [ZegoReplayKitExt.sharedInstance sendSampleBuffer:sampleBuffer withType:sampleBufferType];

3. 系统通过 broadcastFinished 回调通知 Extension 屏幕录制已结束，若屏幕录制失败可接收到失败的原因。您可以在该回调中，调用 ZegoReplayKitExt 类中的 finished 接口停止屏幕采集并断开数据传输通道：

   [ZegoReplayKitExt.sharedInstance finished];

   [ZegoReplayKitExt.sharedInstance finished];

4. 通过上述调用 SDK 的 setupWithDelegate 方法初始化并设置代理，可以在当前类添加 <ZegoReplayKitExtHandler> 协议以及实现回调，用于监听屏幕共享结束或失败的原因。

   - (void)broadcastFinished:(ZegoReplayKitExt *)broadcast reason:(ZegoReplayKitExtReason)reason {
   
       switch (reason) {
           case ZegoReplayKitExtReasonHostStop:
               {
                   NSDictionary *userInfo = @{NSLocalizedDescriptionKey : @"Host app stop srceen capture"};
                   NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:0 userInfo:userInfo];
                   [self finishBroadcastWithError:error];
               }
               break;
           case ZegoReplayKitExtReasonConnectFail:
               {
                   NSDictionary *userInfo = @{NSLocalizedDescriptionKey : @"Connect host app fail need startScreenCapture in host app"};
                   NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:0 userInfo:userInfo];
                   [self finishBroadcastWithError:error];
               }
               break;
           case ZegoReplayKitExtReasonDisconnect:
               {
                   NSDictionary *userInfo = @{NSLocalizedDescriptionKey : @"disconnect with host app"};
                   NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:0 userInfo:userInfo];
                   [self finishBroadcastWithError:error];
               }
               break;
       }
   }

   - (void)broadcastFinished:(ZegoReplayKitExt *)broadcast reason:(ZegoReplayKitExtReason)reason {
   
       switch (reason) {
           case ZegoReplayKitExtReasonHostStop:
               {
                   NSDictionary *userInfo = @{NSLocalizedDescriptionKey : @"Host app stop srceen capture"};
                   NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:0 userInfo:userInfo];
                   [self finishBroadcastWithError:error];
               }
               break;
           case ZegoReplayKitExtReasonConnectFail:
               {
                   NSDictionary *userInfo = @{NSLocalizedDescriptionKey : @"Connect host app fail need startScreenCapture in host app"};
                   NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:0 userInfo:userInfo];
                   [self finishBroadcastWithError:error];
               }
               break;
           case ZegoReplayKitExtReasonDisconnect:
               {
                   NSDictionary *userInfo = @{NSLocalizedDescriptionKey : @"disconnect with host app"};
                   NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:0 userInfo:userInfo];
                   [self finishBroadcastWithError:error];
               }
               break;
       }
   }