apple.avfoundation.protocol

Interface AVCaptureFileOutputRecordingDelegate

public interface AVCaptureFileOutputRecordingDelegate

[@protocol] AVCaptureFileOutputRecordingDelegate

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

Method Summary

Modifier and Type	Method and Description
void	captureOutputDidFinishRecordingToOutputFileAtURLFromConnectionsError(AVCaptureFileOutput output, NSURL outputFileURL, NSArray<? extends AVCaptureConnection> connections, NSError error) captureOutput:didFinishRecordingToOutputFileAtURL:fromConnections:error:
default void	captureOutputDidStartRecordingToOutputFileAtURLFromConnections(AVCaptureFileOutput output, NSURL fileURL, NSArray<? extends AVCaptureConnection> connections) captureOutput:didStartRecordingToOutputFileAtURL:fromConnections:

Method Detail

captureOutputDidFinishRecordingToOutputFileAtURLFromConnectionsError

void captureOutputDidFinishRecordingToOutputFileAtURLFromConnectionsError(AVCaptureFileOutput output,
                                                                          NSURL outputFileURL,
                                                                          NSArray<? extends AVCaptureConnection> connections,
                                                                          NSError error)

captureOutput:didFinishRecordingToOutputFileAtURL:fromConnections:error:

Informs the delegate when all pending data has been written to an output file.

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 will be nil). This method will always be called for each recording request, even if no data is successfully written to the file.

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

Delegates are required to implement this method.

Parameters:

output - The capture file output that has finished writing the file.

outputFileURL - The file URL of the file that has been written.

connections - An array of AVCaptureConnection objects attached to the file output that provided the data that was written to the file.

error - An error describing what caused the file to stop recording, or nil if there was no error.

captureOutputDidStartRecordingToOutputFileAtURLFromConnections

default void captureOutputDidStartRecordingToOutputFileAtURLFromConnections(AVCaptureFileOutput output,
                                                                            NSURL fileURL,
                                                                            NSArray<? extends AVCaptureConnection> connections)

captureOutput:didStartRecordingToOutputFileAtURL:fromConnections:

Informs the delegate when the output has started writing to a file.

This method is called when the file output has started writing data to a file. 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: will always be called, even if no data is written.

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

Parameters:

output - 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.