* @since_tizen 2.3
* @remarks If you use HTTP or RSTP, URI should start with "http://" or "rtsp://". The default protocol is "file://".
* If you provide an invalid URI, you won't receive an error message until you call player_start().
- *
+ * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any video/audio files are used to play located in the internal storage.
+ * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any video/audio files are used to play located in the external storage.
+ * @remarks The internet privilege(http://tizen.org/privilege/internet) must be added if any URLs are used to play from network.
* @param[in] player The handle to the media player
* @param[in] uri The content location, such as the file path, the URI of the HTTP or RSTP stream you want to play
*
* @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
+ * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE Unsupported feature
* @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
* @see player_set_memory_buffer()
*/
* @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid state
- * @retval #PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE Unsupported feature
* @pre The player state must be one of #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
* @see #player_display_rotation_e
* @see player_set_display
* @brief Sets a path to download, progressively.
* @since_tizen 2.3
* @remarks Progressive download will be started when you invoke player_start().
+ * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any files are used to download and play located in the internal storage.
+ * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any files are used to downlaod and play located in the external storage.
* @param[in] player The handle to the media player
* @param[in] path The absolute path to download
* @return @c 0 on success,
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
* @retval #PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE Unsupported feature
+ * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
* @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
* @see player_set_progressive_download_message_cb()
* @see player_unset_progressive_download_message_cb()
* @brief Sets a subtitle path.
* @since_tizen 2.3
* @remarks Only MicroDVD/SubViewer(*.sub), SAMI(*.smi), and SubRip(*.srt) subtitle formats are supported.
+ * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any files are used to play located in the internal storage.
+ * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any files are used to play located in the external storage.
* @param[in] player The handle to the media player
* @param[in] path The absolute path of the subtitle file, it can be @c NULL in the #PLAYER_STATE_IDLE state.
* @return @c 0 on success,
* @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
+ * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
* @pre The player state must be one of #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
* @pre The path value can be @c NULL for reset when the player state is set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
*/
* @brief Gets current track index.
* @since_tizen 2.4
* @details Index starts from 0.
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[out] index The index of track
* @return @c 0 on success,
* otherwise a negative error value
* @brief Gets language code of a track.
* @since_tizen 2.4
* @remarks @a code must be released with @c free() by caller
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[in] index The index of track
* @param[out] code A language code in ISO 639-1. "und" will be returned if the language is undefined.
* @return @c 0 on success,
/**
* @brief Gets the track count.
* @since_tizen 2.4
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[out] count The number of track
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Selects a track to play.
* @since_tizen 2.4
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[in] index The index of track
* @return @c 0 on success,
* otherwise a negative error value
* @since_tizen 2.3.1
* @remarks If you use HTTP or RSTP, URI should start with "http://" or "rtsp://". The default protocol is "file://".
* If you provide an invalid URI, you won't receive an error message until you call player_start().
- *
+ * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any video/audio files are used to play located in the internal storage.
+ * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any video/audio files are used to play located in the external storage.
+ * @remarks The internet privilege(http://tizen.org/privilege/internet) must be added if any URLs are used to play from network.
* @param[in] player The handle to the media player
* @param[in] uri The content location, such as the file path, the URI of the HTTP or RSTP stream you want to play
*
* @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
+ * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE Unsupported feature
* @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
* @see player_set_memory_buffer()
*/
* @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid state
- * @retval #PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE Unsupported feature
* @pre The player state must be one of #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
* @see #player_display_rotation_e
* @see player_set_display
* @brief Sets a path to download, progressively.
* @since_tizen 2.3.1
* @remarks Progressive download will be started when you invoke player_start().
+ * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any files are used to download and play located in the internal storage.
+ * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any files are used to download and play located in the external storage.
* @param[in] player The handle to the media player
* @param[in] path The absolute path to download
* @return @c 0 on success,
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
* @retval #PLAYER_ERROR_FEATURE_NOT_SUPPORTED_ON_DEVICE Unsupported feature
+ * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
* @pre The player state must be set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
* @see player_set_progressive_download_message_cb()
* @see player_unset_progressive_download_message_cb()
* @brief Sets a subtitle path.
* @since_tizen 2.3.1
* @remarks Only MicroDVD/SubViewer(*.sub), SAMI(*.smi), and SubRip(*.srt) subtitle formats are supported.
+ * @remarks The mediastorage privilege(http://tizen.org/privilege/mediastorage) must be added if any files are used to play located in the internal storage.
+ * @remarks The externalstorage privilege(http://tizen.org/privilege/externalstorage) must be added if any files are used to play located in the external storage.
* @param[in] player The handle to the media player
* @param[in] path The absolute path of the subtitle file, it can be @c NULL in the #PLAYER_STATE_IDLE state.
* @return @c 0 on success,
* @retval #PLAYER_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #PLAYER_ERROR_INVALID_OPERATION Invalid operation
* @retval #PLAYER_ERROR_INVALID_STATE Invalid player state
+ * @retval #PLAYER_ERROR_PERMISSION_DENIED Permission denied
* @pre The player state must be one of #PLAYER_STATE_IDLE, #PLAYER_STATE_READY, #PLAYER_STATE_PLAYING, or #PLAYER_STATE_PAUSED.
* @pre The path value can be @c NULL for reset when the player state is set to #PLAYER_STATE_IDLE by calling player_create() or player_unprepare().
*/
* @brief Gets current track index.
* @since_tizen 3.0
* @details Index starts from 0.
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[out] index The index of track
* @return @c 0 on success,
* otherwise a negative error value
* @brief Gets language code of a track.
* @since_tizen 3.0
* @remarks @a code must be released with @c free() by caller
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[in] index The index of track
* @param[out] code A language code in ISO 639-1. "und" will be returned if the language is undefined.
* @return @c 0 on success,
/**
* @brief Gets the track count.
* @since_tizen 3.0
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[out] count The number of track
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Selects a track to play.
* @since_tizen 3.0
- * @remarks PLAYER_STREAM_TYPE_VIDEO is not supported.
* @param[in] player The handle to the media player
- * @param[in] type The type of target stream
+ * @param[in] type The type of target stream which is PLAYER_STREAM_TYPE_AUDIO or PLAYER_STREAM_TYPE_TEXT
* @param[in] index The index of track
* @return @c 0 on success,
* otherwise a negative error value