IAudioPolicyService.h revision f4ddfefc8ba59a8486d91826154cc9447821409e
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, 63e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uid_t uid, 64e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const audio_config_t *config, 65e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_output_flags_t flags, 669ae8c597d9a0c8cedc4047fc4716d7361453f6abEric Laurent audio_port_handle_t *selectedDeviceId, 67e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_port_handle_t *portId) = 0; 68e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t startOutput(audio_io_handle_t output, 69e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_stream_type_t stream, 70e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 71e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t stopOutput(audio_io_handle_t output, 72e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_stream_type_t stream, 73e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 74e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void releaseOutput(audio_io_handle_t output, 75e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_stream_type_t stream, 76e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 77e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getInputForAttr(const audio_attributes_t *attr, 78e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_io_handle_t *input, 79e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session, 80e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman pid_t pid, 81e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uid_t uid, 82e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const audio_config_base_t *config, 83e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_input_flags_t flags, 849ae8c597d9a0c8cedc4047fc4716d7361453f6abEric Laurent audio_port_handle_t *selectedDeviceId, 85e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_port_handle_t *portId) = 0; 86e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t startInput(audio_io_handle_t input, 87f4ddfefc8ba59a8486d91826154cc9447821409eSvet Ganov audio_session_t session, 88f4ddfefc8ba59a8486d91826154cc9447821409eSvet Ganov audio_devices_t device, 89f4ddfefc8ba59a8486d91826154cc9447821409eSvet Ganov uid_t uid, 90f4ddfefc8ba59a8486d91826154cc9447821409eSvet Ganov bool *silenced) = 0; 91e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t stopInput(audio_io_handle_t input, 92e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 93e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void releaseInput(audio_io_handle_t input, 94e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session) = 0; 95e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t initStreamVolume(audio_stream_type_t stream, 96e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int indexMin, 97e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int indexMax) = 0; 98e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setStreamVolumeIndex(audio_stream_type_t stream, 99e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int index, 100e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_devices_t device) = 0; 101e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getStreamVolumeIndex(audio_stream_type_t stream, 102e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int *index, 103e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_devices_t device) = 0; 104e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual uint32_t getStrategyForStream(audio_stream_type_t stream) = 0; 105e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream) = 0; 106e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc) = 0; 107e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t registerEffect(const effect_descriptor_t *desc, 108e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_io_handle_t io, 109e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uint32_t strategy, 110e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_session_t session, 111e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman int id) = 0; 112e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t unregisterEffect(int id) = 0; 113e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setEffectEnabled(int id, bool enabled) = 0; 114e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const = 0; 115e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) 116e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const = 0; 117e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isSourceActive(audio_source_t source) const = 0; 118e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t queryDefaultPreProcessing(audio_session_t audioSession, 119e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman effect_descriptor_t *descriptors, 120e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uint32_t *count) = 0; 121e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman // Check if offload is possible for given format, stream type, sample rate, 122e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman // bit rate, duration, video and streaming or offload property is enabled 123e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual bool isOffloadSupported(const audio_offload_info_t& info) = 0; 124e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 125e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* List available audio ports and their attributes */ 126e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t listAudioPorts(audio_port_role_t role, 127e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_port_type_t type, 128e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman unsigned int *num_ports, 129e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman struct audio_port *ports, 130e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman unsigned int *generation) = 0; 131e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 132e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Get attributes for a given audio port */ 133e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getAudioPort(struct audio_port *port) = 0; 134e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 135e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Create an audio patch between several source and sink ports */ 136e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t createAudioPatch(const struct audio_patch *patch, 137e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_patch_handle_t *handle) = 0; 138e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 139e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Release an audio patch */ 140e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t releaseAudioPatch(audio_patch_handle_t handle) = 0; 141e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 142e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* List existing audio patches */ 143e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t listAudioPatches(unsigned int *num_patches, 144e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman struct audio_patch *patches, 145e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman unsigned int *generation) = 0; 146e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Set audio port configuration */ 147e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setAudioPortConfig(const struct audio_port_config *config) = 0; 148e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 149e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void registerClient(const sp<IAudioPolicyServiceClient>& client) = 0; 150e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 151e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void setAudioPortCallbacksEnabled(bool enabled) = 0; 152e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 153e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t acquireSoundTriggerSession(audio_session_t *session, 154e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_io_handle_t *ioHandle, 155e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_devices_t *device) = 0; 156e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 157e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t releaseSoundTriggerSession(audio_session_t session) = 0; 158e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 159e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual audio_mode_t getPhoneState() = 0; 160e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 161e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t registerPolicyMixes(const Vector<AudioMix>& mixes, bool registration) = 0; 162e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 163e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t startAudioSource(const struct audio_port_config *source, 164e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const audio_attributes_t *attributes, 165e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman audio_patch_handle_t *handle) = 0; 166e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t stopAudioSource(audio_patch_handle_t handle) = 0; 167e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 168e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setMasterMono(bool mono) = 0; 169e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getMasterMono(bool *mono) = 0; 170ac9cef5f3288df6e65cb4488e2615cc3c07b70d0Eric Laurent virtual float getStreamVolumeDB( 171ac9cef5f3288df6e65cb4488e2615cc3c07b70d0Eric Laurent audio_stream_type_t stream, int index, audio_devices_t device) = 0; 172e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; 173e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 174e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 175e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 176e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 177e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanclass BnAudioPolicyService : public BnInterface<IAudioPolicyService> 178e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman{ 179e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanpublic: 180e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t onTransact( uint32_t code, 181e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const Parcel& data, 182e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman Parcel* reply, 183e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uint32_t flags = 0); 18439fdbd097a147b5c719dac9ad2759e6c44eb3a4eKevin Rocardprivate: 18539fdbd097a147b5c719dac9ad2759e6c44eb3a4eKevin Rocard void sanetizeAudioAttributes(audio_attributes_t* attr); 186e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; 187e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 188e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 189e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 190e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; // namespace android 191e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 192e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#endif // ANDROID_IAUDIOPOLICYSERVICE_H 193