1e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman/* 2e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * Copyright (C) 2009 The Android Open Source Project 3e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * 4e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * Licensed under the Apache License, Version 2.0 (the "License"); 5e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * you may not use this file except in compliance with the License. 6e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * You may obtain a copy of the License at 7e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * 8e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * http://www.apache.org/licenses/LICENSE-2.0 9e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * 10e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * Unless required by applicable law or agreed to in writing, software 11e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * distributed under the License is distributed on an "AS IS" BASIS, 12e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * See the License for the specific language governing permissions and 14e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * limitations under the License. 15e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman */ 16e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 17e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#ifndef ANDROID_IAUDIOPOLICYSERVICE_H 18e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#define ANDROID_IAUDIOPOLICYSERVICE_H 19e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 20e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <stdint.h> 21e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <sys/types.h> 22e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <unistd.h> 23e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 24e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <utils/RefBase.h> 25e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <utils/Errors.h> 26e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <binder/IInterface.h> 27e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <media/AudioSystem.h> 28e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <media/AudioPolicy.h> 29e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <media/IAudioPolicyServiceClient.h> 30e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 31e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <system/audio_policy.h> 32e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 33e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramannamespace android { 34e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 35e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 36e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 37e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanclass IAudioPolicyService : public IInterface 38e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman{ 39e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanpublic: 40e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman DECLARE_META_INTERFACE(AudioPolicyService); 41e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 42e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman // 43e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions) 44e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman // 45e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setDeviceConnectionState(audio_devices_t device, 46e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_policy_dev_state_t state, 47e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const char *device_address, 48e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const char *device_name) = 0; 49e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device, 50e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const char *device_address) = 0; 51e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t handleDeviceConfigChange(audio_devices_t device, 52e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const char *device_address, 53e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const char *device_name) = 0; 54e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setPhoneState(audio_mode_t state) = 0; 55e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setForceUse(audio_policy_force_use_t usage, 56e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_policy_forced_cfg_t config) = 0; 57e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage) = 0; 58f4e63452b37c799c9387a6a88b46e6191f6a5f7eEric Laurent virtual audio_io_handle_t getOutput(audio_stream_type_t stream) = 0; 59e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getOutputForAttr(const audio_attributes_t *attr, 60e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_io_handle_t *output, 61e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session, 62e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_stream_type_t *stream, 63766fb020a50b64bf9a808bd80df60c54c2ca8cc3Nadav Bar pid_t pid, 64e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uid_t uid, 65e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const audio_config_t *config, 66e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_output_flags_t flags, 679ae8c597d9a0c8cedc4047fc4716d7361453f6abEric Laurent audio_port_handle_t *selectedDeviceId, 68e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_port_handle_t *portId) = 0; 69e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t startOutput(audio_io_handle_t output, 70e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_stream_type_t stream, 71e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 72e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t stopOutput(audio_io_handle_t output, 73e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_stream_type_t stream, 74e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 75e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void releaseOutput(audio_io_handle_t output, 76e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_stream_type_t stream, 77e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 78e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getInputForAttr(const audio_attributes_t *attr, 79e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_io_handle_t *input, 80e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session, 81e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman pid_t pid, 82e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uid_t uid, 83fee1976a2849c37a53d8a01ac10327d522a1ba93Eric Laurent const String16& opPackageName, 84e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const audio_config_base_t *config, 85e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_input_flags_t flags, 869ae8c597d9a0c8cedc4047fc4716d7361453f6abEric Laurent audio_port_handle_t *selectedDeviceId, 87e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_port_handle_t *portId) = 0; 88fee1976a2849c37a53d8a01ac10327d522a1ba93Eric Laurent virtual status_t startInput(audio_port_handle_t portId, 89f4ddfefc8ba59a8486d91826154cc9447821409eSvet Ganov bool *silenced) = 0; 90fee1976a2849c37a53d8a01ac10327d522a1ba93Eric Laurent virtual status_t stopInput(audio_port_handle_t portId) = 0; 91fee1976a2849c37a53d8a01ac10327d522a1ba93Eric Laurent virtual void releaseInput(audio_port_handle_t portId) = 0; 92e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t initStreamVolume(audio_stream_type_t stream, 93e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int indexMin, 94e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int indexMax) = 0; 95e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setStreamVolumeIndex(audio_stream_type_t stream, 96e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int index, 97e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_devices_t device) = 0; 98e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getStreamVolumeIndex(audio_stream_type_t stream, 99e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int *index, 100e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_devices_t device) = 0; 101e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual uint32_t getStrategyForStream(audio_stream_type_t stream) = 0; 102e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream) = 0; 103e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc) = 0; 104e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t registerEffect(const effect_descriptor_t *desc, 105e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_io_handle_t io, 106e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uint32_t strategy, 107e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session, 108e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int id) = 0; 109e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t unregisterEffect(int id) = 0; 110e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setEffectEnabled(int id, bool enabled) = 0; 111e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const = 0; 112e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) 113e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const = 0; 114e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isSourceActive(audio_source_t source) const = 0; 115e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t queryDefaultPreProcessing(audio_session_t audioSession, 116e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman effect_descriptor_t *descriptors, 117e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uint32_t *count) = 0; 118e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman // Check if offload is possible for given format, stream type, sample rate, 119e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman // bit rate, duration, video and streaming or offload property is enabled 120e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isOffloadSupported(const audio_offload_info_t& info) = 0; 121e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 122e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* List available audio ports and their attributes */ 123e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t listAudioPorts(audio_port_role_t role, 124e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_port_type_t type, 125e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman unsigned int *num_ports, 126e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman struct audio_port *ports, 127e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman unsigned int *generation) = 0; 128e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 129e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Get attributes for a given audio port */ 130e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getAudioPort(struct audio_port *port) = 0; 131e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 132e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Create an audio patch between several source and sink ports */ 133e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t createAudioPatch(const struct audio_patch *patch, 134e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_patch_handle_t *handle) = 0; 135e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 136e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Release an audio patch */ 137e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t releaseAudioPatch(audio_patch_handle_t handle) = 0; 138e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 139e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* List existing audio patches */ 140e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t listAudioPatches(unsigned int *num_patches, 141e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman struct audio_patch *patches, 142e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman unsigned int *generation) = 0; 143e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Set audio port configuration */ 144e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setAudioPortConfig(const struct audio_port_config *config) = 0; 145e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 146e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void registerClient(const sp<IAudioPolicyServiceClient>& client) = 0; 147e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 148e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void setAudioPortCallbacksEnabled(bool enabled) = 0; 149e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 150e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t acquireSoundTriggerSession(audio_session_t *session, 151e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_io_handle_t *ioHandle, 152e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_devices_t *device) = 0; 153e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 154e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t releaseSoundTriggerSession(audio_session_t session) = 0; 155e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 156e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_mode_t getPhoneState() = 0; 157e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 158e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t registerPolicyMixes(const Vector<AudioMix>& mixes, bool registration) = 0; 159e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 160e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t startAudioSource(const struct audio_port_config *source, 161e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const audio_attributes_t *attributes, 162e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_patch_handle_t *handle) = 0; 163e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t stopAudioSource(audio_patch_handle_t handle) = 0; 164e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 165e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setMasterMono(bool mono) = 0; 166e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getMasterMono(bool *mono) = 0; 167ac9cef5f3288df6e65cb4488e2615cc3c07b70d0Eric Laurent virtual float getStreamVolumeDB( 168ac9cef5f3288df6e65cb4488e2615cc3c07b70d0Eric Laurent audio_stream_type_t stream, int index, audio_devices_t device) = 0; 169817729095966c338615a8a791d2dbf774fc034efjiabin 170817729095966c338615a8a791d2dbf774fc034efjiabin virtual status_t getSurroundFormats(unsigned int *numSurroundFormats, 171817729095966c338615a8a791d2dbf774fc034efjiabin audio_format_t *surroundFormats, 172817729095966c338615a8a791d2dbf774fc034efjiabin bool *surroundFormatsEnabled, 173817729095966c338615a8a791d2dbf774fc034efjiabin bool reported) = 0; 174817729095966c338615a8a791d2dbf774fc034efjiabin virtual status_t setSurroundFormatEnabled(audio_format_t audioFormat, bool enabled) = 0; 175e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; 176e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 177e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 178e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 179e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 180e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanclass BnAudioPolicyService : public BnInterface<IAudioPolicyService> 181e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman{ 182e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanpublic: 183e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t onTransact( uint32_t code, 184e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const Parcel& data, 185e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman Parcel* reply, 186e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uint32_t flags = 0); 18739fdbd097a147b5c719dac9ad2759e6c44eb3a4eKevin Rocardprivate: 18839fdbd097a147b5c719dac9ad2759e6c44eb3a4eKevin Rocard void sanetizeAudioAttributes(audio_attributes_t* attr); 189b0272097450ef868637e8a50d2575e16e37c90fbAndy Hung status_t sanitizeEffectDescriptor(effect_descriptor_t* desc); 190b0272097450ef868637e8a50d2575e16e37c90fbAndy Hung status_t sanitizeAudioPortConfig(struct audio_port_config* config); 191e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; 192e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 193e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 194e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 195e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; // namespace android 196e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 197e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#endif // ANDROID_IAUDIOPOLICYSERVICE_H 198