legacy_recorder.h: Remove profile check for supported platform version 29/302429/1 accepted/tizen_unified_riscv accepted/tizen/unified/20231211.095356 accepted/tizen/unified/riscv/20231226.211639
authorJeongmo Yang <jm80.yang@samsung.com>
Wed, 6 Dec 2023 09:16:57 +0000 (18:16 +0900)
committerJeongmo Yang <jm80.yang@samsung.com>
Wed, 6 Dec 2023 09:16:57 +0000 (18:16 +0900)
[Version] 0.3.30
[Issue Type] Doxygen

Change-Id: I7c15ac8aa4578b165eb4009994496cf5741721ee
Signed-off-by: Jeongmo Yang <jm80.yang@samsung.com>
legacy/include/legacy_recorder.h
packaging/mmsvc-recorder.spec

index 554ff8d040743a690d46acb4f44a7e9b7bec2308..a31c6a553e2b1e7f74d00c4018fe1a93956cfc9c 100644 (file)
@@ -28,7 +28,7 @@ extern "C" {
 /**
  * @file recorder.h
  * @brief This file contains the Recorder API.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 
 /**
@@ -38,13 +38,13 @@ extern "C" {
 
 /**
  * @brief The Media recorder handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct recorder_s *recorder_h;
 
 /**
  * @brief Enumeration for error code of the media recorder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_ERROR_NONE                  = TIZEN_ERROR_NONE,                /**< Successful */
@@ -63,7 +63,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for recorder states.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_STATE_NONE,      /**< Recorder is not created */
@@ -75,7 +75,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for the recording limit.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_RECORDING_LIMIT_TIME,        /**< Time limit (second) of recording file */
@@ -85,7 +85,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for the file container format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_FILE_FORMAT_3GP,    /**< 3GP file format */
@@ -99,7 +99,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for the audio codec.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_AUDIO_CODEC_DISABLE = -1, /**< Disable audio track */
@@ -112,7 +112,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for the video codec.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_VIDEO_CODEC_H263,    /**< H263 codec */
@@ -123,7 +123,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for audio capture devices.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_AUDIO_DEVICE_MIC,      /**< Mic device */
@@ -132,7 +132,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for the recorder rotation type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_ROTATION_NONE, /**< No rotation */
@@ -143,7 +143,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for the recorder policy.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
        RECORDER_POLICY_NONE = 0,               /**< None */
@@ -193,7 +193,7 @@ typedef enum {
 /**
  * @brief Called when limitation error occurs while recording.
  * @details The callback function is possible to receive three types of limits: time, size and no-space.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 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.
  * @param[in] type The imitation type
  * @param[in] user_data The user data passed from the callback registration function
@@ -206,7 +206,7 @@ typedef void (*recorder_recording_limit_reached_cb)(recorder_recording_limit_typ
 
 /**
  * @brief Called to indicate the recording status.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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)
@@ -220,7 +220,7 @@ typedef void (*recorder_recording_status_cb)(unsigned long long elapsed_time, un
 
 /**
  * @brief Called when the record state is changed.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] previous The previous state of the recorder
  * @param[in] current  The current state of the recorder
  * @param[in] by_policy     @c true if the state is changed by policy, otherwise @c false if the state is not changed
@@ -238,7 +238,7 @@ typedef void (*recorder_state_changed_cb)(recorder_state_e previous, recorder_st
 
 /**
  * @brief Called when the recorder is interrupted by a policy.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] policy        The policy that is interrupting the recorder
  * @param[in] previous      The previous state of the recorder
  * @param[in] current       The current state of the recorder
@@ -259,7 +259,7 @@ typedef void (*recorder_interrupt_started_cb)(recorder_policy_e policy, recorder
 
 /**
  * @brief Called when audio stream data was being delivered just before storing in the recorded file.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks The callback function holds the same buffer that will be recorded. \n
  *          So if the user changes the buffer, the result file will contain the buffer.
  * @remarks The callback is called via internal thread of Frameworks, therefore do not invoke UI API, legacy_recorder_unprepare(), legacy_recorder_commit() and legacy_recorder_cancel() in callback.
@@ -302,7 +302,7 @@ typedef bool (*recorder_video_encode_decision_cb)(MMCamcorderVideoStreamDataType
 
 /**
  * @brief Called once for each supported video resolution.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -314,7 +314,7 @@ typedef bool (*recorder_supported_video_resolution_cb)(int width, int height, vo
 
 /**
  * @brief Called when the error occurred.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks This callback informs about the critical error situation. \n
  *          When being invoked, user should release the resource and terminate the application. \n
  *          This error code will be reported.
@@ -341,7 +341,7 @@ typedef void (*recorder_error_cb)(recorder_error_e error, recorder_state_e curre
 
 /**
  * @brief Called iteratively to notify about the supported file formats.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] format   The format of recording files
  * @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
@@ -352,7 +352,7 @@ typedef bool (*recorder_supported_file_format_cb)(recorder_file_format_e format,
 
 /**
  * @brief Called iteratively to notify about the supported audio encoders.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] codec    The codec of audio encoder
  * @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
@@ -363,7 +363,7 @@ typedef bool (*recorder_supported_audio_encoder_cb)(recorder_audio_codec_e codec
 
 /**
  * @brief Called iteratively to notify about the supported video encoders.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] codec    The codec of video encoder
  * @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
@@ -383,7 +383,7 @@ typedef bool (*recorder_supported_video_encoder_cb)(recorder_video_codec_e codec
 
 /**
  * @brief Creates a recorder handle to record a video.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @remarks You must release @a recorder using legacy_recorder_destroy(). \n
@@ -409,7 +409,7 @@ int legacy_recorder_create_videorecorder(camera_h camera, recorder_h *recorder);
 
 /**
  * @brief Creates a recorder handle to record an audio.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @remarks You must release @a recorder using legacy_recorder_destroy().
@@ -428,7 +428,7 @@ int legacy_recorder_create_audiorecorder(recorder_h *recorder);
 
 /**
  * @brief Destroys the recorder handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @remarks The video recorder's camera handle is not released by this function.
@@ -450,7 +450,7 @@ int legacy_recorder_destroy(recorder_h recorder);
 
 /**
  * @brief Prepares the media recorder for recording.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @remarks Before calling the function, it is required to properly set audio encoder (recorder_set_audio_encoder()),
@@ -477,7 +477,7 @@ int legacy_recorder_prepare(recorder_h recorder);
 
 /**
  * @brief Resets the media recorder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @param[in]  recorder  The handle to the media recorder
@@ -499,7 +499,7 @@ int legacy_recorder_unprepare(recorder_h recorder);
 
 /**
  * @brief Starts the recording.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel 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. \n
@@ -533,7 +533,7 @@ int legacy_recorder_start(recorder_h recorder);
 
 /**
  * @brief Pauses the recording.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel public
  * @privilege %http://tizen.org/privilege/recorder
  * @remarks Recording can be resumed with legacy_recorder_start().
@@ -555,7 +555,7 @@ int legacy_recorder_pause(recorder_h recorder);
 
 /**
  * @brief Stops recording and saves the result.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel 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. \n
@@ -581,7 +581,7 @@ int legacy_recorder_commit(recorder_h recorder);
 /**
  * @brief Cancels the recording.
  * @details The recording data is discarded and not written in the recording file.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @privlevel 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. \n
@@ -606,7 +606,7 @@ int legacy_recorder_cancel(recorder_h recorder);
 
 /**
  * @brief Gets the recorder's current state.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder The handle to the media recorder
  * @param[out] state  The current state of the recorder
  * @return  @c 0 on success, otherwise a negative error value
@@ -619,7 +619,7 @@ int legacy_recorder_get_state(recorder_h recorder, recorder_state_e *state);
 
 /**
  * @brief Gets the peak audio input level that was sampled since the last call to this function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks @c 0 dB indicates maximum input level, @c -300 dB indicates minimum input level.
  * @param[in]  recorder The handle to the media recorder
  * @param[out] dB  The audio input level in dB
@@ -636,7 +636,7 @@ int legacy_recorder_get_audio_level(recorder_h recorder, double *dB);
 /**
  * @brief Sets the file path to record.
  * @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
+ * @since_tizen 2.3
  * @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
@@ -653,7 +653,7 @@ int legacy_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
+ * @since_tizen 2.3
  * @remarks You must release @a path using free().
  * @param[in]  recorder    The handle to the media recorder
  * @param[out] path    The recording file path
@@ -668,7 +668,7 @@ int legacy_recorder_get_filename(recorder_h recorder, char **path);
 
 /**
  * @brief Sets the file format for recording media stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 2.3.1, it could be returned #RECORDER_ERROR_INVALID_OPERATION \n
  *          when it's audio recorder and its state is #RECORDER_STATE_READY \n
  *          because of checking codec compatibility with current encoder.
@@ -691,7 +691,7 @@ int legacy_recorder_set_file_format(recorder_h recorder, recorder_file_format_e
 
 /**
  * @brief Gets the file format for recording media stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -736,7 +736,7 @@ int legacy_recorder_set_sound_stream_info(recorder_h recorder, char *stream_type
 
 /**
  * @brief Retrieves all supported file formats by invoking a specific callback for each supported file format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] recorder   The handle to the media recorder
  * @param[in] foreach_cb The iteration callback
  * @param[in] codec_type The type of codec(Audio or Video)
@@ -767,7 +767,7 @@ int legacy_recorder_foreach_supported_file_format(recorder_h recorder,
 
 /**
  * @brief Sets the audio codec for encoding an audio stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks You can get available audio encoders by using legacy_recorder_foreach_supported_audio_encoder(). \n
  *          If set to #RECORDER_AUDIO_CODEC_DISABLE, the audio track is not created in recording files.\n
  *          Since 2.3.1, it could be returned #RECORDER_ERROR_INVALID_OPERATION \n
@@ -790,7 +790,7 @@ int legacy_recorder_set_audio_encoder(recorder_h recorder, recorder_audio_codec_
 
 /**
  * @brief Gets the audio codec for encoding an audio stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -814,7 +814,7 @@ int legacy_recorder_get_audio_encoder(recorder_h recorder, recorder_audio_codec_
 
 /**
  * @brief Retrieves all supported audio encoders by invoking a specific callback for each supported audio encoder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] recorder   The handle to the media recorder
  * @param[in] foreach_cb The iteration callback
  * @param[in] codec_type The type of codec(Audio or Video)
@@ -844,7 +844,7 @@ int legacy_recorder_foreach_supported_audio_encoder(recorder_h recorder,
 
 /**
  * @brief Sets the resolution of the video recording.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks This function should be called before recording (recorder_start()).
  * @param[in] recorder The handle to the media recorder
  * @param[in] width    The preview width
@@ -864,7 +864,7 @@ int legacy_recorder_set_video_resolution(recorder_h recorder, int width, int hei
 
 /**
  * @brief Gets the resolution of the video recording.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] recorder The handle to the media recorder
  * @param[out] width   The video width
  * @param[out] height  The video height
@@ -889,7 +889,7 @@ int legacy_recorder_get_video_resolution(recorder_h recorder, int *width, int *h
 
 /**
  * @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
+ * @since_tizen 2.3
  * @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
@@ -917,7 +917,7 @@ int legacy_recorder_foreach_supported_video_resolution(recorder_h recorder,
 
 /**
  * @brief Sets the video codec for encoding video stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks You can get available video encoders by using legacy_recorder_foreach_supported_video_encoder().
  * @param[in] recorder The handle to the media recorder
  * @param[in] codec    The video codec
@@ -935,7 +935,7 @@ int legacy_recorder_set_video_encoder(recorder_h recorder, recorder_video_codec_
 
 /**
  * @brief Gets the video codec for encoding video stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -959,7 +959,7 @@ int legacy_recorder_get_video_encoder(recorder_h recorder, recorder_video_codec_
 
 /**
  * @brief Retrieves all supported video encoders by invoking a specific callback for each supported video encoder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] recorder   The handle to the media recorder
  * @param[in] foreach_cb The iteration callback
  * @param[in] codec_type The type of codec(Audio or Video)
@@ -989,7 +989,7 @@ int legacy_recorder_foreach_supported_video_encoder(recorder_h recorder,
 
 /**
  * @brief Registers the callback function that will be invoked when the recorder state changes.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1006,7 +1006,7 @@ int legacy_recorder_set_state_changed_cb(recorder_h recorder, recorder_state_cha
 
 /**
  * @brief Unregisters the callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder The handle to the media recorder
  * @return @c 0 on success, otherwise a negative error value
  * @retval #RECORDER_ERROR_NONE Successful
@@ -1019,7 +1019,7 @@ int legacy_recorder_unset_state_changed_cb(recorder_h recorder);
 
 /**
  * @brief Registers a callback function to be called when the media recorder is interrupted according to a policy.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1035,7 +1035,7 @@ int legacy_recorder_set_interrupted_cb(recorder_h recorder, recorder_interrupted
 
 /**
  * @brief Unregisters the callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder        The handle to the media recorder
  * @return @c 0 on success, otherwise a negative error value
  * @retval #RECORDER_ERROR_NONE Successful
@@ -1073,7 +1073,7 @@ int legacy_recorder_unset_interrupt_started_cb(recorder_h recorder);
 
 /**
  * @brief Registers a callback function to be called when audio stream data is being delivered.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks This callback function holds the same buffer that will be recorded. \n
  *          Therefore if an user changes the buffer, the result file will have the buffer. \n
  * @remarks The callback is called via internal thread of Frameworks. Therefore do not invoke UI API, legacy_recorder_unprepare(), legacy_recorder_commit() and legacy_recorder_cancel() in callback.\n
@@ -1095,7 +1095,7 @@ int legacy_recorder_set_audio_stream_cb(recorder_h recorder, recorder_audio_stre
 
 /**
  * @brief Unregisters the callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder        The handle to the media recorder
  * @return @c 0 on success, otherwise a negative error value
  * @retval #RECORDER_ERROR_NONE Successful
@@ -1174,7 +1174,7 @@ int legacy_recorder_unset_video_encode_decision_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
+ * @since_tizen 2.3
  * @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
@@ -1191,7 +1191,7 @@ int legacy_recorder_set_recording_status_cb(recorder_h recorder, recorder_record
 
 /**
  * @brief Unregisters the callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder    The handle to the media recorder
  * @return @c 0 on success, otherwise a negative error value
  * @retval #RECORDER_ERROR_NONE Successful
@@ -1204,7 +1204,7 @@ int legacy_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
+ * @since_tizen 2.3
  * @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
@@ -1223,7 +1223,7 @@ int legacy_recorder_set_recording_limit_reached_cb(recorder_h recorder, recorder
 
 /**
  * @brief Unregisters the callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder  The handle to the media recorder
  * @return @c 0 on success, otherwise a negative error value
  * @retval #RECORDER_ERROR_NONE Successful
@@ -1236,7 +1236,7 @@ int legacy_recorder_unset_recording_limit_reached_cb(recorder_h recorder);
 
 /**
  * @brief Registers a callback function to be called when an asynchronous operation error occurred.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks This callback informs critical error situation.\n
  *          When this callback is invoked, user should release the resource and terminate the application. \n
  *          These error codes will occur. \n
@@ -1260,7 +1260,7 @@ int legacy_recorder_set_error_cb(recorder_h recorder, recorder_error_cb callback
 
 /**
  * @brief Unregisters the callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder        The handle to the recorder
  * @return  @c on success, otherwise a negative error value
  * @retval    #RECORDER_ERROR_NONE Successful
@@ -1284,7 +1284,7 @@ int legacy_recorder_unset_error_cb(recorder_h recorder);
 
 /**
  * @brief Sets the maximum size of a recording file.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks After reaching the limitation, the recording data is discarded and not written in the recording file.
  * @param[in] recorder The handle to the media recorder
  * @param[in] kbyte    The maximum size of the recording file(KB) \n
@@ -1303,7 +1303,7 @@ int legacy_recorder_attr_set_size_limit(recorder_h recorder, int kbyte);
 
 /**
  * @brief Gets the maximum size of a recording file.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in]  recorder The handle to the media recorder
  * @param[out] kbyte    The maximum size of recording file (KB) \n
  *                      @c 0 means unlimited recording size.
@@ -1319,7 +1319,7 @@ int legacy_recorder_attr_get_size_limit(recorder_h recorder, int *kbyte);
 
 /**
  * @brief Sets the time limit of a recording file.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks After reaching the limitation, the recording data is discarded and not written in the recording file.
  * @param[in] recorder The handle to the media recorder
  * @param[in] second   The time limit of the recording file (in seconds) \n
@@ -1339,7 +1339,7 @@ int legacy_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
+ * @since_tizen 2.3
  * @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.
@@ -1355,7 +1355,7 @@ int legacy_recorder_attr_get_time_limit(recorder_h recorder, int *second);
 
 /**
  * @brief Sets the audio device for recording.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] recorder The handle to the media recorder
  * @param[in] device   The type of an audio device
  * @return @c 0 on success, otherwise a negative error value
@@ -1372,7 +1372,7 @@ int legacy_recorder_attr_set_audio_device(recorder_h recorder, recorder_audio_de
 
 /**
  * @brief Gets the audio device for recording.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] recorder  The handle to the media recorder
  * @param[out] device The type of an audio device
  * @return @c 0 on success, otherwise a negative error value
@@ -1386,7 +1386,7 @@ int legacy_recorder_attr_get_audio_device(recorder_h recorder, recorder_audio_de
 
 /**
  * @brief Sets the sampling rate of an audio stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1403,7 +1403,7 @@ int legacy_recorder_attr_set_audio_samplerate(recorder_h recorder, int samplerat
 
 /**
  * @brief Gets the sampling rate of an audio stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1417,7 +1417,7 @@ int legacy_recorder_attr_get_audio_samplerate(recorder_h recorder, int *samplera
 
 /**
  * @brief Sets the bitrate of an audio encoder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1433,7 +1433,7 @@ int legacy_recorder_attr_set_audio_encoder_bitrate(recorder_h recorder, int bitr
 
 /**
  * @brief Sets the bitrate of a video encoder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1449,7 +1449,7 @@ int legacy_recorder_attr_set_video_encoder_bitrate(recorder_h recorder, int bitr
 
 /**
  * @brief Gets the bitrate of an audio encoder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1463,7 +1463,7 @@ int legacy_recorder_attr_get_audio_encoder_bitrate(recorder_h recorder, int *bit
 
 /**
  * @brief Gets the bitrate of a video encoder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1477,7 +1477,7 @@ int legacy_recorder_attr_get_video_encoder_bitrate(recorder_h recorder, int *bit
 
 /**
  * @brief Sets the mute state of a recorder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1491,7 +1491,7 @@ int legacy_recorder_attr_set_mute(recorder_h recorder, bool enable);
 
 /**
  * @brief Gets the mute state of a recorder.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] recorder The handle to the media recorder
  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
  * @return  @c true if the recorder is not recording any sound,
@@ -1506,7 +1506,7 @@ bool legacy_recorder_attr_is_muted(recorder_h recorder);
 
 /**
  * @brief Sets the recording motion rate.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks This attribute is valid only in a video recorder. \n
  *          If the rate bigger than @c 0 and smaller than @c 1, video is recorded in a slow motion mode. \n
  *          If the rate bigger than @c 1, video is recorded in a fast motion mode (time lapse recording).
@@ -1527,7 +1527,7 @@ int legacy_recorder_attr_set_recording_motion_rate(recorder_h recorder, double r
 
 /**
  * @brief Gets the recording motion rate.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks This attribute is valid only in a video recorder. \n
  *          If the rate bigger than @c 0 and smaller than @c 1, video is recorded in a slow motion mode. \n
  *          If the rate bigger than @c 1, video is recorded in a fast motion mode (time lapse recording).
@@ -1547,7 +1547,7 @@ int legacy_recorder_attr_get_recording_motion_rate(recorder_h recorder, double *
 
 /**
  * @brief Sets the number of the audio channel.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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.
@@ -1566,7 +1566,7 @@ int legacy_recorder_attr_set_audio_channel(recorder_h recorder, int channel_coun
 
 /**
  * @brief Gets the number of the audio channel.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1581,7 +1581,7 @@ int legacy_recorder_attr_get_audio_channel(recorder_h recorder, int *channel_cou
 
 /**
  * @brief Sets the video orientation in a video metadata tag.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
@@ -1595,7 +1595,7 @@ int legacy_recorder_attr_set_orientation_tag(recorder_h recorder, recorder_rotat
 
 /**
  * @brief Gets the video orientation in a video metadata tag.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @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
index f4b6382a97917df0cd358ebfe2ec4c35d1ffabd0..4ee6e621a2bb7c800f151b1cde76f6dfc4faa07a 100644 (file)
@@ -1,6 +1,6 @@
 Name:       mmsvc-recorder
 Summary:    A Recorder module for muse server
-Version:    0.3.29
+Version:    0.3.30
 Release:    0
 Group:      Multimedia/Libraries
 License:    Apache-2.0