Class Recorder

Definition

Namespace:

Tizen.Multimedia

Assembly:

Tizen.Multimedia.Recorder.dll

API Level:

3

Recorder is a base class for audio and video recorders that provides the ability to control the recording of a multimedia content.

Simple audio and audio/video are supported.

public abstract class Recorder : IDisposable

Inheritance

Object

Recorder

Derived

AudioRecorder

AudioRecorder

VideoRecorder

VideoRecorder

Implements

IDisposable

Properties

AudioBitRate

Gets or sets the bitrate of an audio encoder in bits per second.

Declaration

public int AudioBitRate { get; set; }

Property Value

Type	Description
Int32

Remarks

To set, the recorder must be in the Idle or the Ready state.

Exceptions

Type	Condition
ArgumentOutOfRangeException	value is less than or equal to zero.
InvalidOperationException	The recorder is not in the valid state.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

AudioChannels

Gets or sets the number of the audio channel.

Declaration

public int AudioChannels { get; set; }

Property Value

Type	Description
Int32	For mono recording, set the channel to 1. For stereo recording, set the channel to 2.

Remarks

To set, the recorder must be in the Idle or the Ready state.

Exceptions

Type	Condition
ArgumentOutOfRangeException	value is less than or equal to zero.
InvalidOperationException	The recorder is not in the valid state.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

AudioCodec

Gets the audio codec for encoding an audio stream.

Declaration

public RecorderAudioCodec AudioCodec { get; }

Property Value

Type	Description
RecorderAudioCodec

See Also

GetSupportedAudioCodecs()

API Level: 4

AudioDevice

Gets or sets the audio device for recording.

Declaration

public RecorderAudioDevice AudioDevice { get; set; }

Property Value

Type	Description
RecorderAudioDevice	A RecorderAudioDevice that specifies the type of the audio device.

Remarks

To set, the recorder must be in the Idle or the Ready state.

Exceptions

Type	Condition
ArgumentException	value is not valid.
InvalidOperationException	The recorder is not in the valid state.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

AudioSampleRate

Gets or sets the sampling rate of an audio stream in hertz.

Declaration

public int AudioSampleRate { get; set; }

Property Value

Type	Description
Int32

Remarks

To set, the recorder must be in the Idle or the Ready state.

Exceptions

Type	Condition
ArgumentOutOfRangeException	value is less than or equal to zero.
InvalidOperationException	The recorder is not in the valid state.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

FileFormat

Gets the file format of the recording result.

Declaration

public RecorderFileFormat FileFormat { get; }

Property Value

Type	Description
RecorderFileFormat

See Also

GetSupportedFileFormats()

API Level: 4

Muted

Gets or sets the mute state of a recorder.

Declaration

public bool Muted { get; set; }

Property Value

Type	Description
Boolean

Exceptions

Type	Condition
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

SizeLimit

Gets or sets the maximum size of a recording file.

Declaration

public int SizeLimit { get; set; }

Property Value

Type	Description
Int32	The maximum size of a recording file in kilobytes, or 0 for unlimited size.

Remarks

After reaching the limitation, the data which is being recorded will be discarded and will not be written to the file.

To set, the recorder must be in the Idle or the Ready state.

Exceptions

Type	Condition
ArgumentOutOfRangeException	value is less than zero.
InvalidOperationException	The recorder is not in the valid state.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

State

Gets the current state of the recorder.

Declaration

public RecorderState State { get; }

Property Value

Type	Description
RecorderState	A RecorderState that specifies the state of the recorder.

Exceptions

Type	Condition
ObjectDisposedException	The recorder already has been disposed of.

API Level: 3

TimeLimit

Gets or sets the time limit of recording.

Declaration

public int TimeLimit { get; set; }

Property Value

Type	Description
Int32	The time of recording in seconds, or 0 for unlimited time.

Remarks

After reaching the limitation, the data which is being recorded will be discarded and will not be written to the file.

To set, the recorder must be in the Idle or the Ready state.

