* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
* @retval #VC_ERROR_OPERATION_FAILED Operation failure
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @post If this function is called, the state will be #VC_STATE_INITIALIZED.
* @see vc_deinitialize()
*/
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_STATE Invalid state
* @retval #VC_ERROR_OPERATION_FAILED Operation failure
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @see vc_initialize()
*/
int vc_deinitialize(void);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_STATE Invalid state
* @retval #VC_ERROR_OPERATION_FAILED Operation failure
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED.
* @post If this function is called, the state will be #VC_STATE_READY.
* @see vc_unprepare()
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
* @pre The state should be #VC_STATE_READY.
* @post If this function is called, the state will be #VC_STATE_INITIALIZED.
* @see vc_prepare()
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_OPERATION_FAILED Operation failure
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED or #VC_STATE_READY.
* @post This function invokes vc_supported_language_cb() repeatedly for getting languages.
* @see vc_supported_language_cb()
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
* @retval #VC_ERROR_OPERATION_FAILED Operation failure
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED or #VC_STATE_READY.
* @see vc_foreach_supported_languages()
*/
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_state_changed_cb()
* @see vc_set_state_changed_cb()
*/
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @pre The state should be #VC_STATE_READY.
* @see vc_set_service_state_changed_cb()
* @see vc_unset_service_state_changed_cb()
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The service state should be #VC_SERVICE_STATE_READY.
* @see vc_cmd_list_destroy()
*/
/**
* @brief Sets the invocation name.
- * @since_tizen 3.0
- * @privlevel public
- * @privilege %http://tizen.org/privilege/recorder
- * @remarks Invocation name is used to activate background commands. The invocation name can be the same as the application name or any other phrase.
+ * @details Invocation name is used to activate background commands. The invocation name can be the same as the application name or any other phrase.
* For example, an application "Tizen Sample" has a background command, "Play music", and the invocation name of the application is set to "Tizen Sample".
* In order to activate the background command, users can say "Tizen Sample, Play music".
* The invocation name is dependent on the current language. For example, if the current language is "en_US"(English), the invocation name is also "en_US".
* If the current language is "ja_JP"(Japanese) and the invocation name is "en_US", the invocation name will not be recognized.
* This function should be called before vc_set_command_list().
+ * @since_tizen 3.0
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/recorder
+ * @remarks If @a name is @c NULL, the invocation name will be unset.
* @param[in] name Invocation name that an application wants to be invoked by
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
* @pre The state should be #VC_STATE_READY.
* @see vc_set_command_list()
*/
* @since_tizen 5.0
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
+ * @remarks If @a app_id is @c NULL, the API tries to get app ID using app manager framework.
+ * However, getting app ID may be failed.
* @param[in] app_id App id which is to want to ask server dialog.
* @param[in] credential Credential key.
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The service state should be #VC_SERVICE_STATE_READY.
* @see vc_unset_server_dialog()
*/
* @since_tizen 5.0
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
+ * @remarks If @a app_id is @c NULL, the API tries to get app ID using app manager framework.
+ * However, getting app ID may be failed.
* @param[in] app_id App id which is to not want to ask server dialog.
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The service state should be #VC_SERVICE_STATE_READY.
* @see vc_set_server_dialog()
*/
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @remarks If @a auto_start is @c true, the recognition will start again. In this case, it can be restarted up to 4 times.
+ * @a disp_text and @a utt_text allow @c NULL. However, it is not allowed to set both @a disp_text and @a utt_text as @c NULL.
* @param[in] disp_text Text to be displayed on the screen
* @param[in] utt_text Text to be spoken
* @param[in] auto_start A variable for setting whether the dialog session will be restarted automatically or not
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The service state should be #VC_SERVICE_STATE_READY.
*/
int vc_request_dialog(const char* disp_text, const char* utt_text, bool auto_start);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_READY.
* @see vc_unset_command_list()
*/
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_READY.
* @see vc_set_command_list()
*/
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_READY.
* @see vc_result_cb()
*/
/**
- * @brief Registers a callback function for getting recognition result.
+ * @brief Sets a callback function for getting recognition result.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_result_cb()
* @see vc_unset_result_cb()
/**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_set_result_cb()
*/
/**
- * @brief Registers a callback function to be called when state is changed.
+ * @brief Sets a callback function to be called when service state is changed.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_service_state_changed_cb()
* @see vc_unset_service_state_changed_cb()
/**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_set_service_state_changed_cb()
*/
/**
- * @brief Registers a callback function to be called when state is changed.
+ * @brief Sets a callback function to be called when state is changed.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_state_changed_cb()
* @see vc_unset_state_changed_cb()
/**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_set_state_changed_cb()
*/
/**
- * @brief Registers a callback function to be called when current language is changed.
+ * @brief Sets a callback function to be called when current language is changed.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_current_language_changed_cb()
* @see vc_unset_current_language_changed_cb()
/**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_set_current_language_changed_cb()
*/
/**
- * @brief Registers a callback function to be called when an error occurred.
+ * @brief Sets a callback function to be called when an error occurred.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_error_cb()
* @see vc_unset_error_cb()
/**
- * @brief Unregisters the callback function.
+ * @brief Unsets the callback function.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/recorder
* @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_STATE Invalid state
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #VC_ERROR_INVALID_STATE Invalid state
* @pre The state should be #VC_STATE_INITIALIZED.
* @see vc_set_error_cb()
*/
* @brief Sets the TTS utterance status callback function.
* @details Using this function, the developer can set the utterance status callback to be called
* when the VC manager client starts or stops playing TTS PCM data which was requested to be synthesized with the vc_tts_request() function.
- * This function is called when @a to_vc_manager in the vc_tts_request() function call is @c true.
+ * This function is called when to_vc_manager in the vc_tts_request() function call is @c true.
* @since_tizen 5.5
* @privlevel partner
* @privilege %http://tizen.org/privilege/voicecontrol.tts
/**
* @brief Called to retrieve The commands in list.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @remarks @a vc_command should not be released. It is managed by the framework and will be released when invoking this callback is finished.
* @param[in] vc_command The command handle
* @param[in] user_data The user data passed from the foreach function
* @return @c true to continue with the next iteration of the loop,
/**
* @brief Creates a handle for command list.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @remarks If the function succeeds, @a The list handle must be released with vc_cmd_list_destroy().
+ * @remarks If the function succeeds, @a vc_cmd_list must be released with vc_cmd_list_destroy().
* @param[out] vc_cmd_list The command list handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
* @see vc_cmd_list_destroy()
*/
int vc_cmd_list_create(vc_cmd_list_h* vc_cmd_list);
* @param[in] vc_cmd_list The command list handle
* @param[in] free_command The command free option @c true = release each commands in list,
* @c false = remove command from list
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_list_create()
*/
int vc_cmd_list_destroy(vc_cmd_list_h vc_cmd_list, bool free_command);
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_cmd_list The command list handle
* @param[out] count The count
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
*/
int vc_cmd_list_get_count(vc_cmd_list_h vc_cmd_list, int* count);
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_cmd_list The command list handle
* @param[in] vc_command The command handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_list_remove()
*/
int vc_cmd_list_add(vc_cmd_list_h vc_cmd_list, vc_cmd_h vc_command);
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_cmd_list The command list handle
* @param[in] vc_command The command handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_list_add()
*/
int vc_cmd_list_remove(vc_cmd_list_h vc_cmd_list, vc_cmd_h vc_command);
* @param[in] vc_cmd_list The command list handle
* @param[in] callback Callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @post This function invokes vc_cmd_list_cb() repeatedly for getting commands.
* @see vc_cmd_list_cb()
*/
* @brief Moves index to first command.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_cmd_list The command list handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_EMPTY List empty
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @see vc_cmd_list_last()
*/
int vc_cmd_list_first(vc_cmd_list_h vc_cmd_list);
* @brief Moves index to last command.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_cmd_list The command list handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_EMPTY List empty
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @see vc_cmd_list_first()
*/
int vc_cmd_list_last(vc_cmd_list_h vc_cmd_list);
* @brief Moves index to next command.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_cmd_list The command list handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_EMPTY List empty
* @retval #VC_ERROR_ITERATION_END List reached end
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @see vc_cmd_list_prev()
*/
int vc_cmd_list_next(vc_cmd_list_h vc_cmd_list);
* @brief Moves index to previous command.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_cmd_list The command list handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_EMPTY List empty
* @retval #VC_ERROR_ITERATION_END List reached end
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @see vc_cmd_list_next()
*/
int vc_cmd_list_prev(vc_cmd_list_h vc_cmd_list);
/**
- * @brief Get current command from command list by index.
+ * @brief Gets current command from command list by index.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @remarks @a vc_command should be released after removing it from @a vc_cmd_list with vc_cmd_list_remove().
* @param[in] vc_cmd_list The command list handle
* @param[out] vc_command The command handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
+ * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #VC_ERROR_EMPTY List empty
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
- * @retval #VC_ERROR_NOT_SUPPORTED Not supported
* @see vc_cmd_list_first()
* @see vc_cmd_list_last()
* @see vc_cmd_list_prev()
/**
* @brief Creates a handle for command.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @remarks If the function succeeds, @a The command handle must be released
- * with vc_cmd_destroy() or vc_cmd_list_destroy().
+ * @remarks If the function succeeds, @a vc_command must be released with vc_cmd_destroy() or vc_cmd_list_destroy().
* You should set command and type if command is valid.
* The command format is set to #VC_COMMAND_FORMAT_FIXED by default and can be changed with vc_cmd_set_format().
* @param[out] vc_command The command handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #VC_ERROR_OUT_OF_MEMORY Out of memory
* @see vc_cmd_destroy()
*/
int vc_cmd_create(vc_cmd_h* vc_command);
* @brief Destroys the handle.
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_command The command handle
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_create()
*/
int vc_cmd_destroy(vc_cmd_h vc_command);
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_command The command handle
* @param[in] command The command or action text
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_get_command()
*/
int vc_cmd_set_command(vc_cmd_h vc_command, const char* command);
* @remarks If the function succeeds, @a command must be released with free() by you if they are not NULL.
* @param[in] vc_command The command handle
* @param[out] command The command text
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_set_command()
*/
int vc_cmd_get_command(vc_cmd_h vc_command, char** command);
* This function should be used for commands which have non-fixed format.
* @param[in] vc_command The command handle
* @param[out] command The unfixed command text
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported feature
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
*/
int vc_cmd_get_unfixed_command(vc_cmd_h vc_command, char** command);
* You should set type if command is valid
* @param[in] vc_command The command handle
* @param[in] type The command type
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_get_type()
*/
int vc_cmd_set_type(vc_cmd_h vc_command, int type);
* @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
* @param[in] vc_command The command handle
* @param[out] type The command type
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_set_type()
*/
int vc_cmd_get_type(vc_cmd_h vc_command, int* type);
* @remarks The default format is #VC_COMMAND_FORMAT_FIXED.
* @param[in] vc_command The command handle
* @param[in] format The command format
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported feature
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_get_format()
*/
int vc_cmd_set_format(vc_cmd_h vc_command, int format);
* @remarks The default format is #VC_COMMAND_FORMAT_FIXED.
* @param[in] vc_command The command handle
* @param[out] format The command format
- * @return @c 0 on success,
+ * @return @c 0 on success,
* otherwise a negative error value
* @retval #VC_ERROR_NONE Successful
- * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #VC_ERROR_PERMISSION_DENIED Permission denied
* @retval #VC_ERROR_NOT_SUPPORTED Not supported feature
+ * @retval #VC_ERROR_INVALID_PARAMETER Invalid parameter
* @see vc_cmd_set_format()
*/
int vc_cmd_get_format(vc_cmd_h vc_command, int* format);