Tizen Native API  3.0
Media Information

The Media Information API provides functions to get information about media items stored on an internal and external storage.

Required Header

#include <media_content.h>

Overview

The Media Information API provides functions to get basic information e.g. path, date, type etc about media items (media_info_h) present in the device. Media Information (media_info_h) is a generalization of media content of any type (audio, image, video and others).

Received information about media items can be the processed using dedicated APIs:

API Description
Media Information Provides details about all items present in the device.
Provide functions to get information (e.g. title, size, mime type etc) about the files.
Audio Metadata Provides details about audio items present in the device.
Provide functions to get information (e.g. genre, album, year, bitrate etc) about the audio files.
Image Metadata Provides details about image items present in the device.
Provide functions to get information (e.g. longitude, description, date etc) about the image files.
Video Metadata Provides details about video items present in the device.
Provide functions to get information (e.g. title, duration, date etc) about the video files.

Video and Audio information can be further processed with respect to its properties i.e. playlist, album, using their respective APIs.

Foreach Operations

FOREACH CALLBACK DESCRIPTION
media_info_foreach_media_from_db() media_info_cb() Iterates through items
media_info_foreach_tag_from_db() media_tag_cb() Iterate through tags
media_info_foreach_bookmark_from_db() media_bookmark_cb() Iterate through bookmark

Functions

int media_info_insert_to_db (const char *path, media_info_h *info)
 Inserts a media file into the media database.
int media_info_insert_batch_to_db (const char **path_array, unsigned int array_length, media_insert_completed_cb callback, void *user_data)
 Inserts media files into the media database, asynchronously.
int media_info_insert_burst_shot_to_db (const char **path_array, unsigned int array_length, media_insert_burst_shot_completed_cb callback, void *user_data)
 Inserts the burst shot images into the media database, asynchronously.
int media_info_delete_from_db (const char *media_id)
 Deletes a media file from the media database.
int media_info_delete_batch_from_db (filter_h filter)
 Deletes media files from the media database. The media files for deletion can be specified as a condition in a filter.
int media_info_destroy (media_info_h media)
 Destroys media info.
int media_info_clone (media_info_h *dst, media_info_h src)
 Clones the media info handle.
int media_info_get_media_count_from_db (filter_h filter, int *media_count)
 Gets the count of media info for the passed filter from the media database.
int media_info_foreach_media_from_db (filter_h filter, media_info_cb callback, void *user_data)
 Iterates through media info from the media database.
int media_info_get_tag_count_from_db (const char *media_id, filter_h filter, int *tag_count)
 Gets the count of media tags for the passed filter in the given media_id from the media database.
int media_info_foreach_tag_from_db (const char *media_id, filter_h filter, media_tag_cb callback, void *user_data)
 Iterates through the media tag in the given media info from the media database.
int media_info_get_bookmark_count_from_db (const char *media_id, filter_h filter, int *bookmark_count)
 Gets the number of bookmarks for the passed filter in the given media ID from the media database.
int media_info_foreach_bookmark_from_db (const char *media_id, filter_h filter, media_bookmark_cb callback, void *user_data)
 Iterates through the media bookmark in the given media info from the media database.
int media_info_get_face_count_from_db (const char *media_id, filter_h filter, int *face_count)
 Gets the number of face for the passed media_id from the media database.
int media_info_foreach_face_from_db (const char *media_id, filter_h filter, media_face_cb callback, void *user_data)
 Iterates through the media files with optional media_id in the given face face from the media database.
int media_info_get_image (media_info_h media, image_meta_h *image)
 Gets the image metadata for a given media info.
int media_info_get_video (media_info_h media, video_meta_h *video)
 Gets a video metadata for a given media info.
int media_info_get_audio (media_info_h media, audio_meta_h *audio)
 Gets an audio metadata for a given media info.
int media_info_get_media_id (media_info_h media, char **media_id)
 Gets the tag ID for the media info.
int media_info_get_file_path (media_info_h media, char **path)
 Gets the path to the media info.
int media_info_get_display_name (media_info_h media, char **name)
 Gets the name of the media info.
int media_info_get_media_type (media_info_h media, media_content_type_e *type)
 Gets the content type of the media info.
int media_info_get_mime_type (media_info_h media, char **mime_type)
 Gets the MIME type from the media info.
int media_info_get_size (media_info_h media, unsigned long long *size)
 Gets the media file size.
int media_info_get_added_time (media_info_h media, time_t *added_time)
 Gets the addition time of the media.
int media_info_get_modified_time (media_info_h media, time_t *time)
 Gets the date of modification of media info.
int media_info_get_timeline (media_info_h media, time_t *time)
 Gets the timeline of media info.
int media_info_get_thumbnail_path (media_info_h media, char **path)
 Gets the thumbnail of media info.
