The Recorder API provides functions for audio and video recording.

Required Header

#include <recorder.h>

Overview

The Recorder API provides functions to control the recording of a multimedia content. Simple audio and audio/video are supported. Recording operations operate as a state machine, described below.

In addition, the API contains functions to configure the recording process, or find details about it, such as getting/setting the filename for the recording, the file format and the video codec. Some of these interfaces are listed in the Recorder Attributes API.

Additional functions allow registering notifications via callback functions for various state change events.

State Diagram

State Transitions

FUNCTION	PRE-STATE	POST-STATE	SYNC TYPE
recorder_create_videorecorder() recorder_create_audiorecorder()	NONE	CREATED	SYNC
recorder_destroy()	CREATED	NONE	SYNC
recorder_prepare()	CREATED	READY	SYNC
recorder_unprepare()	READY	CREATED	SYNC
recorder_start()	READY / PAUSED	RECORDING	SYNC
recorder_pause()	RECORDING	PAUSED	SYNC
recorder_cancel() recorder_commit()	RECORDING / PAUSED	READY	SYNC

Callback(Event) Operations

The callback mechanism is used to notify the application about significant recorder events.

REGISTER	UNREGISTER	CALLBACK	DESCRIPTION
recorder_set_recording_limit_reached_cb()	recorder_unset_recording_limit_reached_cb()	recorder_recording_limit_reached_cb()	This callback is called when recording limitation error has occurred during recording.
recorder_set_recording_status_cb()	recorder_unset_recording_status_cb()	recorder_recording_status_cb()	This callback is used to notify the recording status.
recorder_set_state_changed_cb()	recorder_unset_state_changed_cb()	recorder_state_changed_cb()	This callback is used to notify the change of recorder's state.

Foreach Operations

FOREACH	CALLBACK	DESCRIPTION
recorder_foreach_supported_file_format()	recorder_supported_file_format_cb()	Supported file format
recorder_foreach_supported_audio_encoder()	recorder_supported_audio_encoder_cb()	Supported audio encoder
recorder_foreach_supported_video_encoder()	recorder_supported_video_encoder_cb()	Supported video encoder

Related Features

This API is related with the following features:

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

It is recommended to design feature related codes in your application for reliability.
You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on featuring your application can be found from Feature Element.

Functions
int	recorder_create_videorecorder (camera_h camera, recorder_h *recorder)
	Creates a recorder handle to record a video.
int	recorder_create_audiorecorder (recorder_h *recorder)
	Creates a recorder handle to record an audio.
int	recorder_destroy (recorder_h recorder)
	Destroys the recorder handle.
int	recorder_prepare (recorder_h recorder)
	Prepares the media recorder for recording.
int	recorder_unprepare (recorder_h recorder)
	Resets the media recorder.
int	recorder_start (recorder_h recorder)
	Starts the recording.
int	recorder_pause (recorder_h recorder)
	Pauses the recording.
int	recorder_commit (recorder_h recorder)
	Stops recording and saves the result.
int	recorder_cancel (recorder_h recorder)
	Cancels the recording.
int	recorder_get_state (recorder_h recorder, recorder_state_e *state)
	Gets the recorder's current state.
int	recorder_get_audio_level (recorder_h recorder, double *dB)
	Gets the peak audio input level that was sampled since the last call to this function.
int	recorder_set_filename (recorder_h recorder, const char *path)
	Sets the file path to record.
int	recorder_get_filename (recorder_h recorder, char **path)
	Gets the file path to record.
int	recorder_set_file_format (recorder_h recorder, recorder_file_format_e format)
	Sets the file format for recording media stream.
int	recorder_get_file_format (recorder_h recorder, recorder_file_format_e *format)
	Gets the file format for recording media stream.
int	recorder_set_sound_stream_info (recorder_h recorder, sound_stream_info_h stream_info)
	Sets the recorder's sound manager stream information.
int	recorder_set_audio_encoder (recorder_h recorder, recorder_audio_codec_e codec)
	Sets the audio codec for encoding an audio stream.
int	recorder_get_audio_encoder (recorder_h recorder, recorder_audio_codec_e *codec)
	Gets the audio codec for encoding an audio stream.
int	recorder_set_video_resolution (recorder_h recorder, int width, int height)
	Sets the resolution of the video recording.
int	recorder_get_video_resolution (recorder_h recorder, int width, int height)
	Gets the resolution of the video recording.
int	recorder_set_video_encoder (recorder_h recorder, recorder_video_codec_e codec)
	Sets the video codec for encoding video stream.
int	recorder_get_video_encoder (recorder_h recorder, recorder_video_codec_e *codec)
	Gets the video codec for encoding video stream.
int	recorder_set_state_changed_cb (recorder_h recorder, recorder_state_changed_cb callback, void *user_data)
	Registers the callback function that will be invoked when the recorder state changes.
int	recorder_unset_state_changed_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_interrupted_cb (recorder_h recorder, recorder_interrupted_cb callback, void *user_data)
	Registers a callback function to be called when the media recorder is interrupted according to a policy.
