include/media_playlist.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 #ifndef __TIZEN_CONTENT_MEDIA_PLAYLIST_H__
  18 #define __TIZEN_CONTENT_MEDIA_PLAYLIST_H__
  19
  20 #include <media_content_type.h>
  21
  22 #ifdef __cplusplus
  23 extern "C" {
  24 #endif /* __cplusplus */
  25
  26 /**
  27  * @file
  28  * @brief This file contains the playlist API and functions related with handling playlists. \n
  29  *        Functions include operations to get the number of playlists, the number of media-info for the playlist  \n
  30  *        and all media files in the playlist, to clone, destroy, insert and delete playlist from DB,  \n
  31  *        to handle with name, ID, thumbnail, played order and media info of the playlist.
  32  */
  33
  34 /**
  35  * @addtogroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
  36  * @{
  37  */
  38
  39
  40 /**
  41  * @deprecated Deprecated since 9.0.
  42  * @brief Gets the number of playlists for the passed @a filter from the media database.
  43  * @since_tizen 2.3
  44  *
  45  * @param[in] filter The handle to the media filter
  46  * @param[out] playlist_count The count of the media playlist
  47  *
  48  * @return @c 0 on success,
  49  *         otherwise a negative error value
  50  *
  51  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  52  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  53  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  54  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
  55  *
  56  * @pre This function requires opened connection to content service by media_content_connect().
  57  *
  58  * @see media_content_connect()
  59  */
  60 int media_playlist_get_playlist_count_from_db(filter_h filter, int *playlist_count) TIZEN_DEPRECATED_API;
  61
  62 /**
  63  * @deprecated Deprecated since 9.0.
  64  * @brief Iterates through the media playlists with an optional @a filter from the media database.
  65  * @details This function gets all media playlists meeting the given filter.
  66  *          The callback function will be invoked for every retrieved media playlist.
  67  *          If @c NULL is passed to the filter, no filtering is applied.
  68  *
  69  * @since_tizen 2.3
  70  *
  71  * @param[in] filter The handle to the media filter
  72  * @param[in] callback The callback function to be invoked
  73  * @param[in] user_data The user data to be passed to the callback function
  74  *
  75  * @return @c 0 on success,
  76  *         otherwise a negative error value
  77  *
  78  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  79  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  80  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  81  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  82  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
  83  *
  84  * @pre  This function requires opened connection to content service by media_content_connect().
  85  * @post This function invokes media_playlist_cb().
  86  *
  87  * @see media_playlist_cb()
  88  * @see media_content_connect()
  89  * @see media_filter_create()
  90  */
  91 int media_playlist_foreach_playlist_from_db(filter_h filter, media_playlist_cb callback, void *user_data) TIZEN_DEPRECATED_API;
  92
  93 /**
  94  * @deprecated Deprecated since 9.0.
  95  * @brief Gets the number of the media info for the given playlist present in the media database.
  96  * @since_tizen 2.3
  97  *
  98  * @param[in] playlist_id The ID of the media playlist
  99  * @param[in] filter The handle to the media filter
 100  * @param[out] media_count The number of media items
 101  *
 102  * @return @c 0 on success,
 103  *         otherwise a negative error value
 104  *
 105  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 106  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 107  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 108  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 109  *
 110  * @pre This function requires opened connection to content service by media_content_connect().
 111  *
 112  * @see media_content_connect()
 113  */
 114 int media_playlist_get_media_count_from_db(int playlist_id, filter_h filter, int *media_count) TIZEN_DEPRECATED_API;
 115
 116 /**
 117  * @deprecated Deprecated since 9.0.
 118  * @brief Iterates through the media files with an optional @a filter in the given audio playlist from the media database.
 119  * @details This function gets all media files associated with the given media playlist and
 120  *          meeting desired filter option and calls @a callback for
 121  *          every retrieved media info. If @c NULL is passed to the @a filter, no filtering is applied.
 122  *
 123  * @since_tizen 2.3
 124  *
 125  * @param[in] playlist_id The ID of the media playlist
 126  * @param[in] filter The handle to the media filter
 127  * @param[in] callback The callback function to be invoked
 128  * @param[in] user_data The user data to be passed to the callback function
 129  *
 130  * @return @c 0 on success,
 131  *         otherwise a negative error value
 132  *
 133  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 134  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 135  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 136  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 137  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 138  *
 139  * @pre  This function requires opened connection to content service by media_content_connect().
 140  * @post This function invokes media_info_cb().
 141  *
 142  * @see media_info_cb()
 143  * @see media_content_connect()
 144  * @see media_filter_create()
 145  */
 146 int media_playlist_foreach_media_from_db(int playlist_id, filter_h filter, playlist_member_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 147
 148 /**
 149  * @deprecated Deprecated since 9.0.
 150  * @brief Inserts a new playlist with the given name into the media database.
 151  * @since_tizen 2.3
 152  *
 153  * @privlevel public
 154  * @privilege %http://tizen.org/privilege/content.write
 155  *
 156  * @remarks The @a playlist should be released using media_playlist_destroy().
 157  *
 158  * @param[in] name The name of the inserted playlist
 159  * @param[out] playlist The handle to the media playlist
 160  *
 161  * @return @c 0 on success,
 162  *         otherwise a negative error value
 163  *
 164  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 165  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 166  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 167  * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
 168  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 169  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 170  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
 171  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 172  *
 173  * @pre This function requires opened connection to content service by media_content_connect().
 174  *
 175  * @see media_content_connect()
 176  * @see media_playlist_delete_from_db()
 177  */
 178 int media_playlist_insert_to_db(const char *name, media_playlist_h *playlist) TIZEN_DEPRECATED_API;
 179
 180 /**
 181  * @deprecated Deprecated since 9.0.
 182  * @brief Deletes the given playlist from the media database.
 183  * @since_tizen 2.3
 184  *
 185  * @privlevel public
 186  * @privilege %http://tizen.org/privilege/content.write
 187  *
 188  * @param[in] playlist_id The ID of media playlist
 189  *
 190  * @return @c 0 on success,
 191  *         otherwise a negative error value
 192  *
 193  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 194  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 195  * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
 196  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 197  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 198  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
 199  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 200  *
 201  * @pre This function requires opened connection to content service by media_content_connect().
 202  *
 203  * @see media_content_connect()
 204  * @see media_playlist_insert_to_db()
 205  */
 206 int media_playlist_delete_from_db(int playlist_id) TIZEN_DEPRECATED_API;
 207
 208 /**
 209  * @deprecated Deprecated since 9.0.
 210  * @brief Gets the media playlist from the media database.
 211  *
 212  * @details This function creates a new media playlist handle from the media database by the given @a playlist_id.
 213  *          The media playlist will be created and will be filled with the playlist information.
 214  *
 215  * @since_tizen 2.3
 216  *
 217  * @remarks The @a playlist should be released using media_playlist_destroy().
 218  *
 219  * @param[in] playlist_id The ID of the media playlist
 220  * @param[out] playlist The handle to the media playlist
 221  *
 222  * @return @c 0 on success,
 223  *         otherwise a negative error value
 224  *
 225  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 226  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 227  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 228  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 229  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 230  *
 231  * @pre This function requires opened connection to content service by media_content_connect().
 232  *
 233  * @see media_content_connect()
 234  * @see media_playlist_destroy()
 235  */
 236 int media_playlist_get_playlist_from_db(int playlist_id, media_playlist_h *playlist) TIZEN_DEPRECATED_API;
 237
 238 /**
 239  * @deprecated Deprecated since 9.0.
 240  * @brief Destroys a playlist handle.
 241  * @details This function frees all resources related to the playlist handle. This
 242  *          handle no longer can be used to perform any operations. A new handle has to
 243  *          be created before next usage.
 244  *
 245  * @since_tizen 2.3
 246  *
 247  * @param[in] playlist The handle to the media playlist
 248  *
 249  * @return @c 0 on success,
 250  *         otherwise a negative error value
 251  *
 252  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 253  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 254  *
 255  * @pre Get a copy of playlist handle by calling media_playlist_clone() or media_playlist_insert_to_db().
 256  *
 257  * @see media_playlist_clone()
 258  */
 259 int media_playlist_destroy(media_playlist_h playlist) TIZEN_DEPRECATED_API;
 260
 261 /**
 262  * @deprecated Deprecated since 9.0.
 263  * @brief Clones a playlist handle.
 264  * @details This function copies the media playlist handle from a source to
 265  *          destination. There is no media_playlist_create() function. The media_playlist_h is created internally and available through
 266  *          media playlist foreach function such as media_playlist_foreach_playlist_from_db().
 267  *          To use this handle outside of these foreach functions, use this function.
 268  *
 269  * @since_tizen 2.3
 270  *
 271  * @remarks The @a dst should be released using media_playlist_destroy().
 272  *
 273  * @param[out] dst The destination handle to the media playlist
 274  * @param[in] src The source handle to the media playlist
 275  *
 276  * @return @c 0 on success,
 277  *         otherwise a negative error value
 278  *
 279  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 280  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 281  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 282  *
 283  * @see media_playlist_destroy()
 284  * @see media_playlist_foreach_playlist_from_db()
 285  */
 286 int media_playlist_clone(media_playlist_h *dst, media_playlist_h src) TIZEN_DEPRECATED_API;
 287
 288 /**
 289  * @deprecated Deprecated since 9.0.
 290  * @brief Gets the media playlist ID.
 291  * @since_tizen 2.3
 292  *
 293  * @param[in] playlist The handle to the media playlist
 294  * @param[out] playlist_id The ID of the media playlist
 295  *
 296  * @return @c 0 on success,
 297  *         otherwise a negative error value
 298  *
 299  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 300  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 301  */
 302 int media_playlist_get_playlist_id(media_playlist_h playlist, int *playlist_id) TIZEN_DEPRECATED_API;
 303
 304 /**
 305  * @deprecated Deprecated since 9.0.
 306  * @brief Gets a name of the playlist.
 307  * @since_tizen 2.3
 308  *
 309  * @remarks The @a playlist_name should be released using free().
 310  *
 311  * @param[in] playlist The handle to the media playlist
 312  * @param[out] playlist_name The playlist name
 313  *
 314  * @return @c 0 on success,
 315  *         otherwise a negative error value
 316  *
 317  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 318  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 319  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 320  */
 321 int media_playlist_get_name(media_playlist_h playlist, char **playlist_name) TIZEN_DEPRECATED_API;
 322
 323 /**
 324  * @deprecated Deprecated since 9.0.
 325  * @brief Sets the name of the playlist.
 326  * @since_tizen 2.3
 327  *
 328  * @param[in] playlist The handle to the media playlist
 329  * @param[in] playlist_name The name of the media playlist
 330  *
 331  * @return @c 0 on success,
 332  *         otherwise a negative error value
 333  *
 334  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 335  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 336  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 337  *
 338  * @post media_playlist_update_to_db()
 339  *
 340  */
 341 int media_playlist_set_name(media_playlist_h playlist, const char *playlist_name) TIZEN_DEPRECATED_API;
 342
 343 /**
 344  * @deprecated Deprecated since 9.0.
 345  * @brief Gets a thumbnail path of the playlist.
 346  * @since_tizen 2.3
 347  *
 348  * @remarks The @a path should be released using free().
 349  *
 350  * @param[in] playlist The handle to the media playlist
 351  * @param[out] path The path of the thumbnail
 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_OUT_OF_MEMORY     Out of memory
 359  */
 360 int media_playlist_get_thumbnail_path(media_playlist_h playlist, char **path) TIZEN_DEPRECATED_API;
 361
 362 /**
 363  * @deprecated Deprecated since 9.0.
 364  * @brief Sets the thumbnail path of the playlist.
 365  * @since_tizen 2.3
 366  *
 367  * @param[in] playlist The handle to the media playlist
 368  * @param[in] path The path of the thumbnail
 369  *
 370  * @return @c 0 on success,
 371  *         otherwise a negative error value
 372  *
 373  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 374  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 375  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 376  *
 377  * @post media_playlist_update_to_db()
 378  */
 379 int media_playlist_set_thumbnail_path(media_playlist_h playlist, const char *path) TIZEN_DEPRECATED_API;
 380
 381
 382 /**
 383  * @deprecated Deprecated since 9.0.
 384  * @brief Sets the playing order in the playlist.
 385  * @since_tizen 2.3
 386  *
 387  * @param[in] playlist The handle to the media playlist
 388  * @param[in] playlist_member_id The ID of the playlist member
 389  * @param[in] play_order The playing order
 390  *
 391  * @return @c 0 on success,
 392  *         otherwise a negative error value
 393  *
 394  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 395  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 396  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 397  *
 398  * @post media_playlist_update_to_db()
 399  */
 400 int media_playlist_set_play_order(media_playlist_h playlist, int playlist_member_id, int play_order) TIZEN_DEPRECATED_API;
 401
 402 /**
 403  * @deprecated Deprecated since 9.0.
 404  * @brief Adds a new media info to the playlist.
 405  * @since_tizen 2.3
 406  *
 407  * @param[in] playlist The handle to the media playlist
 408  * @param[in] media_id The media ID
 409  *
 410  * @return @c 0 on success,
 411  *         otherwise a negative error value
 412  *
 413  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 414  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 415  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 416  *
 417  * @pre  This function requires opened connection to content service by media_content_connect().
 418  * @post media_playlist_update_to_db()
 419  *
 420  * @see media_content_connect()
 421  * @see media_playlist_remove_media()
 422  */
 423 int media_playlist_add_media(media_playlist_h playlist, const char *media_id) TIZEN_DEPRECATED_API;
 424
 425 /**
 426  * @deprecated Deprecated since 9.0.
 427  * @brief Removes the playlist members related with the media from the given playlist.
 428  * @since_tizen 2.3
 429  *
 430  * @param[in] playlist The handle to the media playlist
 431  * @param[in] playlist_member_id The ID of the playlist member
 432  *
 433  * @return @c 0 on success,
 434  *         otherwise a negative error value
 435  *
 436  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 437  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 438  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 439  *
 440  * @pre  This function requires opened connection to content service by media_content_connect().
 441  * @post media_playlist_update_to_db()
 442  *
 443  * @see media_content_connect()
 444  * @see media_playlist_add_media()
 445  */
 446 int media_playlist_remove_media(media_playlist_h playlist, int playlist_member_id) TIZEN_DEPRECATED_API;
 447
 448 /**
 449  * @deprecated Deprecated since 9.0.
 450  * @brief Gets the played order of the playlist.
 451  * @since_tizen 2.3
 452  *
 453  * @param[in] playlist The handle to the media playlist
 454  * @param[in] playlist_member_id The ID of the playlist member
 455  * @param[out] play_order The played order
 456  *
 457  * @return @c 0 on success,
 458  *         otherwise a negative error value
 459  *
 460  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 461  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 462  */
 463 int media_playlist_get_play_order(media_playlist_h playlist, int playlist_member_id, int *play_order) TIZEN_DEPRECATED_API;
 464
 465 /**
 466  * @deprecated Deprecated since 9.0.
 467  * @brief Updates the media playlist to the media database.
 468  *
 469  * @details The function updates the given media playlist in the media database.
 470  *          The function should be called after any change in the playlist, to be updated to the media database.
 471  *          For example, after using media_playlist_set_name() for setting the name of the playlist, the
 472  *          media_playlist_update_to_db() function should be called so as to update
 473  *          the given playlist attributes in the media database.
 474  *
 475  * @since_tizen 2.3
 476  *
 477  * @privlevel public
 478  * @privilege %http://tizen.org/privilege/content.write
 479  *
 480  * @param[in] playlist The handle to the media playlist
 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_OUT_OF_MEMORY     Out of memory
 488  * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
 489  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 490  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 491  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
 492  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 493  *
 494  * @pre This function requires opened connection to content service by media_content_connect().
 495  *
 496  * @see media_content_connect()
 497  * @see media_playlist_destroy()
 498  * @see media_playlist_add_media()
 499  * @see media_playlist_remove_media()
 500  * @see media_playlist_set_name()
 501  * @see media_playlist_set_play_order()
 502  */
 503 int media_playlist_update_to_db(media_playlist_h playlist) TIZEN_DEPRECATED_API;
 504
 505 /**
 506  * @deprecated Deprecated since 9.0.
 507  * @brief Imports the playlist from m3u playlist file.
 508  * @details This function reads a playlist from the m3u playlist file and insert into the db.
 509  * @since_tizen 2.4
 510  *
 511  * @privlevel public
 512  * @privilege %http://tizen.org/privilege/content.write
 513  *
 514  * @remarks The @a playlist should be released using media_playlist_destroy().
 515  * @remarks   %http://tizen.org/privilege/mediastorage is needed if input or output path are relevant to media storage. \n
 516  *                     %http://tizen.org/privilege/externalstorage is needed if input or output path are relevant to external storage. \n
 517  *                     This function does not support the file of extended m3u playlist.
 518  *
 519  * @param[in] playlist_name The name of the media playlist to save
 520  * @param[in] path The path to import the playlist file
 521  * @param[out] playlist The handle to the media playlist
 522  *
 523  * @return @c 0 on success,
 524  *         otherwise a negative error value
 525  *
 526  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 527  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 528  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 529  * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
 530  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 531  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 532  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
 533  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 534  */
 535 int media_playlist_import_from_file(const char *playlist_name, const char *path, media_playlist_h *playlist) TIZEN_DEPRECATED_API;
 536
 537 /**
 538  * @deprecated Deprecated since 9.0.
 539  * @brief Exports the playlist to m3u playlist file.
 540  * @since_tizen 2.4
 541  *
 542  * @remarks   %http://tizen.org/privilege/mediastorage is needed if input or output path are relevant to media storage. \n
 543  *                     %http://tizen.org/privilege/externalstorage is needed if input or output path are relevant to external storage.
 544  *
 545  * @param[in] playlist The handle to the media playlist
 546  * @param[in] path path The path to export the playlist
 547  *
 548  * @return @c 0 on success,
 549  *         otherwise a negative error value
 550  *
 551  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
 552  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
 553  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
 554  * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
 555  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
 556  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
 557  * @retval #MEDIA_CONTENT_ERROR_NETWORK           Network fail
 558  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
 559  */
 560 int media_playlist_export_to_file(media_playlist_h playlist, const char* path) TIZEN_DEPRECATED_API;
 561
 562 /**
 563  * @}
 564  */
 565
 566 #ifdef __cplusplus
 567 }
 568 #endif /* __cplusplus */
 569 #endif /*__TIZEN_CONTENT_MEDIA_PLAYLIST_H__*/