int media_info_get_description (media_info_h media, char **description)
 Gets the description of media info.
int media_info_get_longitude (media_info_h media, double *longitude)
 Gets the longitude of media info.
int media_info_get_latitude (media_info_h media, double *latitude)
 Gets the latitude of media info.
int media_info_get_altitude (media_info_h media, double *altitude)
 Gets the altitude of media info.
int media_info_get_weather (media_info_h media, char **weather)
 Gets the weather of media info.
int media_info_get_rating (media_info_h media, int *rating)
 Gets the rating of media info.
int media_info_get_favorite (media_info_h media, bool *favorite)
 Gets the favorite status of media info.
int media_info_get_author (media_info_h media, char **author)
 Gets the author of media info.
int media_info_get_provider (media_info_h media, char **provider)
 Gets the provider of media info.
int media_info_get_content_name (media_info_h media, char **content_name)
 Gets the content name of media info.
int media_info_get_title (media_info_h media, char **title)
 Gets the title of media info.
int media_info_get_category (media_info_h media, char **category)
 Gets the category of media info.
int media_info_get_location_tag (media_info_h media, char **location_tag)
 Gets the location tag of media info.
int media_info_get_age_rating (media_info_h media, char **age_rating)
 Gets the age_rating of media info.
int media_info_get_keyword (media_info_h media, char **keyword)
 Gets the keyword of media info.
int media_info_get_storage_id (media_info_h media, char **storage_id)
 Gets the storage id of media info.
int media_info_is_drm (media_info_h media, bool *is_drm)
 Checks whether the media is protected via DRM.
int media_info_is_360_content (media_info_h media, bool *is_360)
 Checks whether the media is 360 content.
int media_info_get_storage_type (media_info_h media, media_content_storage_e *storage_type)
 Gets the storage type of media info.
int media_info_get_played_count (media_info_h media, int *played_count)
 Gets number which represents how many times given content has been played.
int media_info_get_played_time (media_info_h media, time_t *played_time)
 Gets the content's played time parameter.
int media_info_get_media_from_db (const char *media_id, media_info_h *media)
 Gets the media info from the media database.
int media_info_increase_played_count (media_info_h media)
 Increments the played count to content meta handle.
int media_info_set_played_time (media_info_h media)
 Sets the played time to content meta handle.
int media_info_set_display_name (media_info_h media, const char *display_name)
 Sets the display name of media info.
int media_info_set_description (media_info_h media, const char *description)
 Sets the description of media info.
int media_info_set_longitude (media_info_h media, double longitude)
 Sets the longitude of media info.
int media_info_set_latitude (media_info_h media, double latitude)
 Sets the latitude of media info.
int media_info_set_altitude (media_info_h media, double altitude)
 Sets the altitude of media info.
int media_info_set_weather (media_info_h media, const char *weather)
 Sets the weather of media info.
int media_info_set_rating (media_info_h media, int rating)
 Sets the rating of media info.
int media_info_set_favorite (media_info_h media, bool favorite)
 Sets the favorite of media info.
int media_info_set_author (media_info_h media, const char *author)
 Sets the author of media info.
int media_info_set_provider (media_info_h media, const char *provider)
 Sets the provider of media info.
int media_info_set_content_name (media_info_h media, const char *content_name)
 Sets the content name of media info.
int media_info_set_category (media_info_h media, const char *category)
 Sets the category of media info.
int media_info_set_location_tag (media_info_h media, const char *location_tag)
 Sets the location tag of media info.
int media_info_set_age_rating (media_info_h media, const char *age_rating)
 Sets the age rating of media info.
int media_info_set_keyword (media_info_h media, const char *keyword)
 Sets the keyword of media info.
int media_info_update_to_db (media_info_h media)
 Updates the media info to the media database.
int media_info_refresh_metadata_to_db (const char *media_id)
 Refreshes the media metadata to the media database.
int media_info_set_added_time (media_info_h media, time_t added_time)
 Sets the added time of media info.
int media_info_move_to_db (media_info_h media, const char *dst_path)
 Moves the media info to the given destination path in the media database.
int media_info_create_thumbnail (media_info_h media, media_thumbnail_completed_cb callback, void *user_data)
 Creates a thumbnail image for the given media, asynchronously.
int media_info_cancel_thumbnail (media_info_h media)
 Cancels the creation of image's thumbnail for the given media.
int media_info_create (const char *path, media_info_h *media)
 Creates the media info handle.
int media_info_insert_to_db_with_data (media_info_h media)
 Inserts media info to database with media info data.
int media_info_set_title (media_info_h media, const char *title)
 Sets the title of media info handle.
int media_info_set_album (media_info_h media, const char *album)
 Sets the album of media info handle.
int media_info_set_artist (media_info_h media, const char *artist)
 Sets the artist of media info handle.