int	recorder_unset_interrupted_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_interrupt_started_cb (recorder_h recorder, recorder_interrupt_started_cb callback, void *user_data)
	Registers a callback function to be called when the media recorder interrupt is started according to a policy.
int	recorder_unset_interrupt_started_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_audio_stream_cb (recorder_h recorder, recorder_audio_stream_cb callback, void *user_data)
	Registers a callback function to be called when audio stream data is being delivered.
int	recorder_unset_audio_stream_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_muxed_stream_cb (recorder_h recorder, recorder_muxed_stream_cb callback, void *user_data)
	Registers a callback function to be called when muxed stream data is delivered.
int	recorder_unset_muxed_stream_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_video_encode_decision_cb (recorder_h recorder, recorder_video_encode_decision_cb callback, void *user_data)
	Registers a callback function to be called when each video frame is delivered before encoding.
int	recorder_unset_video_encode_decision_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_recording_status_cb (recorder_h recorder, recorder_recording_status_cb callback, void *user_data)
	Registers a callback function to be invoked when the recording information changes.
int	recorder_unset_recording_status_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_recording_limit_reached_cb (recorder_h recorder, recorder_recording_limit_reached_cb callback, void *user_data)
	Registers the callback function to be run when reached the recording limit.
int	recorder_unset_recording_limit_reached_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_set_error_cb (recorder_h recorder, recorder_error_cb callback, void *user_data)
	Registers a callback function to be called when an asynchronous operation error occurred.
int	recorder_unset_error_cb (recorder_h recorder)
	Unregisters the callback function.
int	recorder_get_device_state (recorder_type_e type, recorder_device_state_e *state)
	Gets the state of recorder device.
int	recorder_add_device_state_changed_cb (recorder_device_state_changed_cb callback, void user_data, int cb_id)
	Registers a callback function to be called when the recorder device state changes.
int	recorder_remove_device_state_changed_cb (int cb_id)
	Unregisters a callback function.
Typedefs
typedef struct recorder_s *	recorder_h
	The Media recorder handle.
typedef camera_preview_data_s	recorder_video_data_s
	The structure type to contain video stream data.
typedef void(*	recorder_recording_limit_reached_cb )(recorder_recording_limit_type_e type, void *user_data)
	Called when limitation error occurs while recording.
typedef void(*	recorder_recording_status_cb )(unsigned long long elapsed_time, unsigned long long file_size, void *user_data)
	Called to indicate the recording status.
typedef void(*	recorder_state_changed_cb )(recorder_state_e previous, recorder_state_e current, bool by_policy, void *user_data)
	Called when the record state is changed.
typedef void(*	recorder_device_state_changed_cb )(recorder_type_e type, recorder_device_state_e state, void *user_data)
	Called when the recorder device state is changed.
typedef void(*	recorder_interrupted_cb )(recorder_policy_e policy, recorder_state_e previous, recorder_state_e current, void *user_data)
	Called when the recorder is interrupted by a policy.
typedef void(*	recorder_interrupt_started_cb )(recorder_policy_e policy, recorder_state_e state, void *user_data)
	Called when the recorder interrupt is started by a policy.
typedef void(*	recorder_audio_stream_cb )(void stream, int size, audio_sample_type_e format, int channel, unsigned int timestamp, void user_data)
	Called when audio stream data was being delivered just before storing in the recorded file.
typedef void(*	recorder_muxed_stream_cb )(void stream, int size, unsigned long long offset, void user_data)
	Called when muxed stream data is delivered just before writing to the file.
typedef bool(*	recorder_video_encode_decision_cb )(recorder_video_data_s frame, void user_data)
	Called when each video frame is delivered before encoding, and it will be encoded if the application returns `true`, otherwise dropped.
typedef bool(*	recorder_supported_video_resolution_cb )(int width, int height, void *user_data)
	Called once for each supported video resolution.
typedef void(*	recorder_error_cb )(recorder_error_e error, recorder_state_e current_state, void *user_data)
	Called when the error occurred.

Typedef Documentation

typedef void(* recorder_audio_stream_cb)(void *stream, int size, audio_sample_type_e format, int channel, unsigned int timestamp, void *user_data)

Called when audio stream data was being delivered just before storing in the recorded file.

Since :: 2.3

Remarks:: The callback function holds the same buffer that will be recorded.
So if the user changes the buffer, the result file will contain the buffer.; The callback is called via internal thread of Frameworks, therefore do not invoke UI API, recorder_unprepare(), recorder_commit() and recorder_cancel() in callback.

Parameters:

[in]	stream	The audio stream data
[in]	size	The size of the stream data
[in]	format	The audio format
[in]	channel	The number of the channel
[in]	timestamp	The timestamp of the stream buffer (in msec)
[in]	user_data	The user data passed from the callback registration function

See also:: recorder_set_audio_stream_cb()

typedef void(* recorder_device_state_changed_cb)(recorder_type_e type, recorder_device_state_e state, void *user_data)

