ReplayKit是苹果在iOS9上面提供的一个框架.

库的特性说明

  • 目前这个库只支持真机允许,不支持模拟器。
  • 系统版本必须高于iOS9。
  • 不支持录avplayer播放的视频,这个可能是为了保护视频的版权,避免影视资源被复制拷贝。
  • 仅支持录制app内部内容,不支持跨app录制
  • 支持开启麦克风, 可以同时录制app内部声音和麦克风声音

RPScreenRecorder负责录制回放视频, 是一个单例

RPPreviewViewController为用户提供预览、分享、保存等功能。

视频录制完成之后可以调用ReplayKit的接口显示视频预览页面,对应的接口是返回一个页面的ViewController,至于如何显示这个页面,各个客户端可以自由处理,Demo中只是给了其中一种实现方法。

库的潜在问题

经过实验,发现ReplayKit有如下情况:

  • 录制的启动初始化有时很慢,有见过几十秒才初始化完成的,也碰见过初始化没有成功的。第一次一般比较慢,需要用户授权才能开始, 然而,一旦用户选择了其中一种偏好设置,系统会在接下来的8分钟记住这个选择。
  • 录制调用了停止接口后系统还会继续录制多几秒的视频。
  • 出现过录制结果为黑屏的情况。
  • 出现过报错"录制被多任务和内容大小调整中断", stackoverflow上说iOS13.1.3之后才修复, 低于这个系统的只能重启设备,

Demo说明

连接iPhone或者iPad之后可以编译并运行这个工程,在真机上运行后可以看到如下界面。

参见附件图片

  1. 点击 开始按钮 后就会调用开始录屏的接口,但这个时候不是马上进行录屏,ReplayKit需要初始化完成开自动开始录屏,所以实际中加了一个Loading提示“初始化”
  2. 初始化完成后 结束 按钮变为可以点击的状态,并提示 “正在录制”
  3. 等要结束时点击 结束按钮,会调用ReplayKit的停止接口,停止接口给了回调后可以显示录屏视频的预览页面,至于要不要显示和如何显示,由具体需求确定,Demo只是给了个参考的例子。
  4. 在视频预览页面可以选择保存到系统相册或者分享到社交网络,还可以拷贝到剪切板,这些操作都可以在回调中获取到,app可以根据这些回调的信息给用户提示(比如“视频成功保存到系统相册”)

ReplayKit的官网使用说明 Apple Developer Documentation

demo地址: GitHub - ReplayKitDemo: app录屏demo

边录制边回调数据做视频流上传:

基于ReplayKit实现屏幕录制 - 简书

iOS端屏幕录制(replaykit)调研 - 简书

iOS端屏幕录制Replaykit项目实践 - 简书

iOS端使用replaykit录制屏幕的技术细节 - 简书

demo核心代码:

#import "ViewController.h"
#import <ReplayKit/ReplayKit.h>

@interface ViewController ()<RPScreenRecorderDelegate,RPPreviewViewControllerDelegate>

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

}

- (IBAction)startRecordAction:(UIButton *)sender {

    if ([RPScreenRecorder sharedRecorder].recording==YES) {
        NSLog(@"正在录制中");
        return;
    }

    if ([RPScreenRecorder sharedRecorder].isAvailable) {

        NSLog(@"[RPScreenRecorder sharedRecorder].isAvailable支持录屏,准备开始录屏");
        [RPScreenRecorder sharedRecorder].delegate = self;
        [RPScreenRecorder sharedRecorder].microphoneEnabled = YES;
        [[RPScreenRecorder sharedRecorder] startRecordingWithHandler:^(NSError * _Nullable error) {
            if (error) {
                NSLog(@"录屏初始化失败, %@",error);
                /*
                 开发中遇到了一个错误, 低版本的系统解决方案看起来只有重启,可以做个提示给用户需要重启设备
                 com.apple.ReplayKit.rprecordingerrodomain代码=-5807 “录制被多任务和内容大小调整中断” UserInfo={NSLocalizedDescription=录制被多任务中断 和内容大小调整})

                 我遇到这个问题因为Extension启动失败导致上一个Extension没有关闭没办法重新打开,关机重启手机可以解决,
                 根本解决办法还是在Extension上,找到Extension崩溃的原因才能根治
                 链接:https://www.jianshu.com/p/0d3840463c56

                 在iOS 12.0之前一切正常.从更新我得到上面的错误.出于同样的原因,我的应用程序已被App Store拒绝.到目前为止,唯一的解决方法是重启设备.
                 https://www.codercto.com/a/51450.html

                 我遇到了同样的问题,我的设备甚至完全无法再录制屏幕。更新设备到iOS13.1.3修复了所有问题。
                 http://ask.sov5.cn/q/M67Qqiz5Hb
                 */

            } else {
                NSLog(@"录屏初始化成功,真正开始录屏");
            }
        }];

    } else {
        NSLog(@"[RPScreenRecorder sharedRecorder].isAvailable不支持录屏");
    }
}

- (IBAction)endRecordAction:(UIButton *)sender {

    NSLog(@"点击结束录屏");
    [[RPScreenRecorder sharedRecorder] stopRecordingWithHandler:^(RPPreviewViewController * _Nullable previewViewController, NSError * _Nullable error) {

        if (error) {
            NSLog(@"真正结束录屏,出错了: %@",error);
        }
        NSLog(@"真正结束录屏,显示预览");
        // 显示预览
        // 录屏结束,调用显示预览,根据自己的需求来处理,也可以不显示预览,直接存相册,让用户到相册里编辑
        previewViewController.previewControllerDelegate = self;
        [self presentViewController:previewViewController animated:YES completion:^{

        }];

    }];

    // 这个是iOS14之后可用,可以把录屏的视频导入到自己的app沙盒中
//    - (void)stopRecordingWithOutputURL:(NSURL *)url completionHandler:(nullable void (^)(NSError *_Nullable error))completionHandler


}


#pragma mark - 录制事件回调
// 录屏结束, 显示出预览画面
- (void)screenRecorder:(RPScreenRecorder *)screenRecorder didStopRecordingWithPreviewViewController:(nullable RPPreviewViewController *)previewViewController error:(nullable NSError *)error {
    NSLog(@"录屏结束, 显示出预览画面");
}

// [RPScreenRecorder sharedRecorder].isAvailable, 状态变化会抛这个回调
- (void)screenRecorderDidChangeAvailability:(RPScreenRecorder *)screenRecorder {
    NSLog(@"[RPScreenRecorder sharedRecorder].isAvailable状态改变, %d",[RPScreenRecorder sharedRecorder].isAvailable);
}


#pragma mark - 预览视图回调
// 预览视图编辑结束, 取消/保存
- (void)previewControllerDidFinish:(RPPreviewViewController *)previewController {
    [previewController dismissViewControllerAnimated:YES completion:^{

    }];
}

// 预览页面点击保存,取消,复制,AirDrop等,会进入此回调,不需要做什么逻辑,只是把事件回调回来
- (void)previewController:(RPPreviewViewController *)previewController didFinishWithActivityTypes:(NSSet <NSString *> *)activityTypes {

    if ([activityTypes containsObject:@"com.apple.UIKit.activity.SaveToCameraRoll"]) {
        NSLog(@"保存到系统相册");
    }
    if ([activityTypes containsObject:@"com.apple.UIKit.activity.CopyToPasteboard"]) {
        NSLog(@"复制到粘贴板");
    }
    if ([activityTypes containsObject:@"com.apple.UIKit.activity.AirDrop"]) {
        NSLog(@"AirDrop发送成功");
    }
}


@end