int media_info_set_genre (media_info_h media, const char *genre)
 Sets the genre of media info handle.
int media_info_set_recorded_date (media_info_h media, const char *recorded_date)
 Sets the recorded date of media info handle.

Typedefs

typedef struct media_info_s * media_info_h
 The structure type for the Media info handle.
typedef bool(* media_info_cb )(media_info_h media, void *user_data)
 Called for every available media info.
typedef void(* media_insert_completed_cb )(media_content_error_e error, void *user_data)
 Called when media items are inserted completely.
typedef void(* media_insert_burst_shot_completed_cb )(media_content_error_e error, void *user_data)
 Called when the burst shot is inserted completely.
typedef void(* media_thumbnail_completed_cb )(media_content_error_e error, const char *path, void *user_data)
 Called when creating a thumbnail image.

Typedef Documentation

typedef bool(* media_info_cb)(media_info_h media, void *user_data)

Called for every available media info.

Since :
2.3.1

Iterates over a list of media info.

Remarks:
To use the media outside this function, copy the handle with media_info_clone() function.
The callback is called in the main loop.
Parameters:
[in]mediaThe handle to the media info
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop, otherwise false to break out of the loop
Precondition:
media_tag_foreach_media_from_db(), media_playlist_foreach_media_from_db(), media_genre_foreach_media_from_db(), media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
See also:
media_info_clone()
media_album_foreach_media_from_db()
media_playlist_foreach_media_from_db()
media_tag_foreach_media_from_db()
media_info_foreach_media_from_db()
media_folder_foreach_media_from_db()
typedef struct media_info_s* media_info_h

The structure type for the Media info handle.

Since :
2.3.1
typedef void(* media_insert_burst_shot_completed_cb)(media_content_error_e error, void *user_data)

Called when the burst shot is inserted completely.

Since :
2.3.1
Remarks:
The callback is called in a separate thread(not in the main loop).
Parameters:
[in]mediaThe handle to the media info
[in]user_dataThe user data passed from the foreach function
Precondition:
media_info_insert_burst_shot_to_db()
See also:
media_info_insert_burst_shot_to_db()
typedef void(* media_insert_completed_cb)(media_content_error_e error, void *user_data)

Called when media items are inserted completely.

Since :
2.3.1
Remarks:
The callback is called in a separate thread(not in the main loop).
Parameters:
[in]mediaThe handle to the media info
[in]user_dataThe user data passed from the foreach function
Precondition:
media_info_insert_batch_to_db()
See also:
media_info_insert_batch_to_db()
typedef void(* media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data)

Called when creating a thumbnail image.

Since :
2.3.1

This callback is called for completion of generating the thumbnail image.

Remarks:
The callback is called in a separate thread(not in the main loop).
Parameters:
[in]errorThe error code
[in]pathThe path of the thumbnail which is generated
[in]user_dataThe user data passed from the foreach function
Precondition:
media_info_create_thumbnail()
See also:
media_info_create_thumbnail()

Enumeration Type Documentation

Enumeration for orientation types.

Since :
2.3.1
Enumerator:
MEDIA_CONTENT_ORIENTATION_NOT_AVAILABLE 

Not available

MEDIA_CONTENT_ORIENTATION_NORMAL 

Normal

MEDIA_CONTENT_ORIENTATION_HFLIP 

Flip horizontal

MEDIA_CONTENT_ORIENTATION_ROT_180 

Rotate 180 degrees

MEDIA_CONTENT_ORIENTATION_VFLIP 

Flip vertical

MEDIA_CONTENT_ORIENTATION_TRANSPOSE 

Transpose

MEDIA_CONTENT_ORIENTATION_ROT_90 

Rotate 90 degrees

MEDIA_CONTENT_ORIENTATION_TRANSVERSE 

Transverse

MEDIA_CONTENT_ORIENTATION_ROT_270 

Rotate 270 degrees


Function Documentation

Cancels the creation of image's thumbnail for the given media.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
Remarks:
If you request cancel for the already thumbnail created media, this API return MEDIA_CONTENT_ERROR_INVALID_OPERATION
Parameters:
[in]mediaThe media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_clone ( media_info_h dst,
media_info_h  src 
)

Clones the media info handle.

This function copies the media info handle from a source to the destination. There is no media_info_create() function. The media_info_h is created internally and available through media info foreach function such as media_info_foreach_media_from_db(). To use this handle outside of these foreach functions, use this function.

Since :
2.3.1
Remarks:
You must release the destination handle using media_info_destroy().
Parameters:
[out]dstThe destination handle to the media info
[in]srcThe source handle to media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
See also:
media_info_destroy()
media_album_foreach_media_from_db()
media_playlist_foreach_media_from_db()
media_group_foreach_media_from_db
media_tag_foreach_media_from_db()
media_info_foreach_media_from_db()
media_folder_foreach_media_from_db()
int media_info_create ( const char *  path,
media_info_h media 
)

