* @brief Called to indicate the recording status.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks This callback function is repeatedly invoked during the #RECORDER_STATE_RECORDING state.
- * @param[in] elapsed_time The time of the recording (milliseconds)
- * @param[in] file_size The size of the recording file (KB)
- * @param[in] user_data The user data passed from the callback registration function
+ * @param[in] elapsed_time The time of the recording (milliseconds)
+ * @param[in] file_size The size of the recording file (KB)
+ * @param[in] user_data The user data passed from the callback registration function
* @pre recorder_start() will invoke this callback if you register it using recorder_set_recording_status_cb().
- * @see recorder_set_recording_status_cb()
- * @see recorder_unset_recording_status_cb()
- * @see recorder_start()
+ * @see recorder_set_recording_status_cb()
+ * @see recorder_unset_recording_status_cb()
+ * @see recorder_start()
*/
typedef void (*recorder_recording_status_cb)(unsigned long long elapsed_time, unsigned long long file_size, void *user_data);
* @param[in] by_policy @c true if the state is changed by policy, otherwise @c false if the state is not changed
* @param[in] user_data The user data passed from the callback registration function
* @pre This function is required to register a callback using recorder_set_state_changed_cb().
- * @see recorder_set_state_changed_cb()
- * @see recorder_prepare()
- * @see recorder_unprepare()
- * @see recorder_start()
- * @see recorder_pause()
- * @see recorder_commit()
- * @see recorder_cancel()
+ * @see recorder_set_state_changed_cb()
+ * @see recorder_prepare()
+ * @see recorder_unprepare()
+ * @see recorder_start()
+ * @see recorder_pause()
+ * @see recorder_commit()
+ * @see recorder_cancel()
*/
typedef void (*recorder_state_changed_cb)(recorder_state_e previous , recorder_state_e current , bool by_policy, void *user_data);
* @param[in] type The recorder type
* @param[in] state The state of the recorder device
* @param[in] user_data The user data passed from the callback registration function
- * @see recorder_add_device_state_changed_cb()
+ * @see recorder_add_device_state_changed_cb()
*/
typedef void (*recorder_device_state_changed_cb)(recorder_type_e type, recorder_device_state_e state, void *user_data);
* @brief Called when the recorder is interrupted by a policy.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks This callback is called after interrupt handling is completed.
- * @param[in] policy The policy that interrupted the recorder
- * @param[in] previous The previous state of the recorder
- * @param[in] current The current state of the recorder
- * @param[in] user_data The user data passed from the callback registration function
- * @see recorder_set_interrupted_cb()
+ * @param[in] policy The policy that interrupted the recorder
+ * @param[in] previous The previous state of the recorder
+ * @param[in] current The current state of the recorder
+ * @param[in] user_data The user data passed from the callback registration function
+ * @see recorder_set_interrupted_cb()
*/
typedef void (*recorder_interrupted_cb)(recorder_policy_e policy, recorder_state_e previous, recorder_state_e current, void *user_data);
* @brief Called when the recorder interrupt is started by a policy.
* @since_tizen 4.0
* @remarks This callback is called before interrupt handling is started.
- * @param[in] policy The policy that is interrupting the recorder
- * @param[in] state The current state of the recorder
- * @param[in] user_data The user data passed from the callback registration function
- * @see recorder_set_interrupt_started_cb()
+ * @param[in] policy The policy that is interrupting the recorder
+ * @param[in] state The current state of the recorder
+ * @param[in] user_data The user data passed from the callback registration function
+ * @see recorder_set_interrupt_started_cb()
*/
typedef void (*recorder_interrupt_started_cb)(recorder_policy_e policy, recorder_state_e state, void *user_data);
/**
* @brief Called once for each supported video resolution.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] width The video image width
- * @param[in] height The video image height
- * @param[in] user_data The user data passed from the foreach function
+ * @param[in] width The video image width
+ * @param[in] height The video image height
+ * @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop
- * @pre recorder_foreach_supported_video_resolution() will invoke this callback.
- * @see recorder_foreach_supported_video_resolution()
+ * @pre recorder_foreach_supported_video_resolution() will invoke this callback.
+ * @see recorder_foreach_supported_video_resolution()
*/
typedef bool (*recorder_supported_video_resolution_cb)(int width, int height, void *user_data);
* #RECORDER_ERROR_DEVICE \n
* #RECORDER_ERROR_INVALID_OPERATION \n
* #RECORDER_ERROR_OUT_OF_MEMORY.
- * @param[in] error The error code
- * @param[in] current_state The current state of the recorder
- * @param[in] user_data The user data passed from the callback registration function
- * @pre This callback function is invoked if you register this callback using recorder_set_error_cb().
- * @see recorder_set_error_cb()
- * @see recorder_unset_error_cb()
+ * @param[in] error The error code
+ * @param[in] current_state The current state of the recorder
+ * @param[in] user_data The user data passed from the callback registration function
+ * @pre This callback function is invoked if you register this callback using recorder_set_error_cb().
+ * @see recorder_set_error_cb()
+ * @see recorder_unset_error_cb()
*/
typedef void (*recorder_error_cb)(recorder_error_e error, recorder_state_e current_state, void *user_data);
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop
* @pre recorder_foreach_supported_file_format() will invoke this callback.
- * @see recorder_foreach_supported_file_format()
+ * @see recorder_foreach_supported_file_format()
*/
typedef bool (*recorder_supported_file_format_cb)(recorder_file_format_e format, void *user_data);
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop
* @pre recorder_foreach_supported_audio_encoder() will invoke this callback.
- * @see recorder_foreach_supported_audio_encoder()
+ * @see recorder_foreach_supported_audio_encoder()
*/
typedef bool (*recorder_supported_audio_encoder_cb)(recorder_audio_codec_e codec, void *user_data);
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop
* @pre recorder_foreach_supported_video_encoder() will invoke this callback.
- * @see recorder_foreach_supported_video_encoder()
+ * @see recorder_foreach_supported_video_encoder()
*/
typedef bool (*recorder_supported_video_encoder_cb)(recorder_video_codec_e codec, void *user_data);
* but it is required in all earlier versions.
* @remarks Since 4.0, It's related to the following feature: %http://tizen.org/feature/media.video_recording \n
* instead of using %http://tizen.org/feature/microphone
- * @param[in] camera The handle to the camera
- * @param[out] recorder A handle to the recorder
+ * @param[in] camera The handle to the camera
+ * @param[out] recorder A handle to the recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* but it is required in all earlier versions.
* @remarks Since 4.0, It's related to the following feature: %http://tizen.org/feature/media.audio_recording \n
* instead of using %http://tizen.org/feature/microphone
- * @param[out] recorder A handle to the recorder
+ * @param[out] recorder A handle to the recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @brief Destroys the recorder handle.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks The video recorder's camera handle is not released by this function.
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_INVALID_STATE Invalid state
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
- * @pre The recorder state should be #RECORDER_STATE_CREATED.
+ * @pre The recorder state should be #RECORDER_STATE_CREATED.
* @post The recorder state will be #RECORDER_STATE_NONE.
- * @see camera_destroy()
- * @see recorder_create_videorecorder()
- * @see recorder_create_audiorecorder()
+ * @see camera_destroy()
+ * @see recorder_create_videorecorder()
+ * @see recorder_create_audiorecorder()
*/
int recorder_destroy(recorder_h recorder);
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @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()).
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @pre The recorder state should be #RECORDER_STATE_CREATED by recorder_create_videorecorder(), recorder_create_audiorecorder() or recorder_unprepare().
+ * @pre The recorder state should be #RECORDER_STATE_CREATED by recorder_create_videorecorder(), recorder_create_audiorecorder() or recorder_unprepare().
* @post The recorder state will be #RECORDER_STATE_READY.
* @post If recorder handle is created by recorder_create_videorecorder(), the camera state will be changed to #CAMERA_STATE_PREVIEW.
- * @see recorder_create_videorecorder()
- * @see recorder_create_audiorecorder()
- * @see recorder_unprepare()
- * @see recorder_set_audio_encoder()
- * @see recorder_set_video_encoder()
- * @see recorder_set_file_format()
+ * @see recorder_create_videorecorder()
+ * @see recorder_create_audiorecorder()
+ * @see recorder_unprepare()
+ * @see recorder_set_audio_encoder()
+ * @see recorder_set_video_encoder()
+ * @see recorder_set_file_format()
*/
int recorder_prepare(recorder_h recorder);
/**
* @brief Resets the media recorder.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @pre The recorder state should be #RECORDER_STATE_READY set by recorder_prepare(), recorder_cancel() or recorder_commit().
+ * @pre The recorder state should be #RECORDER_STATE_READY set by recorder_prepare(), recorder_cancel() or recorder_commit().
* @post The recorder state will be #RECORDER_STATE_CREATED.
* @post If the recorder handle is created by recorder_create_videorecorder(), camera state will be changed to #CAMERA_STATE_CREATED.
- * @see recorder_prepare()
- * @see recorder_cancel()
- * @see recorder_commit()
+ * @see recorder_prepare()
+ * @see recorder_cancel()
+ * @see recorder_commit()
*/
int recorder_unprepare(recorder_h recorder);
* If you want to save contents to internal storage, you should add mediastorage privilege. \n
* If you want to save contents to external storage, you should add externalstorage privilege. \n
* The filename should be set before this function is invoked.
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @pre The recorder state must be #RECORDER_STATE_READY by recorder_prepare() or #RECORDER_STATE_PAUSED by recorder_pause(). \n
* The filename should be set by recorder_set_filename().
* @post The recorder state will be #RECORDER_STATE_RECORDING.
- * @see recorder_pause()
- * @see recorder_commit()
- * @see recorder_cancel()
- * @see recorder_set_audio_encoder()
- * @see recorder_set_filename()
- * @see recorder_set_file_format()
- * @see recorder_recording_status_cb()
- * @see recorder_set_filename()
+ * @see recorder_pause()
+ * @see recorder_commit()
+ * @see recorder_cancel()
+ * @see recorder_set_audio_encoder()
+ * @see recorder_set_filename()
+ * @see recorder_set_file_format()
+ * @see recorder_recording_status_cb()
+ * @see recorder_set_filename()
*/
int recorder_start(recorder_h recorder);
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @remarks Recording can be resumed with recorder_start().
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @remarks When you want to record audio or video file, you need to add privilege according to rules below additionally. \n
* If you want to save contents to internal storage, you should add mediastorage privilege. \n
* If you want to save contents to external storage, you should add externalstorage privilege.
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @see recorder_pause()
* @see recorder_cancel()
* @see recorder_set_filename()
- * @see recorder_start()
+ * @see recorder_start()
*/
int recorder_commit(recorder_h recorder);
* @remarks When you want to record audio or video file, you need to add privilege according to rules below additionally. \n
* If you want to save contents to internal storage, you should add mediastorage privilege. \n
* If you want to save contents to external storage, you should add externalstorage privilege.
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @details This function sets file path which defines where newly recorded data should be stored.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks If the same file already exists in the file system, then old file will be overwritten.
- * @param[in] recorder The handle to the media recorder
- * @param[in] path The recording file path
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] path The recording file path
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_get_filename()
+ * @see recorder_get_filename()
*/
int recorder_set_filename(recorder_h recorder, const char *path);
* @brief Gets the file path to record.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @remarks You must release @a path using free().
- * @param[in] recorder The handle to the media recorder
- * @param[out] path The recording file path
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] path The recording file path
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_set_filename()
+ * @see recorder_set_filename()
*/
int recorder_get_filename(recorder_h recorder, char **path);
/**
* @brief Gets the file format for recording media stream.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @param[out] format The media file format
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @since_tizen 3.0
* @remarks You can set sound stream information including audio routing.
* For more details, please refer to @ref CAPI_MEDIA_SOUND_MANAGER_MODULE
- * @param[in] recorder The handle to the media recorder
- * @param[in] stream_info The sound manager info
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] stream_info The sound manager info
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post recorder_supported_file_format_cb() will be invoked.
+ * @post recorder_supported_file_format_cb() will be invoked.
* @see recorder_get_file_format()
* @see recorder_set_file_format()
* @see recorder_supported_file_format_cb()
* @retval #RECORDER_ERROR_INVALID_OPERATION Invalid operation (Since 2.3.1)
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_get_audio_encoder()
+ * @see recorder_get_audio_encoder()
* @see recorder_foreach_supported_audio_encoder()
*/
int recorder_set_audio_encoder(recorder_h recorder, recorder_audio_codec_e codec);
/**
* @brief Gets the audio codec for encoding an audio stream.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[out] codec The audio codec
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] codec The audio codec
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_set_audio_encoder()
+ * @see recorder_set_audio_encoder()
* @see recorder_foreach_supported_audio_encoder()
*/
int recorder_get_audio_encoder(recorder_h recorder, recorder_audio_codec_e *codec);
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post recorder_supported_audio_encoder_cb() will be invoked.
- * @see recorder_set_audio_encoder()
- * @see recorder_get_audio_encoder()
- * @see recorder_supported_audio_encoder_cb()
+ * @post recorder_supported_audio_encoder_cb() will be invoked.
+ * @see recorder_set_audio_encoder()
+ * @see recorder_get_audio_encoder()
+ * @see recorder_supported_audio_encoder_cb()
*/
int recorder_foreach_supported_audio_encoder(recorder_h recorder, recorder_supported_audio_encoder_cb callback, void *user_data);
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_start()
- * @see recorder_get_video_resolution()
- * @see recorder_foreach_supported_video_resolution()
+ * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
+ * @see recorder_start()
+ * @see recorder_get_video_resolution()
+ * @see recorder_foreach_supported_video_resolution()
*/
int recorder_set_video_resolution(recorder_h recorder, int width, int height);
/**
* @brief Gets the resolution of the video recording.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @param[out] width The video width
* @param[out] height The video height
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_set_video_resolution()
- * @see recorder_foreach_supported_video_resolution()
+ * @see recorder_set_video_resolution()
+ * @see recorder_foreach_supported_video_resolution()
*/
int recorder_get_video_resolution(recorder_h recorder, int *width, int *height);
/**
* @brief Retrieves all supported video resolutions by invoking callback function once for each supported video resolution.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[in] foreach_cb The callback function to be invoked
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] foreach_cb The callback function to be invoked
+ * @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post This function invokes recorder_supported_video_resolution_cb() repeatedly to retrieve each supported video resolution.
- * @see recorder_set_video_resolution()
- * @see recorder_get_video_resolution()
- * @see recorder_supported_video_resolution_cb()
+ * @post This function invokes recorder_supported_video_resolution_cb() repeatedly to retrieve each supported video resolution.
+ * @see recorder_set_video_resolution()
+ * @see recorder_get_video_resolution()
+ * @see recorder_supported_video_resolution_cb()
*/
int recorder_foreach_supported_video_resolution(recorder_h recorder, recorder_supported_video_resolution_cb foreach_cb, void *user_data);
/**
* @brief Gets the video codec for encoding video stream.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[out] codec The video codec
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] codec The video codec
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post recorder_supported_video_encoder_cb() will be invoked.
+ * @post recorder_supported_video_encoder_cb() will be invoked.
* @see recorder_set_video_encoder()
* @see recorder_get_video_encoder()
- * @see recorder_supported_video_encoder_cb()
+ * @see recorder_supported_video_encoder_cb()
*/
int recorder_foreach_supported_video_encoder(recorder_h recorder, recorder_supported_video_encoder_cb callback, void *user_data);
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post recorder_state_changed_cb() will be invoked.
+ * @post recorder_state_changed_cb() will be invoked.
* @see recorder_unset_state_changed_cb()
* @see recorder_state_changed_cb()
*/
/**
* @brief Unregisters the callback function.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_unset_interrupted_cb()
- * @see recorder_interrupted_cb()
+ * @see recorder_unset_interrupted_cb()
+ * @see recorder_interrupted_cb()
*/
int recorder_set_interrupted_cb(recorder_h recorder, recorder_interrupted_cb callback, void *user_data);
/**
* @brief Unregisters the callback function.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_set_interrupted_cb()
+ * @see recorder_set_interrupted_cb()
*/
int recorder_unset_interrupted_cb(recorder_h recorder);
/**
* @brief Registers a callback function to be called when the media recorder interrupt is started according to a policy.
* @since_tizen 4.0
- * @param[in] recorder The handle to the media recorder
- * @param[in] callback The callback function to register
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] callback The callback function to register
+ * @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
- * @see recorder_unset_interrupt_started_cb()
- * @see recorder_interrupt_started_cb()
+ * @see recorder_unset_interrupt_started_cb()
+ * @see recorder_interrupt_started_cb()
*/
int recorder_set_interrupt_started_cb(recorder_h recorder, recorder_interrupt_started_cb callback, void *user_data);
/**
* @brief Unregisters the callback function.
* @since_tizen 4.0
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
- * @see recorder_set_interrupt_started_cb()
+ * @see recorder_set_interrupt_started_cb()
*/
int recorder_unset_interrupt_started_cb(recorder_h recorder);
* @remarks The callback is called via internal thread of Frameworks. Therefore do not invoke UI API, recorder_unprepare(), recorder_commit() and recorder_cancel() in callback.\n
* This callback function to be called in #RECORDER_STATE_RECORDING and #RECORDER_STATE_PAUSED state.
*
- * @param[in] recorder The handle to the recorder
- * @param[in] callback The callback function to register
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] recorder The handle to the recorder
+ * @param[in] callback The callback function to register
+ * @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED.
- * @see recorder_unset_audio_stream_cb()
- * @see recorder_audio_stream_cb()
+ * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED.
+ * @see recorder_unset_audio_stream_cb()
+ * @see recorder_audio_stream_cb()
*/
int recorder_set_audio_stream_cb(recorder_h recorder, recorder_audio_stream_cb callback, void *user_data);
/**
* @brief Unregisters the callback function.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @since_tizen 4.0
* @remarks This callback receives the data that will be recorded, \n
* but any changes to this data will not affect the recorded file.
- * @param[in] recorder The handle to the recorder
- * @param[in] callback The callback function to register
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] recorder The handle to the recorder
+ * @param[in] callback The callback function to register
+ * @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_INVALID_OPERATION Invalid operation
* @retval #RECORDER_ERROR_INVALID_STATE Invalid state
- * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED.
- * @see recorder_unset_muxed_stream_cb()
- * @see recorder_muxed_stream_cb()
+ * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED.
+ * @see recorder_unset_muxed_stream_cb()
+ * @see recorder_muxed_stream_cb()
*/
int recorder_set_muxed_stream_cb(recorder_h recorder, recorder_muxed_stream_cb callback, void *user_data);
/**
* @brief Unregisters the callback function.
* @since_tizen 4.0
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_INVALID_OPERATION Invalid operation
* @retval #RECORDER_ERROR_INVALID_STATE Invalid state
- * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED.
- * @see recorder_set_muxed_stream_cb()
+ * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED.
+ * @see recorder_set_muxed_stream_cb()
*/
int recorder_unset_muxed_stream_cb(recorder_h recorder);
/**
* @brief Registers a callback function to be invoked when the recording information changes.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[in] callback The function pointer of user callback
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] callback The function pointer of user callback
+ * @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post recorder_recording_status_cb() will be invoked.
- * @see recorder_unset_recording_status_cb()
- * @see recorder_recording_status_cb()
+ * @post recorder_recording_status_cb() will be invoked.
+ * @see recorder_unset_recording_status_cb()
+ * @see recorder_recording_status_cb()
*/
int recorder_set_recording_status_cb(recorder_h recorder, recorder_recording_status_cb callback, void *user_data);
/**
* @brief Unregisters the callback function.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_set_recording_status_cb()
+ * @see recorder_set_recording_status_cb()
*/
int recorder_unset_recording_status_cb(recorder_h recorder);
/**
* @brief Registers the callback function to be run when reached the recording limit.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to media recorder
- * @param[in] callback The function pointer of user callback
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] recorder The handle to media recorder
+ * @param[in] callback The function pointer of user callback
+ * @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post recorder_recording_limit_reached_cb() will be invoked.
- * @see recorder_unset_recording_limit_reached_cb()
- * @see recorder_attr_set_size_limit()
- * @see recorder_attr_set_time_limit()
- * @see recorder_recording_limit_reached_cb()
+ * @post recorder_recording_limit_reached_cb() will be invoked.
+ * @see recorder_unset_recording_limit_reached_cb()
+ * @see recorder_attr_set_size_limit()
+ * @see recorder_attr_set_time_limit()
+ * @see recorder_recording_limit_reached_cb()
*/
int recorder_set_recording_limit_reached_cb(recorder_h recorder, recorder_recording_limit_reached_cb callback, void *user_data);
/**
* @brief Unregisters the callback function.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
+ * @param[in] recorder The handle to the media recorder
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_set_recording_limit_reached_cb()
+ * @see recorder_set_recording_limit_reached_cb()
*/
int recorder_unset_recording_limit_reached_cb(recorder_h recorder);
* #RECORDER_ERROR_DEVICE \n
* #RECORDER_ERROR_INVALID_OPERATION \n
* #RECORDER_ERROR_OUT_OF_MEMORY
- * @param[in] recorder The handle to the recorder
- * @param[in] callback The callback function to register
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] recorder The handle to the recorder
+ * @param[in] callback The callback function to register
+ * @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @post This function will invoke recorder_error_cb() when an asynchronous operation error occur.
- * @see recorder_unset_error_cb()
- * @see recorder_error_cb()
+ * @post This function will invoke recorder_error_cb() when an asynchronous operation error occur.
+ * @see recorder_unset_error_cb()
+ * @see recorder_error_cb()
*/
int recorder_set_error_cb(recorder_h recorder, recorder_error_cb callback, void *user_data);
/**
* @brief Unregisters the callback function.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the recorder
+ * @param[in] recorder The handle to the recorder
* @return @c on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_set_error_cb()
+ * @see recorder_set_error_cb()
*/
int recorder_unset_error_cb(recorder_h recorder);
/**
* @brief Gets the state of recorder device.
* @since_tizen 3.0
- * @param[in] type The recorder type
- * @param[out] state The current state of the device
+ * @param[in] type The recorder type
+ * @param[out] state The current state of the device
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
/**
* @brief Registers a callback function to be called when the recorder device state changes.
* @since_tizen 3.0
- * @param[in] callback The callback function to register
- * @param[in] user_data The user data to be passed to the callback function
- * @param[out] cb_id The id of the registered callback
+ * @param[in] callback The callback function to register
+ * @param[in] user_data The user data to be passed to the callback function
+ * @param[out] cb_id The id of the registered callback
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_attr_get_size_limit()
- * @see recorder_attr_set_time_limit()
+ * @see recorder_attr_get_size_limit()
+ * @see recorder_attr_set_time_limit()
*/
int recorder_attr_set_size_limit(recorder_h recorder, int kbyte);
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_size_limit()
- * @see recorder_attr_get_time_limit()
+ * @see recorder_attr_set_size_limit()
+ * @see recorder_attr_get_time_limit()
*/
int recorder_attr_get_size_limit(recorder_h recorder, int *kbyte);
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_attr_get_time_limit()
- * @see recorder_attr_set_size_limit()
+ * @see recorder_attr_get_time_limit()
+ * @see recorder_attr_set_size_limit()
*/
int recorder_attr_set_time_limit(recorder_h recorder, int second);
/**
* @brief Gets the time limit of a recording file.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[out] second The time limit of the recording file (in seconds) \n
- * @c 0 means unlimited recording time.
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] second The time limit of the recording file (in seconds) \n
+ * @c 0 means unlimited recording time.
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_time_limit()
- * @see recorder_attr_get_size_limit()
+ * @see recorder_attr_set_time_limit()
+ * @see recorder_attr_get_size_limit()
*/
int recorder_attr_get_time_limit(recorder_h recorder, int *second);
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY (for video recorder only).\n
* Since 2.3.1, this API also works for audio recorder when its state is #RECORDER_STATE_READY.
- * @see recorder_attr_get_audio_device()
+ * @see recorder_attr_get_audio_device()
*/
int recorder_attr_set_audio_device(recorder_h recorder, recorder_audio_device_e device);
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_audio_device()
+ * @see recorder_attr_set_audio_device()
*/
int recorder_attr_get_audio_device(recorder_h recorder, recorder_audio_device_e *device);
/**
* @brief Sets the sampling rate of an audio stream.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[in] samplerate The sample rate in Hertz
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] samplerate The sample rate in Hertz
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY (for video recorder only).\n
* Since 2.3.1, this API also works for audio recorder when its state is #RECORDER_STATE_READY.
- * @see recorder_attr_get_audio_samplerate()
+ * @see recorder_attr_get_audio_samplerate()
*/
int recorder_attr_set_audio_samplerate(recorder_h recorder, int samplerate);
/**
* @brief Gets the sampling rate of an audio stream.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[out] samplerate The sample rate in Hertz
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] samplerate The sample rate in Hertz
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_audio_samplerate()
+ * @see recorder_attr_set_audio_samplerate()
*/
int recorder_attr_get_audio_samplerate(recorder_h recorder, int *samplerate);
/**
* @brief Sets the bitrate of an audio encoder.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[in] bitrate The bitrate (for mms : 12200[bps], normal : 288000[bps])
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] bitrate The bitrate (for mms : 12200[bps], normal : 288000[bps])
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_attr_get_audio_encoder_bitrate()
+ * @see recorder_attr_get_audio_encoder_bitrate()
*/
int recorder_attr_set_audio_encoder_bitrate(recorder_h recorder, int bitrate);
/**
* @brief Sets the bitrate of a video encoder.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[in] bitrate The bitrate in bits per second
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] bitrate The bitrate in bits per second
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_attr_get_video_encoder_bitrate()
+ * @see recorder_attr_get_video_encoder_bitrate()
*/
int recorder_attr_set_video_encoder_bitrate(recorder_h recorder, int bitrate);
/**
* @brief Gets the bitrate of an audio encoder.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[out] bitrate The bitrate in bits per second
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] bitrate The bitrate in bits per second
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_audio_encoder_bitrate()
+ * @see recorder_attr_set_audio_encoder_bitrate()
*/
int recorder_attr_get_audio_encoder_bitrate(recorder_h recorder, int *bitrate);
/**
* @brief Gets the bitrate of a video encoder.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[out] bitrate The bitrate in bits per second
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] bitrate The bitrate in bits per second
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_audio_encoder_bitrate()
+ * @see recorder_attr_set_audio_encoder_bitrate()
*/
int recorder_attr_get_video_encoder_bitrate(recorder_h recorder, int *bitrate);
/**
* @brief Sets the mute state of a recorder.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[in] enable The mute state
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] enable The mute state
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_is_muted()
+ * @see recorder_attr_is_muted()
*/
int recorder_attr_set_mute(recorder_h recorder, bool enable);
* @exception #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @exception #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
- * @see recorder_attr_set_mute()
+ * @see recorder_attr_set_mute()
*/
bool recorder_attr_is_muted(recorder_h recorder);
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY.
- * @see recorder_attr_get_recording_motion_rate()
+ * @see recorder_attr_get_recording_motion_rate()
*/
int recorder_attr_set_recording_motion_rate(recorder_h recorder , double rate);
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_recording_motion_rate()
+ * @see recorder_attr_set_recording_motion_rate()
*/
int recorder_attr_get_recording_motion_rate(recorder_h recorder , double *rate);
* @remarks This attribute is applied only in RECORDER_STATE_CREATED state. \n
* For mono recording, setting channel to @c 1. \n
* For stereo recording, setting channel to @c 2.
- * @param[in] recorder The handle to the media recorder
- * @param[in] channel_count The number of the audio channel
+ * @param[in] recorder The handle to the media recorder
+ * @param[in] channel_count The number of the audio channel
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
* @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY (for video recorder only).\n
* Since 2.3.1, this API also works for audio recorder when its state is #RECORDER_STATE_READY.
- * @see recorder_attr_get_audio_channel()
+ * @see recorder_attr_get_audio_channel()
*/
int recorder_attr_set_audio_channel(recorder_h recorder, int channel_count);
/**
* @brief Gets the number of the audio channel.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to the media recorder
- * @param[out] channel_count The number of the audio channel
+ * @param[in] recorder The handle to the media recorder
+ * @param[out] channel_count The number of the audio channel
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_audio_channel()
+ * @see recorder_attr_set_audio_channel()
*/
int recorder_attr_get_audio_channel(recorder_h recorder, int *channel_count);
/**
* @brief Sets the video orientation in a video metadata tag.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to a media recorder
- * @param[in] orientation The information of the video orientation
+ * @param[in] recorder The handle to a media recorder
+ * @param[in] orientation The information of the video orientation
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_get_orientation_tag()
+ * @see recorder_attr_get_orientation_tag()
*/
int recorder_attr_set_orientation_tag(recorder_h recorder, recorder_rotation_e orientation);
/**
* @brief Gets the video orientation in a video metadata tag.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @param[in] recorder The handle to a media recorder
- * @param[out] orientation The information of the video orientation
+ * @param[in] recorder The handle to a media recorder
+ * @param[out] orientation The information of the video orientation
* @return @c 0 on success, otherwise a negative error value
* @retval #RECORDER_ERROR_NONE Successful
* @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted
* @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported
* @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected
- * @see recorder_attr_set_orientation_tag()
+ * @see recorder_attr_set_orientation_tag()
*/
int recorder_attr_get_orientation_tag(recorder_h recorder, recorder_rotation_e *orientation);
projects / platform / core / api / recorder.git / commitdiff