From: HyungKyu Song Date: Fri, 15 Feb 2013 15:11:00 +0000 (+0900) Subject: Tizen 2.0 Release X-Git-Tag: submit/tizen_2.0/20130215.191657^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=refs%2Fheads%2Ftizen_2.0;p=platform%2Fcore%2Fapi%2Fsound-manager.git Tizen 2.0 Release --- diff --git a/AUTHORS b/AUTHORS new file mode 100755 index 0000000..5fe5722 --- /dev/null +++ b/AUTHORS @@ -0,0 +1,3 @@ +Seungkeun Lee +Kangho Hur +Seungbae Shin diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100755 index 0000000..09a0ed6 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,125 @@ +CMAKE_MINIMUM_REQUIRED(VERSION 2.6) + +SET(Services + "application" + "base" + "content" + "location" + "media" + "messaging" + "network" + "social" + "telephony" + "system" + ) + + +# project +SET(project_prefix "capi") +SET(prefix "/usr") +SET(version "0.0.1") +SET(maintainer "Seungkeun Lee , Kangho Hur") +SET(description "A Sound Manager library in Tizen Native API") +SET(service "media") +SET(submodule "sound-manager") + +# for package file +SET(dependents "mm-sound dlog capi-base-common mm-session") +SET(pc_dependents "capi-base-common") + +# for deb +SET(deb_dependents "libdlog-0 libmm-sound-0") + + +SET(fw_name "${project_prefix}-${service}-${submodule}") + +PROJECT(${fw_name}) + +SET(CMAKE_INSTALL_PREFIX ${prefix}) +SET(PREFIX ${CMAKE_INSTALL_PREFIX}) +SET(VERSION ${version}) + +SET(INC_DIR include) +INCLUDE_DIRECTORIES(${INC_DIR}) + +INCLUDE(FindPkgConfig) +pkg_check_modules(${fw_name} REQUIRED ${dependents}) +FOREACH(flag ${${fw_name}_CFLAGS}) + SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}") +ENDFOREACH(flag) + +SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -fPIC -Wall -Werror") +SET(CMAKE_C_FLAGS_DEBUG "-O0 -g") + +IF("${ARCH}" STREQUAL "arm") + ADD_DEFINITIONS("-DTARGET") +ENDIF("${ARCH}" STREQUAL "arm") + +ADD_DEFINITIONS("-DPREFIX=\"${CMAKE_INSTALL_PREFIX}\"") +ADD_DEFINITIONS("-DTIZEN_DEBUG") + +SET(CMAKE_EXE_LINKER_FLAGS "-Wl,--as-needed -Wl,--rpath=/usr/lib") + +aux_source_directory(src SOURCES) +ADD_LIBRARY(${fw_name} SHARED ${SOURCES}) + +TARGET_LINK_LIBRARIES(${fw_name} ${${fw_name}_LDFLAGS}) + +SET_TARGET_PROPERTIES(${fw_name} + PROPERTIES + VERSION ${FULLVER} + SOVERSION ${MAJORVER} + CLEAN_DIRECT_OUTPUT 1 +) + +INSTALL(TARGETS ${fw_name} DESTINATION lib) +INSTALL( + DIRECTORY ${INC_DIR}/ DESTINATION include/${service} + FILES_MATCHING + PATTERN "*_private.h" EXCLUDE + PATTERN "${INC_DIR}/*.h" + ) + +SET(PC_NAME ${fw_name}) +SET(PC_REQUIRED ${pc_dependents}) +SET(PC_LDFLAGS -l${fw_name}) + +CONFIGURE_FILE( + ${fw_name}.pc.in + ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc + @ONLY +) +INSTALL(FILES ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc DESTINATION lib/pkgconfig) + +#ADD_SUBDIRECTORY(test) + +IF(UNIX) + +ADD_CUSTOM_TARGET (distclean @echo cleaning for source distribution) +ADD_CUSTOM_COMMAND( + DEPENDS clean + COMMENT "distribution clean" + COMMAND find + ARGS . + -not -name config.cmake -and \( + -name tester.c -or + -name Testing -or + -name CMakeFiles -or + -name cmake.depends -or + -name cmake.check_depends -or + -name CMakeCache.txt -or + -name cmake.check_cache -or + -name *.cmake -or + -name Makefile -or + -name core -or + -name core.* -or + -name gmon.out -or + -name install_manifest.txt -or + -name *.pc -or + -name *~ \) + | grep -v TC | xargs rm -rf + TARGET distclean + VERBATIM +) + +ENDIF(UNIX) diff --git a/LICENSE.APLv2 b/LICENSE.APLv2 new file mode 100755 index 0000000..f94008a --- /dev/null +++ b/LICENSE.APLv2 @@ -0,0 +1,206 @@ +Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved. + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + + diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000..ccdad52 --- /dev/null +++ b/NOTICE @@ -0,0 +1,3 @@ +Copyright (c) Samsung Electronics Co., Ltd. All rights reserved. +Except as noted, this software is licensed under Apache License, Version 2. +Please, see the LICENSE file for Apache License terms and conditions. diff --git a/capi-media-sound-manager.manifest b/capi-media-sound-manager.manifest new file mode 100755 index 0000000..a76fdba --- /dev/null +++ b/capi-media-sound-manager.manifest @@ -0,0 +1,5 @@ + + + + + diff --git a/capi-media-sound-manager.pc.in b/capi-media-sound-manager.pc.in new file mode 100644 index 0000000..5d02f8d --- /dev/null +++ b/capi-media-sound-manager.pc.in @@ -0,0 +1,15 @@ + +# Package Information for pkg-config + +prefix=@PREFIX@ +exec_prefix=/usr +libdir=/usr/lib +includedir=/usr/include/media + +Name: @PC_NAME@ +Description: @PACKAGE_DESCRIPTION@ +Version: @VERSION@ +Requires: @PC_REQUIRED@ +Libs: -L${libdir} @PC_LDFLAGS@ +Cflags: -I${includedir} + diff --git a/include/sound_manager.h b/include/sound_manager.h new file mode 100755 index 0000000..bd20c50 --- /dev/null +++ b/include/sound_manager.h @@ -0,0 +1,523 @@ +/* +* Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved +* +* Licensed under the Apache License, Version 2.0 (the "License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + + + + +#ifndef __TIZEN_MEDIA_SOUND_MANAGER_H__ +#define __TIZEN_MEDIA_SOUND_MANAGER_H__ + +#include + +#ifdef __cplusplus +extern "C" +{ +#endif + +#define SOUND_MANAGER_ERROR_CLASS TIZEN_ERROR_MULTIMEDIA_CLASS | 0x30 + +/** + * @file sound_manager.h + * @brief This file contains the Sound Manager API + */ + +/** + * @addtogroup CAPI_MEDIA_SOUND_MANAGER_MODULE + * @{ + */ + +/** + * @brief Enumerations of sound type + */ +typedef enum +{ + SOUND_TYPE_SYSTEM, /**< Sound type for system */ + SOUND_TYPE_NOTIFICATION, /**< Sound type for notifications */ + SOUND_TYPE_ALARM, /**< Sound type for alarm */ + SOUND_TYPE_RINGTONE, /**< Sound type for ringtones */ + SOUND_TYPE_MEDIA, /**< Sound type for media */ + SOUND_TYPE_CALL, /**< Sound type for call */ +} sound_type_e; + +/** + * @brief Enumerations of volume key type + */ +typedef enum +{ + VOLUME_KEY_TYPE_NONE=-1, /**< Volume key type for current played sound */ + VOLUME_KEY_TYPE_SYSTEM=0, /**< Volume key type for system sound */ + VOLUME_KEY_TYPE_NOTIFICATION, /**< Volume key type for notifications sound*/ + VOLUME_KEY_TYPE_ALARM, /**< Volume key type for alarm sound */ + VOLUME_KEY_TYPE_RINGTONE, /**< Volume key type for ringtones sound */ + VOLUME_KEY_TYPE_MEDIA, /**< Volume key type for media sound */ + VOLUME_KEY_TYPE_CALL, /**< Volume key type for call sound */ +} volume_key_type_e; + +/** + * @brief error codes for sound manager + */ +typedef enum{ + SOUND_MANAGER_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */ + SOUND_MANAGER_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */ + SOUND_MANAGER_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */ + SOUND_MANAGER_ERROR_INVALID_OPERATION = TIZEN_ERROR_INVALID_OPERATION, /**< Invalid operation */ + SOUND_MANAGER_ERROR_NO_PLAYING_SOUND = SOUND_MANAGER_ERROR_CLASS | 01, /**< No playing sound */ +} sound_manager_error_e; + +/** + * @brief Enumerations of session type + */ +typedef enum{ + SOUND_SESSION_TYPE_SHARE = 0, /**< Share type : shares it's session with other share type application. */ + SOUND_SESSION_TYPE_EXCLUSIVE, /**< Exclusive type : make previous session stop.*/ + SOUND_SESSION_TYPE_ALARM, /**< Alarm type */ + SOUND_SESSION_TYPE_EMERGENCY, /**< Emergency type */ +} sound_session_type_e; + +/** + * @brief Enumerations of session notification + */ +typedef enum{ + SOUND_SESSION_NOTIFY_STOP = 0, /**< Stop : session of application has interrupted by policy. */ + SOUND_SESSION_NOTIFY_RESUME, /**< Resume : session interrupt of application has ended. */ +} sound_session_notify_e; + +/** + * @brief Enumerations of audio input device type. + */ +typedef enum{ + SOUND_DEVICE_IN_MIC = 0x01, /**< Device builtin mic. */ + SOUND_DEVICE_IN_WIRED_ACCESSORY = 0x02, /**< Wired input devices */ + SOUND_DEVICE_IN_BT_SCO = 0x04, /**< Bluetooth SCO device */ +} sound_device_in_e; + +/** + * @brief Enumerations of audio output device type. + */ +typedef enum{ + SOUND_DEVICE_OUT_SPEAKER = 0x01<<8, /**< Device builtin speaker */ + SOUND_DEVICE_OUT_RECEIVER = 0x02<<8, /**< Device builtin receiver */ + SOUND_DEVICE_OUT_WIRED_ACCESSORY = 0x04<<8, /**< Wired output devices such as headphone, headset, and so on. */ + SOUND_DEVICE_OUT_BT_SCO = 0x08<<8, /**< Bluetooth SCO device */ + SOUND_DEVICE_OUT_BT_A2DP = 0x10<<8, /**< Bluetooth A2DP device */ + SOUND_DEVICE_OUT_DOCK = 0x020<<8, /**< DOCK device */ + SOUND_DEVICE_OUT_HDMI = 0x040<<8, /**< HDMI device */ + SOUND_DEVICE_OUT_WFD = 0x080<<8, /**< WFD device */ + SOUND_DEVICE_OUT_USB_AUDIO = 0x100<<8, /**< USB Audio device */ +} sound_device_out_e; + +/** + * @brief Enumerations of route type. + */ +typedef enum{ + SOUND_ROUTE_OUT_SPEAKER = SOUND_DEVICE_OUT_SPEAKER, /**< Routing audio output to builtin device such as internal speaker. */ + SOUND_ROUTE_OUT_WIRED_ACCESSORY = SOUND_DEVICE_OUT_WIRED_ACCESSORY,/**< Routing audio output to wired accessory such as headphone, headset, and so on. */ + SOUND_ROUTE_OUT_BLUETOOTH = SOUND_DEVICE_OUT_BT_A2DP, /**< Routing audio output to bluetooth A2DP. */ + SOUND_ROUTE_OUT_DOCK = SOUND_DEVICE_OUT_DOCK, /**< Routing audio output to DOCK */ + SOUND_ROUTE_OUT_HDMI = SOUND_DEVICE_OUT_HDMI, /**< Routing audio output to HDMI */ + SOUND_ROUTE_OUT_WFD = SOUND_DEVICE_OUT_WFD, /**< Routing audio output to WFD */ + SOUND_ROUTE_OUT_USB_AUDIO = SOUND_DEVICE_OUT_USB_AUDIO, /**< Routing audio output to USB Audio */ + SOUND_ROUTE_IN_MIC = SOUND_DEVICE_IN_MIC, /**< Routing audio input to device builtin mic. */ + SOUND_ROUTE_IN_WIRED_ACCESSORY = SOUND_DEVICE_IN_WIRED_ACCESSORY, /**< Routing audio input to wired accessory. */ + SOUND_ROUTE_IN_MIC_OUT_RECEIVER = SOUND_DEVICE_IN_MIC |SOUND_DEVICE_OUT_RECEIVER, /**< Routing audio input to device builtin mic and routing audio output to builtin receiver*/ + SOUND_ROUTE_IN_MIC_OUT_SPEAKER = SOUND_DEVICE_IN_MIC |SOUND_DEVICE_OUT_SPEAKER , /**< Routing audio input to device builtin mic and routing audio output to builtin speaker */ + SOUND_ROUTE_IN_MIC_OUT_HEADPHONE = SOUND_DEVICE_IN_MIC | SOUND_DEVICE_OUT_WIRED_ACCESSORY,/**< Routing audio input to device builtin mic and routing audio output to headphone */ + SOUND_ROUTE_INOUT_HEADSET = SOUND_DEVICE_IN_WIRED_ACCESSORY | SOUND_DEVICE_OUT_WIRED_ACCESSORY, /**< Routing audio input and output to headset*/ + SOUND_ROUTE_INOUT_BLUETOOTH = SOUND_DEVICE_IN_BT_SCO |SOUND_DEVICE_OUT_BT_SCO /**< Routing audio input and output to bluetooth SCO */ +} sound_route_e; + +/** + * @brief Enumerations of call session type + */ +typedef enum{ + SOUND_CALL_SESSION_TYPE_CALL = 0, /**< call type */ + SOUND_CALL_SESSION_TYPE_VOIP = 1, /**< voip type */ + SOUND_SESSION_TYPE_CALL = 0, + SOUND_SESSION_TYPE_VOIP = 1, +} sound_call_session_type_e; + +/** + * @brief Enumerations of communication session type + */ +typedef enum{ + SOUND_CALL_SESSION_MODE_VOICE = 0, /**< normal talking mode */ + SOUND_CALL_SESSION_MODE_RINGTONE, /**< ringtone mode */ + SOUND_CALL_SESSION_MODE_MEDIA, /**< notification sound in call*/ +} sound_call_session_mode_e; + +/** + * @brief Enumerations of sound interrupted type + */ +typedef enum +{ + SOUND_INTERRUPTED_COMPLETED = 0, /**< Interrupt completed*/ + SOUND_INTERRUPTED_BY_MEDIA, /**< Interrupted by non-resumable media application*/ + SOUND_INTERRUPTED_BY_CALL, /**< Interrupted by incoming call*/ + SOUND_INTERRUPTED_BY_EARJACK_UNPLUG, /**< Interrupted by unplugging headphone*/ + SOUND_INTERRUPTED_BY_RESOURCE_CONFLICT, /**< Interrupted by resource conflict*/ + SOUND_INTERRUPTED_BY_ALARM, /**< Interrupted by alarm*/ + SOUND_INTERRUPTED_BY_EMERGENCY, /**< Interrupted by emergency*/ + SOUND_INTERRUPTED_BY_RESUMABLE_MEDIA, /**< Interrupted by resumable media application*/ +} sound_interrupted_code_e; + +/** + * @brief Sound call session handle type. + */ +typedef struct sound_call_session_s *sound_call_session_h; + +/** + * @brief Called when the sound session notification has occured. + * @param[in] notify The sound session notification + * @param[in] user_data The user data passed from the callback registration function + * @pre You should register this callback by sound_manager_set_session_notify_cb() + * @see sound_manager_set_session_notify_cb() + */ +typedef void (*sound_session_notify_cb) (sound_session_notify_e notify, void *user_data); + +/** + * @brief Called when the playing sound was interrupted. + * @param[in] code The interrupted code + * @param[in] user_data The user data passed from the callback registration function + * @pre You should register this callback by sound_manager_set_interrupted_cb() + * @see sound_manager_set_interrupted_cb() + */ +typedef void(* sound_interrupted_cb)(sound_interrupted_code_e code, void *user_data); + + +/** + * @brief Called when the system volume has changed. + * @param[in] type The sound type of changed volume + * @param[in] volume The new volume value + * @param[in] user_data The user data passed from the callback registration function + * @pre sound_manager_set_volume() will invoke this callback if you register it using sound_manager_set_volume_changed_cb() + * @see sound_manager_set_volume_changed_cb() + * @see sound_manager_unset_volume_changed_cb() + */ +typedef void (*sound_manager_volume_changed_cb)(sound_type_e type, unsigned int volume, void *user_data); + +/** + * @brief Gets the maximum volume level supported for a particular sound type + * @param[in] type The sound type + * @param[out] max The maximum volume level + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_set_volume() + */ +int sound_manager_get_max_volume(sound_type_e type, int *max); + +/** + * @brief Sets the volume level specified for a particular sound type + * @param[in] type The sound type + * @param[out] volume The volume level to be set + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_get_max_volume() + * @see sound_manager_get_volume() + */ +int sound_manager_set_volume(sound_type_e type, int volume); + +/** + * @brief Gets the volume level specified for a particular sound type + * @param[in] type The sound type + * @param[out] volume The current volume level + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_get_max_volume() + * @see sound_manager_set_volume() + */ +int sound_manager_get_volume(sound_type_e type, int *volume); + +/** + * @brief Gets the current playing sound type + * @param[out] type The current sound type + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #SOUND_MANAGER_ERROR_NO_PLAYING_SOUND No playing sound + * @see player_set_sound_type() + * @see audio_out_create() + * @see wav_player_start() + */ +int sound_manager_get_current_sound_type(sound_type_e *type); + +/** + * @brief Registers a callback function to be invoked when the volume level is changed. + * @param[in] callback Callback function to indicate change in volume + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post sound_manager_volume_changed_cb() will be invoked + * @see sound_manager_unset_volume_changed_cb() + * @see sound_manager_volume_changed_cb() + */ +int sound_manager_set_volume_changed_cb(sound_manager_volume_changed_cb callback, void *user_data); + +/** + * @brief Unregisters the volume change callback + * @see sound_manager_set_volume_changed_cb() + */ +void sound_manager_unset_volume_changed_cb(void); + +/** + * @brief Gets the A2DP activation information. + * @remarks If @a connected is @c true, @a bt_name must be released with free() by you. If @a connected is @c false, @a bt_name is set to NULL. + * @param[out] connected The Bluetooth A2DP connection status (@c true = connected, @c false = disconnected) + * @param[out] bt_name The Bluetooth A2DP connected device name + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #SOUND_MANAGER_ERROR_INVALID_OPERATION Invalid operation + */ +int sound_manager_get_a2dp_status(bool *connected, char **bt_name); + + +/** + * @brief Sets the application's sound session type + * @param[in] type The session type to set + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + */ +int sound_manager_set_session_type(sound_session_type_e type); + + +/** + * @brief Gets the application's sound session type + * @param[in] type The session type + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + */ +int sound_manager_get_session_type(sound_session_type_e *type); + + +/** + * @brief Registers a callback function to be invoked when the sound session notification is occured. + * @param[in] callback The session notify callback function + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post sound_session_notify_cb() will be invoked + * @see sound_manager_unset_session_notify_cb() + * @see sound_session_notify_cb() + */ +int sound_manager_set_session_notify_cb(sound_session_notify_cb callback, void *user_data); + +/** + * @brief Unregisters the callback function which is called when the session notification is occured + * @see sound_manager_set_session_notify_cb() + */ +void sound_manager_unset_session_notify_cb(void); + +/** + * @brief Registers a callback function to be invoked when the playing sound was interrupted. + * @param[in] callback The interrupted callback function + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post sound_interrupted_cb() will be invoked + * @see sound_manager_unset_interrupted_cb() + * @see sound_interrupted_cb() + */ +int sound_manager_set_interrupted_cb(sound_interrupted_cb callback, void *user_data); + +/** + * @brief Unregisters the callback function which is called when the playing sound was interrupted + * @see sound_manager_set_interrupted_cb() + */ +void sound_manager_unset_interrupted_cb(void); + + + +/** + * @brief Sets the volume key type + * @param[in] type The volume key type to set + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + */ +int sound_manager_set_volume_key_type(volume_key_type_e type); + +/** + * @brief Gets called iteratively to notify you of available route. + * @param[in] route The available route + * @param[in] user_data The user data passed from the foreach function + * @return @c true to continue with the next iteration of the loop, \n @c false to break out of the loop + * @pre sound_manager_foreach_available_route() will invoke this callback. + * @see sound_manager_foreach_available_route() + */ +typedef bool(* sound_available_route_cb)(sound_route_e route, void *user_data); + +/** + * @brief Called when the available audio route is changed. + * @param[in] route The audio route + * @param[in] available The status of given route + * @param[in] user_data The user data passed from the foreach function + * @pre sound_manager_foreach_available_route() will invoke this callback. + * @see sound_manager_foreach_available_route() + */ +typedef void(* sound_available_route_changed_cb)(sound_route_e route, bool available, void *user_data); + +/** + * @brief Called when the audio route is changed. + * @param[in] route The audio route + * @param[in] user_data The user data passed from the callback registration function + * @pre You should register this callback by sound_manager_set_active_device_changed_cb() + * @see sound_manager_set_active_device_changed_cb() + */ +typedef void(* sound_active_device_changed_cb)(sound_device_in_e in, sound_device_out_e out, void *user_data); + +/** + * @brief Retrieves all available audio routes by invoking a specific callback for each valid route. + * @param[in] callback The session notify callback function + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post sound_available_route_cb() will be invoked + * @see sound_available_route_cb() + */ +int sound_manager_foreach_available_route (sound_available_route_cb callback, void *user_data); + +/** + * @brief Changes the audio routes. + * @param[in] route The route to set + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_get_active_device() + */ +int sound_manager_set_active_route (sound_route_e route); + +/** + * @brief Changes the audio route. + * @param[out] in The current sound input device + * @param[out] in The current sound output device + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_set_active_route() + */ +int sound_manager_get_active_device (sound_device_in_e *in, sound_device_out_e *out); + +/** + * @brief Check if given audio route is available or not. + * @param[in] route The route to set + * @return 0 on success, otherwise a negative error value. + * @return @c true if the specified route is supported, \n else @c false + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + */ +bool sound_manager_is_route_available (sound_route_e route); + +/** + * @brief Registers a callback function to be invoked when the available status is changed. + * @param[in] callback The available status changed callback function + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post sound_available_route_changed_cb() will be invoked + * @see sound_manager_unset_available_route_changed_cb() + * @see sound_available_route_changed_cb() + */ +int sound_manager_set_available_route_changed_cb (sound_available_route_changed_cb callback, void *user_data); + +/** + * @brief Unregisters the callback function. + * @see sound_manager_set_available_route_changed_cb() + */ +void sound_manager_unset_available_route_changed_cb (void); + +/** + * @brief Registers a callback function to be invoked when the audio device is changed. + * @param[in] callback The session notify callback function + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Success + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post sound_active_device_changed_cb() will be invoked + * @see sound_manager_unset_active_device_changed_cb() + * @see sound_active_device_changed_cb() + */ +int sound_manager_set_active_device_changed_cb (sound_active_device_changed_cb callback, void *user_data); + +/** + * @brief Unregisters the callback function which is called when the route notification is occured. + * @see sound_manager_set_active_device_changed_cb() + */ +void sound_manager_unset_active_device_changed_cb (void); + +/** + * @brief Creates a call session handle. + * @remarks @a session must be released sound_manager_call_session_destroy() by you. + * @param[out] session A new handle to call session + * @retval #SOUND_MANAGER_ERROR_NONE Successful + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #SOUND_MANAGER_OUT_OF_MEMORY Out of memory + * @see sound_manager_call_session_destroy() + */ +int sound_manager_call_session_create(sound_call_session_type_e type, sound_call_session_h *session); + +/** + * @brief Sets the call session mode. + * + * @param[in] session The handle to call session + * @param[in] mode The call session mode + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Successful + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_call_session_get_mode() + */ +int sound_manager_call_session_set_mode(sound_call_session_h session, sound_call_session_mode_e mode); + +/** + * @brief Gets the call session mode. + * + * @param[in] session The handle to call session + * @param[out] mode The call session mode + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Successful + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_call_session_set_mode() + */ +int sound_manager_call_session_get_mode(sound_call_session_h session, sound_call_session_mode_e *mode); + +/** + * @brief Destroys the call session handle. + * + * @param[in] session The handle to call session to be destroyed + * @return 0 on success, otherwise a negative error value. + * @retval #SOUND_MANAGER_ERROR_NONE Successful + * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @see sound_manager_call_session_create() + */ +int sound_manager_call_session_destroy(sound_call_session_h session); + +/** + * @} + */ + +#ifdef __cplusplus +} +#endif + +#endif /* __TIZEN_MEDIA_SOUND_MANAGER_H__ */ diff --git a/packaging/capi-media-sound-manager.spec b/packaging/capi-media-sound-manager.spec new file mode 100755 index 0000000..8b4f013 --- /dev/null +++ b/packaging/capi-media-sound-manager.spec @@ -0,0 +1,57 @@ +#sbs-git:slp/api/sound-manager capi-media-sound-manager 0.1.0 6ac5ae741e8b8dc20b33fc82c3f74602b19732d4 +Name: capi-media-sound-manager +Summary: Sound Manager library +Version: 0.1.1 +Release: 1 +Group: TO_BE/FILLED_IN +License: TO BE FILLED IN +Source0: %{name}-%{version}.tar.gz +BuildRequires: cmake +BuildRequires: pkgconfig(dlog) +BuildRequires: pkgconfig(mm-sound) +BuildRequires: pkgconfig(mm-session) +BuildRequires: pkgconfig(capi-base-common) +Requires(post): /sbin/ldconfig +Requires(postun): /sbin/ldconfig + +%description +A Sound Manager library in Tizen C API + +%package devel +Summary: Sound Manager library (Development) +Group: TO_BE/FILLED_IN +Requires: %{name} = %{version}-%{release} + +%description devel +A Sound Manager library in Tizen C API (DEV) + +%prep +%setup -q + + +%build +MAJORVER=`echo %{version} | awk 'BEGIN {FS="."}{print $1}'` +cmake . -DCMAKE_INSTALL_PREFIX=/usr -DFULLVER=%{version} -DMAJORVER=${MAJORVER} + + +make %{?jobs:-j%jobs} + +%install +rm -rf %{buildroot} +%make_install + +%post -p /sbin/ldconfig + +%postun -p /sbin/ldconfig + + +%files +%{_libdir}/libcapi-media-sound-manager.so.* +%manifest capi-media-sound-manager.manifest + +%files devel +%{_includedir}/media/sound_manager.h +%{_libdir}/pkgconfig/*.pc +%{_libdir}/libcapi-media-sound-manager.so + + diff --git a/src/sound_manager.c b/src/sound_manager.c new file mode 100755 index 0000000..c5ea851 --- /dev/null +++ b/src/sound_manager.c @@ -0,0 +1,539 @@ +/* +* Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved +* +* Licensed under the Apache License, Version 2.0 (the "License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + + +#define LOG_TAG "TIZEN_N_SOUND_MANGER" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define MAX_VOLUME_TYPE 5 + +typedef struct { + void *user_data; + sound_manager_volume_changed_cb user_cb; +}_changed_volume_info_s; + +typedef struct { + int is_registered; + void *user_data; + sound_session_notify_cb user_cb; + void *interrupted_user_data; + sound_interrupted_cb interrupted_cb; +}_session_notify_info_s; + +typedef struct { + void *user_data; + sound_available_route_changed_cb user_cb; +}_changed_available_route_info_s; + +typedef struct { + void *user_data; + sound_active_device_changed_cb user_cb; +}_changed_active_device_info_s; + +static _changed_volume_info_s g_volume_changed_cb_table; +static _session_notify_info_s g_session_notify_cb_table = {0, NULL, NULL, NULL, NULL}; +static sound_session_type_e g_cached_session = -1; + +#define SOUND_SESSION_TYPE_DEFAULT SOUND_SESSION_TYPE_SHARE + +static void __volume_changed_cb(void *user_data) +{ + int ret = SOUND_MANAGER_ERROR_NONE; + sound_type_e type = (sound_type_e)user_data; + + int new_volume; + ret = sound_manager_get_volume(type, &new_volume); + if (ret == SOUND_MANAGER_ERROR_NONE) { + if(g_volume_changed_cb_table.user_cb) + (g_volume_changed_cb_table.user_cb)(type, new_volume, g_volume_changed_cb_table.user_data); + } else { + LOGE("sound_manager_get_volume() error code(0x%08x)", ret); + } +} + +static void __session_notify_cb(session_msg_t msg, session_event_t event, void *user_data){ + if(g_session_notify_cb_table.user_cb){ + g_session_notify_cb_table.user_cb(msg, g_session_notify_cb_table.user_data); + } + if( g_session_notify_cb_table.interrupted_cb ){ + sound_interrupted_code_e e = SOUND_INTERRUPTED_COMPLETED; + if( msg == MM_SESSION_MSG_RESUME ) + e = SOUND_INTERRUPTED_COMPLETED; + else{ + switch(event){ + case MM_SESSION_EVENT_MEDIA : + e = SOUND_INTERRUPTED_BY_MEDIA; + break; + case MM_SESSION_EVENT_RESUMABLE_MEDIA : + e = SOUND_INTERRUPTED_BY_RESUMABLE_MEDIA; + break; + case MM_SESSION_EVENT_CALL : + e = SOUND_INTERRUPTED_BY_CALL; + break; + case MM_SESSION_EVENT_ALARM : + e = SOUND_INTERRUPTED_BY_ALARM; + break; + case MM_SESSION_EVENT_EARJACK_UNPLUG: + e = SOUND_INTERRUPTED_BY_EARJACK_UNPLUG; + break; + case MM_SESSION_EVENT_RESOURCE_CONFLICT: + e = SOUND_INTERRUPTED_BY_RESOURCE_CONFLICT; + break; + case MM_SESSION_EVENT_EMERGENCY: + e = SOUND_INTERRUPTED_BY_EMERGENCY; + break; + default : + e = SOUND_INTERRUPTED_BY_MEDIA; + break; + } + } + g_session_notify_cb_table.interrupted_cb(e, g_session_notify_cb_table.interrupted_user_data); + } +} + +static int __convert_sound_manager_error_code(const char *func, int code){ + int ret = SOUND_MANAGER_ERROR_NONE; + char *errorstr = NULL; + + switch(code) + { + case SOUND_MANAGER_ERROR_INVALID_PARAMETER: + ret = SOUND_MANAGER_ERROR_INVALID_PARAMETER; + errorstr = "INVALID_PARAMETER"; + break; + case SOUND_MANAGER_ERROR_INVALID_OPERATION: + ret = SOUND_MANAGER_ERROR_INVALID_OPERATION; + errorstr = "INVALID_OPERATION"; + break; + case MM_ERROR_NONE: + ret = SOUND_MANAGER_ERROR_NONE; + errorstr = "ERROR_NONE"; + break; + case MM_ERROR_INVALID_ARGUMENT: + case MM_ERROR_SOUND_INVALID_POINTER: + ret = SOUND_MANAGER_ERROR_INVALID_PARAMETER; + errorstr = "INVALID_PARAMETER"; + break; + case MM_ERROR_SOUND_INTERNAL: + case MM_ERROR_POLICY_DUPLICATED: + case MM_ERROR_POLICY_BLOCKED: + case MM_ERROR_POLICY_INTERNAL: + ret = SOUND_MANAGER_ERROR_INVALID_OPERATION; + errorstr = "INVALID_OPERATION" ; + break; + case MM_ERROR_SOUND_VOLUME_NO_INSTANCE: + case MM_ERROR_SOUND_VOLUME_CAPTURE_ONLY: + ret = SOUND_MANAGER_ERROR_NO_PLAYING_SOUND; + errorstr = "NO_PLAYING_SOUND" ; + break; + } + LOGE("[%s] %s(0x%08x) : core frameworks error code(0x%08x)",func, errorstr, ret, code); + return ret; +} + +int sound_manager_get_max_volume(sound_type_e type, int *max) +{ + int volume; + if(max == NULL) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + + if(type > MAX_VOLUME_TYPE || type < 0) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + int ret = mm_sound_volume_get_step(type, &volume); + + if(ret == 0) + *max = volume -1; // actual volume step can be max step - 1 + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_set_volume(sound_type_e type, int volume) +{ + if(type > MAX_VOLUME_TYPE || type < 0) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + if(volume < 0) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + + int ret = mm_sound_volume_set_value(type, volume); + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_get_volume(sound_type_e type, int *volume) +{ + unsigned int uvolume; + if(type > MAX_VOLUME_TYPE || type < 0) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + if(volume == NULL) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + int ret = mm_sound_volume_get_value(type, &uvolume); + + if(ret == 0) + *volume = uvolume; + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_get_current_sound_type(sound_type_e *type) +{ + if(type == NULL) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + int ret; + ret = mm_sound_volume_get_current_playing_type((volume_type_t *)type); + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_set_volume_changed_cb(sound_manager_volume_changed_cb callback, void* user_data) +{ + if(callback == NULL) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + int i; + g_volume_changed_cb_table.user_cb = callback; + g_volume_changed_cb_table.user_data = user_data; + for(i = 0 ; i <= MAX_VOLUME_TYPE ; i++) + { + mm_sound_volume_add_callback(i , __volume_changed_cb ,(void*) i); + } + return 0; +} + +void sound_manager_unset_volume_changed_cb(void) +{ + int i; + for(i = 0 ; i <= MAX_VOLUME_TYPE ; i++) + { + mm_sound_volume_remove_callback(i); + } + g_volume_changed_cb_table.user_cb = NULL; + g_volume_changed_cb_table.user_data = NULL; +} + +int sound_manager_get_a2dp_status(bool *connected , char** bt_name){ + int ret = mm_sound_route_get_a2dp_status(connected , bt_name); + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_set_session_type(sound_session_type_e type){ + int ret = 0; + int session = 0; + if(type < 0 || type > SOUND_SESSION_TYPE_EMERGENCY) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + + /* if call session is activated, can't set session */ + ret = mm_session_get_current_type(&session); + if( ret == 0 && session >= MM_SESSION_TYPE_CALL ) { + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_OPERATION); + } + + if(g_session_notify_cb_table.is_registered){ + ret = mm_session_finish(); + if (ret != MM_ERROR_NONE) { + return __convert_sound_manager_error_code(__func__, ret); + } + g_session_notify_cb_table.is_registered = 0; + } + + ret = mm_session_init_ex(type , __session_notify_cb, NULL); + if(ret == 0){ + g_session_notify_cb_table.is_registered = 1; + } + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_get_session_type(sound_session_type_e *type){ + if( type == NULL ) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + int ret = 0; + int session; + ret = mm_session_get_current_type(&session); + if( ret !=0 ) + session = SOUND_SESSION_TYPE_DEFAULT; + if( session > SOUND_SESSION_TYPE_EMERGENCY ){ // call session or voip session + if( g_cached_session != -1 ) + session = g_cached_session; // saved session + else //will be never reach here. just prevent code + session = SOUND_SESSION_TYPE_DEFAULT; + } + + *type = session; + return 0; +} + + +int sound_manager_set_session_notify_cb(sound_session_notify_cb callback , void *user_data){ + int ret =0 ; + if(callback == NULL) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + + + if(g_session_notify_cb_table.is_registered ==0){ + ret = mm_session_init_ex(SOUND_SESSION_TYPE_DEFAULT /*default*/ , __session_notify_cb, NULL); + if(ret != 0) + return __convert_sound_manager_error_code(__func__, ret); + g_session_notify_cb_table.is_registered = 1; + } + + g_session_notify_cb_table.user_cb = callback; + g_session_notify_cb_table.user_data = user_data; + return SOUND_MANAGER_ERROR_NONE; +} + +void sound_manager_unset_session_notify_cb(void){ + g_session_notify_cb_table.user_cb = NULL; + g_session_notify_cb_table.user_data = NULL; +} + +int sound_manager_set_interrupted_cb(sound_interrupted_cb callback, void *user_data){ + int ret =0 ; + if(callback == NULL) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + + if(g_session_notify_cb_table.is_registered ==0){ + ret = mm_session_init_ex(SOUND_SESSION_TYPE_DEFAULT /*default*/ , __session_notify_cb, NULL); + if(ret != 0) + return __convert_sound_manager_error_code(__func__, ret); + g_session_notify_cb_table.is_registered = 1; + } + + g_session_notify_cb_table.interrupted_cb= callback; + g_session_notify_cb_table.interrupted_user_data = user_data; + return SOUND_MANAGER_ERROR_NONE; +} + +void sound_manager_unset_interrupted_cb(void){ + g_session_notify_cb_table.interrupted_cb= NULL; + g_session_notify_cb_table.interrupted_user_data = NULL; +} + + +int sound_manager_set_volume_key_type(volume_key_type_e type){ + if(type < VOLUME_KEY_TYPE_NONE || type > VOLUME_KEY_TYPE_CALL) + return __convert_sound_manager_error_code(__func__, SOUND_MANAGER_ERROR_INVALID_PARAMETER); + int ret; + if(type == VOLUME_KEY_TYPE_NONE) + ret = mm_sound_volume_primary_type_clear(); + else + ret = mm_sound_volume_primary_type_set(type); + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_foreach_available_route (sound_available_route_cb callback, void *user_data) +{ + int ret; + ret = mm_sound_foreach_available_route_cb((mm_sound_available_route_cb)callback, user_data); + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_set_active_route (sound_route_e route) +{ + int ret; + ret = mm_sound_set_active_route(route); + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_get_active_device (sound_device_in_e *in, sound_device_out_e *out) +{ + int ret; + ret = mm_sound_get_active_device((mm_sound_device_in *)in, (mm_sound_device_out *)out); + + return __convert_sound_manager_error_code(__func__, ret); +} + +bool sound_manager_is_route_available (sound_route_e route) +{ + bool is_available; + mm_sound_is_route_available(route, &is_available); + + return is_available; +} + +int sound_manager_set_available_route_changed_cb (sound_available_route_changed_cb callback, void *user_data) +{ + int ret; + ret = mm_sound_add_available_route_changed_callback((mm_sound_available_route_changed_cb)callback, user_data); + + return __convert_sound_manager_error_code(__func__, ret); +} + +void sound_manager_unset_available_route_changed_cb (void) +{ + mm_sound_remove_available_route_changed_callback(); +} + +int sound_manager_set_active_device_changed_cb (sound_active_device_changed_cb callback, void *user_data) +{ + int ret; + ret = mm_sound_add_active_device_changed_callback((mm_sound_active_device_changed_cb)callback, user_data); + + return __convert_sound_manager_error_code(__func__, ret); +} + +void sound_manager_unset_active_device_changed_cb (void) +{ + mm_sound_remove_active_device_changed_callback(); +} + +struct sound_call_session_s +{ + int previous_session; +}; + +int sound_manager_call_session_create(sound_call_session_type_e type, sound_call_session_h *session) +{ + int ret = SOUND_MANAGER_ERROR_NONE; + sound_call_session_h handle = NULL; + + /* Check input parameters */ + if(type < SOUND_SESSION_TYPE_CALL || type > SOUND_SESSION_TYPE_VOIP || session == NULL) { + ret = SOUND_MANAGER_ERROR_INVALID_PARAMETER; + goto ERROR; + } + + /* Allocate handle */ + handle = malloc(sizeof(struct sound_call_session_s)); + if(!handle) { + ret = SOUND_MANAGER_ERROR_OUT_OF_MEMORY; + goto ERROR; + } + memset(handle, 0, sizeof(struct sound_call_session_s)); + + /* Finish previous session if exists */ + if(g_session_notify_cb_table.is_registered){ + sound_manager_get_session_type((sound_session_type_e*)&handle->previous_session); + g_cached_session = handle->previous_session; + + ret = mm_session_finish(); + if (ret != MM_ERROR_NONE) { + goto ERROR; + } + g_session_notify_cb_table.is_registered = 0; + + }else{ + g_cached_session = SOUND_SESSION_TYPE_DEFAULT; + handle->previous_session = SOUND_SESSION_TYPE_DEFAULT; + } + + /* Initialize session */ + switch(type) { + case SOUND_SESSION_TYPE_CALL: + ret = mm_session_init_ex(MM_SESSION_TYPE_CALL, __session_notify_cb, NULL); + break; + case SOUND_SESSION_TYPE_VOIP: + ret = mm_session_init_ex(MM_SESSION_TYPE_VIDEOCALL,__session_notify_cb, NULL); + break; + } + if(ret != MM_ERROR_NONE) + goto ERROR; + + g_session_notify_cb_table.is_registered = 1; + *session = handle; + + return SOUND_MANAGER_ERROR_NONE; + +ERROR: + if(handle) + free(handle); + + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_call_session_set_mode(sound_call_session_h session, sound_call_session_mode_e mode) +{ + int ret = SOUND_MANAGER_ERROR_NONE; + + if(mode < SOUND_CALL_SESSION_MODE_VOICE || mode > SOUND_CALL_SESSION_MODE_MEDIA || session == NULL) { + ret = SOUND_MANAGER_ERROR_INVALID_PARAMETER; + goto ERROR; + } + + ret = mm_session_set_subsession ((mm_subsession_t)mode); + + if(ret != MM_ERROR_NONE) + goto ERROR; + + return SOUND_MANAGER_ERROR_NONE; + +ERROR: + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_call_session_get_mode(sound_call_session_h session, sound_call_session_mode_e *mode) +{ + int ret = SOUND_MANAGER_ERROR_NONE; + + if(mode == NULL || session == NULL) { + ret = SOUND_MANAGER_ERROR_INVALID_PARAMETER; + goto ERROR; + } + + ret = mm_session_get_subsession ((mm_subsession_t *)mode); + + if(ret != MM_ERROR_NONE) + goto ERROR; + + return SOUND_MANAGER_ERROR_NONE; + +ERROR: + return __convert_sound_manager_error_code(__func__, ret); +} + +int sound_manager_call_session_destroy(sound_call_session_h session) +{ + int ret = SOUND_MANAGER_ERROR_NONE; + + if(session == NULL) { + ret = SOUND_MANAGER_ERROR_INVALID_PARAMETER; + goto ERROR; + } + + if(g_session_notify_cb_table.is_registered){ + ret = mm_session_finish(); + if(ret != MM_ERROR_NONE) + goto ERROR; + g_session_notify_cb_table.is_registered = 0; + } + + /* Restore previous session */ + ret = mm_session_init_ex(session->previous_session , __session_notify_cb, NULL); + if(ret == 0){ + g_session_notify_cb_table.is_registered = 1; + } + + if(session) + free(session); + + return SOUND_MANAGER_ERROR_NONE; + +ERROR: + return __convert_sound_manager_error_code(__func__, ret); +} + diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt new file mode 100644 index 0000000..c0fae15 --- /dev/null +++ b/test/CMakeLists.txt @@ -0,0 +1,21 @@ +SET(fw_test "${fw_name}-test") + +INCLUDE(FindPkgConfig) +pkg_check_modules(${fw_test} REQUIRED mm-sound glib-2.0 gthread-2.0 capi-media-player) +FOREACH(flag ${${fw_test}_CFLAGS}) + SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}") + MESSAGE(${flag}) +ENDFOREACH() + +SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -Wall") + +#ADD_EXECUTABLE("system-sensor" system-sensor.c) +#TARGET_LINK_LIBRARIES("system-sensor" ${fw_name} ${${fw_test}_LDFLAGS}) + +aux_source_directory(. sources) +FOREACH(src ${sources}) + GET_FILENAME_COMPONENT(src_name ${src} NAME_WE) + MESSAGE("${src_name}") + ADD_EXECUTABLE(${src_name} ${src}) + TARGET_LINK_LIBRARIES(${src_name} ${fw_name} ${${fw_test}_LDFLAGS}) +ENDFOREACH() diff --git a/test/multimedia_sound_manager_test.c b/test/multimedia_sound_manager_test.c new file mode 100644 index 0000000..50ba3b6 --- /dev/null +++ b/test/multimedia_sound_manager_test.c @@ -0,0 +1,244 @@ +/* +* Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved +* +* Licensed under the Apache License, Version 2.0 (the "License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + + + +#include +#include +#include +#include +#include +#include +#include +#include + +static GMainLoop *g_mainloop = NULL; +static GThread *event_thread; +#define MAX_VOLUME_TYPE 5 + +gpointer GmainThread(gpointer data){ + g_mainloop = g_main_loop_new (NULL, 0); + g_main_loop_run (g_mainloop); + + return NULL; +} + +void _sound_manager_volume_changed_cb(sound_type_e type, unsigned int volume, void* user_data) +{ + printf("changed!! type=%d, volume = %d\n", type, volume); +} + +int set_volume_test() +{ + printf("set volume test\n"); + int i; + sound_manager_set_volume_changed_cb(_sound_manager_volume_changed_cb ,NULL); + for( i = SOUND_TYPE_SYSTEM ; i <=MAX_VOLUME_TYPE; i++){ + int max_value; + int j; + sound_manager_get_max_volume(i, &max_value); + printf(" sound type = %d , max volume = %d\n", i, max_value); + for( j = 0; j <= max_value+1 ; j++){ + int ret; + int getvalue; + ret = sound_manager_set_volume(i, j); + if( j <= max_value && ret == 0 ){ + sound_manager_get_volume(i, &getvalue); + if( j == getvalue ) + printf("PASS\n"); + else + printf("FAIL!set=%d, get=%d\n", j, getvalue); + } else if( j > max_value && ret == 0 ) + printf("FAIL! max_value over!!\n"); + + } + } + //sound_manager_unset_volume_changed_cb(); + printf("end set volume test!!!\n"); + sleep(10); + return 0; +} + +void _sound_manager_route_policy_changed_cb(sound_route_policy_e route , void* user_data) +{ + printf("new route policy %d\n", route); +} + +int set_policy_test() +{ + printf("-----------set policy test--------------\n"); + int ret; + //int i; + //sound_route_policy_e value; + sound_manager_set_route_policy_changed_cb(_sound_manager_route_policy_changed_cb,NULL); + /* + for( i = SOUND_ROUTE_DEFAULT ; i <= SOUND_ROUTE_HANDSET_ONLY ; i++){ + ret = sound_manager_set_route_policy(i); + ret = sound_manager_get_route_policy(&value); + if( i == value ) + printf("PASS\n"); + else + printf("FAIL\n"); + } + */ + ret = sound_manager_set_route_policy(SOUND_ROUTE_DEFAULT); + ret = sound_manager_set_route_policy(SOUND_ROUTE_DEFAULT); + ret = sound_manager_set_route_policy(SOUND_ROUTE_DEFAULT); + ret = sound_manager_set_route_policy(SOUND_ROUTE_DEFAULT); + + + return 0; +} + + +static void mm_volume_changed_cb(void *user_data) +{ + int v = (int)user_data; + unsigned int value = 0; + int ret = mm_sound_volume_get_value(v, &value); + printf("mm_volume_changed_cb type = %d ,volume = %d , ret = %x\n", v, value, ret ); +} + + +int mm_bug_test() +{ + int ret = 0; + mm_sound_volume_add_callback(0 , mm_volume_changed_cb , (void*)0); + mm_sound_volume_add_callback(1 , mm_volume_changed_cb ,(void*) 1); + mm_sound_volume_add_callback(2 , mm_volume_changed_cb , (void*)2); + mm_sound_volume_add_callback(5 , mm_volume_changed_cb , (void*)5); + + int i; + + for( i = 0 ; i < 10 ; i++) + { + ret = mm_sound_volume_set_value(0, i); + printf("type = 0 , volume = %d set , ret = %x\n", i, ret); + ret = mm_sound_volume_set_value(1, i); + printf("type = 1 , volume = %d set , ret = %x\n", i, ret); + ret = mm_sound_volume_set_value(2, i); + printf("type = 2 , volume = %d set , ret = %x\n", i, ret); + ret = mm_sound_volume_set_value(5, i); + printf("type = 5 , volume = %d set , ret = %x\n", i, ret); + sleep(1); + } + + //mm_sound_volume_remove_callback(0); + //mm_sound_volume_remove_callback(1); + //mm_sound_volume_remove_callback(2); + //mm_sound_volume_remove_callback(5); + + + ret = mm_sound_volume_set_value(5, 4); + + mm_sound_route_set_system_policy(SOUND_ROUTE_DEFAULT); + mm_sound_route_set_system_policy(SOUND_ROUTE_DEFAULT); + mm_sound_route_set_system_policy(SOUND_ROUTE_DEFAULT); + return 0; +} + +void mm_test(){ + + char path[255]; + int id; + int i; + getcwd(path, 255); + strcat(path, "/test2.wav"); + for( i =0 ; i < 10 ; i++){ + mm_sound_play_sound(path, SOUND_TYPE_MEDIA, NULL ,NULL, &id); + mm_sound_stop_sound(id); + } +} + +void session_notify_cb(sound_session_notify_e notify, void *user_data) +{ + printf("notify %d\n", notify); + + +} + + +void session_test(){ + printf("session_test\n"); + int ret = 0; + player_h player; + + ret = sound_manager_set_session_type(SOUND_SESSION_TYPE_EXCLUSIVE); + sound_manager_set_session_notify_cb(session_notify_cb,NULL); + + + + ret = player_create(&player); + printf("player_create ret =%x\n", ret); + ret = player_set_uri(player, "title_theme.mp3"); + printf("player_set_uri ret =%x\n", ret); + ret =player_prepare(player); + printf("player_prepare ret =%x\n", ret); + ret = player_start(player); + printf("player_start ret =%x\n", ret); + + while(1){ + player_state_e state; + player_get_state(player, &state); + printf("state %d\n", state); + //if( state == 4) + //player_start(player); + sleep(1); + //wav_player_start("test.wav", SOUND_TYPE_MEDIA,NULL, NULL,NULL); + } + + +} + + +void a2dp_test(){ + bool isconnected; + char * name; + sound_manager_get_a2dp_status(&isconnected, &name); + if( isconnected ){ + printf("name = %s\n", name); + free(name); + }else{ + printf("disconnected\n"); + } + sound_device_e device; + sound_manager_get_current_sound_device(&device); + printf("device =%d\n", device); + +} + +int main() +{ + if( !g_thread_supported() ) + { + g_thread_init(NULL); + } + + GError *gerr = NULL; + event_thread = g_thread_create(GmainThread, NULL, 1, &gerr); + + + + //set_volume_test(); + //set_policy_test(); + //mm_bug_test(); + //wav_play_test(); + //tone_play_test(); + //wav_play_test(); + session_test(); + //a2dp_test(); + return 0; +}