Creates the media info handle.

If the information about the file that is already known, you can use this API to generate empty handler. And you can add the information to the generated handler using media_info_set_XXX() API. After filling the information to the handler, you can insert into database using media_info_insert_to_db_with_data() API.

Since :
3.0
Privilege:
http://tizen.org/privilege/mediastorage
http://tizen.org/privilege/externalstorage
Remarks:
If you want to access only internal storage with this API, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage with this API, you should add privilege http://tizen.org/privilege/externalstorage.
If you can access both storage, you must add all privilege.
Parameters:
[in]pathThe path to create the media info handle
[out]mediaThe media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_DB_FAILEDDB operation failed
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
See also:
media_info_insert_to_db_with_data()
media_info_destroy()
int media_info_create_thumbnail ( media_info_h  media,
media_thumbnail_completed_cb  callback,
void *  user_data 
)

Creates a thumbnail image for the given media, asynchronously.

This function creates an thumbnail image for given media item and calls registered callback function for completion of creating the thumbnail. If a thumbnail already exists for the given media, then the path of thumbnail will be returned in callback function.
Since 3.0, a thumbnail is not automatically extracted during media scanning.
Therefore, if there exists no thumbnail for the given media, you MUST call this function to create a thumbnail.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
Remarks:
If you want to destroy media handle before callback invoked, you must cancel thumbnail request by using media_info_cancel_thumbnail()
Since 3.0, if creation of a thumbnail is failed, empty string will be passed through media_thumbnail_completed_cb(). Items in external storage except MMC not supported.
Parameters:
[in]mediaThe media info handle
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()

Deletes media files from the media database. The media files for deletion can be specified as a condition in a filter.

This function deletes the media items from the content storage. Normally, deleting media files in the database are done automatically by the media server, without calling this function. This function is only called when the media server is busy and user needs to get quick result of deleting.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
Parameters:
[in]filterThe handle to filter
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_delete_from_db ( const char *  media_id)

Deletes a media file from the media database.

This function deletes a media item from the content storage. Normally, deleting a media file in the database is done automatically by the media server, without calling this function. This function is only called when the media server is busy and user needs to get quick result of deleting.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
Parameters:
[in]media_idThe ID to the media file
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()

Destroys media info.

The function frees all resources related to the media info handle. This handle can no longer be used to perform any operation. New media info handle has to be created before the next usage.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Get copy of media_info handle by calling media_info_clone().
See also:
media_info_clone()
int media_info_foreach_bookmark_from_db ( const char *  media_id,
filter_h  filter,
media_bookmark_cb  callback,
void *  user_data 
)

Iterates through the media bookmark in the given media info from the media database.

This function gets all media bookmarks associated with the given media and calls registered callback function for every retrieved media bookmark.

Since :
2.3.1
Parameters:
[in]media_idThe ID of the media info
[in]filterThe handle to the media filter
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
Postcondition:
This function invokes media_bookmark_cb().
See also:
media_content_connect()
media_bookmark_cb()
int media_info_foreach_face_from_db ( const char *  media_id,
filter_h  filter,
media_face_cb  callback,
void *  user_data 
)

Iterates through the media files with optional media_id in the given face face from the media database.

This function gets all media face info associated with the given media id and meeting desired filter option and calls registered callback function for every retrieved media face info. If NULL is passed to the filter, no filtering is applied.

Since :
3.0
Parameters:
[in]media_idmedia id
[in]filterThe handle to the media filter
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value.
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
media_filter_create()
int media_info_foreach_media_from_db ( filter_h  filter,
media_info_cb  callback,
void *  user_data 
)

Iterates through media info from the media database.

This function gets all media info handles meeting the given filter. The callback function will be invoked for every retrieved media info. If NULL is passed to the filter, then no filtering is applied.

Since :
2.3.1
Remarks:
Do not call updating DB function like media_info_update_to_db(), media_info_refresh_metadata_to_db(), audio_meta_update_to_db(), image_meta_update_to_db() and video_meta_update_to_db() in your callback function, your callback function is invoked as inline function. So, your callback function is in read state in SQLite. When you are in read state, sometimes you do not update DB. We do not recommend you call updating DB function in callback of foreach function.
Parameters:
[in]filterThe media info handle filter
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
Postcondition:
This function invokes media_info_cb().
See also:
media_content_connect()
media_info_cb
media_info_filter_create()
int media_info_foreach_tag_from_db ( const char *  media_id,
filter_h  filter,
media_tag_cb  callback,
void *  user_data 
)

Iterates through the media tag in the given media info from the media database.

This function gets all the media tags associated with the given media_id and calls registered callback function for every retrieved media tag.

