include_product/media_audio.h

   1 /*
   2 * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
   3 *
   4 * Licensed under the Apache License, Version 2.0 (the "License");
   5 * you may not use this file except in compliance with the License.
   6 * You may obtain a copy of the License at
   7 *
   8 * http://www.apache.org/licenses/LICENSE-2.0
   9 *
  10 * Unless required by applicable law or agreed to in writing, software
  11 * distributed under the License is distributed on an "AS IS" BASIS,
  12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 * See the License for the specific language governing permissions and
  14 * limitations under the License.
  15 */
  16
  17
  18 #ifndef __TIZEN_AUDIO_META_H__
  19 #define __TIZEN_AUDIO_META_H__
  20
  21 #include <media_content_type.h>
  22
  23 #ifdef __cplusplus
  24 extern "C" {
  25 #endif /* __cplusplus */
  26
  27 /**
  28  * @file media_audio.h
  29  * @brief This file contains the audio metadata API and related functions to proceed with audio metadata. \n
  30  *        Description of the audio content involves: album, artist, album_artist, author, genre and description tags. \n
  31  *        Parameters of the recording are also supported such as format, bitrate, duration, size etc.
  32  */
  33
  34 /**
  35  * @addtogroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
  36  * @{
  37  */
  38
  39 /**
  40  * @brief Clones the audio metadata.
  41  * @details This function copies the audio metadata handle from a source to destination.
  42  *
  43  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  44  *
  45  * @remarks You must release the destination handle using audio_meta_destroy().
  46  *
  47  * @param[out] dst The destination handle to the audio metadata
  48  * @param[in]  src The source handle to the audio metadata
  49  *
  50  * @return @c 0 on success,
  51  *         otherwise a negative error value
  52  *
  53  * @retval #MEDIA_CONTENT_ERROR_NONE Successful
  54  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  55  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
  56  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  57  *
  58  * @see audio_meta_destroy()
  59  */
  60 int audio_meta_clone(audio_meta_h *dst, audio_meta_h src);
  61
  62 /**
  63  * @brief Destroys the audio metadata.
  64  * @details This function frees all resources related to the audio metadata handle. This handle
  65  *          no longer can be used to perform any operation. A new handle has to
  66  *          be created before the next use.
  67  *
  68  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  69  *
  70  * @param[in] audio The audio metadata handle
  71  *
  72  * @return @c 0 on success,
  73  *         otherwise a negative error value
  74  *
  75  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  76  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  77  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  78  *
  79  * @pre Get a copy of audio metadata handle handle by calling audio_meta_clone().
  80  *
  81  * @see audio_meta_clone()
  82  */
  83 int audio_meta_destroy(audio_meta_h audio);
  84
  85 /**
  86  * @brief Gets the ID of the media of the given audio metadata.
  87  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  88  *
  89  * @remarks You must release @a media_id using free().
  90  *
  91  * @param[in]  audio    The audio metadata handle
  92  * @param[out] media_id The ID of the audio
  93  *
  94  * @return @c 0 on success,
  95  *         otherwise a negative error value
  96  *
  97  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  98  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  99  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 100  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 101  */
 102 int audio_meta_get_media_id(audio_meta_h audio, char **media_id);
 103
 104 /**
 105  * @brief Gets the album of the given audio metadata.
 106  * @details If the value is an empty string, the method returns "Unknown". \n
 107  *                Since 3.0, if the media content has no album info, the method returns empty string.
 108  *
 109  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 110  *
 111  * @remarks You must release @a album using free().
 112  *
 113  * @param[in]  audio The audio metadata handle
 114  * @param[out] album The album of the audio metadata
 115  *
 116  * @return @c 0 on success,
 117  *         otherwise a negative error value
 118  *
 119  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 120  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 121  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 122  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 123  */
 124 int audio_meta_get_album(audio_meta_h audio, char **album);
 125
 126 /**
 127  * @brief Gets the artist of the given audio metadata.
 128  * @details If the value is an empty string, the method returns "Unknown". \n
 129  *                Since 3.0, if the media content has no artist info, the method returns empty string.
 130  *
 131  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 132  *
 133  * @remarks You must release @a artist using free().
 134  *
 135  * @param[in]  audio  The audio metadata handle
 136  * @param[out] artist The artist of the audio metadata
 137  *
 138  * @return @c 0 on success,
 139  *         otherwise a negative error value
 140  *
 141  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 142  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 143  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 144  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 145  */
 146 int audio_meta_get_artist(audio_meta_h audio, char **artist);
 147
 148 /**
 149  * @brief Gets the album artist of the given audio metadata.
 150  * @details If the value is an empty string, the method returns "Unknown". \n
 151  *                Since 3.0, if the media content has no album artist info, the method returns empty string.
 152  *
 153  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 154  *
 155  * @remarks You must release @a album_artist using free().
 156  *
 157  * @param[in]  audio        The audio metadata handle
 158  * @param[out] album_artist The album artist of the audio metadata
 159  *
 160  * @return @c 0 on success,
 161  *         otherwise a negative error value
 162  *
 163  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 164  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 165  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 166  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 167  */
 168 int audio_meta_get_album_artist(audio_meta_h audio, char **album_artist);
 169
 170 /**
 171  * @brief Gets the genre of the given audio metadata.
 172  * @details If the value is an empty string, the method returns "Unknown". \n
 173  *                Since 3.0, if the media content has no genre info, the method returns empty string.
 174  *
 175  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 176  *
 177  * @remarks You must release @a genre using free().
 178  *
 179  * @param[in]  audio The audio metadata handle
 180  * @param[out] genre The genre of the audio metadata
 181  *
 182  * @return @c 0 on success,
 183  *         otherwise a negative error value
 184  *
 185  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 186  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 187  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 188  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 189  */
 190 int audio_meta_get_genre(audio_meta_h audio, char **genre);
 191
 192 /**
 193  * @brief Gets the composer of the given audio metadata.
 194  * @details If the value is an empty string, the method returns "Unknown". \n
 195  *                Since 3.0, if the media content has no composer info, the method returns empty string.
 196  *
 197  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 198  *
 199  * @remarks You must release @a composer using free().
 200  *
 201  * @param[in]  audio    The audio metadata handle
 202  * @param[out] composer The composer of the audio metadata
 203  *
 204  * @return @c 0 on success,
 205  *         otherwise a negative error value
 206  *
 207  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 208  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 209  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 210  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 211  */
 212 int audio_meta_get_composer(audio_meta_h audio, char **composer);
 213
 214 /**
 215  * @brief Gets the year of the given audio metadata.
 216  * @details If the value is an empty string, the method returns "Unknown". \n
 217  *                Since 3.0, if the media content has no year info, the method returns empty string.
 218  *
 219  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 220  *
 221  * @remarks You must release @a year using free().
 222  *
 223  * @param[in]  audio The audio metadata handle
 224  * @param[out] year  The year of the audio metadata
 225  *
 226  * @return @c 0 on success,
 227  *         otherwise a negative error value
 228  *
 229  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 230  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 231  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 232  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 233  */
 234 int audio_meta_get_year(audio_meta_h audio, char **year);
 235
 236 /**
 237  * @brief Gets the recorded date of the given audio metadata.
 238  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 239  *
 240  * @remarks You must release @a recorded_date using free().
 241  *
 242  * @param[in]  audio         The audio metadata handle
 243  * @param[out] recorded_date The recorded date of the audio metadata
 244  *
 245  * @return @c 0 on success,
 246  *         otherwise a negative error value
 247  *
 248  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 249  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 250  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 251  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 252  */
 253 int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date);
 254
 255 /**
 256  * @brief Gets the copyright notice of the given audio metadata.
 257  * @details If the media content has no copyright info, the method returns empty string.
 258  *
 259  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 260  *
 261  * @remarks You must release @a copyright using free().
 262  *
 263  * @param[in]  audio     The audio metadata handle
 264  * @param[out] copyright The copyright of the audio metadata
 265  *
 266  * @return @c 0 on success,
 267  *         otherwise a negative error value
 268  *
 269  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 270  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 271  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 272  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 273  */
 274 int audio_meta_get_copyright(audio_meta_h audio, char **copyright);
 275
 276 /**
 277  * @brief Gets the track number of the given audio metadata.
 278  * @details If the value is an empty string, the method returns "Unknown". \n
 279  *                Since 3.0, if the media content has no track info, the method returns empty string.
 280  *
 281  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 282  *
 283  * @remarks You must release @a track_num using free().
 284  *
 285  * @param[in]  audio     The audio metadata handle
 286  * @param[out] track_num The audio track number of the audio metadata
 287  *
 288  * @return @c 0 on success,
 289  *         otherwise a negative error value
 290  *
 291  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 292  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 293  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 294  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 295  */
 296 int audio_meta_get_track_num(audio_meta_h audio, char **track_num);
 297
 298 /**
 299  * @brief Gets the bitrate of the given audio metadata in bitrate per second.
 300  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 301  *
 302  * @param[in]  audio    The audio metadata handle
 303  * @param[out] bit_rate The audio bitrate in bit per second [bps]
 304  *
 305  * @return @c 0 on success,
 306  *         otherwise a negative error value
 307  *
 308  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 309  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 310  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 311  */
 312 int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate);
 313
 314 /**
 315  * @brief Gets bit per sample of the given audio metadata.
 316  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 317  *
 318  * @param [in]  audio        The handle to the audio metadata
 319  * @param [out] bitpersample The audio bit per sample
 320  *
 321  * @return @c 0 on success,
 322  *         otherwise a negative error value
 323  *
 324  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 325  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 326  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 327  */
 328 int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample);
 329
 330 /**
 331  * @brief Gets the sample rate of the given audio metadata.
 332  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 333  *
 334  * @param[in]  audio       The audio metadata handle
 335  * @param[out] sample_rate The audio sample rate[hz]
 336  *
 337  * @return @c 0 on success,
 338  *         otherwise a negative error value
 339  *
 340  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 341  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 342  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 343  */
 344 int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate);
 345
 346 /**
 347  * @brief Gets the channel of the given audio metadata.
 348  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 349  *
 350  * @param[in]  audio   The audio metadata handle
 351  * @param[out] channel The channel of the audio
 352  *
 353  * @return @c 0 on success,
 354  *         otherwise a negative error value
 355  *
 356  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 357  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 358  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 359  */
 360 int audio_meta_get_channel(audio_meta_h audio, int *channel);
 361
 362 /**
 363  * @brief Gets the track duration of the given audio metadata.
 364  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 365  *
 366  * @param[in]  audio    The audio metadata handle
 367  * @param[out] duration The audio file duration
 368  *
 369  * @return @c 0 on success,
 370  *         otherwise a negative error value
 371  *
 372  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 373  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 374  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 375  */
 376 int audio_meta_get_duration(audio_meta_h audio, int *duration);
 377
 378 /**
 379  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_get_played_count() instead]
 380  * @brief Gets the number of times the given audio has been played.
 381  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 382  *
 383  * @param[in]  audio        The audio metadata handle
 384  * @param[out] played_count The counter of the audio played
 385  *
 386  * @return @c 0 on success,
 387  *         otherwise a negative error value
 388  *
 389  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 390  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 391  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 392  */
 393 int audio_meta_get_played_count(audio_meta_h audio, int *played_count) TIZEN_DEPRECATED_API;
 394
 395 /**
 396  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_get_played_time() instead]
 397  * @brief Gets the last played time parameter of the audio.
 398  *
 399  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 400  *
 401  * @param[in]  audio       The audio metadata handle
 402  * @param[out] played_time The last played time of the audio
 403  *
 404  * @return @c 0 on success,
 405  *         otherwise a negative error value
 406  *
 407  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 408  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 409  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 410  */
 411 int audio_meta_get_played_time(audio_meta_h audio, time_t *played_time) TIZEN_DEPRECATED_API;
 412
 413 /**
 414  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif.
 415  * @brief Gets the played position parameter of the audio.
 416  * @details This function returns the elapsed playback position parameter of the audio as a period
 417  *          starting from the beginning of the track.
 418  *
 419  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 420  *
 421  * @param[in]  audio           The audio metadata handle
 422  * @param[out] played_position The elapsed time of the audio
 423  *
 424  * @return @c 0 on success,
 425  *         otherwise a negative error value
 426  *
 427  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 428  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 429  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 430  */
 431 int audio_meta_get_played_position(audio_meta_h audio, int *played_position) TIZEN_DEPRECATED_API;
 432
 433 /**
 434  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_increase_played_count() instead]
 435  * @brief Sets the played count of the audio.
 436  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 437  *
 438  * @param[in] audio        The audio metadata handle
 439  * @param[in] played_count The played count of the audio
 440  *
 441  * @return @c 0 on success,
 442  *         otherwise a negative error value
 443  *
 444  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 445  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 446  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 447  *
 448  * @post audio_meta_update_to_db().
 449  */
 450 int audio_meta_set_played_count(audio_meta_h audio, int played_count) TIZEN_DEPRECATED_API;
 451
 452 /**
 453  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_set_played_time() instead]
 454  * @brief Sets the last played time of the audio.
 455  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 456  *
 457  * @param[in] audio       The audio metadata handle
 458  * @param[in] played_time The last played time of the audio
 459  *
 460  * @return @c 0 on success,
 461  *         otherwise a negative error value
 462  *
 463  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 464  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 465  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 466  *
 467  * @post audio_meta_update_to_db().
 468  */
 469 int audio_meta_set_played_time(audio_meta_h audio, time_t played_time) TIZEN_DEPRECATED_API;
 470
 471 /**
 472  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif.
 473  * @brief Sets the played position of the audio.
 474  *
 475  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 476  *
 477  * @remarks  It is NOT recommended to use this attribute for your application-specific purpose because this attribute can be overwritten by other applications (even 0).
 478  *
 479  * @param[in] audio           The audio metadata handle
 480  * @param[in] played_position The played position of the audio
 481  *
 482  * @return @c 0 on success,
 483  *         otherwise a negative error value
 484  *
 485  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 486  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 487  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 488  *
 489  * @post audio_meta_update_to_db().
 490  */
 491 int audio_meta_set_played_position(audio_meta_h audio, int played_position) TIZEN_DEPRECATED_API;
 492
 493 /**
 494  * @brief Updates an audio metadata with modified attributes in the media database.
 495  * @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
 496  *          database. For example, for setting the played time using audio_meta_get_played_time(), after that the audio_meta_update_to_db() function should be called to update media database.
 497  *
 498  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 499  *
 500  * @privlevel public
 501  * @privilege %http://tizen.org/privilege/content.write
 502  *
 503  * @remarks Do not call this function in callback function of foreach function like media_info_foreach_media_from_db().
 504  *
 505  * @param[in] audio The audio metadata handle
 506  *
 507  * @return @c 0 on success,
 508  *         otherwise a negative error value
 509  *
 510  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 511  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 512  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 513  * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
 514  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 515  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 516  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
 517  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 518  *
 519  * @pre This function requires opened connection to content service by media_content_connect().
 520  *
 521  * @see media_content_connect()
 522  * @see audio_meta_set_played_time()
 523  * @see audio_meta_set_played_count()
 524  * @see audio_meta_set_played_position()
 525  */
 526 int audio_meta_update_to_db(audio_meta_h audio);
 527
 528 /**
 529  *@}
 530  */
 531
 532 #ifdef __cplusplus
 533 }
 534 #endif /* __cplusplus */
 535
 536 #endif /*__TIZEN_AUDIO_META_H__*/