屏幕共享

若用户只在应用内共享画面与声音，可以调用 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];

跨应用屏幕共享是由 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” 。

   无需勾选 “Include UI Extension”。

   

   创建完成后，您会在项目中看到该 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];

4 启动 Extension 扩展进程

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

方式一 方式二

您需要在 iOS 系统的控制中心，长按录屏按钮后，选择对应的 Extension 来开启录制。

苹果在 iOS 12.0 中新增了 RPSystemBroadcastPickerView，可以从 App 应用弹出启动器，供用户确认启动屏幕分享。

1. 创建 RPSystemBroadcastPickerView 系统类，绑定 Extension 的 “BundleID”。
2. 遍历 RPSystemBroadcastPickerView 的子 view 寻找 UIButton， 并触发其点击事件。

RPSystemBroadcastPickerView *broadcastPickerView = [[RPSystemBroadcastPickerView alloc] initWithFrame:CGRectMake(0, 0, 44, 44)];
NSString *bundlePath = [[NSBundle mainBundle] pathForResource:@"ZegoExpressExample-Broadcast" ofType:@"appex" inDirectory:@"PlugIns"];
if (bundlePath) {
    NSBundle *bundle = [NSBundle bundleWithPath:bundlePath];
    if (bundle) {
        broadcastPickerView.preferredExtension = bundle.bundleIdentifier;
        for (UIView *subView in broadcastPickerView.subviews) {
            if ([subView isMemberOfClass:[UIButton class]]) {
                UIButton *button = (UIButton *)subView;
                [button sendActionsForControlEvents:UIControlEventAllEvents];
            }
        }
    }
}

• 苹果在 iOS 12.0 中新增了 RPSystemBroadcastPickerView，可以从 App 应用弹出启动器，供用户确认启动屏幕分享。但目前 RPSystemBroadcastPickerView 还不支持自定义界面，也没有官方的唤起方法。

• 苹果官方不推荐该方案，并有可能在新一轮的系统更新中失效，因此只是一个可选方案，选用此方案您需要自行承担风险。

5 获取屏幕数据

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

   [ZegoReplayKitExt.sharedInstance setupWithDelegate:self];

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

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

3. 系统通过 broadcastFinished 回调通知 Extension 屏幕录制已结束，若屏幕录制失败可接收到失败的原因。您可以在该回调中，调用 ZegoReplayKitExt 类中的 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;
       }
   }