Since :
2.3.1
Parameters:
[in]media_idThe ID of the media info
[in]filterThe handle to the media filter
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
Postcondition:
This function invokes media_tag_cb().
See also:
media_content_connect()
media_tag_cb
int media_info_get_added_time ( media_info_h  media,
time_t *  added_time 
)

Gets the addition time of the media.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]added_timeThe added time to the DB
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_age_rating ( media_info_h  media,
char **  age_rating 
)

Gets the age_rating of media info.

Since :
2.3.1
Remarks:
You must release age_rating using free().
Parameters:
[in]mediaThe media info handle
[out]age_ratingThe age rating of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_altitude ( media_info_h  media,
double *  altitude 
)

Gets the altitude of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]altitudeThe altitude of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_audio ( media_info_h  media,
audio_meta_h audio 
)

Gets an audio metadata for a given media info.

This function returns an audio metadata handle retrieved from the media info handle.

Since :
2.3.1
Remarks:
You must release the audio handle using audio_meta_destroy().
Parameters:
[in]mediaThe media info handle
[out]audioA handle to the audio meta
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
See also:
audio_meta_destroy()
int media_info_get_author ( media_info_h  media,
char **  author 
)

Gets the author of media info.

Since :
2.3.1
Remarks:
You must release author using free().
Parameters:
[in]mediaThe media info handle
[out]authorThe author of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_bookmark_count_from_db ( const char *  media_id,
filter_h  filter,
int *  bookmark_count 
)

Gets the number of bookmarks for the passed filter in the given media ID from the media database.

Since :
2.3.1
Parameters:
[in]media_idThe ID of the media info
[in]filterThe handle to the media filter
[out]bookmark_countThe count of the media tag
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_get_category ( media_info_h  media,
char **  category 
)

Gets the category of media info.

Since :
2.3.1
Remarks:
You must release category using free().
Parameters:
[in]mediaThe media info handle
[out]categoryThe category of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_content_name ( media_info_h  media,
char **  content_name 
)

Gets the content name of media info.

Since :
2.3.1
Remarks:
You must release content_name using free().
Parameters:
[in]mediaThe media info handle
[out]content_nameThe content name of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_description ( media_info_h  media,
char **  description 
)

Gets the description of media info.

If the value is an empty string, the method returns "Unknown".
Since 3.0, if the media info has no description, the method returns empty string.

Since :
2.3.1
Remarks:
You must release description using free().
Parameters:
[in]mediaThe media info handle
[out]descriptionThe description of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_display_name ( media_info_h  media,
char **  name 
)

Gets the name of the media info.

Since :
2.3.1
Remarks:
You must release name using free().
Parameters:
[in]mediaThe media info handle
[out]nameThe name of media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_face_count_from_db ( const char *  media_id,
filter_h  filter,
int *  face_count 
)

Gets the number of face for the passed media_id from the media database.

Since :
3.0
Parameters:
[in]media_idmedia id
[in]filterThe handle to the media filter
[out]face_countThe count of media face
Returns:
0 on success, otherwise a negative error value.
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_DB_FAILEDDB operation failed
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_get_favorite ( media_info_h  media,
bool *  favorite 
)

Gets the favorite status of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]favoritetrue if media info is set as favorite, otherwise false if media info is not set as favorite
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_file_path ( media_info_h  media,
char **  path 
)

Gets the path to the media info.

Since :
2.3.1
Remarks:
You must release path using free().
Parameters:
[in]mediaThe media info handle
[out]pathThe path of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_image ( media_info_h  media,
image_meta_h image 
)

Gets the image metadata for a given media info.

This function returns an image metadata handle retrieved from the media info.

Since :
2.3.1
Remarks:
You must release the image handle using image_meta_destroy().
Parameters:
[in]mediaThe media info handle
[out]imageA handle to image metadata
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
See also:
image_meta_destroy()
int media_info_get_keyword ( media_info_h  media,
char **  keyword 
)

Gets the keyword of media info.

Since :
2.3.1
Remarks:
You must release keyword using free().
Parameters:
[in]mediaThe media info handle
[out]keywordThe keyword of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_latitude ( media_info_h  media,
double *  latitude 
)

Gets the latitude of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]latitudeThe latitude of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_location_tag ( media_info_h  media,
char **  location_tag 
)

Gets the location tag of media info.

Since :
2.3.1
Remarks:
You must release location_tag using free().
Parameters:
[in]mediaThe media info handle
[out]location_tagThe location of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_longitude ( media_info_h  media,
double *  longitude 
)

Gets the longitude of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]longitudeThe longitude of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_media_count_from_db ( filter_h  filter,
int *  media_count 
)

Gets the count of media info for the passed filter from the media database.

