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#pragma once 18 19#include <stdint.h> 20#include <sys/types.h> 21#include <cutils/config_utils.h> 22#include <cutils/misc.h> 23#include <utils/Timers.h> 24#include <utils/Errors.h> 25#include <utils/KeyedVector.h> 26#include <utils/SortedVector.h> 27#include <media/AudioParameter.h> 28#include <media/AudioPolicy.h> 29#include "AudioPolicyInterface.h" 30 31#include <AudioPolicyManagerInterface.h> 32#include <AudioPolicyManagerObserver.h> 33#include <AudioGain.h> 34#include <AudioPort.h> 35#include <AudioPatch.h> 36#include <DeviceDescriptor.h> 37#include <IOProfile.h> 38#include <HwModule.h> 39#include <AudioInputDescriptor.h> 40#include <AudioOutputDescriptor.h> 41#include <AudioPolicyMix.h> 42#include <EffectDescriptor.h> 43#include <SoundTriggerSession.h> 44#include <SessionRoute.h> 45#include <VolumeCurve.h> 46 47namespace android { 48 49// ---------------------------------------------------------------------------- 50 51// Attenuation applied to STRATEGY_SONIFICATION streams when a headset is connected: 6dB 52#define SONIFICATION_HEADSET_VOLUME_FACTOR_DB (-6) 53// Min volume for STRATEGY_SONIFICATION streams when limited by music volume: -36dB 54#define SONIFICATION_HEADSET_VOLUME_MIN_DB (-36) 55// Max volume difference on A2DP between playing media and STRATEGY_SONIFICATION streams: 12dB 56#define SONIFICATION_A2DP_MAX_MEDIA_DIFF_DB (12) 57 58// Time in milliseconds during which we consider that music is still active after a music 59// track was stopped - see computeVolume() 60#define SONIFICATION_HEADSET_MUSIC_DELAY 5000 61 62// Time in milliseconds during witch some streams are muted while the audio path 63// is switched 64#define MUTE_TIME_MS 2000 65 66#define NUM_TEST_OUTPUTS 5 67 68#define NUM_VOL_CURVE_KNEES 2 69 70// Default minimum length allowed for offloading a compressed track 71// Can be overridden by the audio.offload.min.duration.secs property 72#define OFFLOAD_DEFAULT_MIN_DURATION_SECS 60 73 74// ---------------------------------------------------------------------------- 75// AudioPolicyManager implements audio policy manager behavior common to all platforms. 76// ---------------------------------------------------------------------------- 77 78class AudioPolicyManager : public AudioPolicyInterface, public AudioPolicyManagerObserver 79 80#ifdef AUDIO_POLICY_TEST 81 , public Thread 82#endif //AUDIO_POLICY_TEST 83{ 84 85public: 86 explicit AudioPolicyManager(AudioPolicyClientInterface *clientInterface); 87 virtual ~AudioPolicyManager(); 88 89 // AudioPolicyInterface 90 virtual status_t setDeviceConnectionState(audio_devices_t device, 91 audio_policy_dev_state_t state, 92 const char *device_address, 93 const char *device_name); 94 virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device, 95 const char *device_address); 96 virtual status_t handleDeviceConfigChange(audio_devices_t device, 97 const char *device_address, 98 const char *device_name); 99 virtual void setPhoneState(audio_mode_t state); 100 virtual void setForceUse(audio_policy_force_use_t usage, 101 audio_policy_forced_cfg_t config); 102 virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage); 103 104 virtual void setSystemProperty(const char* property, const char* value); 105 virtual status_t initCheck(); 106 virtual audio_io_handle_t getOutput(audio_stream_type_t stream, 107 uint32_t samplingRate, 108 audio_format_t format, 109 audio_channel_mask_t channelMask, 110 audio_output_flags_t flags, 111 const audio_offload_info_t *offloadInfo); 112 virtual status_t getOutputForAttr(const audio_attributes_t *attr, 113 audio_io_handle_t *output, 114 audio_session_t session, 115 audio_stream_type_t *stream, 116 uid_t uid, 117 const audio_config_t *config, 118 audio_output_flags_t flags, 119 audio_port_handle_t selectedDeviceId, 120 audio_port_handle_t *portId); 121 virtual status_t startOutput(audio_io_handle_t output, 122 audio_stream_type_t stream, 123 audio_session_t session); 124 virtual status_t stopOutput(audio_io_handle_t output, 125 audio_stream_type_t stream, 126 audio_session_t session); 127 virtual void releaseOutput(audio_io_handle_t output, 128 audio_stream_type_t stream, 129 audio_session_t session); 130 virtual status_t getInputForAttr(const audio_attributes_t *attr, 131 audio_io_handle_t *input, 132 audio_session_t session, 133 uid_t uid, 134 const audio_config_base_t *config, 135 audio_input_flags_t flags, 136 audio_port_handle_t selectedDeviceId, 137 input_type_t *inputType, 138 audio_port_handle_t *portId); 139 140 // indicates to the audio policy manager that the input starts being used. 141 virtual status_t startInput(audio_io_handle_t input, 142 audio_session_t session, 143 concurrency_type__mask_t *concurrency); 144 145 // indicates to the audio policy manager that the input stops being used. 146 virtual status_t stopInput(audio_io_handle_t input, 147 audio_session_t session); 148 virtual void releaseInput(audio_io_handle_t input, 149 audio_session_t session); 150 virtual void closeAllInputs(); 151 virtual void initStreamVolume(audio_stream_type_t stream, 152 int indexMin, 153 int indexMax); 154 virtual status_t setStreamVolumeIndex(audio_stream_type_t stream, 155 int index, 156 audio_devices_t device); 157 virtual status_t getStreamVolumeIndex(audio_stream_type_t stream, 158 int *index, 159 audio_devices_t device); 160 161 // return the strategy corresponding to a given stream type 162 virtual uint32_t getStrategyForStream(audio_stream_type_t stream); 163 // return the strategy corresponding to the given audio attributes 164 virtual uint32_t getStrategyForAttr(const audio_attributes_t *attr); 165 166 // return the enabled output devices for the given stream type 167 virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream); 168 169 virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc = NULL); 170 virtual status_t registerEffect(const effect_descriptor_t *desc, 171 audio_io_handle_t io, 172 uint32_t strategy, 173 int session, 174 int id); 175 virtual status_t unregisterEffect(int id) 176 { 177 return mEffects.unregisterEffect(id); 178 } 179 virtual status_t setEffectEnabled(int id, bool enabled) 180 { 181 return mEffects.setEffectEnabled(id, enabled); 182 } 183 184 virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const; 185 // return whether a stream is playing remotely, override to change the definition of 186 // local/remote playback, used for instance by notification manager to not make 187 // media players lose audio focus when not playing locally 188 // For the base implementation, "remotely" means playing during screen mirroring which 189 // uses an output for playback with a non-empty, non "0" address. 190 virtual bool isStreamActiveRemotely(audio_stream_type_t stream, 191 uint32_t inPastMs = 0) const; 192 193 virtual bool isSourceActive(audio_source_t source) const; 194 195 virtual status_t dump(int fd); 196 197 virtual bool isOffloadSupported(const audio_offload_info_t& offloadInfo); 198 199 virtual status_t listAudioPorts(audio_port_role_t role, 200 audio_port_type_t type, 201 unsigned int *num_ports, 202 struct audio_port *ports, 203 unsigned int *generation); 204 virtual status_t getAudioPort(struct audio_port *port); 205 virtual status_t createAudioPatch(const struct audio_patch *patch, 206 audio_patch_handle_t *handle, 207 uid_t uid); 208 virtual status_t releaseAudioPatch(audio_patch_handle_t handle, 209 uid_t uid); 210 virtual status_t listAudioPatches(unsigned int *num_patches, 211 struct audio_patch *patches, 212 unsigned int *generation); 213 virtual status_t setAudioPortConfig(const struct audio_port_config *config); 214 215 virtual void releaseResourcesForUid(uid_t uid); 216 217 virtual status_t acquireSoundTriggerSession(audio_session_t *session, 218 audio_io_handle_t *ioHandle, 219 audio_devices_t *device); 220 221 virtual status_t releaseSoundTriggerSession(audio_session_t session) 222 { 223 return mSoundTriggerSessions.releaseSession(session); 224 } 225 226 virtual status_t registerPolicyMixes(const Vector<AudioMix>& mixes); 227 virtual status_t unregisterPolicyMixes(Vector<AudioMix> mixes); 228 229 virtual status_t startAudioSource(const struct audio_port_config *source, 230 const audio_attributes_t *attributes, 231 audio_patch_handle_t *handle, 232 uid_t uid); 233 virtual status_t stopAudioSource(audio_patch_handle_t handle); 234 235 virtual status_t setMasterMono(bool mono); 236 virtual status_t getMasterMono(bool *mono); 237 238 // return the strategy corresponding to a given stream type 239 routing_strategy getStrategy(audio_stream_type_t stream) const; 240 241protected: 242 // From AudioPolicyManagerObserver 243 virtual const AudioPatchCollection &getAudioPatches() const 244 { 245 return mAudioPatches; 246 } 247 virtual const SoundTriggerSessionCollection &getSoundTriggerSessionCollection() const 248 { 249 return mSoundTriggerSessions; 250 } 251 virtual const AudioPolicyMixCollection &getAudioPolicyMixCollection() const 252 { 253 return mPolicyMixes; 254 } 255 virtual const SwAudioOutputCollection &getOutputs() const 256 { 257 return mOutputs; 258 } 259 virtual const AudioInputCollection &getInputs() const 260 { 261 return mInputs; 262 } 263 virtual const DeviceVector &getAvailableOutputDevices() const 264 { 265 return mAvailableOutputDevices; 266 } 267 virtual const DeviceVector &getAvailableInputDevices() const 268 { 269 return mAvailableInputDevices; 270 } 271 virtual IVolumeCurvesCollection &getVolumeCurves() { return *mVolumeCurves; } 272 virtual const sp<DeviceDescriptor> &getDefaultOutputDevice() const 273 { 274 return mDefaultOutputDevice; 275 } 276protected: 277 void addOutput(audio_io_handle_t output, const sp<SwAudioOutputDescriptor>& outputDesc); 278 void removeOutput(audio_io_handle_t output); 279 void addInput(audio_io_handle_t input, const sp<AudioInputDescriptor>& inputDesc); 280 281 // return appropriate device for streams handled by the specified strategy according to current 282 // phone state, connected devices... 283 // if fromCache is true, the device is returned from mDeviceForStrategy[], 284 // otherwise it is determine by current state 285 // (device connected,phone state, force use, a2dp output...) 286 // This allows to: 287 // 1 speed up process when the state is stable (when starting or stopping an output) 288 // 2 access to either current device selection (fromCache == true) or 289 // "future" device selection (fromCache == false) when called from a context 290 // where conditions are changing (setDeviceConnectionState(), setPhoneState()...) AND 291 // before updateDevicesAndOutputs() is called. 292 virtual audio_devices_t getDeviceForStrategy(routing_strategy strategy, 293 bool fromCache); 294 295 bool isStrategyActive(const sp<AudioOutputDescriptor>& outputDesc, routing_strategy strategy, 296 uint32_t inPastMs = 0, nsecs_t sysTime = 0) const; 297 298 // change the route of the specified output. Returns the number of ms we have slept to 299 // allow new routing to take effect in certain cases. 300 virtual uint32_t setOutputDevice(const sp<AudioOutputDescriptor>& outputDesc, 301 audio_devices_t device, 302 bool force = false, 303 int delayMs = 0, 304 audio_patch_handle_t *patchHandle = NULL, 305 const char* address = NULL); 306 status_t resetOutputDevice(const sp<AudioOutputDescriptor>& outputDesc, 307 int delayMs = 0, 308 audio_patch_handle_t *patchHandle = NULL); 309 status_t setInputDevice(audio_io_handle_t input, 310 audio_devices_t device, 311 bool force = false, 312 audio_patch_handle_t *patchHandle = NULL); 313 status_t resetInputDevice(audio_io_handle_t input, 314 audio_patch_handle_t *patchHandle = NULL); 315 316 // select input device corresponding to requested audio source 317 virtual audio_devices_t getDeviceForInputSource(audio_source_t inputSource); 318 319 // compute the actual volume for a given stream according to the requested index and a particular 320 // device 321 virtual float computeVolume(audio_stream_type_t stream, 322 int index, 323 audio_devices_t device); 324 325 // check that volume change is permitted, compute and send new volume to audio hardware 326 virtual status_t checkAndSetVolume(audio_stream_type_t stream, int index, 327 const sp<AudioOutputDescriptor>& outputDesc, 328 audio_devices_t device, 329 int delayMs = 0, bool force = false); 330 331 // apply all stream volumes to the specified output and device 332 void applyStreamVolumes(const sp<AudioOutputDescriptor>& outputDesc, 333 audio_devices_t device, int delayMs = 0, bool force = false); 334 335 // Mute or unmute all streams handled by the specified strategy on the specified output 336 void setStrategyMute(routing_strategy strategy, 337 bool on, 338 const sp<AudioOutputDescriptor>& outputDesc, 339 int delayMs = 0, 340 audio_devices_t device = (audio_devices_t)0); 341 342 // Mute or unmute the stream on the specified output 343 void setStreamMute(audio_stream_type_t stream, 344 bool on, 345 const sp<AudioOutputDescriptor>& outputDesc, 346 int delayMs = 0, 347 audio_devices_t device = (audio_devices_t)0); 348 349 // handle special cases for sonification strategy while in call: mute streams or replace by 350 // a special tone in the device used for communication 351 void handleIncallSonification(audio_stream_type_t stream, bool starting, bool stateChange); 352 353 audio_mode_t getPhoneState(); 354 355 // true if device is in a telephony or VoIP call 356 virtual bool isInCall(); 357 // true if given state represents a device in a telephony or VoIP call 358 virtual bool isStateInCall(int state); 359 360 // when a device is connected, checks if an open output can be routed 361 // to this device. If none is open, tries to open one of the available outputs. 362 // Returns an output suitable to this device or 0. 363 // when a device is disconnected, checks if an output is not used any more and 364 // returns its handle if any. 365 // transfers the audio tracks and effects from one output thread to another accordingly. 366 status_t checkOutputsForDevice(const sp<DeviceDescriptor>& devDesc, 367 audio_policy_dev_state_t state, 368 SortedVector<audio_io_handle_t>& outputs, 369 const String8& address); 370 371 status_t checkInputsForDevice(const sp<DeviceDescriptor>& devDesc, 372 audio_policy_dev_state_t state, 373 SortedVector<audio_io_handle_t>& inputs, 374 const String8& address); 375 376 // close an output and its companion duplicating output. 377 void closeOutput(audio_io_handle_t output); 378 379 // close an input. 380 void closeInput(audio_io_handle_t input); 381 382 // checks and if necessary changes outputs used for all strategies. 383 // must be called every time a condition that affects the output choice for a given strategy 384 // changes: connected device, phone state, force use... 385 // Must be called before updateDevicesAndOutputs() 386 void checkOutputForStrategy(routing_strategy strategy); 387 388 // Same as checkOutputForStrategy() but for a all strategies in order of priority 389 void checkOutputForAllStrategies(); 390 391 // manages A2DP output suspend/restore according to phone state and BT SCO usage 392 void checkA2dpSuspend(); 393 394 // selects the most appropriate device on output for current state 395 // must be called every time a condition that affects the device choice for a given output is 396 // changed: connected device, phone state, force use, output start, output stop.. 397 // see getDeviceForStrategy() for the use of fromCache parameter 398 audio_devices_t getNewOutputDevice(const sp<AudioOutputDescriptor>& outputDesc, 399 bool fromCache); 400 401 // updates cache of device used by all strategies (mDeviceForStrategy[]) 402 // must be called every time a condition that affects the device choice for a given strategy is 403 // changed: connected device, phone state, force use... 404 // cached values are used by getDeviceForStrategy() if parameter fromCache is true. 405 // Must be called after checkOutputForAllStrategies() 406 void updateDevicesAndOutputs(); 407 408 // selects the most appropriate device on input for current state 409 audio_devices_t getNewInputDevice(const sp<AudioInputDescriptor>& inputDesc); 410 411 virtual uint32_t getMaxEffectsCpuLoad() 412 { 413 return mEffects.getMaxEffectsCpuLoad(); 414 } 415 416 virtual uint32_t getMaxEffectsMemory() 417 { 418 return mEffects.getMaxEffectsMemory(); 419 } 420#ifdef AUDIO_POLICY_TEST 421 virtual bool threadLoop(); 422 void exit(); 423 int testOutputIndex(audio_io_handle_t output); 424#endif //AUDIO_POLICY_TEST 425 426 SortedVector<audio_io_handle_t> getOutputsForDevice(audio_devices_t device, 427 const SwAudioOutputCollection& openOutputs); 428 bool vectorsEqual(SortedVector<audio_io_handle_t>& outputs1, 429 SortedVector<audio_io_handle_t>& outputs2); 430 431 // mute/unmute strategies using an incompatible device combination 432 // if muting, wait for the audio in pcm buffer to be drained before proceeding 433 // if unmuting, unmute only after the specified delay 434 // Returns the number of ms waited 435 virtual uint32_t checkDeviceMuteStrategies(const sp<AudioOutputDescriptor>& outputDesc, 436 audio_devices_t prevDevice, 437 uint32_t delayMs); 438 439 audio_io_handle_t selectOutput(const SortedVector<audio_io_handle_t>& outputs, 440 audio_output_flags_t flags, 441 audio_format_t format); 442 // samplingRate, format, channelMask are in/out and so may be modified 443 sp<IOProfile> getInputProfile(audio_devices_t device, 444 const String8& address, 445 uint32_t& samplingRate, 446 audio_format_t& format, 447 audio_channel_mask_t& channelMask, 448 audio_input_flags_t flags); 449 sp<IOProfile> getProfileForDirectOutput(audio_devices_t device, 450 uint32_t samplingRate, 451 audio_format_t format, 452 audio_channel_mask_t channelMask, 453 audio_output_flags_t flags); 454 455 audio_io_handle_t selectOutputForMusicEffects(); 456 457 virtual status_t addAudioPatch(audio_patch_handle_t handle, const sp<AudioPatch>& patch) 458 { 459 return mAudioPatches.addAudioPatch(handle, patch); 460 } 461 virtual status_t removeAudioPatch(audio_patch_handle_t handle) 462 { 463 return mAudioPatches.removeAudioPatch(handle); 464 } 465 466 audio_devices_t availablePrimaryOutputDevices() const 467 { 468 if (!hasPrimaryOutput()) { 469 return AUDIO_DEVICE_NONE; 470 } 471 return mPrimaryOutput->supportedDevices() & mAvailableOutputDevices.types(); 472 } 473 audio_devices_t availablePrimaryInputDevices() const 474 { 475 if (!hasPrimaryOutput()) { 476 return AUDIO_DEVICE_NONE; 477 } 478 return mAvailableInputDevices.getDevicesFromHwModule(mPrimaryOutput->getModuleHandle()); 479 } 480 481 uint32_t updateCallRouting(audio_devices_t rxDevice, uint32_t delayMs = 0); 482 483 // if argument "device" is different from AUDIO_DEVICE_NONE, startSource() will force 484 // the re-evaluation of the output device. 485 status_t startSource(const sp<AudioOutputDescriptor>& outputDesc, 486 audio_stream_type_t stream, 487 audio_devices_t device, 488 const char *address, 489 uint32_t *delayMs); 490 status_t stopSource(const sp<AudioOutputDescriptor>& outputDesc, 491 audio_stream_type_t stream, 492 bool forceDeviceUpdate); 493 494 void clearAudioPatches(uid_t uid); 495 void clearSessionRoutes(uid_t uid); 496 void checkStrategyRoute(routing_strategy strategy, audio_io_handle_t ouptutToSkip); 497 498 status_t hasPrimaryOutput() const { return mPrimaryOutput != 0; } 499 500 status_t connectAudioSource(const sp<AudioSourceDescriptor>& sourceDesc); 501 status_t disconnectAudioSource(const sp<AudioSourceDescriptor>& sourceDesc); 502 503 sp<AudioSourceDescriptor> getSourceForStrategyOnOutput(audio_io_handle_t output, 504 routing_strategy strategy); 505 506 void cleanUpForDevice(const sp<DeviceDescriptor>& deviceDesc); 507 508 void clearAudioSources(uid_t uid); 509 510 static bool isConcurrentSource(audio_source_t source); 511 512 bool isConcurentCaptureAllowed(const sp<AudioInputDescriptor>& inputDesc, 513 const sp<AudioSession>& audioSession); 514 515 static bool streamsMatchForvolume(audio_stream_type_t stream1, 516 audio_stream_type_t stream2); 517 518 uid_t mUidCached; 519 AudioPolicyClientInterface *mpClientInterface; // audio policy client interface 520 sp<SwAudioOutputDescriptor> mPrimaryOutput; // primary output descriptor 521 // list of descriptors for outputs currently opened 522 523 SwAudioOutputCollection mOutputs; 524 // copy of mOutputs before setDeviceConnectionState() opens new outputs 525 // reset to mOutputs when updateDevicesAndOutputs() is called. 526 SwAudioOutputCollection mPreviousOutputs; 527 AudioInputCollection mInputs; // list of input descriptors 528 529 DeviceVector mAvailableOutputDevices; // all available output devices 530 DeviceVector mAvailableInputDevices; // all available input devices 531 532 SessionRouteMap mOutputRoutes = SessionRouteMap(SessionRouteMap::MAPTYPE_OUTPUT); 533 SessionRouteMap mInputRoutes = SessionRouteMap(SessionRouteMap::MAPTYPE_INPUT); 534 535 IVolumeCurvesCollection *mVolumeCurves; // Volume Curves per use case and device category 536 537 bool mLimitRingtoneVolume; // limit ringtone volume to music volume if headset connected 538 audio_devices_t mDeviceForStrategy[NUM_STRATEGIES]; 539 float mLastVoiceVolume; // last voice volume value sent to audio HAL 540 541 EffectDescriptorCollection mEffects; // list of registered audio effects 542 bool mA2dpSuspended; // true if A2DP output is suspended 543 sp<DeviceDescriptor> mDefaultOutputDevice; // output device selected by default at boot time 544 HwModuleCollection mHwModules; 545 546 volatile int32_t mAudioPortGeneration; 547 548 AudioPatchCollection mAudioPatches; 549 550 SoundTriggerSessionCollection mSoundTriggerSessions; 551 552 sp<AudioPatch> mCallTxPatch; 553 sp<AudioPatch> mCallRxPatch; 554 555 HwAudioOutputCollection mHwOutputs; 556 AudioSourceCollection mAudioSources; 557 558 // for supporting "beacon" streams, i.e. streams that only play on speaker, and never 559 // when something other than STREAM_TTS (a.k.a. "Transmitted Through Speaker") is playing 560 enum { 561 STARTING_OUTPUT, 562 STARTING_BEACON, 563 STOPPING_OUTPUT, 564 STOPPING_BEACON 565 }; 566 uint32_t mBeaconMuteRefCount; // ref count for stream that would mute beacon 567 uint32_t mBeaconPlayingRefCount;// ref count for the playing beacon streams 568 bool mBeaconMuted; // has STREAM_TTS been muted 569 bool mTtsOutputAvailable; // true if a dedicated output for TTS stream is available 570 571 bool mMasterMono; // true if we wish to force all outputs to mono 572 AudioPolicyMixCollection mPolicyMixes; // list of registered mixes 573 audio_io_handle_t mMusicEffectOutput; // output selected for music effects 574 575 576#ifdef AUDIO_POLICY_TEST 577 Mutex mLock; 578 Condition mWaitWorkCV; 579 580 int mCurOutput; 581 bool mDirectOutput; 582 audio_io_handle_t mTestOutputs[NUM_TEST_OUTPUTS]; 583 int mTestInput; 584 uint32_t mTestDevice; 585 uint32_t mTestSamplingRate; 586 uint32_t mTestFormat; 587 uint32_t mTestChannels; 588 uint32_t mTestLatencyMs; 589#endif //AUDIO_POLICY_TEST 590 591 uint32_t nextAudioPortGeneration(); 592 593 // Audio Policy Engine Interface. 594 AudioPolicyManagerInterface *mEngine; 595private: 596 // Add or remove AC3 DTS encodings based on user preferences. 597 void filterSurroundFormats(FormatVector *formatsPtr); 598 void filterSurroundChannelMasks(ChannelsVector *channelMasksPtr); 599 600 // If any, resolve any "dynamic" fields of an Audio Profiles collection 601 void updateAudioProfiles(audio_devices_t device, audio_io_handle_t ioHandle, 602 AudioProfileVector &profiles); 603 604 // Notify the policy client of any change of device state with AUDIO_IO_HANDLE_NONE, 605 // so that the client interprets it as global to audio hardware interfaces. 606 // It can give a chance to HAL implementer to retrieve dynamic capabilities associated 607 // to this device for example. 608 // TODO avoid opening stream to retrieve capabilities of a profile. 609 void broadcastDeviceConnectionState(audio_devices_t device, 610 audio_policy_dev_state_t state, 611 const String8 &device_address); 612 613 // updates device caching and output for streams that can influence the 614 // routing of notifications 615 void handleNotificationRoutingForStream(audio_stream_type_t stream); 616 // find the outputs on a given output descriptor that have the given address. 617 // to be called on an AudioOutputDescriptor whose supported devices (as defined 618 // in mProfile->mSupportedDevices) matches the device whose address is to be matched. 619 // see deviceDistinguishesOnAddress(audio_devices_t) for whether the device type is one 620 // where addresses are used to distinguish between one connected device and another. 621 void findIoHandlesByAddress(const sp<SwAudioOutputDescriptor>& desc /*in*/, 622 const audio_devices_t device /*in*/, 623 const String8& address /*in*/, 624 SortedVector<audio_io_handle_t>& outputs /*out*/); 625 uint32_t curAudioPortGeneration() const { return mAudioPortGeneration; } 626 // internal method to return the output handle for the given device and format 627 audio_io_handle_t getOutputForDevice( 628 audio_devices_t device, 629 audio_session_t session, 630 audio_stream_type_t stream, 631 uint32_t samplingRate, 632 audio_format_t format, 633 audio_channel_mask_t channelMask, 634 audio_output_flags_t flags, 635 const audio_offload_info_t *offloadInfo); 636 // internal method to return the input handle for the given device and format 637 audio_io_handle_t getInputForDevice(audio_devices_t device, 638 String8 address, 639 audio_session_t session, 640 uid_t uid, 641 audio_source_t inputSource, 642 uint32_t samplingRate, 643 audio_format_t format, 644 audio_channel_mask_t channelMask, 645 audio_input_flags_t flags, 646 AudioMix *policyMix); 647 648 // internal function to derive a stream type value from audio attributes 649 audio_stream_type_t streamTypefromAttributesInt(const audio_attributes_t *attr); 650 // event is one of STARTING_OUTPUT, STARTING_BEACON, STOPPING_OUTPUT, STOPPING_BEACON 651 // returns 0 if no mute/unmute event happened, the largest latency of the device where 652 // the mute/unmute happened 653 uint32_t handleEventForBeacon(int event); 654 uint32_t setBeaconMute(bool mute); 655 bool isValidAttributes(const audio_attributes_t *paa); 656 657 // select input device corresponding to requested audio source and return associated policy 658 // mix if any. Calls getDeviceForInputSource(). 659 audio_devices_t getDeviceAndMixForInputSource(audio_source_t inputSource, 660 AudioMix **policyMix = NULL); 661 662 // Called by setDeviceConnectionState(). 663 status_t setDeviceConnectionStateInt(audio_devices_t device, 664 audio_policy_dev_state_t state, 665 const char *device_address, 666 const char *device_name); 667 void updateMono(audio_io_handle_t output) { 668 AudioParameter param; 669 param.addInt(String8(AudioParameter::keyMonoOutput), (int)mMasterMono); 670 mpClientInterface->setParameters(output, param.toString()); 671 } 672}; 673 674}; 675