iOS Developer Library

Developer

AVFoundation Framework Reference AVCaptureFileOutputRecordingDelegate Protocol Reference

Options
Deployment Target:

On This Page
Language:

AVCaptureFileOutputRecordingDelegate

Defines an interface for delegates of AVCaptureFileOutput to respond to events that occur in the process of recording a single file. More...

Inheritance


Not Applicable

Import Statement


import AVFoundation @import AVFoundation;

Availability


Available in iOS 4.0 and later.
  • Informs the delegate when the output has started writing to a file.

    Declaration

    Swift

    optional func captureOutput(_ captureOutput: AVCaptureFileOutput!, didStartRecordingToOutputFileAtURL fileURL: NSURL!, fromConnections connections: [AnyObject]!)

    Objective-C

    - (void)captureOutput:(AVCaptureFileOutput *)captureOutput didStartRecordingToOutputFileAtURL:(NSURL *)fileURL fromConnections:(NSArray *)connections

    Parameters

    captureOutput

    The capture file output that started writing the file.

    fileURL

    The file URL of the file that is being written.

    connections

    An array of AVCaptureConnection objects attached to the file output that provided the data that is being written to the file.

    Discussion

    If an error condition prevents any data from being written, this method may not be called. captureOutput:willFinishRecordingToOutputFileAtURL:fromConnections:error: and captureOutput:didFinishRecordingToOutputFileAtURL:fromConnections:error: are always called, even if no data is written.

    You should not assume that this method will be called on a specific thread, and should make this method as efficient as possible.

    Import Statement

    import AVFoundation

    Availability

    Available in iOS 4.0 and later.

  • Informs the delegate when all pending data has been written to an output file. (required)

    Declaration

    Swift

    func captureOutput(_ captureOutput: AVCaptureFileOutput!, didFinishRecordingToOutputFileAtURL outputFileURL: NSURL!, fromConnections connections: [AnyObject]!, error error: NSError!)

    Objective-C

    - (void)captureOutput:(AVCaptureFileOutput *)captureOutput didFinishRecordingToOutputFileAtURL:(NSURL *)outputFileURL fromConnections:(NSArray *)connections error:(NSError *)error

    Parameters

    captureOutput

    The capture file output that has finished writing the file.

    outputFileURL

    The file URL of the file that is being written.

    connections

    An array of AVCaptureConnection objects attached to the file output that provided the data that is being written to the file.

    error

    If the file was not written successfully, an error object that describes the problem; otherwise nil.

    Discussion

    This method is called whenever a file is finished. If the file was forced to be finished due to an error, the error is described in the error parameter—otherwise, the error parameter is nil.

    This method is called when the file output has finished writing all data to a file whose recording was stopped, either because startRecordingToOutputFileURL:recordingDelegate: or stopRecording were called, or because an error (described by the error parameter), occurred (if no error occurred, the error parameter is nil).

    This method is always called for each recording request, even if no data is successfully written to the file.

    You should not assume that this method will be called on a specific thread.

    Import Statement

    import AVFoundation

    Availability

    Available in iOS 4.0 and later.