Since :
2.3.1
Parameters:
[in]filterThe handle to filter
[out]media_countThe count of media
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_get_media_from_db ( const char *  media_id,
media_info_h media 
)

Gets the media info from the media database.

This function creates a new media handle from the media database by the given media_id. Media info will be created and filled with information.

Since :
2.3.1
Remarks:
You must release media using media_tag_destroy().
Parameters:
[in]media_idThe ID of media info
[out]mediaThe media handle associated with the media ID
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
media_info_destroy()
int media_info_get_media_id ( media_info_h  media,
char **  media_id 
)

Gets the tag ID for the media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]media_idThe ID of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied

Gets the content type of the media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]typeThe type of the media content (media_content_type_e)
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_mime_type ( media_info_h  media,
char **  mime_type 
)

Gets the MIME type from the media info.

Since :
2.3.1
Remarks:
You must release mime_type using free().
Parameters:
[in]mediaThe media info handle
[out]mime_typeThe MIME type of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_modified_time ( media_info_h  media,
time_t *  time 
)

Gets the date of modification of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]timeThe date of modification of the file
Get from the file.
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_played_count ( media_info_h  media,
int *  played_count 
)

Gets number which represents how many times given content has been played.

Since :
3.0
Parameters:
[in]mediaThe handle to media info
[out]played_countThe counter of content played
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
int media_info_get_played_time ( media_info_h  media,
time_t *  played_time 
)

Gets the content's played time parameter.

Function returns content's elapsed playback time parameter as period starting from the beginning of the track.

Since :
3.0
Parameters:
[in]mediaThe handle to media info
[out]played_timeThe elapsed time of the content
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
int media_info_get_provider ( media_info_h  media,
char **  provider 
)

Gets the provider of media info.

Since :
2.3.1
Remarks:
You must release provider using free().
Parameters:
[in]mediaThe media info handle
[out]providerThe provider of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_rating ( media_info_h  media,
int *  rating 
)

Gets the rating of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]ratingThe rating of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_size ( media_info_h  media,
unsigned long long *  size 
)

Gets the media file size.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]sizeThe type of the media content
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_storage_id ( media_info_h  media,
char **  storage_id 
)

Gets the storage id of media info.

Since :
3.0
Remarks:
You must release storage_id using free().
Parameters:
[in]mediaThe media info handle
[out]storage_idThe storage id of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied

Gets the storage type of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]storage_typeThe storage type of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_tag_count_from_db ( const char *  media_id,
filter_h  filter,
int *  tag_count 
)

Gets the count of media tags for the passed filter in the given media_id from the media database.

Since :
2.3.1
Parameters:
[in]media_idThe ID of the media info
[in]filterThe handle to the media filter
[out]tag_countThe count of the media tag
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_get_thumbnail_path ( media_info_h  media,
char **  path 
)

Gets the thumbnail of media info.

Since :
2.3.1
Remarks:
You must release path using free().
If the thumbnail extraction for the given media has not been requested yet, this API returns NULL. To create a thumbnail, you should use media_info_create_thumbnail() API.
Since 3.0, this function returns an empty string if media_info_create_thumbnail() has failed to create a thumbnail for the given media.
Parameters:
[in]mediaThe media info handle
[out]pathThe path to the thumbnail of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_timeline ( media_info_h  media,
time_t *  time 
)

Gets the timeline of media info.

If the image file has the creation time, the value of the timeline is the creation time.
Otherwise, the value of the timeline is the same as modified time.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]timeThe date of the timeline
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_title ( media_info_h  media,
char **  title 
)

Gets the title of media info.

If the value is an empty string, the method returns "Unknown".
Since 3.0, if the media info has no title, the method returns empty string.

Since :
2.3.1
Remarks:
You must release title using free().
Parameters:
[in]mediaThe media info handle
[out]titleThe title of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_get_video ( media_info_h  media,
video_meta_h video 
)

Gets a video metadata for a given media info.

This function returns a video metadata handle retrieved from the media info handle.

Since :
2.3.1
Remarks:
You must release the video handle using video_meta_destroy().
Parameters:
[in]mediaThe media info handle
[out]videoA handle to the video meta
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
See also:
video_meta_destroy()
int media_info_get_weather ( media_info_h  media,
char **  weather 
)

Gets the weather of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]weatherThe weather of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied

Increments the played count to content meta handle.

You can increase the played(opened) count of the media file.

Since :
3.0
Parameters:
[in]mediaThe handle to media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
media_info_update_to_db()
int media_info_insert_batch_to_db ( const char **  path_array,
unsigned int  array_length,
media_insert_completed_cb  callback,
void *  user_data 
)

Inserts media files into the media database, asynchronously.