Exceptions

Type	Condition
ArgumentOutOfRangeException	value is less than zero.
InvalidOperationException	The recorder is not in the valid state.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

Methods

ApplyAudioStreamPolicy(AudioStreamPolicy)

Apply the audio stream policy.

Declaration

public void ApplyAudioStreamPolicy(AudioStreamPolicy policy)

Parameters

Type	Name	Description
AudioStreamPolicy	policy	The policy to apply.

Remarks

The recorder must be in the Idle or the Ready state.

Exceptions

Type	Condition
ArgumentNullException	policy is null.
InvalidOperationException	The recorder is not in the valid state. -or- policy is not supported for the recorder. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of. -or- policy already has been disposed of.

API Level: 4

Cancel()

Cancels the recording.
The recording data is discarded and not written in the recording file.

Declaration

public void Cancel()

Remarks

The recorder must be in the Recording or the Paused state. The state of the recorder will be the Ready after the operation.

Exceptions

Type	Condition
InvalidOperationException	The recorder is not in the valid state. -or- The method is called in AudioStreamStoring event. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 3

Commit()

Stops recording and saves the result.

Declaration

public void Commit()

Remarks

The recorder must be in the Recording or the Paused state. The state of the recorder will be the Ready after the operation.

Exceptions

Type	Condition
InvalidOperationException	The recorder is not in the valid state. -or- The method is called in AudioStreamStoring event. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 3

Dispose()

Releases the unmanaged resources used by the Recorder.

Declaration

public void Dispose()

API Level: 3

Dispose(Boolean)

Releases the resources used by the Recorder.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	true to release both managed and unmanaged resources; false to release only unmanaged resources.

API Level: 3

GetDeviceState(RecorderType)

Returns the state of recorder device.

Declaration

public static RecorderDeviceState GetDeviceState(RecorderType type)

Parameters

Type	Name	Description
RecorderType	type

Returns

Type	Description
RecorderDeviceState

Exceptions

Type	Condition
ArgumentException	type is invalid.

API Level: 4

GetPeakAudioLevel()

Returns the peak audio input level in dB since the last call to this method.

Declaration

public double GetPeakAudioLevel()

Returns

Type	Description
Double

Remarks

0dB indicates the maximum input level, -300dB indicates the minimum input level.

The recorder must be in the Recording or the Paused state.

Exceptions

Type	Condition
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

GetSupportedAudioCodecs()

Gets the audio encoders that the current device supports.

Declaration

public static IEnumerable<RecorderAudioCodec> GetSupportedAudioCodecs()

Returns

Type	Description
IEnumerable<RecorderAudioCodec>

Exceptions

Type	Condition
NotSupportedException	A required feature is not supported.

API Level: 4

Feature: http://tizen.org/feature/media.audio_recording

GetSupportedFileFormats()

Gets the file formats that the current device supports.

Declaration

public static IEnumerable<RecorderFileFormat> GetSupportedFileFormats()

Returns

Type	Description
IEnumerable<RecorderFileFormat>

Exceptions

Type	Condition
NotSupportedException	A required feature is not supported.

API Level: 4

Feature: http://tizen.org/feature/media.audio_recording

Pause()

Pauses the recording.

Declaration

public void Pause()

Remarks

The recorder should be in the Recording state. The state of the recorder will be the Paused after this. It has no effect if the current state is the Paused.

Exceptions

Type	Condition
InvalidOperationException	The recorder is not in the valid state. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 3

Prepare()

Prepares the media recorder for recording.

Declaration

public void Prepare()

Remarks

The recorder should be in the Idle state. The state of the recorder will be the Ready after this. It has no effect if the current state is the Ready.

Exceptions

Type	Condition
InvalidOperationException	The recorder is not in the valid state. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 3

Resume()

Resumes the recording.

Declaration

public void Resume()

Remarks

The recorder should be in the Paused state. The state of recorder will be the Recording after this. It has no effect if the current state is the Recording.

Exceptions

