Tells the receiver to start recording to a new file of the specified format, and specifies a delegate that will be notified when recording is finished.
- macOS 10.7+
The URL of the output file.
This method throws an
invalidif the URL is not a valid file URL.
If a file at the given URL already exists when capturing starts, recording to the new file will fail.
A UTI indicating the format of the file to be written.
UTIs for common audio file types are declared in
An object conforming to the
File Output Recording Delegate
You must specify a delegate to be notified when recording is finished.
You do not need not to call
stop before calling this method while another recording is in progress. If this method is invoked while an existing output file was already being recorded, no media samples will be discarded between the old file and the new file.
When recording is stopped—by calling
stop, by changing files using this method, or because of an error—the remaining data that needs to be included to the file will be written in the background. Therefore, you must specify a delegate that will be notified when all data has been written to the file using the
file method. The recording delegate can also optionally implement methods that inform it when data starts being written, when recording is paused and resumed, and when recording is about to be finished.
In macOS, if this method is called within the
capture delegate method, the first samples written to the new file are guaranteed to be those contained in the sample buffer passed to that method.