This function inserts media items into the content storage. Normally, inserting a media file in database is done automatically by the media server, without calling this function. This function invokes media_insert_completed_cb() callback function when insertion to the media database is finished.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
http://tizen.org/privilege/mediastorage
http://tizen.org/privilege/externalstorage
Remarks:
You must add privilege http://tizen.org/privilege/content.write. And You add more privilege depending on your choice of contents path.
If you want to access only internal storage by using this API, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage by using this API, you should add privilege http://tizen.org/privilege/externalstorage.
If you can access both storage, you must add all privilege.
Parameters:
[in]path_arrayThe path array to the media files
[in]array_lengthThe length of the array
[in]callbackThe callback to be invoked when media items inserted completely
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
media_insert_completed_cb()
int media_info_insert_burst_shot_to_db ( const char **  path_array,
unsigned int  array_length,
media_insert_burst_shot_completed_cb  callback,
void *  user_data 
)

Inserts the burst shot images into the media database, asynchronously.

This function inserts burst images into the content storage. media_insert_burst_shot_completed_cb() will be called when insertion to media database is finished.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
http://tizen.org/privilege/mediastorage
http://tizen.org/privilege/externalstorage
Remarks:
You must add privilege http://tizen.org/privilege/content.write. And You add more privilege depending on your choice of contents path.
If you want to access only internal storage with this API, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage with this API, you should add privilege http://tizen.org/privilege/externalstorage.
If you can access both storage, you must add all privilege.
Parameters:
[in]path_arrayThe path array to the burst shot images
[in]array_lengthThe length of the array
[in]callbackThe callback to be invoked when the images are inserted completely
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
media_insert_burst_shot_completed_cb()
int media_info_insert_to_db ( const char *  path,
media_info_h info 
)

Inserts a media file into the media database.

This function inserts a media item into the content storage. Normally, inserting a media file in database is done automatically by the media server, without calling this function. This function is only called when the media server is busy and the user needs to get quick result of inserting e.g. Taking a photo while media server is busy and the user wants to see the quick snapshot of the photo taken.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
http://tizen.org/privilege/mediastorage
http://tizen.org/privilege/externalstorage
Remarks:
You must release the handle using media_info_destroy().
You must add privilege http://tizen.org/privilege/content.write. And You add more privilege depending on your choice of contents path.
If you want to access only internal storage by using this API, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage by using this API, you should add privilege http://tizen.org/privilege/externalstorage.
If you can access both storage, you must add all privilege.
Parameters:
[in]pathThe path to the media file
[out]infoThe handle to the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()

Inserts media info to database with media info data.

After filling the information to the generated handler using media_info_create() API, you can insert into database using this API.

Since :
3.0
Remarks:
You must create media handle using media_info_create(), and release info using media_info_destroy().
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
Parameters:
[in]mediaThe media info handle to be inserted
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_DB_FAILEDDB operation failed
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
See also:
media_info_create()
int media_info_is_360_content ( media_info_h  media,
bool *  is_360 
)

Checks whether the media is 360 content.

Since :
3.0
Parameters:
[in]mediaThe media info handle
[out]is_360true if media is 360 content, otherwise false if media is not 360 content
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
int media_info_is_drm ( media_info_h  media,
bool *  is_drm 
)

Checks whether the media is protected via DRM.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[out]is_drmtrue if media is DRM media, otherwise false if media is not DRM media
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_move_to_db ( media_info_h  media,
const char *  dst_path 
)

Moves the media info to the given destination path in the media database.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
http://tizen.org/privilege/mediastorage
http://tizen.org/privilege/externalstorage
Remarks:
You must add privilege http://tizen.org/privilege/content.write. And You add more privilege depending on your choice of contents path.
If you want to access only internal storage by using this API, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage by using this API, you should add privilege http://tizen.org/privilege/externalstorage.
If you can access both storage, you should add all privilege.
Parameters:
[in]mediaThe media info handle
[in]dst_pathThe path of destination
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter (Especially, if the request is duplicated, this error returns.)
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_refresh_metadata_to_db ( const char *  media_id)

Refreshes the media metadata to the media database.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
http://tizen.org/privilege/mediastorage
http://tizen.org/privilege/externalstorage
Remarks:
You must add privilege http://tizen.org/privilege/content.write. And You add more privilege depending on your choice of contents path.
If you want to access only internal storage by using this API, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage by using this API, you should add privilege http://tizen.org/privilege/externalstorage.
If you can access both storage, you should add all privilege.
Parameters:
[in]media_idThe ID of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
int media_info_set_added_time ( media_info_h  media,
time_t  added_time 
)

Sets the added time of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]added_timeThe added time of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db()
int media_info_set_age_rating ( media_info_h  media,
const char *  age_rating 
)

Sets the age rating of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]age_ratingThe age rating of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db()
int media_info_set_album ( media_info_h  media,
const char *  album 
)

Sets the album of media info handle.