Called when the recorder device state is changed.

Since :: 3.0

Parameters:

[in]	type	The recorder type
[in]	state	The state of the recorder device
[in]	user_data	The user data passed from the callback registration function

See also:: recorder_add_device_state_changed_cb()

typedef void(* recorder_error_cb)(recorder_error_e error, recorder_state_e current_state, void *user_data)

Called when the error occurred.

Since :: 2.3

Remarks:: This callback informs about the critical error situation.
When being invoked, user should release the resource and terminate the application.
This error code will be reported. RECORDER_ERROR_DEVICE
RECORDER_ERROR_INVALID_OPERATION
RECORDER_ERROR_OUT_OF_MEMORY.

Parameters:

[in]	error	The error code
[in]	current_state	The current state of the recorder
[in]	user_data	The user data passed from the callback registration function

Precondition:: This callback function is invoked if you register this callback using recorder_set_error_cb().

See also:: recorder_set_error_cb(); recorder_unset_error_cb()

typedef struct recorder_s* recorder_h

The Media recorder handle.

Since :: 2.3

typedef void(* recorder_interrupt_started_cb)(recorder_policy_e policy, recorder_state_e state, void *user_data)

Called when the recorder interrupt is started by a policy.

Since :: 4.0

Remarks:: This callback is called before interrupt handling is started.

Parameters:

[in]	policy	The policy that is interrupting the recorder
[in]	state	The current state of the recorder
[in]	user_data	The user data passed from the callback registration function

See also:: recorder_set_interrupt_started_cb()

typedef void(* recorder_interrupted_cb)(recorder_policy_e policy, recorder_state_e previous, recorder_state_e current, void *user_data)

Called when the recorder is interrupted by a policy.

Since :: 2.3

Remarks:: This callback is called after interrupt handling is completed.

Parameters:

[in]	policy	The policy that interrupted the recorder
[in]	previous	The previous state of the recorder
[in]	current	The current state of the recorder
[in]	user_data	The user data passed from the callback registration function

See also:: recorder_set_interrupted_cb()

typedef void(* recorder_muxed_stream_cb)(void *stream, int size, unsigned long long offset, void *user_data)

Called when muxed stream data is delivered just before writing to the file.

Since :: 4.0

Remarks:: This callback receives the data that will be recorded,
but any changes to this data will not affect the recorded file.
The stream should not be freed and it's valid only in the callback. To use outside the callback, make a copy.

Parameters:

[in]	stream	The muxed stream data
[in]	size	The size of the stream data
[in]	offset	The offset of the stream data
[in]	user_data	The user data passed from the callback registration function

See also:: recorder_set_muxed_stream_cb()

typedef void(* recorder_recording_limit_reached_cb)(recorder_recording_limit_type_e type, void *user_data)

Called when limitation error occurs while recording.

The callback function is possible to receive three types of limits: time, size and no-space.

Since :: 2.3

Remarks:: After being called, recording data is discarded and not written in the recording file. Also the state of recorder is not changed.

Parameters:

[in]	type	The imitation type
[in]	user_data	The user data passed from the callback registration function

Precondition:: You have to register a callback using recorder_set_recording_limit_reached_cb().

See also:: recorder_set_recording_status_cb(); recorder_set_recording_limit_reached_cb(); recorder_unset_recording_limit_reached_cb()

typedef void(* recorder_recording_status_cb)(unsigned long long elapsed_time, unsigned long long file_size, void *user_data)

Called to indicate the recording status.

Since :: 2.3

Remarks:: This callback function is repeatedly invoked during the RECORDER_STATE_RECORDING state.

Parameters:

[in]	elapsed_time	The time of the recording (milliseconds)
[in]	file_size	The size of the recording file (KB)
[in]	user_data	The user data passed from the callback registration function

Precondition:: recorder_start() will invoke this callback if you register it using recorder_set_recording_status_cb().

See also:: recorder_set_recording_status_cb(); recorder_unset_recording_status_cb(); recorder_start()

typedef void(* recorder_state_changed_cb)(recorder_state_e previous, recorder_state_e current, bool by_policy, void *user_data)

Called when the record state is changed.

Since :: 2.3

Parameters:

[in]	previous	The previous state of the recorder
[in]	current	The current state of the recorder
[in]	by_policy	`true` if the state is changed by policy, otherwise `false` if the state is not changed
[in]	user_data	The user data passed from the callback registration function

Precondition:: This function is required to register a callback using recorder_set_state_changed_cb().

See also:: recorder_set_state_changed_cb(); recorder_prepare(); recorder_unprepare(); recorder_start(); recorder_pause(); recorder_commit(); recorder_cancel()

typedef bool(* recorder_supported_video_resolution_cb)(int width, int height, void *user_data)

Called once for each supported video resolution.

Since :: 2.3

Parameters:

[in]	width	The video image width
[in]	height	The video image height
[in]	user_data	The user data passed from the foreach function

