iOS Screen Capture View

• Supported build target - iOS 6.0 / Mac OS 10.7 (Xcode 4.3.1, Apple LLVM compiler 3.1)
• Earliest supported deployment target - iOS 6.0 / Mac OS 10.6
• Earliest compatible deployment target - iOS 6.0 / Mac OS 10.6

NOTE: 'Supported' means that the library has been tested with this version. 'Compatible' means that the library should work on this OS version (i.e. it doesn't rely on any unavailable SDK features) but is no longer being tested for compatibility and may require tweaking or bug fixes to run correctly.

To install UIScreenCaptureView into your app, drag the, UIScreenCaptureView.h and UIScreenCaptureView.m into your project. Make sure that you indicate to copy the files into your project. Also make sure that the Target Membership is checked for UIScreenCaptureView.m

To use this class, you must link against the following frameworks:

  - AssetsLibrary
  - AVFoundation
  - CoreGraphics
  - CoreMedia
  - CoreVideo
  - QuartzCore
  - MediaPlayer

// see Demo Example in Examples/Demo folder for full example and source code

 // To use view to make a video of screen snapshots of you app.
 // First make your view the UIScreenCaptureView
 // then any view added to UIScreenCaptureView will included when recording…


  (void)viewDidLoad {
 [super viewDidLoad];

 // create screen capture view.   Any subviews added to screen capture view will be recorded.
 UIScreenCaptureView * screenCaptureView = [[UIScreenCaptureView alloc] initWithFrame:[[UIScreen mainScreen] applicationFrame]];
 screenCaptureView.delegate = self;   // implements UIScreenCaptureViewDelegate interface
 self.view = screenCaptureView;

 // add your views to be recorded.   If you do not want to make the screenCaptureView your main view, see ALTERNATIVE below
 [self.view addSubView:yourView];

  // set some options
 [screenCaptureView setFrameRate:10.0f];            // 10 frames per seconds (10 frames is the default) adjust to control
                                                    // sampling of screen captures used in making video.
 [screenCaptureView setOutputName:@"output1.mp4"];  // output name (output.mp4 is the default)
 [screenCaptureView setVerbose:false];              // verbose debug mode (false is default)

  // ALTERNATIVE: if you did not want to set a UIScreenCaptureView as your parent view, then you
  // can use this alternate recording method to record your main views components.
  // To use this method you do not need to do the [self.view addSubview:yourView] call above
  // as you will be providing self.view which is your current view used.
  // [screenCaptureView startRecordingViewForTimePeriod:seconds view:self.view parent:self];

 // MANUAL RECORDING TIED TO BUTTONS if you want manual start recording by clicking a button, 
 // then create a UIButton that calls startRecording method when clicked.  Add another button 
 // to call stopRecording 

 // TIMED RECORDING: this test shows starting a timed recording for 20 seconds which records 
 // a video of view added to screenCaptureView
 [NSThread detachNewThreadSelector:@selector(startRecordingForTimePeriodTestThread:) toTarget:self withObject:@""];
 }

 // timed recording...
 (void)startRecordingForTimePeriodTestThread:(NSString *)arg {

[NSThread sleepForTimeInterval:1];
[self performSelectorOnMainThread:@selector(startRecordingForTimePeriodTest:) withObject:@"" waitUntilDone:NO];
}

 (void)startRecordingForTimePeriodTest:(NSString *)arg {

    [self startRecordingForTimePeriod:20];
}

 (void)startRecordingForTimePeriod:(int)seconds {

recordButton.hidden = TRUE;
stopButton.hidden = TRUE;

playIndex = 0;
recordingSeconds = seconds;
recordingTimer = [NSTimer scheduledTimerWithTimeInterval:1.0f target:self selector:@selector(recordingTimerElapsed:) userInfo:nil repeats:YES];   

[screenCaptureView setFrameRate:10.0f];             // 10 frames per seconds (10 frames is the default)
[screenCaptureView setOutputName:@"video.mp4"];     // output name (output.mp4 is the default)
[screenCaptureView setVerbose:FALSE];                // verbose debug mode off

// record any subview of screenCaptureView...
//[screenCaptureView startRecordingForTimePeriod:seconds];   // record for N seconds

// if you did not want to add a UIScreenCaptureView as your parent view, then you
// can use this alternate recording method to record your main views components.

// alternate method records any subview of self.view without having to 
// make screenCaptureView the parent view.   Make sure the view passed is the main app view...
// this is useful for adding app demo video recording to your app without modifying your view layout...
[screenCaptureView startRecordingViewForTimePeriod:seconds view:self.view parent:self];
 }

 (void)startRecording {

recordButton.hidden = TRUE;
stopButton.hidden = FALSE;

playIndex = 0;
recordingTimer = [NSTimer scheduledTimerWithTimeInterval:1.0f target:self selector:@selector(recordingTimerElapsed:) userInfo:nil repeats:YES];   

[screenCaptureView setFrameRate:10.0f];            // 10 frames per seconds (10 frames is the default)
[screenCaptureView setOutputName:@"video.mp4"];    // output name (output.mp4 is the default)
[screenCaptureView setVerbose:FALSE];              // verbose debug mode off
[screenCaptureView startRecording];                // verbose debug mode (false is default)
 }

// outputPathOrNil has the local output path if successful or nil if an error occurred...
 (void)recordingFinished:(NSURL *)outputPathOrNil {

 if (outputPathOrNil != nil) {
     NSLog(@"local output filename is %@", outputPathOrNil);

     // save the created video to Photos...
     NSString * outputName = [outputPathOrNil path];
     [screenCaptureView saveToPhotos:outputName target:self];

     // ---- other options:
     // play recorded video
     // [screenCaptureView playVideo:outputPathOrNil parent:self];

     // remove local copy
     // [screenCaptureView removeLocalCopyOfVideo:outputPathOrNil];    
     // ---- end other options
 } else
     NSLog(@"Error creating the video!");
}

 (void)video:(NSString *)videoPath didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo {

 if (error != nil)
     NSLog(@"Try to saved video and got the error: %@", [error description]);
}

// Methods:

(id)initWithFrame:(CGRect)frame parent:(UIViewController *)parent;  

(BOOL)startRecording;     // start recording screen captures...
(BOOL)startRecordingForTimePeriod:(int)seconds;  // start recording screen captures for so many seconds...

 (BOOL)startRecordingView:(UIView *)view parent:(UIViewController *)_parent;     // start recording screen captures for a view...
 (BOOL)startRecordingViewForTimePeriod:(int)seconds view:(UIView *)view parent:(UIViewController *)_parent;  // start recording screen captures for so many seconds for a view...

 (void)stopRecording;   // stop recording screen captures and save video...

 (UIImage *)screenCaptureView:(UIView *)view;   // get screen capture image for a view

 (UIImage *)screenCaptureView2:(UIView *)view rect:(CGRect)rect;  // get screen capture image for a specific area of a view

 (void)playVideo:(NSURL *)videoUrl parent:(UIViewController *)parent;  // play a recorded view using the supplied view controller

 (BOOL)removeLocalCopyOfVideo:(NSURL *)localFile;    // remove the local copy of a recorded video

 (void)setVerbose:(BOOL)verbose;   // turn verbose mode on which displays more details when recording

The UIScreenCaptureViewDemo demo example in the Examples/Demo folder demonstrates how you might implement using UIScreenCaptureView.

The example is for iOS.