/**
* @file media_audio.h
* @brief This file contains the audio metadata API and related functions to proceed with audio metadata. \n
- * Description of the audio content involves: album, artist, album_artist, author, genre and description tags. \n
+ * Description of the audio content involves: album, artist, album_artist, genre and description tags. \n
* Parameters of the recording are also supported such as format, bitrate, duration, size etc.
*/
* @brief Clones the audio metadata.
* @details This function copies the audio metadata handle from a source to destination.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a dst should be released using audio_meta_destroy().
*
* no longer can be used to perform any operations. A new handle has to
* be created before the next use.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @param[in] audio The handle to the audio metadata
*
/**
* @brief Gets the ID of the media of the given audio metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a media_id should be released using free().
*
/**
* @brief Gets the album of the given audio metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
- * Since 3.0, if the media content has no album info, the method returns empty string.
+ * Since 3.0, if the media content has no album info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a album should be released using free().
*
/**
* @brief Gets the artist of the given audio metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
- * Since 3.0, if the media content has no artist info, the method returns empty string.
+ * Since 3.0, if the media content has no artist info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a artist should be released using free().
*
/**
* @brief Gets the album artist of the given audio metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
- * Since 3.0, if the media content has no album artist info, the method returns empty string.
+ * Since 3.0, if the media content has no album artist info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a album_artist should be released using free().
*
/**
* @brief Gets the genre of the given audio metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
- * Since 3.0, if the media content has no genre info, the method returns empty string.
+ * Since 3.0, if the media content has no genre info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a genre should be released using free().
*
int audio_meta_get_genre(audio_meta_h audio, char **genre);
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets the composer of the given audio metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
- * Since 3.0, if the media content has no composer info, the method returns empty string.
+ * Since 3.0, if the media content has no composer info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a composer should be released using free().
*
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
*/
-int audio_meta_get_composer(audio_meta_h audio, char **composer);
+int audio_meta_get_composer(audio_meta_h audio, char **composer) TIZEN_DEPRECATED_API;
/**
* @brief Gets the year of the given audio metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
- * Since 3.0, if the media content has no year info, the method returns empty string.
+ * Since 3.0, if the media content has no year info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a year should be released using free().
*
int audio_meta_get_year(audio_meta_h audio, char **year);
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets the recorded date of the given audio metadata.
- * @details The recorded date is got from audio file's metadata. Some formats like mp4 use UTC and the rest can be different. \n
- * So, please refer to the format specification if needed.
+ * @details The format of the recorded date may vary depending on the file format. \n
+ * For more details on the recorded date format, refer to the file format specification.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a recorded_date should be released using free().
*
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
*/
-int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date);
+int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date) TIZEN_DEPRECATED_API;
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets the copyright notice of the given audio metadata.
* @details If the media content has no copyright info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a copyright should be released using free().
*
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
*/
-int audio_meta_get_copyright(audio_meta_h audio, char **copyright);
+int audio_meta_get_copyright(audio_meta_h audio, char **copyright) TIZEN_DEPRECATED_API;
/**
* @brief Gets the track number of the given audio metadata.
* @details If the value is an empty string, the method returns "Unknown". \n
- * Since 3.0, if the media content has no track info, the method returns empty string.
+ * Since 3.0, if the media content has no track info, the method returns empty string.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @remarks The @a track_num should be released using free().
*
int audio_meta_get_track_num(audio_meta_h audio, char **track_num);
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets the bitrate of the given audio metadata in bitrate per second.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @param[in] audio The handle to the audio metadata
* @param[out] bit_rate The audio bitrate in bit per second [bps]
* @retval #MEDIA_CONTENT_ERROR_NONE Successful
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate);
+int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate) TIZEN_DEPRECATED_API;
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets bit per sample of the given audio metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @param[in] audio The handle to the audio metadata
* @param[out] bitpersample The audio bit per sample
* @retval #MEDIA_CONTENT_ERROR_NONE Successful
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample);
+int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample) TIZEN_DEPRECATED_API;
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets the sample rate of the given audio metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @param[in] audio The handle to the audio metadata
* @param[out] sample_rate The audio sample rate[hz]
* @retval #MEDIA_CONTENT_ERROR_NONE Successful
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate);
+int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate) TIZEN_DEPRECATED_API;
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets the channel of the given audio metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @param[in] audio The handle to the audio metadata
* @param[out] channel The channel of the audio
* @retval #MEDIA_CONTENT_ERROR_NONE Successful
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int audio_meta_get_channel(audio_meta_h audio, int *channel);
+int audio_meta_get_channel(audio_meta_h audio, int *channel) TIZEN_DEPRECATED_API;
/**
+ * @deprecated Deprecated since 9.0.
* @brief Gets the track duration of the given audio metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @param[in] audio The handle to the audio metadata
* @param[out] duration The audio file duration
* @retval #MEDIA_CONTENT_ERROR_NONE Successful
* @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int audio_meta_get_duration(audio_meta_h audio, int *duration);
-
-/**
- * @deprecated Deprecated since 4.0. Related setter functions are deprecated, therefore this function is not needed anymore.
- * @brief Updates an audio metadata with modified attributes in the media database.
- * @details The function updates the given audio meta in the media database. The function should be called after any change in audio attributes, to be updated to the media
- * database.
- *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @privlevel public
- * @privilege %http://tizen.org/privilege/content.write
- *
- * @remarks Do not call this function in callback function of foreach function like media_info_foreach_media_from_db().
- *
- * @param[in] audio The handle to the audio metadata
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
- * @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB Operation failed
- * @retval #MEDIA_CONTENT_ERROR_DB_BUSY DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_NETWORK Network fail
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @pre This function requires opened connection to content service by media_content_connect().
- *
- * @see media_content_connect()
- */
-int audio_meta_update_to_db(audio_meta_h audio) TIZEN_DEPRECATED_API;
+int audio_meta_get_duration(audio_meta_h audio, int *duration) TIZEN_DEPRECATED_API;
/**
*@}
projects / platform / core / api / media-content.git / blobdiff