1c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent/* 2c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Copyright (C) 2009 The Android Open Source Project 3c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 4c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Licensed under the Apache License, Version 2.0 (the "License"); 5c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * you may not use this file except in compliance with the License. 6c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * You may obtain a copy of the License at 7c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 8c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * http://www.apache.org/licenses/LICENSE-2.0 9c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 10c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Unless required by applicable law or agreed to in writing, software 11c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * distributed under the License is distributed on an "AS IS" BASIS, 12c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * See the License for the specific language governing permissions and 14c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * limitations under the License. 15c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent */ 16c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 17c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#ifndef ANDROID_IAUDIOPOLICYSERVICE_H 18c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#define ANDROID_IAUDIOPOLICYSERVICE_H 19c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 20c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <stdint.h> 21c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <sys/types.h> 22c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <unistd.h> 23c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 24c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <utils/RefBase.h> 25c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <utils/Errors.h> 26c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <binder/IInterface.h> 27c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <media/AudioSystem.h> 28baac183f3808d7b68f184647a97bd381620415feEric Laurent#include <media/AudioPolicy.h> 29b52c152d553556b2d227ffc943489de0c60b4b02Eric Laurent#include <media/IAudioPolicyServiceClient.h> 30c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 317394a4f358fa9908a9f0a7c954b65c399f4268e6Dima Zavin#include <system/audio_policy.h> 32c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 33c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentnamespace android { 34c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 35c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent// ---------------------------------------------------------------------------- 36c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 37c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass IAudioPolicyService : public IInterface 38c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent{ 39c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentpublic: 40c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DECLARE_META_INTERFACE(AudioPolicyService); 41c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 42c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 43c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions) 44c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 45fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual status_t setDeviceConnectionState(audio_devices_t device, 46fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin audio_policy_dev_state_t state, 47e743a47f445f02a0612018fa5640301304844fbfPaul McLean const char *device_address, 48e743a47f445f02a0612018fa5640301304844fbfPaul McLean const char *device_name) = 0; 49fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device, 5085ab62c4b433df3f1a9826bed1c9bec07a86c750Glenn Kasten const char *device_address) = 0; 51f78aee70d15daf4690de7e7b4983ee68b0d1381dGlenn Kasten virtual status_t setPhoneState(audio_mode_t state) = 0; 5285ab62c4b433df3f1a9826bed1c9bec07a86c750Glenn Kasten virtual status_t setForceUse(audio_policy_force_use_t usage, 5385ab62c4b433df3f1a9826bed1c9bec07a86c750Glenn Kasten audio_policy_forced_cfg_t config) = 0; 54fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage) = 0; 55fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual audio_io_handle_t getOutput(audio_stream_type_t stream, 56c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate = 0, 5758f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t format = AUDIO_FORMAT_DEFAULT, 58254af180475346b6186b49c297f340c9c4817511Glenn Kasten audio_channel_mask_t channelMask = 0, 59ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, 60ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald const audio_offload_info_t *offloadInfo = NULL) = 0; 61e83b55dc29ca16092ba02f36f55fa6e0e37fd78cEric Laurent virtual status_t getOutputForAttr(const audio_attributes_t *attr, 62d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_io_handle_t *output, 63d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_session_t session, 64d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_stream_type_t *stream, 65d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten uid_t uid, 66d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten uint32_t samplingRate = 0, 67d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_format_t format = AUDIO_FORMAT_DEFAULT, 68d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_channel_mask_t channelMask = 0, 69d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, 70d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_port_handle_t selectedDeviceId = AUDIO_PORT_HANDLE_NONE, 71d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten const audio_offload_info_t *offloadInfo = NULL) = 0; 72de070137f11d346fba77605bd76a44c040a618fcEric Laurent virtual status_t startOutput(audio_io_handle_t output, 73fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin audio_stream_type_t stream, 74e83b55dc29ca16092ba02f36f55fa6e0e37fd78cEric Laurent audio_session_t session) = 0; 75de070137f11d346fba77605bd76a44c040a618fcEric Laurent virtual status_t stopOutput(audio_io_handle_t output, 76fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin audio_stream_type_t stream, 77e83b55dc29ca16092ba02f36f55fa6e0e37fd78cEric Laurent audio_session_t session) = 0; 78e83b55dc29ca16092ba02f36f55fa6e0e37fd78cEric Laurent virtual void releaseOutput(audio_io_handle_t output, 79e83b55dc29ca16092ba02f36f55fa6e0e37fd78cEric Laurent audio_stream_type_t stream, 80e83b55dc29ca16092ba02f36f55fa6e0e37fd78cEric Laurent audio_session_t session) = 0; 81caf7f48a0ef558689d39aafd187c1571ff4128b4Eric Laurent virtual status_t getInputForAttr(const audio_attributes_t *attr, 82466dc8ed6ca6b7f585104806c48613dd34e608c9Paul McLean audio_io_handle_t *input, 83466dc8ed6ca6b7f585104806c48613dd34e608c9Paul McLean audio_session_t session, 84b2379ba0a32638bae2ea0460644f68cf5a0967ceEric Laurent pid_t pid, 858c7e6dac6f5eb38cef627dab92eac8b38513450cEric Laurent uid_t uid, 86466dc8ed6ca6b7f585104806c48613dd34e608c9Paul McLean uint32_t samplingRate, 87466dc8ed6ca6b7f585104806c48613dd34e608c9Paul McLean audio_format_t format, 88466dc8ed6ca6b7f585104806c48613dd34e608c9Paul McLean audio_channel_mask_t channelMask, 89466dc8ed6ca6b7f585104806c48613dd34e608c9Paul McLean audio_input_flags_t flags, 90466dc8ed6ca6b7f585104806c48613dd34e608c9Paul McLean audio_port_handle_t selectedDeviceId = AUDIO_PORT_HANDLE_NONE) = 0; 914dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent virtual status_t startInput(audio_io_handle_t input, 924dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent audio_session_t session) = 0; 934dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent virtual status_t stopInput(audio_io_handle_t input, 944dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent audio_session_t session) = 0; 954dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent virtual void releaseInput(audio_io_handle_t input, 964dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent audio_session_t session) = 0; 97fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual status_t initStreamVolume(audio_stream_type_t stream, 98c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMin, 99c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMax) = 0; 10083844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent virtual status_t setStreamVolumeIndex(audio_stream_type_t stream, 10183844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent int index, 10283844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent audio_devices_t device) = 0; 10383844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent virtual status_t getStreamVolumeIndex(audio_stream_type_t stream, 10483844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent int *index, 10583844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent audio_devices_t device) = 0; 106fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual uint32_t getStrategyForStream(audio_stream_type_t stream) = 0; 1076374252107fd6539397598195ea6defd5870fafbEric Laurent virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream) = 0; 10858e5aa34f01d663654d8bafad65db1dda42161ffGlenn Kasten virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc) = 0; 10958e5aa34f01d663654d8bafad65db1dda42161ffGlenn Kasten virtual status_t registerEffect(const effect_descriptor_t *desc, 1107c7f10bd4fda9a084e5e7f0eb3a040dfcbf01745Eric Laurent audio_io_handle_t io, 111de070137f11d346fba77605bd76a44c040a618fcEric Laurent uint32_t strategy, 112d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten audio_session_t session, 113de070137f11d346fba77605bd76a44c040a618fcEric Laurent int id) = 0; 114de070137f11d346fba77605bd76a44c040a618fcEric Laurent virtual status_t unregisterEffect(int id) = 0; 115db7c079f284f6e91266f6653ae0ec198b1c5006eEric Laurent virtual status_t setEffectEnabled(int id, bool enabled) = 0; 116fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const = 0; 117272ab546940054ad7991bef4b3a36f15175721cdJean-Michel Trivi virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) 118272ab546940054ad7991bef4b3a36f15175721cdJean-Michel Trivi const = 0; 119d7086030fcf731e4bcef6c033cc6418cd04e6b91Jean-Michel Trivi virtual bool isSourceActive(audio_source_t source) const = 0; 120d848eb48c121c119e8ba7583efc75415fe102570Glenn Kasten virtual status_t queryDefaultPreProcessing(audio_session_t audioSession, 12157dae99c9fcd6becd2b5ed0c53f277ba4d7dbcfcEric Laurent effect_descriptor_t *descriptors, 12257dae99c9fcd6becd2b5ed0c53f277ba4d7dbcfcEric Laurent uint32_t *count) = 0; 123ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald // Check if offload is possible for given format, stream type, sample rate, 124ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald // bit rate, duration, video and streaming or offload property is enabled 125ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald virtual bool isOffloadSupported(const audio_offload_info_t& info) = 0; 126203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 127203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* List available audio ports and their attributes */ 128203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t listAudioPorts(audio_port_role_t role, 129203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent audio_port_type_t type, 130203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent unsigned int *num_ports, 131203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent struct audio_port *ports, 132203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent unsigned int *generation) = 0; 133203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 134203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Get attributes for a given audio port */ 135203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t getAudioPort(struct audio_port *port) = 0; 136203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 137203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Create an audio patch between several source and sink ports */ 138203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t createAudioPatch(const struct audio_patch *patch, 139203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent audio_patch_handle_t *handle) = 0; 140203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 141203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Release an audio patch */ 142203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t releaseAudioPatch(audio_patch_handle_t handle) = 0; 143203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 144203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* List existing audio patches */ 145203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t listAudioPatches(unsigned int *num_patches, 146203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent struct audio_patch *patches, 147203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent unsigned int *generation) = 0; 148203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Set audio port configuration */ 149203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t setAudioPortConfig(const struct audio_port_config *config) = 0; 150203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 151b52c152d553556b2d227ffc943489de0c60b4b02Eric Laurent virtual void registerClient(const sp<IAudioPolicyServiceClient>& client) = 0; 152df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent 153e8726fea8a53bf3474aa3c6deaf2f6c1f565e694Eric Laurent virtual void setAudioPortCallbacksEnabled(bool enabled) = 0; 154e8726fea8a53bf3474aa3c6deaf2f6c1f565e694Eric Laurent 155df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent virtual status_t acquireSoundTriggerSession(audio_session_t *session, 156df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent audio_io_handle_t *ioHandle, 157df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent audio_devices_t *device) = 0; 158df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent 159df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent virtual status_t releaseSoundTriggerSession(audio_session_t session) = 0; 160bb6c9a05840d924b502ce0f1868fca4881ada1edEric Laurent 161bb6c9a05840d924b502ce0f1868fca4881ada1edEric Laurent virtual audio_mode_t getPhoneState() = 0; 162baac183f3808d7b68f184647a97bd381620415feEric Laurent 163baac183f3808d7b68f184647a97bd381620415feEric Laurent virtual status_t registerPolicyMixes(Vector<AudioMix> mixes, bool registration) = 0; 164554a277d4e42a3d3df3d90ba0e7dfa2d31690e32Eric Laurent 165554a277d4e42a3d3df3d90ba0e7dfa2d31690e32Eric Laurent virtual status_t startAudioSource(const struct audio_port_config *source, 166554a277d4e42a3d3df3d90ba0e7dfa2d31690e32Eric Laurent const audio_attributes_t *attributes, 167554a277d4e42a3d3df3d90ba0e7dfa2d31690e32Eric Laurent audio_io_handle_t *handle) = 0; 168554a277d4e42a3d3df3d90ba0e7dfa2d31690e32Eric Laurent virtual status_t stopAudioSource(audio_io_handle_t handle) = 0; 1692ddee19245641e86bca436dda23a0f5089bf2ab5Andy Hung 1702ddee19245641e86bca436dda23a0f5089bf2ab5Andy Hung virtual status_t setMasterMono(bool mono) = 0; 1712ddee19245641e86bca436dda23a0f5089bf2ab5Andy Hung virtual status_t getMasterMono(bool *mono) = 0; 172c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; 173c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 174c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 175c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent// ---------------------------------------------------------------------------- 176c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 177c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass BnAudioPolicyService : public BnInterface<IAudioPolicyService> 178c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent{ 179c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentpublic: 180c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t onTransact( uint32_t code, 181c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent const Parcel& data, 182c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent Parcel* reply, 183c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t flags = 0); 184c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; 185c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 186c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent// ---------------------------------------------------------------------------- 187c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 188c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; // namespace android 189c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 190c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#endif // ANDROID_IAUDIOPOLICYSERVICE_H 191