Returns:: true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:: recorder_foreach_supported_video_resolution() will invoke this callback.

See also:: recorder_foreach_supported_video_resolution()

typedef camera_preview_data_s recorder_video_data_s

The structure type to contain video stream data.

Since :: 6.0

typedef bool(* recorder_video_encode_decision_cb)(recorder_video_data_s *frame, void *user_data)

Called when each video frame is delivered before encoding,
and it will be encoded if the application returns true, otherwise dropped.

Since :: 6.0

Remarks:: This function is issued in the context of internal framework so the UI update code should not be directly invoked.; The frame should not be released and it's available until the callback returns.

Parameters:

[in]	frame	The reference pointer to video stream data
[in]	user_data	The user data passed from the callback registration function

See also:: recorder_set_video_encode_decision_cb()

Enumeration Type Documentation

enum recorder_audio_codec_e

Enumeration for the audio codec.

Since :: 2.3

Enumerator:

RECORDER_AUDIO_CODEC_DISABLE	Disable audio track
RECORDER_AUDIO_CODEC_AMR	AMR codec
RECORDER_AUDIO_CODEC_AAC	AAC codec
RECORDER_AUDIO_CODEC_VORBIS	Vorbis codec
RECORDER_AUDIO_CODEC_PCM	PCM codec
RECORDER_AUDIO_CODEC_MP3	MP3 codec (Since 3.0)

enum recorder_audio_device_e

Enumeration for audio capture devices.

Since :: 2.3

Enumerator:

RECORDER_AUDIO_DEVICE_MIC	Mic device
RECORDER_AUDIO_DEVICE_MODEM	Modem

enum recorder_device_state_e

Enumeration for the recorder device state.

Since :: 3.0

Enumerator:

RECORDER_DEVICE_STATE_IDLE	No recording in progress
RECORDER_DEVICE_STATE_RECORDING	Now recording
RECORDER_DEVICE_STATE_PAUSED	All recordings are paused

enum recorder_error_e

Enumeration for error code of the media recorder.

Since :: 2.3

Enumerator:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_OUT_OF_MEMORY	Out of memory
RECORDER_ERROR_DEVICE	Device error
RECORDER_ERROR_INVALID_OPERATION	Internal error
RECORDER_ERROR_SECURITY_RESTRICTED	Restricted by security system policy
RECORDER_ERROR_ESD	ESD situation
RECORDER_ERROR_OUT_OF_STORAGE	Out of storage
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_RESOURCE_CONFLICT	Blocked by resource conflict (Since 3.0)
RECORDER_ERROR_SERVICE_DISCONNECTED	Socket connection lost (Since 3.0)

enum recorder_file_format_e

Enumeration for the file container format.

Since :: 2.3

Enumerator:

RECORDER_FILE_FORMAT_3GP	3GP file format
RECORDER_FILE_FORMAT_MP4	MP4 file format
RECORDER_FILE_FORMAT_AMR	AMR file format
RECORDER_FILE_FORMAT_ADTS	ADTS file format
RECORDER_FILE_FORMAT_WAV	WAV file format
RECORDER_FILE_FORMAT_OGG	OGG file format
RECORDER_FILE_FORMAT_M2TS	MPEG2-TransportStream file format (Since 3.0)

enum recorder_policy_e

Enumeration for the recorder policy.

Since :: 2.3

Enumerator:

RECORDER_POLICY_NONE	None
RECORDER_POLICY_SECURITY	Security policy
RECORDER_POLICY_RESOURCE_CONFLICT	Resource conflict (Since 3.0)

enum recorder_recording_limit_type_e

Enumeration for the recording limit.

Since :: 2.3

Enumerator:

RECORDER_RECORDING_LIMIT_TIME	Time limit (second) of recording file
RECORDER_RECORDING_LIMIT_SIZE	Size limit (kilo bytes [KB]) of recording file
RECORDER_RECORDING_LIMIT_FREE_SPACE	No free space in storage

enum recorder_rotation_e

Enumeration for the recorder rotation type.

Since :: 2.3

Enumerator:

RECORDER_ROTATION_NONE	No rotation
RECORDER_ROTATION_90	90 degree rotation
RECORDER_ROTATION_180	180 degree rotation
RECORDER_ROTATION_270	270 degree rotation

enum recorder_state_e

Enumeration for recorder states.

Since :: 2.3

Enumerator:

RECORDER_STATE_NONE	Recorder is not created
RECORDER_STATE_CREATED	Recorder is created, but not prepared
RECORDER_STATE_READY	Recorder is ready to record In case of video recorder, preview display will be shown
RECORDER_STATE_RECORDING	Recorder is recording media
RECORDER_STATE_PAUSED	Recorder is paused while recording media

enum recorder_type_e

Enumeration for the recorder type.

Since :: 3.0

Enumerator:

RECORDER_TYPE_AUDIO	Audio only recorder
RECORDER_TYPE_VIDEO	Video recorder (audio is optional)

enum recorder_video_codec_e

