AudioPolicyManager.h revision 1c333e252cbca3337c1bedbc57a005f3b7d23fdb
1/* 2 * Copyright (C) 2009 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 18#include <stdint.h> 19#include <sys/types.h> 20#include <cutils/config_utils.h> 21#include <cutils/misc.h> 22#include <utils/Timers.h> 23#include <utils/Errors.h> 24#include <utils/KeyedVector.h> 25#include <utils/SortedVector.h> 26#include "AudioPolicyInterface.h" 27 28 29namespace android { 30 31// ---------------------------------------------------------------------------- 32 33// Attenuation applied to STRATEGY_SONIFICATION streams when a headset is connected: 6dB 34#define SONIFICATION_HEADSET_VOLUME_FACTOR 0.5 35// Min volume for STRATEGY_SONIFICATION streams when limited by music volume: -36dB 36#define SONIFICATION_HEADSET_VOLUME_MIN 0.016 37// Time in milliseconds during which we consider that music is still active after a music 38// track was stopped - see computeVolume() 39#define SONIFICATION_HEADSET_MUSIC_DELAY 5000 40// Time in milliseconds after media stopped playing during which we consider that the 41// sonification should be as unobtrusive as during the time media was playing. 42#define SONIFICATION_RESPECTFUL_AFTER_MUSIC_DELAY 5000 43// Time in milliseconds during witch some streams are muted while the audio path 44// is switched 45#define MUTE_TIME_MS 2000 46 47#define NUM_TEST_OUTPUTS 5 48 49#define NUM_VOL_CURVE_KNEES 2 50 51// Default minimum length allowed for offloading a compressed track 52// Can be overridden by the audio.offload.min.duration.secs property 53#define OFFLOAD_DEFAULT_MIN_DURATION_SECS 60 54 55// ---------------------------------------------------------------------------- 56// AudioPolicyManager implements audio policy manager behavior common to all platforms. 57// ---------------------------------------------------------------------------- 58 59class AudioPolicyManager: public AudioPolicyInterface 60#ifdef AUDIO_POLICY_TEST 61 , public Thread 62#endif //AUDIO_POLICY_TEST 63{ 64 65public: 66 AudioPolicyManager(AudioPolicyClientInterface *clientInterface); 67 virtual ~AudioPolicyManager(); 68 69 // AudioPolicyInterface 70 virtual status_t setDeviceConnectionState(audio_devices_t device, 71 audio_policy_dev_state_t state, 72 const char *device_address); 73 virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device, 74 const char *device_address); 75 virtual void setPhoneState(audio_mode_t state); 76 virtual void setForceUse(audio_policy_force_use_t usage, 77 audio_policy_forced_cfg_t config); 78 virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage); 79 virtual void setSystemProperty(const char* property, const char* value); 80 virtual status_t initCheck(); 81 virtual audio_io_handle_t getOutput(audio_stream_type_t stream, 82 uint32_t samplingRate, 83 audio_format_t format, 84 audio_channel_mask_t channelMask, 85 audio_output_flags_t flags, 86 const audio_offload_info_t *offloadInfo); 87 virtual status_t startOutput(audio_io_handle_t output, 88 audio_stream_type_t stream, 89 int session = 0); 90 virtual status_t stopOutput(audio_io_handle_t output, 91 audio_stream_type_t stream, 92 int session = 0); 93 virtual void releaseOutput(audio_io_handle_t output); 94 virtual audio_io_handle_t getInput(audio_source_t inputSource, 95 uint32_t samplingRate, 96 audio_format_t format, 97 audio_channel_mask_t channelMask, 98 audio_in_acoustics_t acoustics); 99 100 // indicates to the audio policy manager that the input starts being used. 101 virtual status_t startInput(audio_io_handle_t input); 102 103 // indicates to the audio policy manager that the input stops being used. 104 virtual status_t stopInput(audio_io_handle_t input); 105 virtual void releaseInput(audio_io_handle_t input); 106 virtual void closeAllInputs(); 107 virtual void initStreamVolume(audio_stream_type_t stream, 108 int indexMin, 109 int indexMax); 110 virtual status_t setStreamVolumeIndex(audio_stream_type_t stream, 111 int index, 112 audio_devices_t device); 113 virtual status_t getStreamVolumeIndex(audio_stream_type_t stream, 114 int *index, 115 audio_devices_t device); 116 117 // return the strategy corresponding to a given stream type 118 virtual uint32_t getStrategyForStream(audio_stream_type_t stream); 119 120 // return the enabled output devices for the given stream type 121 virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream); 122 123 virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc = NULL); 124 virtual status_t registerEffect(const effect_descriptor_t *desc, 125 audio_io_handle_t io, 126 uint32_t strategy, 127 int session, 128 int id); 129 virtual status_t unregisterEffect(int id); 130 virtual status_t setEffectEnabled(int id, bool enabled); 131 132 virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const; 133 // return whether a stream is playing remotely, override to change the definition of 134 // local/remote playback, used for instance by notification manager to not make 135 // media players lose audio focus when not playing locally 136 virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) const; 137 virtual bool isSourceActive(audio_source_t source) const; 138 139 virtual status_t dump(int fd); 140 141 virtual bool isOffloadSupported(const audio_offload_info_t& offloadInfo); 142 143protected: 144 145 enum routing_strategy { 146 STRATEGY_MEDIA, 147 STRATEGY_PHONE, 148 STRATEGY_SONIFICATION, 149 STRATEGY_SONIFICATION_RESPECTFUL, 150 STRATEGY_DTMF, 151 STRATEGY_ENFORCED_AUDIBLE, 152 NUM_STRATEGIES 153 }; 154 155 // 4 points to define the volume attenuation curve, each characterized by the volume 156 // index (from 0 to 100) at which they apply, and the attenuation in dB at that index. 157 // we use 100 steps to avoid rounding errors when computing the volume in volIndexToAmpl() 158 159 enum { VOLMIN = 0, VOLKNEE1 = 1, VOLKNEE2 = 2, VOLMAX = 3, VOLCNT = 4}; 160 161 class VolumeCurvePoint 162 { 163 public: 164 int mIndex; 165 float mDBAttenuation; 166 }; 167 168 // device categories used for volume curve management. 169 enum device_category { 170 DEVICE_CATEGORY_HEADSET, 171 DEVICE_CATEGORY_SPEAKER, 172 DEVICE_CATEGORY_EARPIECE, 173 DEVICE_CATEGORY_CNT 174 }; 175 176 class IOProfile; 177 178 class HwModule { 179 public: 180 HwModule(const char *name); 181 ~HwModule(); 182 183 void dump(int fd); 184 185 const char *const mName; // base name of the audio HW module (primary, a2dp ...) 186 audio_module_handle_t mHandle; 187 Vector < sp<IOProfile> > mOutputProfiles; // output profiles exposed by this module 188 Vector < sp<IOProfile> > mInputProfiles; // input profiles exposed by this module 189 }; 190 191 class AudioPort: public RefBase 192 { 193 public: 194 AudioPort(audio_port_type_t type, audio_port_role_t role, HwModule *module) : 195 mType(type), mRole(role), mModule(module) {} 196 virtual ~AudioPort() {} 197 198 virtual void toAudioPort(struct audio_port *port) const; 199 200 void loadSamplingRates(char *name); 201 void loadFormats(char *name); 202 void loadOutChannels(char *name); 203 void loadInChannels(char *name); 204 205 audio_port_type_t mType; 206 audio_port_role_t mRole; 207 // by convention, "0' in the first entry in mSamplingRates, mChannelMasks or mFormats 208 // indicates the supported parameters should be read from the output stream 209 // after it is opened for the first time 210 Vector <uint32_t> mSamplingRates; // supported sampling rates 211 Vector <audio_channel_mask_t> mChannelMasks; // supported channel masks 212 Vector <audio_format_t> mFormats; // supported audio formats 213 HwModule *mModule; // audio HW module exposing this I/O stream 214 }; 215 216 217 class DeviceDescriptor: public AudioPort 218 { 219 public: 220 DeviceDescriptor(audio_devices_t type, String8 address, 221 audio_channel_mask_t channelMask) : 222 AudioPort(AUDIO_PORT_TYPE_DEVICE, 223 audio_is_output_device(type) ? AUDIO_PORT_ROLE_SINK : 224 AUDIO_PORT_ROLE_SOURCE, 225 NULL), 226 mDeviceType(type), mAddress(address), 227 mChannelMask(channelMask), mId(0) {} 228 229 DeviceDescriptor(audio_devices_t type) : 230 AudioPort(AUDIO_PORT_TYPE_DEVICE, 231 audio_is_output_device(type) ? AUDIO_PORT_ROLE_SINK : 232 AUDIO_PORT_ROLE_SOURCE, 233 NULL), 234 mDeviceType(type), mAddress(""), 235 mChannelMask(0), mId(0) {} 236 virtual ~DeviceDescriptor() {} 237 238 bool equals(const sp<DeviceDescriptor>& other) const; 239 void toAudioPortConfig(struct audio_port_config *config) const; 240 virtual void toAudioPort(struct audio_port *port) const; 241 242 status_t dump(int fd, int spaces) const; 243 static void dumpHeader(int fd, int spaces); 244 245 audio_devices_t mDeviceType; 246 String8 mAddress; 247 audio_channel_mask_t mChannelMask; 248 audio_port_handle_t mId; 249 }; 250 251 class DeviceVector : public SortedVector< sp<DeviceDescriptor> > 252 { 253 public: 254 DeviceVector() : SortedVector(), mDeviceTypes(AUDIO_DEVICE_NONE) {} 255 256 ssize_t add(const sp<DeviceDescriptor>& item); 257 ssize_t remove(const sp<DeviceDescriptor>& item); 258 ssize_t indexOf(const sp<DeviceDescriptor>& item) const; 259 260 audio_devices_t types() const { return mDeviceTypes; } 261 262 void loadDevicesFromType(audio_devices_t types); 263 sp<DeviceDescriptor> getDevice(audio_devices_t type, String8 address) const; 264 DeviceVector getDevicesFromType(audio_devices_t types) const; 265 266 private: 267 void refreshTypes(); 268 audio_devices_t mDeviceTypes; 269 }; 270 271 // the IOProfile class describes the capabilities of an output or input stream. 272 // It is currently assumed that all combination of listed parameters are supported. 273 // It is used by the policy manager to determine if an output or input is suitable for 274 // a given use case, open/close it accordingly and connect/disconnect audio tracks 275 // to/from it. 276 class IOProfile : public AudioPort 277 { 278 public: 279 IOProfile(audio_port_role_t role, HwModule *module); 280 virtual ~IOProfile(); 281 282 bool isCompatibleProfile(audio_devices_t device, 283 uint32_t samplingRate, 284 audio_format_t format, 285 audio_channel_mask_t channelMask, 286 audio_output_flags_t flags) const; 287 288 void dump(int fd); 289 void log(); 290 291 DeviceVector mSupportedDevices; // supported devices 292 // (devices this output can be routed to) 293 audio_output_flags_t mFlags; // attribute flags (e.g primary output, 294 // direct output...). For outputs only. 295 }; 296 297 // default volume curve 298 static const VolumeCurvePoint sDefaultVolumeCurve[AudioPolicyManager::VOLCNT]; 299 // default volume curve for media strategy 300 static const VolumeCurvePoint sDefaultMediaVolumeCurve[AudioPolicyManager::VOLCNT]; 301 // volume curve for media strategy on speakers 302 static const VolumeCurvePoint sSpeakerMediaVolumeCurve[AudioPolicyManager::VOLCNT]; 303 // volume curve for sonification strategy on speakers 304 static const VolumeCurvePoint sSpeakerSonificationVolumeCurve[AudioPolicyManager::VOLCNT]; 305 static const VolumeCurvePoint sSpeakerSonificationVolumeCurveDrc[AudioPolicyManager::VOLCNT]; 306 static const VolumeCurvePoint sDefaultSystemVolumeCurve[AudioPolicyManager::VOLCNT]; 307 static const VolumeCurvePoint sDefaultSystemVolumeCurveDrc[AudioPolicyManager::VOLCNT]; 308 static const VolumeCurvePoint sHeadsetSystemVolumeCurve[AudioPolicyManager::VOLCNT]; 309 static const VolumeCurvePoint sDefaultVoiceVolumeCurve[AudioPolicyManager::VOLCNT]; 310 static const VolumeCurvePoint sSpeakerVoiceVolumeCurve[AudioPolicyManager::VOLCNT]; 311 // default volume curves per stream and device category. See initializeVolumeCurves() 312 static const VolumeCurvePoint *sVolumeProfiles[AUDIO_STREAM_CNT][DEVICE_CATEGORY_CNT]; 313 314 // descriptor for audio outputs. Used to maintain current configuration of each opened audio output 315 // and keep track of the usage of this output by each audio stream type. 316 class AudioOutputDescriptor 317 { 318 public: 319 AudioOutputDescriptor(const sp<IOProfile>& profile); 320 321 status_t dump(int fd); 322 323 audio_devices_t device() const; 324 void changeRefCount(audio_stream_type_t stream, int delta); 325 326 bool isDuplicated() const { return (mOutput1 != NULL && mOutput2 != NULL); } 327 audio_devices_t supportedDevices(); 328 uint32_t latency(); 329 bool sharesHwModuleWith(const AudioOutputDescriptor *outputDesc); 330 bool isActive(uint32_t inPastMs = 0) const; 331 bool isStreamActive(audio_stream_type_t stream, 332 uint32_t inPastMs = 0, 333 nsecs_t sysTime = 0) const; 334 bool isStrategyActive(routing_strategy strategy, 335 uint32_t inPastMs = 0, 336 nsecs_t sysTime = 0) const; 337 338 void toAudioPortConfig(struct audio_port_config *config) const; 339 void toAudioPort(struct audio_port *port) const; 340 341 audio_port_handle_t mId; 342 audio_io_handle_t mIoHandle; // output handle 343 uint32_t mSamplingRate; // 344 audio_format_t mFormat; // 345 audio_channel_mask_t mChannelMask; // output configuration 346 uint32_t mLatency; // 347 audio_output_flags_t mFlags; // 348 audio_devices_t mDevice; // current device this output is routed to 349 audio_patch_handle_t mPatchHandle; 350 uint32_t mRefCount[AUDIO_STREAM_CNT]; // number of streams of each type using this output 351 nsecs_t mStopTime[AUDIO_STREAM_CNT]; 352 AudioOutputDescriptor *mOutput1; // used by duplicated outputs: first output 353 AudioOutputDescriptor *mOutput2; // used by duplicated outputs: second output 354 float mCurVolume[AUDIO_STREAM_CNT]; // current stream volume 355 int mMuteCount[AUDIO_STREAM_CNT]; // mute request counter 356 const sp<IOProfile> mProfile; // I/O profile this output derives from 357 bool mStrategyMutedByDevice[NUM_STRATEGIES]; // strategies muted because of incompatible 358 // device selection. See checkDeviceMuteStrategies() 359 uint32_t mDirectOpenCount; // number of clients using this output (direct outputs only) 360 }; 361 362 // descriptor for audio inputs. Used to maintain current configuration of each opened audio input 363 // and keep track of the usage of this input. 364 class AudioInputDescriptor 365 { 366 public: 367 AudioInputDescriptor(const sp<IOProfile>& profile); 368 369 status_t dump(int fd); 370 371 audio_port_handle_t mId; 372 audio_io_handle_t mIoHandle; // input handle 373 uint32_t mSamplingRate; // 374 audio_format_t mFormat; // input configuration 375 audio_channel_mask_t mChannelMask; // 376 audio_devices_t mDevice; // current device this input is routed to 377 audio_patch_handle_t mPatchHandle; 378 uint32_t mRefCount; // number of AudioRecord clients using this output 379 audio_source_t mInputSource; // input source selected by application (mediarecorder.h) 380 const sp<IOProfile> mProfile; // I/O profile this output derives from 381 382 void toAudioPortConfig(struct audio_port_config *config) const; 383 void toAudioPort(struct audio_port *port) const; 384 }; 385 386 // stream descriptor used for volume control 387 class StreamDescriptor 388 { 389 public: 390 StreamDescriptor(); 391 392 int getVolumeIndex(audio_devices_t device); 393 void dump(int fd); 394 395 int mIndexMin; // min volume index 396 int mIndexMax; // max volume index 397 KeyedVector<audio_devices_t, int> mIndexCur; // current volume index per device 398 bool mCanBeMuted; // true is the stream can be muted 399 400 const VolumeCurvePoint *mVolumeCurve[DEVICE_CATEGORY_CNT]; 401 }; 402 403 // stream descriptor used for volume control 404 class EffectDescriptor 405 { 406 public: 407 408 status_t dump(int fd); 409 410 int mIo; // io the effect is attached to 411 routing_strategy mStrategy; // routing strategy the effect is associated to 412 int mSession; // audio session the effect is on 413 effect_descriptor_t mDesc; // effect descriptor 414 bool mEnabled; // enabled state: CPU load being used or not 415 }; 416 417 void addOutput(audio_io_handle_t output, AudioOutputDescriptor *outputDesc); 418 void addInput(audio_io_handle_t input, AudioInputDescriptor *inputDesc); 419 420 // return the strategy corresponding to a given stream type 421 static routing_strategy getStrategy(audio_stream_type_t stream); 422 423 // return appropriate device for streams handled by the specified strategy according to current 424 // phone state, connected devices... 425 // if fromCache is true, the device is returned from mDeviceForStrategy[], 426 // otherwise it is determine by current state 427 // (device connected,phone state, force use, a2dp output...) 428 // This allows to: 429 // 1 speed up process when the state is stable (when starting or stopping an output) 430 // 2 access to either current device selection (fromCache == true) or 431 // "future" device selection (fromCache == false) when called from a context 432 // where conditions are changing (setDeviceConnectionState(), setPhoneState()...) AND 433 // before updateDevicesAndOutputs() is called. 434 virtual audio_devices_t getDeviceForStrategy(routing_strategy strategy, 435 bool fromCache); 436 437 // change the route of the specified output. Returns the number of ms we have slept to 438 // allow new routing to take effect in certain cases. 439 uint32_t setOutputDevice(audio_io_handle_t output, 440 audio_devices_t device, 441 bool force = false, 442 int delayMs = 0); 443 status_t resetOutputDevice(audio_io_handle_t output, 444 int delayMs = 0); 445 status_t setInputDevice(audio_io_handle_t input, 446 audio_devices_t device, 447 bool force = false); 448 status_t resetInputDevice(audio_io_handle_t input); 449 450 // select input device corresponding to requested audio source 451 virtual audio_devices_t getDeviceForInputSource(audio_source_t inputSource); 452 453 // return io handle of active input or 0 if no input is active 454 // Only considers inputs from physical devices (e.g. main mic, headset mic) when 455 // ignoreVirtualInputs is true. 456 audio_io_handle_t getActiveInput(bool ignoreVirtualInputs = true); 457 458 // initialize volume curves for each strategy and device category 459 void initializeVolumeCurves(); 460 461 // compute the actual volume for a given stream according to the requested index and a particular 462 // device 463 virtual float computeVolume(audio_stream_type_t stream, int index, 464 audio_io_handle_t output, audio_devices_t device); 465 466 // check that volume change is permitted, compute and send new volume to audio hardware 467 status_t checkAndSetVolume(audio_stream_type_t stream, int index, audio_io_handle_t output, 468 audio_devices_t device, int delayMs = 0, bool force = false); 469 470 // apply all stream volumes to the specified output and device 471 void applyStreamVolumes(audio_io_handle_t output, audio_devices_t device, int delayMs = 0, bool force = false); 472 473 // Mute or unmute all streams handled by the specified strategy on the specified output 474 void setStrategyMute(routing_strategy strategy, 475 bool on, 476 audio_io_handle_t output, 477 int delayMs = 0, 478 audio_devices_t device = (audio_devices_t)0); 479 480 // Mute or unmute the stream on the specified output 481 void setStreamMute(audio_stream_type_t stream, 482 bool on, 483 audio_io_handle_t output, 484 int delayMs = 0, 485 audio_devices_t device = (audio_devices_t)0); 486 487 // handle special cases for sonification strategy while in call: mute streams or replace by 488 // a special tone in the device used for communication 489 void handleIncallSonification(audio_stream_type_t stream, bool starting, bool stateChange); 490 491 // true if device is in a telephony or VoIP call 492 virtual bool isInCall(); 493 494 // true if given state represents a device in a telephony or VoIP call 495 virtual bool isStateInCall(int state); 496 497 // when a device is connected, checks if an open output can be routed 498 // to this device. If none is open, tries to open one of the available outputs. 499 // Returns an output suitable to this device or 0. 500 // when a device is disconnected, checks if an output is not used any more and 501 // returns its handle if any. 502 // transfers the audio tracks and effects from one output thread to another accordingly. 503 status_t checkOutputsForDevice(audio_devices_t device, 504 audio_policy_dev_state_t state, 505 SortedVector<audio_io_handle_t>& outputs, 506 const String8 address); 507 508 status_t checkInputsForDevice(audio_devices_t device, 509 audio_policy_dev_state_t state, 510 SortedVector<audio_io_handle_t>& inputs, 511 const String8 address); 512 513 // close an output and its companion duplicating output. 514 void closeOutput(audio_io_handle_t output); 515 516 // checks and if necessary changes outputs used for all strategies. 517 // must be called every time a condition that affects the output choice for a given strategy 518 // changes: connected device, phone state, force use... 519 // Must be called before updateDevicesAndOutputs() 520 void checkOutputForStrategy(routing_strategy strategy); 521 522 // Same as checkOutputForStrategy() but for a all strategies in order of priority 523 void checkOutputForAllStrategies(); 524 525 // manages A2DP output suspend/restore according to phone state and BT SCO usage 526 void checkA2dpSuspend(); 527 528 // returns the A2DP output handle if it is open or 0 otherwise 529 audio_io_handle_t getA2dpOutput(); 530 531 // selects the most appropriate device on output for current state 532 // must be called every time a condition that affects the device choice for a given output is 533 // changed: connected device, phone state, force use, output start, output stop.. 534 // see getDeviceForStrategy() for the use of fromCache parameter 535 audio_devices_t getNewOutputDevice(audio_io_handle_t output, bool fromCache); 536 537 // updates cache of device used by all strategies (mDeviceForStrategy[]) 538 // must be called every time a condition that affects the device choice for a given strategy is 539 // changed: connected device, phone state, force use... 540 // cached values are used by getDeviceForStrategy() if parameter fromCache is true. 541 // Must be called after checkOutputForAllStrategies() 542 void updateDevicesAndOutputs(); 543 544 // selects the most appropriate device on input for current state 545 audio_devices_t getNewInputDevice(audio_io_handle_t input); 546 547 virtual uint32_t getMaxEffectsCpuLoad(); 548 virtual uint32_t getMaxEffectsMemory(); 549#ifdef AUDIO_POLICY_TEST 550 virtual bool threadLoop(); 551 void exit(); 552 int testOutputIndex(audio_io_handle_t output); 553#endif //AUDIO_POLICY_TEST 554 555 status_t setEffectEnabled(EffectDescriptor *pDesc, bool enabled); 556 557 // returns the category the device belongs to with regard to volume curve management 558 static device_category getDeviceCategory(audio_devices_t device); 559 560 // extract one device relevant for volume control from multiple device selection 561 static audio_devices_t getDeviceForVolume(audio_devices_t device); 562 563 SortedVector<audio_io_handle_t> getOutputsForDevice(audio_devices_t device, 564 DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> openOutputs); 565 bool vectorsEqual(SortedVector<audio_io_handle_t>& outputs1, 566 SortedVector<audio_io_handle_t>& outputs2); 567 568 // mute/unmute strategies using an incompatible device combination 569 // if muting, wait for the audio in pcm buffer to be drained before proceeding 570 // if unmuting, unmute only after the specified delay 571 // Returns the number of ms waited 572 uint32_t checkDeviceMuteStrategies(AudioOutputDescriptor *outputDesc, 573 audio_devices_t prevDevice, 574 uint32_t delayMs); 575 576 audio_io_handle_t selectOutput(const SortedVector<audio_io_handle_t>& outputs, 577 audio_output_flags_t flags); 578 sp<IOProfile> getInputProfile(audio_devices_t device, 579 uint32_t samplingRate, 580 audio_format_t format, 581 audio_channel_mask_t channelMask); 582 sp<IOProfile> getProfileForDirectOutput(audio_devices_t device, 583 uint32_t samplingRate, 584 audio_format_t format, 585 audio_channel_mask_t channelMask, 586 audio_output_flags_t flags); 587 588 audio_io_handle_t selectOutputForEffects(const SortedVector<audio_io_handle_t>& outputs); 589 590 bool isNonOffloadableEffectEnabled(); 591 592 // 593 // Audio policy configuration file parsing (audio_policy.conf) 594 // 595 static uint32_t stringToEnum(const struct StringToEnum *table, 596 size_t size, 597 const char *name); 598 static const char *enumToString(const struct StringToEnum *table, 599 size_t size, 600 uint32_t value); 601 static bool stringToBool(const char *value); 602 static audio_output_flags_t parseFlagNames(char *name); 603 static audio_devices_t parseDeviceNames(char *name); 604 status_t loadOutput(cnode *root, HwModule *module); 605 status_t loadInput(cnode *root, HwModule *module); 606 void loadHwModule(cnode *root); 607 void loadHwModules(cnode *root); 608 void loadGlobalConfig(cnode *root); 609 status_t loadAudioPolicyConfig(const char *path); 610 void defaultAudioPolicyConfig(void); 611 612 613 AudioPolicyClientInterface *mpClientInterface; // audio policy client interface 614 audio_io_handle_t mPrimaryOutput; // primary output handle 615 // list of descriptors for outputs currently opened 616 DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> mOutputs; 617 // copy of mOutputs before setDeviceConnectionState() opens new outputs 618 // reset to mOutputs when updateDevicesAndOutputs() is called. 619 DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> mPreviousOutputs; 620 DefaultKeyedVector<audio_io_handle_t, AudioInputDescriptor *> mInputs; // list of input descriptors 621 DeviceVector mAvailableOutputDevices; // bit field of all available output devices 622 DeviceVector mAvailableInputDevices; // bit field of all available input devices 623 // without AUDIO_DEVICE_BIT_IN to allow direct bit 624 // field comparisons 625 int mPhoneState; // current phone state 626 audio_policy_forced_cfg_t mForceUse[AUDIO_POLICY_FORCE_USE_CNT]; // current forced use configuration 627 628 StreamDescriptor mStreams[AUDIO_STREAM_CNT]; // stream descriptors for volume control 629 bool mLimitRingtoneVolume; // limit ringtone volume to music volume if headset connected 630 audio_devices_t mDeviceForStrategy[NUM_STRATEGIES]; 631 float mLastVoiceVolume; // last voice volume value sent to audio HAL 632 633 // Maximum CPU load allocated to audio effects in 0.1 MIPS (ARMv5TE, 0 WS memory) units 634 static const uint32_t MAX_EFFECTS_CPU_LOAD = 1000; 635 // Maximum memory allocated to audio effects in KB 636 static const uint32_t MAX_EFFECTS_MEMORY = 512; 637 uint32_t mTotalEffectsCpuLoad; // current CPU load used by effects 638 uint32_t mTotalEffectsMemory; // current memory used by effects 639 KeyedVector<int, EffectDescriptor *> mEffects; // list of registered audio effects 640 bool mA2dpSuspended; // true if A2DP output is suspended 641 sp<DeviceDescriptor> mDefaultOutputDevice; // output device selected by default at boot time 642 bool mSpeakerDrcEnabled;// true on devices that use DRC on the DEVICE_CATEGORY_SPEAKER path 643 // to boost soft sounds, used to adjust volume curves accordingly 644 645 Vector <HwModule *> mHwModules; 646 volatile int32_t mNextUniqueId; 647 648#ifdef AUDIO_POLICY_TEST 649 Mutex mLock; 650 Condition mWaitWorkCV; 651 652 int mCurOutput; 653 bool mDirectOutput; 654 audio_io_handle_t mTestOutputs[NUM_TEST_OUTPUTS]; 655 int mTestInput; 656 uint32_t mTestDevice; 657 uint32_t mTestSamplingRate; 658 uint32_t mTestFormat; 659 uint32_t mTestChannels; 660 uint32_t mTestLatencyMs; 661#endif //AUDIO_POLICY_TEST 662 663private: 664 static float volIndexToAmpl(audio_devices_t device, const StreamDescriptor& streamDesc, 665 int indexInUi); 666 // updates device caching and output for streams that can influence the 667 // routing of notifications 668 void handleNotificationRoutingForStream(audio_stream_type_t stream); 669 static bool isVirtualInputDevice(audio_devices_t device); 670 uint32_t nextUniqueId(); 671 // converts device address to string sent to audio HAL via setParameters 672 static String8 addressToParameter(audio_devices_t device, const String8 address); 673}; 674 675}; 676