Type	Condition
InvalidOperationException	The recorder is not in the valid state. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 4

Start(String)

Starts the recording.

Declaration

public void Start(string savePath)

Parameters

Type	Name	Description
String	savePath	The file path for recording result.

Remarks

The recorder must be in the Ready state. The state of the recorder will be the Recording after this.

If the specified path exists, the file is removed automatically and updated by new one.
The mediastorage privilege(http://tizen.org/privilege/mediastorage) is required if the path is relevant to media storage.
The externalstorage privilege(http://tizen.org/privilege/externalstorage) is required if the path is relevant to external storage.

In the video recorder, some preview format does not support record mode. You should use the default preview format or the Nv12 in the record mode.

Exceptions

Type	Condition
InvalidOperationException	The recorder is not in the valid state. -or- The preview format of the camera is not supported. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of.
ArgumentNullException	savePath is null.
ArgumentException	savePath is a zero-length string, contains only white space.
UnauthorizedAccessException	Caller does not have required privilege.

See Also

Commit()

Cancel()

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/recorder

Unprepare()

Resets the media recorder.

Declaration

public void Unprepare()

Remarks

The recorder should be in the Ready state. The state of recorder will be the Idle after this. It has no effect if the current state is the Idle.

Exceptions

Type	Condition
InvalidOperationException	The recorder is not in the valid state. -or- An internal error occurred.
ObjectDisposedException	The recorder already has been disposed of.

API Level: 3

Events

AudioStreamStoring

Occurs when the audio stream data is being delivered.

Declaration

public event EventHandler<AudioStreamStoringEventArgs> AudioStreamStoring

Event Type

Type	Description
EventHandler<AudioStreamStoringEventArgs>

Remarks

Do not call Commit() and Cancel() in this event.

API Level: 4

DeviceStateChanged

Occurs when a recorder device state changes.

Declaration

public static event EventHandler<RecorderDeviceStateChangedEventArgs> DeviceStateChanged

Event Type

Type	Description
EventHandler<RecorderDeviceStateChangedEventArgs>

API Level: 4

ErrorOccurred

Occurs when an error occurs during the recorder operation.

Declaration

public event EventHandler<RecordingErrorOccurredEventArgs> ErrorOccurred

Event Type

Type	Description
EventHandler<RecordingErrorOccurredEventArgs>

API Level: 3

Interrupted

Occurs after interrupt handling is completed.

Declaration

public event EventHandler<RecorderInterruptedEventArgs> Interrupted

Event Type

Type	Description
EventHandler<RecorderInterruptedEventArgs>

API Level: 3

Interrupting

Occurs before interrupt handling is started.

Declaration

public event EventHandler<RecorderInterruptingEventArgs> Interrupting

Event Type

Type	Description
EventHandler<RecorderInterruptingEventArgs>

API Level: 4

MuxedStreamDelivered

Occurs when the muxed stream data is being delivered.

Declaration

public event EventHandler<MuxedStreamDeliveredEventArgs> MuxedStreamDelivered

Event Type

Type	Description
EventHandler<MuxedStreamDeliveredEventArgs>

API Level: 3

RecordingLimitReached

Occurs when recording limit is reached.

Declaration

public event EventHandler<RecordingLimitReachedEventArgs> RecordingLimitReached

Event Type

Type	Description
EventHandler<RecordingLimitReachedEventArgs>

Remarks

After this event is raised, the recording data is discarded and not written in the recording file.

API Level: 3

RecordingStatusChanged

Occurs when the recording information changes.

Declaration

public event EventHandler<RecordingStatusChangedEventArgs> RecordingStatusChanged

Event Type

Type	Description
EventHandler<RecordingStatusChangedEventArgs>

API Level: 4

StateChanged

This event occurs when the recorder state is changed.

Declaration

public event EventHandler<RecorderStateChangedEventArgs> StateChanged

Event Type

Type	Description
EventHandler<RecorderStateChangedEventArgs>

API Level: 3

Implements

System.IDisposable