Enumeration for the video codec.

Since :: 2.3

Enumerator:

RECORDER_VIDEO_CODEC_H263	H263 codec
RECORDER_VIDEO_CODEC_H264	H264 codec
RECORDER_VIDEO_CODEC_MPEG4	MPEG4 codec
RECORDER_VIDEO_CODEC_THEORA	Theora codec

Function Documentation

int recorder_add_device_state_changed_cb	(	recorder_device_state_changed_cb	callback,
		void *	user_data,
		int *	cb_id
	)

Registers a callback function to be called when the recorder device state changes.

Since :: 3.0

Parameters:

[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function
[out]	cb_id	The id of the registered callback

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_OUT_OF_MEMORY	Out of memory
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

Postcondition:: This function will invoke recorder_device_state_changed_cb() when the recorder device's state changes.

See also:: recorder_remove_device_state_changed_cb(); recorder_device_state_changed_cb()

int recorder_cancel ( recorder_h recorder )

Cancels the recording.

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

Since :: 2.3

Privilege Level:: public

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

Remarks:: When you want to record audio or video file, you need to add privilege according to rules below additionally.
If you want to save contents to internal storage, you should add mediastorage privilege.
If you want to save contents to external storage, you should add externalstorage privilege.

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_RECORDING set by recorder_start() or RECORDER_STATE_PAUSED by recorder_pause().

Postcondition:: The recorder state will be RECORDER_STATE_READY.

See also:: recorder_pause(); recorder_commit(); recorder_cancel(); recorder_start()

int recorder_commit ( recorder_h recorder )

Stops recording and saves the result.

Since :: 2.3

Privilege Level:: public

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

Remarks:: When you want to record audio or video file, you need to add privilege according to rules below additionally.
If you want to save contents to internal storage, you should add mediastorage privilege.
If you want to save contents to external storage, you should add externalstorage privilege.

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_RECORDING set by recorder_start() or RECORDER_STATE_PAUSED by recorder_pause().

Postcondition:: The recorder state will be RECORDER_STATE_READY.

See also:: recorder_pause(); recorder_cancel(); recorder_set_filename(); recorder_start()

int recorder_create_audiorecorder ( recorder_h * recorder )

Creates a recorder handle to record an audio.

Since :: 2.3

Remarks:: You must release recorder using recorder_destroy().; The privilege http://tizen.org/privilege/recorder is not required since 4.0,
but it is required in all earlier versions.; Since 4.0, It's related to the following feature: http://tizen.org/feature/media.audio_recording
instead of using http://tizen.org/feature/microphone

Parameters:

[out] recorder A handle to the recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_OUT_OF_MEMORY	Out of memory
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

Postcondition:: The recorder state will be RECORDER_STATE_CREATED.

See also:: recorder_destroy()

int recorder_create_videorecorder	(	camera_h	camera,
		recorder_h *	recorder
	)

Creates a recorder handle to record a video.

Since :: 2.3

Remarks:: You must release recorder using recorder_destroy().
The camera handle also could be used for capturing images.
If the camera state was CAMERA_STATE_CREATED, the preview format will be changed to the recommended preview format for recording.; The created recorder state will be different according to camera state :
CAMERA_STATE_CREATED -> RECORDER_STATE_CREATED
CAMERA_STATE_PREVIEW -> RECORDER_STATE_READY
CAMERA_STATE_CAPTURED -> RECORDER_STATE_READY; The privilege http://tizen.org/privilege/recorder is not required since 4.0,
but it is required in all earlier versions.; Since 4.0, It's related to the following feature: http://tizen.org/feature/media.video_recording
instead of using http://tizen.org/feature/microphone

Parameters:

[in]	camera	The handle to the camera
[out]	recorder	A handle to the recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_OUT_OF_MEMORY	Out of memory
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

See also:: camera_create(); camera_stop_preview(); recorder_destroy()

int recorder_destroy ( recorder_h recorder )

Destroys the recorder handle.

Since :: 2.3

Remarks:: The video recorder's camera handle is not released by this function.

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

Precondition:: The recorder state should be RECORDER_STATE_CREATED.

Postcondition:: The recorder state will be RECORDER_STATE_NONE.

See also:: camera_destroy(); recorder_create_videorecorder(); recorder_create_audiorecorder()

int recorder_get_audio_encoder	(	recorder_h	recorder,
		recorder_audio_codec_e *	codec
	)

Gets the audio codec for encoding an audio stream.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[out]	codec	The audio codec

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_audio_encoder(); recorder_foreach_supported_audio_encoder()

int recorder_get_audio_level	(	recorder_h	recorder,
		double *	dB
	)

Gets the peak audio input level that was sampled since the last call to this function.

Since :: 2.3

Remarks:: 0 dB indicates maximum input level, -300 dB indicates minimum input level.

Parameters:

[in]	recorder	The handle to the media recorder
[out]	dB	The audio input level in dB

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_RECORDING or RECORDER_STATE_PAUSED.

int recorder_get_device_state	(	recorder_type_e	type,
		recorder_device_state_e *	state
	)

Gets the state of recorder device.

Since :: 3.0

Parameters:

[in]	type	The recorder type
[out]	state	The current state of the device

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

int recorder_get_file_format	(	recorder_h	recorder,
		recorder_file_format_e *	format
	)

Gets the file format for recording media stream.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[out]	format	The media file format

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_file_format(); recorder_foreach_supported_file_format()

int recorder_get_filename	(	recorder_h	recorder,
		char **	path
	)

Gets the file path to record.

Since :: 2.3

Remarks:: You must release path using free().

Parameters:

[in]	recorder	The handle to the media recorder
[out]	path	The recording file path

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_filename()

int recorder_get_state	(	recorder_h	recorder,
		recorder_state_e *	state
	)

Gets the recorder's current state.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[out]	state	The current state of the recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

int recorder_get_video_encoder	(	recorder_h	recorder,
		recorder_video_codec_e *	codec
	)

Gets the video codec for encoding video stream.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[out]	codec	The video codec

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_video_encoder(); recorder_foreach_supported_video_encoder()

int recorder_get_video_resolution	(	recorder_h	recorder,
		int *	width,
		int *	height
	)

Gets the resolution of the video recording.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[out]	width	The video width
[out]	height	The video height

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_video_resolution(); recorder_foreach_supported_video_resolution()

int recorder_pause ( recorder_h recorder )

Pauses the recording.

Since :: 2.3

Privilege Level:: public

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

Remarks:: Recording can be resumed with recorder_start().

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_RECORDING.

Postcondition:: The recorder state will be RECORDER_STATE_PAUSED.

See also:: recorder_start(); recorder_commit(); recorder_cancel()

int recorder_prepare ( recorder_h recorder )

Prepares the media recorder for recording.

Since :: 2.3

Remarks:: Before calling the function, it is required to properly set audio encoder (recorder_set_audio_encoder()), video encoder(recorder_set_video_encoder()) and file format (recorder_set_file_format()).

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_RESOURCE_CONFLICT	Resource conflict error
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state should be RECORDER_STATE_CREATED by recorder_create_videorecorder(), recorder_create_audiorecorder() or recorder_unprepare().

Postcondition:: The recorder state will be RECORDER_STATE_READY.; If recorder handle is created by recorder_create_videorecorder(), the camera state will be changed to CAMERA_STATE_PREVIEW.

See also:: recorder_create_videorecorder(); recorder_create_audiorecorder(); recorder_unprepare(); recorder_set_audio_encoder(); recorder_set_video_encoder(); recorder_set_file_format()

int recorder_remove_device_state_changed_cb ( int cb_id )

Unregisters a callback function.

Since :: 3.0

Parameters:

[in] cb_id The id of the registered callback

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

See also:: recorder_add_device_state_changed_cb()

int recorder_set_audio_encoder	(	recorder_h	recorder,
		recorder_audio_codec_e	codec
	)

Sets the audio codec for encoding an audio stream.

Since :: 2.3

Remarks:: You can get available audio encoders by using recorder_foreach_supported_audio_encoder().
If set to RECORDER_AUDIO_CODEC_DISABLE, the audio track is not created in recording files.
Since 2.3.1, it could be returned RECORDER_ERROR_INVALID_OPERATION
when it's audio recorder and its state is RECORDER_STATE_READY
because of checking codec compatibility with current file format.

Parameters:

[in]	recorder	The handle to the media recorder
[in]	codec	The audio codec

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_INVALID_OPERATION	Invalid operation (Since 2.3.1)
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_CREATED or RECORDER_STATE_READY.

See also:: recorder_get_audio_encoder(); recorder_foreach_supported_audio_encoder()

int recorder_set_audio_stream_cb	(	recorder_h	recorder,
		recorder_audio_stream_cb	callback,
		void *	user_data
	)

Registers a callback function to be called when audio stream data is being delivered.

Since :: 2.3

Remarks:: This callback function holds the same buffer that will be recorded.
Therefore if an user changes the buffer, the result file will have the buffer.; The callback is called via internal thread of Frameworks. Therefore do not invoke UI API, recorder_unprepare(), recorder_commit() and recorder_cancel() in callback.
This callback function to be called in RECORDER_STATE_RECORDING and RECORDER_STATE_PAUSED state.

Parameters:

[in]	recorder	The handle to the recorder
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state should be RECORDER_STATE_READY or RECORDER_STATE_CREATED.

See also:: recorder_unset_audio_stream_cb(); recorder_audio_stream_cb()

int recorder_set_error_cb	(	recorder_h	recorder,
		recorder_error_cb	callback,
		void *	user_data
	)

Registers a callback function to be called when an asynchronous operation error occurred.

Since :: 2.3

Remarks:: This callback informs critical error situation.
When this callback is invoked, user should release the resource and terminate the application.
These error codes will occur.
RECORDER_ERROR_DEVICE
RECORDER_ERROR_INVALID_OPERATION
RECORDER_ERROR_OUT_OF_MEMORY

Parameters:

[in]	recorder	The handle to the recorder
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Postcondition:: This function will invoke recorder_error_cb() when an asynchronous operation error occur.

See also:: recorder_unset_error_cb(); recorder_error_cb()

int recorder_set_file_format	(	recorder_h	recorder,
		recorder_file_format_e	format
	)

Sets the file format for recording media stream.

Since :: 2.3

Remarks:: Since 2.3.1, it could be returned RECORDER_ERROR_INVALID_OPERATION
when it's audio recorder and its state is RECORDER_STATE_READY
because of checking codec compatibility with current encoder.

Parameters:

[in]	recorder	The handle to the media recorder
[in]	format	The media file format

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_INVALID_OPERATION	Invalid operation (Since 2.3.1)
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_CREATED or RECORDER_STATE_READY (for video recorder only).
Since 2.3.1, this API also works for audio recorder when its state is RECORDER_STATE_READY.

See also:: recorder_get_file_format(); recorder_foreach_supported_file_format()

int recorder_set_filename	(	recorder_h	recorder,
		const char *	path
	)

Sets the file path to record.

This function sets file path which defines where newly recorded data should be stored.

Since :: 2.3

Remarks:: If the same file already exists in the file system, then old file will be overwritten.

Parameters:

[in]	recorder	The handle to the media recorder
[in]	path	The recording file path

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_CREATED or RECORDER_STATE_READY.

See also:: recorder_get_filename()

int recorder_set_interrupt_started_cb	(	recorder_h	recorder,
		recorder_interrupt_started_cb	callback,
		void *	user_data
	)

Registers a callback function to be called when the media recorder interrupt is started according to a policy.

Since :: 4.0

Parameters:

[in]	recorder	The handle to the media recorder
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: recorder_unset_interrupt_started_cb(); recorder_interrupt_started_cb()

int recorder_set_interrupted_cb	(	recorder_h	recorder,
		recorder_interrupted_cb	callback,
		void *	user_data
	)

Registers a callback function to be called when the media recorder is interrupted according to a policy.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_unset_interrupted_cb(); recorder_interrupted_cb()

int recorder_set_muxed_stream_cb	(	recorder_h	recorder,
		recorder_muxed_stream_cb	callback,
		void *	user_data
	)

Registers a callback function to be called when muxed stream data is delivered.

Since :: 4.0

Remarks:: This callback receives the data that will be recorded,
but any changes to this data will not affect the recorded file.

Parameters:

[in]	recorder	The handle to the recorder
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state

Precondition:: The recorder state should be RECORDER_STATE_READY or RECORDER_STATE_CREATED.

See also:: recorder_unset_muxed_stream_cb(); recorder_muxed_stream_cb()

int recorder_set_recording_limit_reached_cb	(	recorder_h	recorder,
		recorder_recording_limit_reached_cb	callback,
		void *	user_data
	)

Registers the callback function to be run when reached the recording limit.

Since :: 2.3

Parameters:

[in]	recorder	The handle to media recorder
[in]	callback	The function pointer of user callback
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Postcondition:: recorder_recording_limit_reached_cb() will be invoked.

See also:: recorder_unset_recording_limit_reached_cb(); recorder_attr_set_size_limit(); recorder_attr_set_time_limit(); recorder_recording_limit_reached_cb()

int recorder_set_recording_status_cb	(	recorder_h	recorder,
		recorder_recording_status_cb	callback,
		void *	user_data
	)

Registers a callback function to be invoked when the recording information changes.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[in]	callback	The function pointer of user callback
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Postcondition:: recorder_recording_status_cb() will be invoked.

See also:: recorder_unset_recording_status_cb(); recorder_recording_status_cb()

int recorder_set_sound_stream_info	(	recorder_h	recorder,
		sound_stream_info_h	stream_info
	)

Sets the recorder's sound manager stream information.

Since :: 3.0

Remarks:: You can set sound stream information including audio routing. For more details, please refer to Sound Manager

Parameters:

[in]	recorder	The handle to the media recorder
[in]	stream_info	The sound manager info

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_INVALID_OPERATION	Invalid operation

Precondition:: The recorder state must be RECORDER_STATE_CREATED or RECORDER_STATE_READY

See also:: sound_stream_info_h; sound_manager_create_stream_information(); sound_manager_destroy_stream_information()

int recorder_set_state_changed_cb	(	recorder_h	recorder,
		recorder_state_changed_cb	callback,
		void *	user_data
	)

Registers the callback function that will be invoked when the recorder state changes.

Since :: 2.3

Parameters:

[in]	recorder	The handle to the media recorder
[in]	callback	The function pointer of user callback
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Postcondition:: recorder_state_changed_cb() will be invoked.

See also:: recorder_unset_state_changed_cb(); recorder_state_changed_cb()

int recorder_set_video_encode_decision_cb	(	recorder_h	recorder,
		recorder_video_encode_decision_cb	callback,
		void *	user_data
	)

Registers a callback function to be called when each video frame is delivered before encoding.

Since :: 6.0

Remarks:: The audio stream will be disabled by force if callback is set.

Parameters:

[in]	recorder	The handle to the recorder
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

Precondition:: The recorder state should be RECORDER_STATE_READY or RECORDER_STATE_CREATED.

Postcondition:: The callback will be invoked when each video frame is delivered before encoding,
and it will be encoded if the callback returns true, otherwise dropped.

See also:: recorder_unset_video_encode_decision_cb(); recorder_video_encode_decision_cb()

int recorder_set_video_encoder	(	recorder_h	recorder,
		recorder_video_codec_e	codec
	)

Sets the video codec for encoding video stream.

Since :: 2.3

Remarks:: You can get available video encoders by using recorder_foreach_supported_video_encoder().

Parameters:

[in]	recorder	The handle to the media recorder
[in]	codec	The video codec

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_CREATED or RECORDER_STATE_READY.

See also:: recorder_get_video_encoder(); recorder_foreach_supported_video_encoder()

int recorder_set_video_resolution	(	recorder_h	recorder,
		int	width,
		int	height
	)

Sets the resolution of the video recording.

Since :: 2.3

Remarks:: This function should be called before recording (recorder_start()).

Parameters:

[in]	recorder	The handle to the media recorder
[in]	width	The video width
[in]	height	The video height

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_CREATED or RECORDER_STATE_READY.

See also:: recorder_start(); recorder_get_video_resolution(); recorder_foreach_supported_video_resolution()

int recorder_start ( recorder_h recorder )

Starts the recording.

Since :: 2.3

Privilege Level:: public

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

Remarks:: If file path has been set to an existing file, this file is removed automatically and updated by new one.
In the video recorder, some preview format does not support record mode. It will return RECORDER_ERROR_INVALID_OPERATION error.
You should use default preview format or CAMERA_PIXEL_FORMAT_NV12 in the record mode.
When you want to record audio or video file, you need to add privilege according to rules below additionally.
If you want to save contents to internal storage, you should add mediastorage privilege.
If you want to save contents to external storage, you should add externalstorage privilege.
The filename should be set before this function is invoked.

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state must be RECORDER_STATE_READY by recorder_prepare() or RECORDER_STATE_PAUSED by recorder_pause().
The filename should be set by recorder_set_filename().

Postcondition:: The recorder state will be RECORDER_STATE_RECORDING.

See also:: recorder_pause(); recorder_commit(); recorder_cancel(); recorder_set_audio_encoder(); recorder_set_filename(); recorder_set_file_format(); recorder_recording_status_cb(); recorder_set_filename()

int recorder_unprepare ( recorder_h recorder )

Resets the media recorder.

Since :: 2.3

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

Precondition:: The recorder state should be RECORDER_STATE_READY set by recorder_prepare(), recorder_cancel() or recorder_commit().

Postcondition:: The recorder state will be RECORDER_STATE_CREATED.; If the recorder handle is created by recorder_create_videorecorder(), camera state will be changed to CAMERA_STATE_CREATED.

See also:: recorder_prepare(); recorder_cancel(); recorder_commit()

int recorder_unset_audio_stream_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 2.3

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_audio_stream_cb()

int recorder_unset_error_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 2.3

Parameters:

[in] recorder The handle to the recorder

Returns:: on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_error_cb()

int recorder_unset_interrupt_started_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 4.0

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: recorder_set_interrupt_started_cb()

int recorder_unset_interrupted_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 2.3

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_interrupted_cb()

int recorder_unset_muxed_stream_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 4.0

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state

Precondition:: The recorder state should be RECORDER_STATE_READY or RECORDER_STATE_CREATED.

See also:: recorder_set_muxed_stream_cb()

int recorder_unset_recording_limit_reached_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 2.3

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_recording_limit_reached_cb()

int recorder_unset_recording_status_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 2.3

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_recording_status_cb()

int recorder_unset_state_changed_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 2.3

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported
RECORDER_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: recorder_set_state_changed_cb()

int recorder_unset_video_encode_decision_cb ( recorder_h recorder )

Unregisters the callback function.

Since :: 6.0

Parameters:

[in] recorder The handle to the media recorder

Returns:: 0 on success, otherwise a negative error value

Return values:

RECORDER_ERROR_NONE	Successful
RECORDER_ERROR_INVALID_PARAMETER	Invalid parameter
RECORDER_ERROR_INVALID_OPERATION	Invalid operation
RECORDER_ERROR_INVALID_STATE	Invalid state
RECORDER_ERROR_NOT_SUPPORTED	The feature is not supported

Precondition:: The recorder state should be RECORDER_STATE_READY or RECORDER_STATE_CREATED.

See also:: recorder_set_video_encode_decision_cb()

Required Header

Overview

State Diagram

State Transitions

Callback(Event) Operations

Foreach Operations

Related Features

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation