The Video Metadata API provides functions to get information about video files present in the device.

Required Header

#include <media_content.h>

Overview

The Video Metadata API provides functions to get information about video files present in the device. Following information about video content (video_meta_h )is provided:

artist
album
genre
composer
year
recorded date
copyright
track number
bit rate
width
height
played count
played time
played position
and others.

For getting the video handle (video_meta_h) from the media information (media_info_h), call the media_info_get_video() function.
For getting the information related to video files stored in the device call the respective get functions e.g. to get duration of the video file call video_meta_get_duration() function and so on.
When the video handle is no longer needed, it should be destroyed by calling video_meta_destroy() function.

Functions
int	video_meta_clone (video_meta_h *dst, video_meta_h src)
	Clones the video metadata.
int	video_meta_destroy (video_meta_h video)
	Destroys the video metadata.
int	video_meta_get_media_id (video_meta_h video, char **media_id)
	Gets the ID of the media of the given video metadata.
int	video_meta_get_album (video_meta_h video, char **album)
	Gets the video's album.
int	video_meta_get_artist (video_meta_h video, char **artist)
	Gets the video artist.
int	video_meta_get_album_artist (video_meta_h video, char **album_artist)
	Gets the video album artist.
int	video_meta_get_genre (video_meta_h video, char **genre)
	Gets the video genre.
int	video_meta_get_composer (video_meta_h video, char **composer)
	Gets the video composer.
int	video_meta_get_year (video_meta_h video, char **year)
	Gets the year of the video.
int	video_meta_get_recorded_date (video_meta_h video, char **recorded_date)
	Gets the recorded date of the video.
int	video_meta_get_copyright (video_meta_h video, char **copyright)
	Gets the video copyright.
int	video_meta_get_track_num (video_meta_h video, char **track_num)
	Gets the track number of the video.
int	video_meta_get_bit_rate (video_meta_h video, int *bit_rate)
	Gets the video bit rate.
int	video_meta_get_duration (video_meta_h video, int *duration)
	Gets the duration of video metadata.
int	video_meta_get_width (video_meta_h video, int *width)
	Gets the video width in pixels.
int	video_meta_get_height (video_meta_h video, int *height)
	Gets the video height in pixels.
int	video_meta_get_played_count (video_meta_h video, int *played_count)
	Gets the played count of the video.
int	video_meta_get_played_time (video_meta_h video, time_t *played_time)
	Gets the last played time parameter of the video.
int	video_meta_get_played_position (video_meta_h video, int *played_position)
	Gets the position played parameter of the video.
int	video_meta_set_played_count (video_meta_h video, int played_count)
	Sets the played count of the video.
int	video_meta_set_played_time (video_meta_h video, time_t played_time)
	Sets the time last played parameter of the video.
int	video_meta_set_played_position (video_meta_h video, int played_position)
	Sets the position played parameter of the video.
int	video_meta_update_to_db (video_meta_h video)
	Updates the video to the media database.
Typedefs
typedef struct video_meta_s *	video_meta_h
	The structure type for the Video metadata handle.

Function Documentation

int video_meta_clone	(	video_meta_h *	dst,
		video_meta_h	src
	)

Clones the video metadata.

This function copies the video metadata handle from a source to destination.

Since :: 2.3.1

Remarks:: You must release the destination handle using video_meta_destroy().

Parameters:

[out]	dst	The destination handle to the video metadata
[in]	src	The source handle to the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

See also:: video_meta_destroy()

int video_meta_destroy ( video_meta_h video )

Destroys the video metadata.

This function frees all resources related to the video metadata handle. This handle no longer can be used to perform any operation. A new handle has to be created before the next use.

Since :: 2.3.1

Parameters:

[in] video The video metadata handle

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: Get copy of video metadata handle by calling video_meta_clone().

See also:: video_meta_clone()

int video_meta_get_album	(	video_meta_h	video,
		char **	album
	)

Gets the video's album.

If the value is an empty string, the method returns "Unknown".

Since :: 2.3.1

Remarks:: You must release album using free().

Parameters:

[in]	video	The video metadata handle
[out]	album	The video album or `NULL`

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_album_artist	(	video_meta_h	video,
		char **	album_artist
	)

Gets the video album artist.

If the value is an empty string, the method returns "Unknown".

Since :: 2.3.1

Remarks:: You must release album_artist using free().

Parameters:

[in]	video	The video metadata handle
[out]	album_artist	The album artist of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_artist	(	video_meta_h	video,
		char **	artist
	)

Gets the video artist.

If the value is an empty string, the method returns "Unknown".

Since :: 2.3.1

Remarks:: You must release artist using free().

Parameters:

[in]	video	The video metadata handle
[out]	artist	The artist of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_bit_rate	(	video_meta_h	video,
		int *	bit_rate
	)

