AVAudioRecorderDelegate Protocol Reference

Instance Methods

audioRecorderBeginInterruption:

Called when the audio session is interrupted during a recording, such as by an incoming phone call.

- (void)audioRecorderBeginInterruption:(AVAudioRecorder *)recorder

Parameters

recorder

The audio recorder whose recording was interrupted.

Discussion

Upon interruption, your application’s audio session is deactivated and the audio recorder pauses. You cannot use the audio recorder again until you receive a notification that the interruption has ended.

audioRecorderDidFinishRecording:successfully:

Called by the system when a recording is stopped or has finished due to reaching its time limit.

- (void)audioRecorderDidFinishRecording:(AVAudioRecorder *)recorder successfully:(BOOL)flag

Parameters

recorder

The audio recorder that has finished recording.

flag

TRUE on successful completion of recording; FALSE if recording stopped because of an audio encoding error.

Discussion

This method is not called by the system if the audio recorder stopped due to an interruption.

audioRecorderEncodeErrorDidOccur:error:

Called when an audio recorder encounters an encoding error during recording.

- (void)audioRecorderEncodeErrorDidOccur:(AVAudioRecorder *)recorder error:(NSError *)error

Parameters

recorder

The audio recorder that encountered the encoding error.

error

The encoding error.

audioRecorderEndInterruption:

Called when an interruption ends, such as by a user ignoring an incoming phone call.

- (void)audioRecorderEndInterruption:(AVAudioRecorder *)recorder

Parameters

recorder

The paused audio recorder whose interruption has ended.

Discussion

For an audio recorder’s delegate to receive this message, the audio recorder must have been recording when the interruption started. When an interruption ends, the audio session for your application is automatically reactivated, allowing your application to interact with the audio recorder. To resume recording, call the record method.