* @brief Called when the state of focus that belongs to the stream_info is changed.
* @since_tizen 3.0
* @param[in] stream_info The handle of stream information
- * @param[in] reason_for_change The reason for state change of the focus
- * @param[in] additional_info The additional information
+ * @param[in] reason The reason for state change of the focus
+ * @param[in] extra_info The extra information
* @param[in] user_data The user data passed from the callback registration function
*
* @remarks This function is issued in the internal thread of the sound manager.\n
* @see sound_manager_create_stream_information()
* @see sound_manager_destroy_stream_information()
*/
-typedef void (*sound_stream_focus_state_changed_cb) (sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason_for_change, const char *additional_info, void *user_data);
+typedef void (*sound_stream_focus_state_changed_cb) (sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason, const char *extra_info, void *user_data);
/**
* @brief Called when the focus state for each sound stream type is changed regardless of the process.
* @since_tizen 3.0
- * @param[in] changed_focus_mask The changed focus mask
- * @param[in] changed_focus_state The changed focus state
- * @param[in] reason_for_change The reason for state change of the focus
- * @param[in] additional_info The additional information
+ * @param[in] focus_mask The changed focus mask
+ * @param[in] focus_state The changed focus state
+ * @param[in] reason The reason for state change of the focus
+ * @param[in] extra_info The extra information
* @param[in] user_data The user data passed from the callback registration function
*
* @remarks This function is issued in the internal thread of the sound manager.\n
* @see sound_manager_set_focus_state_watch_cb()
* @see sound_manager_unset_focus_state_watch_cb()
*/
-typedef void (*sound_stream_focus_state_watch_cb) (sound_stream_focus_mask_e changed_focus_mask, sound_stream_focus_state_e changed_focus_state, sound_stream_focus_change_reason_e reason_for_change, const char *additional_info, void *user_data);
+typedef void (*sound_stream_focus_state_watch_cb) (sound_stream_focus_mask_e focus_mask, sound_stream_focus_state_e focus_state, sound_stream_focus_change_reason_e reason, const char *extra_info, void *user_data);
/**
* @}
* @brief Acquires the stream focus.
* @since_tizen 3.0
* @param[in] stream_info The handle of stream information
- * @param[in] focus_mask The focus mask that user wants to acquire
- * @param[in] additional_info Additional information for this request (optional, this can be null)
+ * @param[in] focus_mask The focus mask that user wants to acquire
+ * @param[in] extra_info The Extra information for this request (optional, this can be null)
*
* @remarks Do not call this API within sound_stream_focus_state_changed_cb() and sound_stream_focus_state_watch_cb(),\n
* otherwise SOUND_MANAGER_ERROR_INVALID_OPERATION will be returned.
* @see sound_manager_release_focus()
* @see sound_manager_get_focus_state()
*/
-int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *additional_info);
+int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *extra_info);
/**
* @brief Releases the acquired focus.
* @since_tizen 3.0
* @param[in] stream_info The handle of stream information
- * @param[in] focus_mask The focus mask that user wants to release
- * @param[in] additional_info Additional information for this request (optional, this can be null)
+ * @param[in] focus_mask The focus mask that user wants to release
+ * @param[in] extra_info TheExtra information for this request (optional, this can be null)
*
* @remarks Do not call this API within sound_stream_focus_state_changed_cb() and sound_stream_focus_state_watch_cb(),\n
* otherwise SOUND_MANAGER_ERROR_INVALID_OPERATION will be returned.
* @see sound_manager_acquire_focus()
* @see sound_manager_get_focus_state()
*/
-int sound_manager_release_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *additional_info);
+int sound_manager_release_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *extra_info);
/**
* @brief Gets the state of focus.
* @brief Gets the reason for the current acquired playback focus.
* @since_tizen 3.0
* @param[out] acquired_by The reason for the current acquired playback focus
- * @param[out] additional_info The additional information of the acquired playback focus (this can be null)
+ * @param[out] extra_info The extra information of the acquired playback focus (this can be null)
*
* @remarks If there is no acquired playback focus in this system, it'll return #SOUND_MANAGER_ERROR_NO_DATA.
*
* @retval #SOUND_MANAGER_ERROR_NO_DATA No data
* @see sound_manager_get_reason_for_current_recording_focus()
*/
-int sound_manager_get_reason_for_current_playback_focus(sound_stream_focus_change_reason_e *acquired_by, char **additional_info);
+int sound_manager_get_reason_for_current_playback_focus(sound_stream_focus_change_reason_e *acquired_by, char **extra_info);
/**
* @internal
* @brief Gets the reason for the current acquired recording focus.
* @since_tizen 3.0
* @param[out] acquired_by The reason for the current acquired recording focus
- * @param[out] additional_info The additional information of the acquired recording focus (this can be null)
+ * @param[out] extra_info The extra information of the acquired recording focus (this can be null)
*
* @remarks If there is no acquired recording focus in this system, it'll return #SOUND_MANAGER_ERROR_NO_DATA.
*
* @retval #SOUND_MANAGER_ERROR_NO_DATA No data
* @see sound_manager_get_reason_for_current_playback_focus()
*/
-int sound_manager_get_reason_for_current_recording_focus(sound_stream_focus_change_reason_e *acquired_by, char **additional_info);
+int sound_manager_get_reason_for_current_recording_focus(sound_stream_focus_change_reason_e *acquired_by, char **extra_info);
/**
* @internal
sound_device_information_changed_cb user_cb;
} _device_changed_info_s;
-void _focus_session_interrupt_cb(mm_sound_focus_state_e state, const char *reason_for_change, bool is_wcb, void *user_data);
+void _focus_session_interrupt_cb(mm_sound_focus_state_e state, const char *reason, bool is_wcb, void *user_data);
-void _voip_focus_state_change_callback(sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason_for_change, const char *additional_info, void *user_data);
+void _voip_focus_state_change_callback(sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason, const char *extra_info, void *user_data);
void _device_connected_cb(sound_device_h device, bool is_connected, void *user_data);
-void _focus_state_change_callback(int index, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason_for_change, const char *additional_info, void *user_data);
+void _focus_state_change_callback(int index, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason, const char *extra_info, void *user_data);
-void _focus_watch_callback(int id, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason_for_change, const char *additional_info, void *user_data);
+void _focus_watch_callback(int id, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason, const char *extra_info, void *user_data);
int _convert_sound_manager_error_code(const char *func, int code);
Name: capi-media-sound-manager
Summary: Sound Manager library
-Version: 0.3.47
+Version: 0.3.48
Release: 0
Group: Multimedia/API
License: Apache-2.0
return _convert_sound_manager_error_code(__func__, ret);
}
-int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *additional_info)
+int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *extra_info)
{
int ret = MM_ERROR_NONE;
sound_stream_info_s *stream_h = (sound_stream_info_s*)stream_info;
if (stream_h->is_focus_unavailable)
return _convert_sound_manager_error_code(__func__, MM_ERROR_POLICY_INTERNAL);
- ret = mm_sound_acquire_focus(stream_h->index, (mm_sound_focus_type_e)focus_mask, additional_info);
+ ret = mm_sound_acquire_focus(stream_h->index, (mm_sound_focus_type_e)focus_mask, extra_info);
if (ret == MM_ERROR_NONE) {
stream_h->acquired_focus |= focus_mask;
_update_focus_status(stream_h->index, (unsigned int)stream_h->acquired_focus);
return _convert_sound_manager_error_code(__func__, ret);
}
-int sound_manager_release_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *additional_info)
+int sound_manager_release_focus(sound_stream_info_h stream_info, sound_stream_focus_mask_e focus_mask, const char *extra_info)
{
int ret = MM_ERROR_NONE;
sound_stream_info_s *stream_h = (sound_stream_info_s*)stream_info;
SM_INSTANCE_CHECK(stream_h);
- ret = mm_sound_release_focus(stream_h->index, (mm_sound_focus_type_e)focus_mask, additional_info);
+ ret = mm_sound_release_focus(stream_h->index, (mm_sound_focus_type_e)focus_mask, extra_info);
if (ret == MM_ERROR_NONE) {
stream_h->acquired_focus &= ~focus_mask;
_update_focus_status(stream_h->index, (unsigned int)stream_h->acquired_focus);
return _convert_sound_manager_error_code(__func__, ret);
}
-int sound_manager_get_reason_for_current_playback_focus(sound_stream_focus_change_reason_e *acquired_by, char **additional_info)
+int sound_manager_get_reason_for_current_playback_focus(sound_stream_focus_change_reason_e *acquired_by, char **extra_info)
{
int ret = MM_ERROR_NONE;
char *stream_type_str = NULL;
- char *additional_info_str = NULL;
+ char *extra_info_str = NULL;
LOGI(">> enter");
SM_NULL_ARG_CHECK(acquired_by);
- ret = mm_sound_get_stream_type_of_acquired_focus((int)SOUND_STREAM_FOCUS_FOR_PLAYBACK, &stream_type_str, &additional_info_str);
+ ret = mm_sound_get_stream_type_of_acquired_focus((int)SOUND_STREAM_FOCUS_FOR_PLAYBACK, &stream_type_str, &extra_info_str);
if (ret == MM_ERROR_NONE) {
LOGI("current acquired [playback] focus: stream_type=%s", stream_type_str);
ret = _convert_stream_type_to_change_reason(stream_type_str, acquired_by);
- if ((ret == MM_ERROR_NONE) && additional_info) {
- LOGI(" : reason=%d, additional_info=%s", *acquired_by, additional_info_str);
- *additional_info = additional_info_str;
+ if ((ret == MM_ERROR_NONE) && extra_info) {
+ LOGI(" : reason=%d, extra_info=%s", *acquired_by, extra_info_str);
+ *extra_info = extra_info_str;
}
}
return _convert_sound_manager_error_code(__func__, ret);
}
-int sound_manager_get_reason_for_current_recording_focus(sound_stream_focus_change_reason_e *acquired_by, char **additional_info)
+int sound_manager_get_reason_for_current_recording_focus(sound_stream_focus_change_reason_e *acquired_by, char **extra_info)
{
int ret = MM_ERROR_NONE;
char *stream_type_str = NULL;
- char *additional_info_str = NULL;
+ char *extra_info_str = NULL;
LOGI(">> enter");
SM_NULL_ARG_CHECK(acquired_by);
- ret = mm_sound_get_stream_type_of_acquired_focus((int)SOUND_STREAM_FOCUS_FOR_RECORDING, &stream_type_str, &additional_info_str);
+ ret = mm_sound_get_stream_type_of_acquired_focus((int)SOUND_STREAM_FOCUS_FOR_RECORDING, &stream_type_str, &extra_info_str);
if (ret == MM_ERROR_NONE) {
LOGI("current acquired [recording] focus: stream_type=%s", stream_type_str);
ret = _convert_stream_type_to_change_reason(stream_type_str, acquired_by);
- if ((ret == MM_ERROR_NONE) && additional_info) {
- LOGI(" : reason=%d, additional_info=%s", *acquired_by, additional_info_str);
- *additional_info = additional_info_str;
+ if ((ret == MM_ERROR_NONE) && extra_info) {
+ LOGI(" : reason=%d, extra_info=%s", *acquired_by, extra_info_str);
+ *extra_info = extra_info_str;
}
}
return name;
}
-void _focus_state_change_callback(int index, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason_for_change, const char *additional_info, void *user_data)
+void _focus_state_change_callback(int index, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason, const char *extra_info, void *user_data)
{
int ret = MM_ERROR_NONE;
int i = 0;
LOGI(">> enter");
- ret = _convert_stream_type_to_change_reason(reason_for_change, &change_reason);
+ ret = _convert_stream_type_to_change_reason(reason, &change_reason);
if (ret) {
- LOGE("failed to _convert_stream_type_to_enum(), reason_for_change(%s), err(0x%08x)", reason_for_change, ret);
+ LOGE("failed to _convert_stream_type_to_enum(), reason(%s), err(0x%08x)", reason, ret);
goto LEAVE;
}
sound_stream_info_arr[i]->acquired_focus |= focus_type;
LOGI("[FOCUS USER CALLBACK(%p) START]", sound_stream_info_arr[i]->user_cb);
- sound_stream_info_arr[i]->user_cb((sound_stream_info_h)sound_stream_info_arr[i], change_reason, additional_info, sound_stream_info_arr[i]->user_data);
+ sound_stream_info_arr[i]->user_cb((sound_stream_info_h)sound_stream_info_arr[i], change_reason, extra_info, sound_stream_info_arr[i]->user_data);
LOGI("[FOCUS USER CALLBACK(%p) END]", sound_stream_info_arr[i]->user_cb);
break;
}
return;
}
-void _focus_watch_callback(int index, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason_for_change, const char *additional_info, void *user_data)
+void _focus_watch_callback(int index, mm_sound_focus_type_e focus_type, mm_sound_focus_state_e state, const char *reason, const char *extra_info, void *user_data)
{
int ret = MM_ERROR_NONE;
sound_stream_focus_change_reason_e change_reason = SOUND_STREAM_FOCUS_CHANGED_BY_MEDIA;
- ret = _convert_stream_type_to_change_reason(reason_for_change, &change_reason);
+ ret = _convert_stream_type_to_change_reason(reason, &change_reason);
if (ret)
- LOGE("failed to _convert_stream_type_to_enum(), reason_for_change(%s), err(0x%08x)", reason_for_change, ret);
+ LOGE("failed to _convert_stream_type_to_enum(), reason(%s), err(0x%08x)", reason, ret);
if (g_focus_watch_cb_table.user_cb)
- g_focus_watch_cb_table.user_cb(focus_type, state, change_reason, additional_info, g_focus_watch_cb_table.user_data);
+ g_focus_watch_cb_table.user_cb(focus_type, state, change_reason, extra_info, g_focus_watch_cb_table.user_data);
return;
}
return;
}
-void _focus_session_interrupt_cb(mm_sound_focus_state_e state, const char *reason_for_change, bool is_wcb, void *user_data)
+void _focus_session_interrupt_cb(mm_sound_focus_state_e state, const char *reason, bool is_wcb, void *user_data)
{
sound_session_interrupted_code_e e;
- LOGE("session interrupted by [%s]", reason_for_change);
+ LOGE("session interrupted by [%s]", reason);
if (g_session_interrupt_cb_table.user_cb) {
if (is_wcb) {
if (state == FOCUS_IS_RELEASED)
e = SOUND_SESSION_INTERRUPTED_COMPLETED;
else
- _convert_stream_type_to_interrupt_reason(reason_for_change, &e);
+ _convert_stream_type_to_interrupt_reason(reason, &e);
} else {
if (state == FOCUS_IS_ACQUIRED)
e = SOUND_SESSION_INTERRUPTED_COMPLETED;
else
- _convert_stream_type_to_interrupt_reason(reason_for_change, &e);
+ _convert_stream_type_to_interrupt_reason(reason, &e);
}
g_session_interrupt_cb_table.user_cb(e, g_session_interrupt_cb_table.user_data);
}
}
/* This is an internal callback for the VOIP SESSION */
-void _voip_focus_state_change_callback(sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason_for_change, const char *additional_info, void *user_data)
+void _voip_focus_state_change_callback(sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason, const char *extra_info, void *user_data)
{
sound_stream_info_s *info = (sound_stream_info_s *)stream_info;
- LOGI(">> enter, stream_info(%p), change_reason(%d), additional_info(%s)", stream_info, reason_for_change, additional_info);
+ LOGI(">> enter, stream_info(%p), change_reason(%d), extra_info(%s)", stream_info, reason, extra_info);
if (!info) {
LOGE("stream info is null");
/* destroy virtual stream handle */
_destroy_virtual_stream(g_voip_vstream_h);
g_voip_vstream_h = NULL;
- LOGW("internal voip stream is interrupted by (%d)", reason_for_change);
+ LOGW("internal voip stream is interrupted by (%d)", reason);
}
}
pa_threaded_mainloop_wait(stream_h->pa_mainloop);
}
- /* get uniq id of this context */
+ /* get index of this context */
stream_h->index = pa_context_get_index(stream_h->pa_context);
pa_threaded_mainloop_unlock(stream_h->pa_mainloop);
sound_stream_info_h g_stream_info_h = NULL;
virtual_sound_stream_h g_vstream_h = NULL;
-void focus_callback(sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason_for_change, const char *additional_info, void *user_data)
+void focus_callback(sound_stream_info_h stream_info, sound_stream_focus_change_reason_e reason, const char *extra_info, void *user_data)
{
int ret = SOUND_MANAGER_ERROR_NONE;
sound_stream_focus_state_e playback_focus_state;
sound_stream_focus_state_e recording_focus_state;
g_print("*** FOCUS callback is called, stream_info(%p) ***\n", stream_info);
- g_print(" - reason_for_change(%d), additional_info(%s), user_data(%p)\n", reason_for_change, additional_info, user_data);
+ g_print(" - change_reason(%d), extra_info(%s), user_data(%p)\n", reason, extra_info, user_data);
ret = sound_manager_get_focus_state(stream_info, &playback_focus_state, &recording_focus_state);
if (!ret)
return;
}
-void focus_watch_callback(sound_stream_focus_mask_e changed_focus_type, sound_stream_focus_state_e changed_focus_state, sound_stream_focus_change_reason_e reason_for_change, const char *additional_info, void *user_data)
+void focus_watch_callback(sound_stream_focus_mask_e focus_mask, sound_stream_focus_state_e focus_state, sound_stream_focus_change_reason_e reason, const char *extra_info, void *user_data)
{
g_print("*** FOCUS WATCH callback is called ***\n");
- g_print(" - changed_focus_type(%d), changed_focus_state(%d), reason_for_change(%d), additional_info(%s), user_data(%p)\n",
- changed_focus_type, changed_focus_state, reason_for_change, additional_info, user_data);
+ g_print(" - changed_focus_mask(%d), changed_focus_state(%d), change_reason(%d), extra_info(%s), user_data(%p)\n",
+ focus_mask, focus_state, reason, extra_info, user_data);
return;
}
focus_mask = SOUND_STREAM_FOCUS_FOR_PLAYBACK;
break;
}
- ret = sound_manager_acquire_focus(g_stream_info_h, focus_mask, "sound_manager_test_ac");
+ ret = sound_manager_acquire_focus(g_stream_info_h, focus_mask, "sound_manager_test(acquire_focus)");
if (ret)
g_print("fail to sound_manager_acquire_focus(), ret(0x%x)\n", ret);
focus_mask = SOUND_STREAM_FOCUS_FOR_PLAYBACK;
break;
}
- ret = sound_manager_release_focus(g_stream_info_h, focus_mask, "sound_manager_test_rel");
+ ret = sound_manager_release_focus(g_stream_info_h, focus_mask, "sound_manager_test(release_focus)");
if (ret)
g_print("fail to sound_manager_acquire_focus(), ret(0x%x)\n", ret);
}
case CURRENT_STATUS_GET_REASON_FOR_P_FOCUS: {
int ret = SOUND_MANAGER_ERROR_NONE;
- char *additional_info = NULL;
+ char *extra_info = NULL;
sound_stream_focus_change_reason_e reason;
- ret = sound_manager_get_reason_for_current_playback_focus(&reason, &additional_info);
+ ret = sound_manager_get_reason_for_current_playback_focus(&reason, &extra_info);
if (ret)
g_print("fail to sound_manager_get_reason_for_current_playback_focus, ret(0x%x)\n", ret);
else
- g_print("reason(%d), additional_info(%s)\n", reason, additional_info);
+ g_print("reason(%d), extra_info(%s)\n", reason, extra_info);
reset_menu_state();
break;
}
case CURRENT_STATUS_GET_REASON_FOR_R_FOCUS: {
int ret = SOUND_MANAGER_ERROR_NONE;
- char *additional_info = NULL;
+ char *extra_info = NULL;
sound_stream_focus_change_reason_e reason;
- ret = sound_manager_get_reason_for_current_recording_focus(&reason, &additional_info);
+ ret = sound_manager_get_reason_for_current_recording_focus(&reason, &extra_info);
if (ret)
g_print("fail to sound_manager_get_reason_for_current_recording_focus, ret(0x%x)\n", ret);
else
- g_print("reason(%d), additional_info(%s)\n", reason, additional_info);
+ g_print("reason(%d), extra_info(%s)\n", reason, extra_info);
reset_menu_state();
break;
}
projects / platform / core / api / sound-manager.git / commitdiff