Since :
3.0
Parameters:
[in]mediaThe media info handle
[in]albumThe album of media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
media_info_insert_to_db_with_data()
int media_info_set_altitude ( media_info_h  media,
double  altitude 
)

Sets the altitude of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]altitudeThe altitude of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db().
int media_info_set_artist ( media_info_h  media,
const char *  artist 
)

Sets the artist of media info handle.

Since :
3.0
Parameters:
[in]mediaThe media info handle
[in]artistThe artist of media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
media_info_insert_to_db_with_data()
int media_info_set_author ( media_info_h  media,
const char *  author 
)

Sets the author of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]authorThe author of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_set_category ( media_info_h  media,
const char *  category 
)

Sets the category of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]categoryThe category of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db()
int media_info_set_content_name ( media_info_h  media,
const char *  content_name 
)

Sets the content name of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]content_nameThe content name of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db()
int media_info_set_description ( media_info_h  media,
const char *  description 
)

Sets the description of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]descriptionThe description of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db().
int media_info_set_display_name ( media_info_h  media,
const char *  display_name 
)

Sets the display name of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]display_nameThe display name of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db().
int media_info_set_favorite ( media_info_h  media,
bool  favorite 
)

Sets the favorite of media info.

This function can mark favorite of the media. If set to true, this fuction record the time of the change moment.
So, If you use it in order parameter, you can sort the order of the time was a favorite.
Or, if you use it in condition parameter, you can get the result of the favorite media.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]favoriteSet true to set the media info as favorite, otherwise set false to not set the media info as favorite
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_set_genre ( media_info_h  media,
const char *  genre 
)

Sets the genre of media info handle.

Since :
3.0
Parameters:
[in]mediaThe media info handle
[in]genreThe genre of media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
media_info_insert_to_db_with_data()
int media_info_set_keyword ( media_info_h  media,
const char *  keyword 
)

Sets the keyword of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]keywordThe keyword of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db()
int media_info_set_latitude ( media_info_h  media,
double  latitude 
)

Sets the latitude of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]latitudeThe latitude of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db().
int media_info_set_location_tag ( media_info_h  media,
const char *  location_tag 
)

Sets the location tag of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]location_tagThe location of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db()
int media_info_set_longitude ( media_info_h  media,
double  longitude 
)

Sets the longitude of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]longitudeThe longitude of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db().

Sets the played time to content meta handle.

You can set the latest played(opened) time of the media file. the latest played time to be set the current time on the system.

Since :
3.0
Parameters:
[in]mediaThe handle to media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
media_info_update_to_db()
int media_info_set_provider ( media_info_h  media,
const char *  provider 
)

Sets the provider of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]providerThe provider of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
int media_info_set_rating ( media_info_h  media,
int  rating 
)

Sets the rating of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]ratingThe rating of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db().
int media_info_set_recorded_date ( media_info_h  media,
const char *  recorded_date 
)

Sets the recorded date of media info handle.

Since :
3.0
Parameters:
[in]mediaThe media info handle
[in]recorded_dateThe recorded date of media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
media_info_insert_to_db_with_data()
int media_info_set_title ( media_info_h  media,
const char *  title 
)

Sets the title of media info handle.

Since :
3.0
Parameters:
[in]mediaThe media info handle
[in]titleThe title of media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
media_info_insert_to_db_with_data()
int media_info_set_weather ( media_info_h  media,
const char *  weather 
)

Sets the weather of media info.

Since :
2.3.1
Parameters:
[in]mediaThe media info handle
[in]weatherThe weather of the media info
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Postcondition:
media_info_update_to_db().

Updates the media info to the media database.

The function updates the given media info in the media database.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
Remarks:
The function should be called after any change in media, to be updated to the media database. For example, after using media_info_set_display_name() for setting the name of the media, the media_info_update_to_db() function should be called so as to update the given media info attributes in the media database.
Parameters:
[in]mediaThe media info handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTENT_ERROR_NONESuccessful
MEDIA_CONTENT_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORYOut of memory
MEDIA_CONTENT_ERROR_INVALID_OPERATIONInvalid operation
MEDIA_CONTENT_ERROR_DB_FAILEDDB Operation failed
MEDIA_CONTENT_ERROR_DB_BUSYDB Operation busy
MEDIA_CONTENT_ERROR_NETWORKNetwork fail
MEDIA_CONTENT_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
This function requires opened connection to content service by media_content_connect().
See also:
media_content_connect()
media_info_set_display_name()
media_info_set_description()
media_info_set_longitude()
media_info_set_latitude()
media_info_set_altitude()
media_info_set_rating()
media_info_set_favorite()
media_info_set_author()
media_info_set_provider()
media_info_set_content_name()
media_info_set_category()
media_info_set_location_tag()
media_info_set_age_rating()