Gets the video bit rate.

Since :: 2.3.1

Remarks:: You must release bit_rate using free().

Parameters:

[in]	video	The video metadata handle
[out]	bit_rate	The bit rate of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_composer	(	video_meta_h	video,
		char **	composer
	)

Gets the video composer.

If the value is an empty string, the method returns "Unknown".

Since :: 2.3.1

Remarks:: You must release composer using free().

Parameters:

[in]	video	The video metadata handle
[out]	composer	The composer of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_copyright	(	video_meta_h	video,
		char **	copyright
	)

Gets the video copyright.

Since :: 2.3.1

Remarks:: You must release copyright using free().

Parameters:

[in]	video	The video metadata handle
[out]	copyright	The copyright of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_duration	(	video_meta_h	video,
		int *	duration
	)

Gets the duration of video metadata.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[out]	duration	The video duration in milliseconds

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_genre	(	video_meta_h	video,
		char **	genre
	)

Gets the video genre.

If the value is an empty string, the method returns "Unknown".

Since :: 2.3.1

Remarks:: You must release genre using free().

Parameters:

[in]	video	The video metadata handle
[out]	genre	The genre of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_height	(	video_meta_h	video,
		int *	height
	)

Gets the video height in pixels.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[out]	height	The video height in pixels

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_media_id	(	video_meta_h	video,
		char **	media_id
	)

Gets the ID of the media of the given video metadata.

Since :: 2.3.1

Remarks:: You must release media_id using free().

Parameters:

[in]	video	The video metadata handle
[out]	media_id	The ID of the video

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_played_count	(	video_meta_h	video,
		int *	played_count
	)

Gets the played count of the video.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[out]	played_count	The number of played

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_played_position	(	video_meta_h	video,
		int *	played_position
	)

Gets the position played parameter of the video.

This function returns the elapsed playback time parameter of the video as period starting from the beginning of the movie.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[out]	played_position	The position from the beginning of the video (in milliseconds)

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_played_time	(	video_meta_h	video,
		time_t *	played_time
	)

Gets the last played time parameter of the video.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[out]	played_time	The time last played in the video

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_recorded_date	(	video_meta_h	video,
		char **	recorded_date
	)

Gets the recorded date of the video.

Since :: 2.3.1

Remarks:: You must release recorded_date using free().

Parameters:

[in]	video	The video metadata handle
[out]	recorded_date	The recorded date of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_track_num	(	video_meta_h	video,
		char **	track_num
	)

Gets the track number of the video.

If the value is an empty string, the method returns "Unknown".

Since :: 2.3.1

Remarks:: You must release track_num using free().

Parameters:

[in]	video	The video metadata handle
[out]	track_num	The track number of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_width	(	video_meta_h	video,
		int *	width
	)

Gets the video width in pixels.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[out]	width	The video width in pixels

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_get_year	(	video_meta_h	video,
		char **	year
	)

Gets the year of the video.

If the value is an empty string, the method returns "Unknown".

Since :: 2.3.1

Remarks:: You must release year using free().

Parameters:

[in]	video	The video metadata handle
[out]	year	The year of the video metadata

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

int video_meta_set_played_count	(	video_meta_h	video,
		int	played_count
	)

Sets the played count of the video.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[in]	played_count	The number of played

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

Postcondition:: video_meta_update_to_db().

int video_meta_set_played_position	(	video_meta_h	video,
		int	played_position
	)

Sets the position played parameter of the video.

This function returns video's elapsed playback time parameter as period starting from the beginning of the movie.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[in]	played_position	The position from the beginning of the video (in milliseconds)

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

Postcondition:: video_meta_update_to_db().

int video_meta_set_played_time	(	video_meta_h	video,
		time_t	played_time
	)

Sets the time last played parameter of the video.

Since :: 2.3.1

Parameters:

[in]	video	The video metadata handle
[in]	played_time	The time last played in the video

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

Postcondition:: video_meta_update_to_db().

int video_meta_update_to_db ( video_meta_h video )

Updates the video to the media database.

The function updates the given video meta in the media database. The function should be called after any change in video attributes, to be updated to the media database. For example, after using video_meta_get_played_time() for setting the played time of the video, the video_meta_update_to_db() function should be called so as to update the given video attributes in the media database.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/content.write

Remarks:: Do not call this function in callback function of foreach function like media_info_foreach_media_from_db().

Parameters:

[in] video The video metadata handle

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_CONTENT_ERROR_NONE	Successful
MEDIA_CONTENT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTENT_ERROR_PERMISSION_DENIED	Permission denied

Precondition:: This function requires opened connection to content service by media_content_connect().

See also:: media_content_connect(); video_meta_set_played_time(); video_meta_set_played_count()s; video_meta_set_played_position()

Required Header

Overview

Functions

Typedefs

Function Documentation