blob: bfa3ef40d5ea8f0a6e6dfa2f79910af34a11f7ba [file] [log] [blame]
Mathias Agopian65ab4712010-07-14 17:59:35 -07001/*
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#ifndef ANDROID_AUDIOPOLICYSERVICE_H
18#define ANDROID_AUDIOPOLICYSERVICE_H
19
Eric Laurent7c7f10b2011-06-17 21:29:58 -070020#include <cutils/misc.h>
21#include <cutils/config_utils.h>
Mathias Agopiane762be92013-05-09 16:26:45 -070022#include <cutils/compiler.h>
Glenn Kastend1d8f232011-07-08 09:34:50 -070023#include <utils/String8.h>
Mathias Agopian65ab4712010-07-14 17:59:35 -070024#include <utils/Vector.h>
Eric Laurent7c7f10b2011-06-17 21:29:58 -070025#include <utils/SortedVector.h>
Glenn Kastend2dcb082011-02-03 16:55:26 -080026#include <binder/BinderService.h>
Svet Ganovf4ddfef2018-01-16 07:37:58 -080027#include <binder/IUidObserver.h>
Dima Zavin64760242011-05-11 14:15:23 -070028#include <system/audio.h>
Dima Zavin7394a4f2011-06-13 18:16:26 -070029#include <system/audio_policy.h>
Eric Laurent7c7f10b2011-06-17 21:29:58 -070030#include <media/IAudioPolicyService.h>
31#include <media/ToneGenerator.h>
32#include <media/AudioEffect.h>
Eric Laurentbaac1832014-12-01 17:52:59 -080033#include <media/AudioPolicy.h>
bryant_liuba2b4392014-06-11 16:49:30 +080034#include "AudioPolicyEffects.h"
Jean-Michel Trivi56ec4ff2015-01-23 16:45:18 -080035#include "managerdefault/AudioPolicyManager.h"
Dima Zavinfce7a472011-04-19 22:30:36 -070036
Svet Ganovf4ddfef2018-01-16 07:37:58 -080037#include <unordered_map>
38#include <unordered_set>
bryant_liuba2b4392014-06-11 16:49:30 +080039
Mathias Agopian65ab4712010-07-14 17:59:35 -070040namespace android {
41
Svet Ganovf4ddfef2018-01-16 07:37:58 -080042using namespace std;
43
Mathias Agopian65ab4712010-07-14 17:59:35 -070044// ----------------------------------------------------------------------------
45
Glenn Kastend2dcb082011-02-03 16:55:26 -080046class AudioPolicyService :
47 public BinderService<AudioPolicyService>,
48 public BnAudioPolicyService,
Eric Laurentde070132010-07-13 04:45:46 -070049 public IBinder::DeathRecipient
Mathias Agopian65ab4712010-07-14 17:59:35 -070050{
Glenn Kastend2dcb082011-02-03 16:55:26 -080051 friend class BinderService<AudioPolicyService>;
Mathias Agopian65ab4712010-07-14 17:59:35 -070052
53public:
Glenn Kastend2dcb082011-02-03 16:55:26 -080054 // for BinderService
Mathias Agopiane762be92013-05-09 16:26:45 -070055 static const char *getServiceName() ANDROID_API { return "media.audio_policy"; }
Mathias Agopian65ab4712010-07-14 17:59:35 -070056
57 virtual status_t dump(int fd, const Vector<String16>& args);
58
59 //
60 // BnAudioPolicyService (see AudioPolicyInterface for method descriptions)
61 //
62
Dima Zavinfce7a472011-04-19 22:30:36 -070063 virtual status_t setDeviceConnectionState(audio_devices_t device,
64 audio_policy_dev_state_t state,
Paul McLeane743a472015-01-28 11:07:31 -080065 const char *device_address,
66 const char *device_name);
Dima Zavinfce7a472011-04-19 22:30:36 -070067 virtual audio_policy_dev_state_t getDeviceConnectionState(
68 audio_devices_t device,
Eric Laurentde070132010-07-13 04:45:46 -070069 const char *device_address);
Pavlin Radoslavovf862bc62016-12-26 18:57:22 -080070 virtual status_t handleDeviceConfigChange(audio_devices_t device,
71 const char *device_address,
72 const char *device_name);
Glenn Kastenf78aee72012-01-04 11:00:47 -080073 virtual status_t setPhoneState(audio_mode_t state);
Dima Zavinfce7a472011-04-19 22:30:36 -070074 virtual status_t setForceUse(audio_policy_force_use_t usage, audio_policy_forced_cfg_t config);
75 virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage);
Eric Laurentf4e63452017-11-06 19:31:46 +000076 virtual audio_io_handle_t getOutput(audio_stream_type_t stream);
Eric Laurente83b55d2014-11-14 10:06:21 -080077 virtual status_t getOutputForAttr(const audio_attributes_t *attr,
78 audio_io_handle_t *output,
79 audio_session_t session,
80 audio_stream_type_t *stream,
Nadav Bar766fb022018-01-07 12:18:03 +020081 pid_t pid,
Eric Laurent8c7e6da2015-04-21 17:37:00 -070082 uid_t uid,
Eric Laurent20b9ef02016-12-05 11:03:16 -080083 const audio_config_t *config,
84 audio_output_flags_t flags,
Eric Laurent9ae8c592017-06-22 17:17:09 -070085 audio_port_handle_t *selectedDeviceId,
Eric Laurent20b9ef02016-12-05 11:03:16 -080086 audio_port_handle_t *portId);
Eric Laurentde070132010-07-13 04:45:46 -070087 virtual status_t startOutput(audio_io_handle_t output,
Dima Zavinfce7a472011-04-19 22:30:36 -070088 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -080089 audio_session_t session);
Eric Laurentde070132010-07-13 04:45:46 -070090 virtual status_t stopOutput(audio_io_handle_t output,
Dima Zavinfce7a472011-04-19 22:30:36 -070091 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -080092 audio_session_t session);
93 virtual void releaseOutput(audio_io_handle_t output,
94 audio_stream_type_t stream,
95 audio_session_t session);
Eric Laurentcaf7f482014-11-25 17:50:47 -080096 virtual status_t getInputForAttr(const audio_attributes_t *attr,
97 audio_io_handle_t *input,
98 audio_session_t session,
Eric Laurentb2379ba2016-05-23 17:42:12 -070099 pid_t pid,
Eric Laurent8c7e6da2015-04-21 17:37:00 -0700100 uid_t uid,
Eric Laurentfee19762018-01-29 18:44:13 -0800101 const String16& opPackageName,
Eric Laurent20b9ef02016-12-05 11:03:16 -0800102 const audio_config_base_t *config,
Paul McLean466dc8e2015-04-17 13:15:36 -0600103 audio_input_flags_t flags,
Eric Laurent9ae8c592017-06-22 17:17:09 -0700104 audio_port_handle_t *selectedDeviceId = NULL,
Eric Laurent20b9ef02016-12-05 11:03:16 -0800105 audio_port_handle_t *portId = NULL);
Eric Laurentfee19762018-01-29 18:44:13 -0800106 virtual status_t startInput(audio_port_handle_t portId,
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800107 bool *silenced);
Eric Laurentfee19762018-01-29 18:44:13 -0800108 virtual status_t stopInput(audio_port_handle_t portId);
109 virtual void releaseInput(audio_port_handle_t portId);
Dima Zavinfce7a472011-04-19 22:30:36 -0700110 virtual status_t initStreamVolume(audio_stream_type_t stream,
Mathias Agopian65ab4712010-07-14 17:59:35 -0700111 int indexMin,
112 int indexMax);
Eric Laurent83844cc2011-11-18 16:43:31 -0800113 virtual status_t setStreamVolumeIndex(audio_stream_type_t stream,
114 int index,
115 audio_devices_t device);
116 virtual status_t getStreamVolumeIndex(audio_stream_type_t stream,
117 int *index,
118 audio_devices_t device);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700119
Dima Zavinfce7a472011-04-19 22:30:36 -0700120 virtual uint32_t getStrategyForStream(audio_stream_type_t stream);
Eric Laurent63742522012-03-08 13:42:42 -0800121 virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream);
Eric Laurentde070132010-07-13 04:45:46 -0700122
Glenn Kasten58e5aa32012-06-20 14:08:14 -0700123 virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc);
124 virtual status_t registerEffect(const effect_descriptor_t *desc,
Eric Laurent7c7f10b2011-06-17 21:29:58 -0700125 audio_io_handle_t io,
Eric Laurentde070132010-07-13 04:45:46 -0700126 uint32_t strategy,
Glenn Kastend848eb42016-03-08 13:42:11 -0800127 audio_session_t session,
Eric Laurentde070132010-07-13 04:45:46 -0700128 int id);
129 virtual status_t unregisterEffect(int id);
Eric Laurentdb7c0792011-08-10 10:37:50 -0700130 virtual status_t setEffectEnabled(int id, bool enabled);
Glenn Kastenfff6d712012-01-12 16:38:12 -0800131 virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const;
Jean-Michel Trivi272ab542013-02-04 16:26:02 -0800132 virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) const;
Jean-Michel Trivid7086032012-10-10 12:11:16 -0700133 virtual bool isSourceActive(audio_source_t source) const;
Eric Laurentde070132010-07-13 04:45:46 -0700134
Glenn Kastend848eb42016-03-08 13:42:11 -0800135 virtual status_t queryDefaultPreProcessing(audio_session_t audioSession,
Eric Laurent57dae992011-07-24 13:36:09 -0700136 effect_descriptor_t *descriptors,
137 uint32_t *count);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700138 virtual status_t onTransact(
139 uint32_t code,
140 const Parcel& data,
141 Parcel* reply,
142 uint32_t flags);
143
144 // IBinder::DeathRecipient
145 virtual void binderDied(const wp<IBinder>& who);
146
Eric Laurentf5ada6e2014-10-09 17:49:00 -0700147 // RefBase
148 virtual void onFirstRef();
149
Mathias Agopian65ab4712010-07-14 17:59:35 -0700150 //
Dima Zavinfce7a472011-04-19 22:30:36 -0700151 // Helpers for the struct audio_policy_service_ops implementation.
152 // This is used by the audio policy manager for certain operations that
153 // are implemented by the policy service.
Mathias Agopian65ab4712010-07-14 17:59:35 -0700154 //
Dima Zavinfce7a472011-04-19 22:30:36 -0700155 virtual void setParameters(audio_io_handle_t ioHandle,
156 const char *keyValuePairs,
157 int delayMs);
158
159 virtual status_t setStreamVolume(audio_stream_type_t stream,
Eric Laurentde070132010-07-13 04:45:46 -0700160 float volume,
161 audio_io_handle_t output,
162 int delayMs = 0);
Dima Zavinfce7a472011-04-19 22:30:36 -0700163 virtual status_t startTone(audio_policy_tone_t tone, audio_stream_type_t stream);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700164 virtual status_t stopTone();
165 virtual status_t setVoiceVolume(float volume, int delayMs = 0);
Richard Fitzgeraldad3af332013-03-25 16:54:37 +0000166 virtual bool isOffloadSupported(const audio_offload_info_t &config);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700167
Eric Laurent203b1a12014-04-01 10:34:16 -0700168 virtual status_t listAudioPorts(audio_port_role_t role,
169 audio_port_type_t type,
170 unsigned int *num_ports,
171 struct audio_port *ports,
172 unsigned int *generation);
173 virtual status_t getAudioPort(struct audio_port *port);
174 virtual status_t createAudioPatch(const struct audio_patch *patch,
175 audio_patch_handle_t *handle);
176 virtual status_t releaseAudioPatch(audio_patch_handle_t handle);
177 virtual status_t listAudioPatches(unsigned int *num_patches,
178 struct audio_patch *patches,
179 unsigned int *generation);
180 virtual status_t setAudioPortConfig(const struct audio_port_config *config);
181
Eric Laurentb52c1522014-05-20 11:27:36 -0700182 virtual void registerClient(const sp<IAudioPolicyServiceClient>& client);
183
Eric Laurente8726fe2015-06-26 09:39:24 -0700184 virtual void setAudioPortCallbacksEnabled(bool enabled);
185
Eric Laurentdf3dc7e2014-07-27 18:39:40 -0700186 virtual status_t acquireSoundTriggerSession(audio_session_t *session,
187 audio_io_handle_t *ioHandle,
188 audio_devices_t *device);
189
190 virtual status_t releaseSoundTriggerSession(audio_session_t session);
191
Eric Laurentbb6c9a02014-09-25 14:11:47 -0700192 virtual audio_mode_t getPhoneState();
193
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700194 virtual status_t registerPolicyMixes(const Vector<AudioMix>& mixes, bool registration);
Eric Laurentbaac1832014-12-01 17:52:59 -0800195
Eric Laurent554a2772015-04-10 11:29:24 -0700196 virtual status_t startAudioSource(const struct audio_port_config *source,
197 const audio_attributes_t *attributes,
Glenn Kasten559d4392016-03-29 13:42:57 -0700198 audio_patch_handle_t *handle);
199 virtual status_t stopAudioSource(audio_patch_handle_t handle);
Eric Laurent554a2772015-04-10 11:29:24 -0700200
Andy Hung2ddee192015-12-18 17:34:44 -0800201 virtual status_t setMasterMono(bool mono);
202 virtual status_t getMasterMono(bool *mono);
203
Eric Laurentac9cef52017-06-09 15:46:26 -0700204 virtual float getStreamVolumeDB(
205 audio_stream_type_t stream, int index, audio_devices_t device);
206
Eric Laurentbfb1b832013-01-07 09:53:42 -0800207 status_t doStopOutput(audio_io_handle_t output,
208 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -0800209 audio_session_t session);
210 void doReleaseOutput(audio_io_handle_t output,
211 audio_stream_type_t stream,
212 audio_session_t session);
Eric Laurentbfb1b832013-01-07 09:53:42 -0800213
Eric Laurent951f4552014-05-20 10:48:17 -0700214 status_t clientCreateAudioPatch(const struct audio_patch *patch,
215 audio_patch_handle_t *handle,
216 int delayMs);
217 status_t clientReleaseAudioPatch(audio_patch_handle_t handle,
218 int delayMs);
Eric Laurente1715a42014-05-20 11:30:42 -0700219 virtual status_t clientSetAudioPortConfig(const struct audio_port_config *config,
220 int delayMs);
221
Eric Laurentb52c1522014-05-20 11:27:36 -0700222 void removeNotificationClient(uid_t uid);
223 void onAudioPortListUpdate();
224 void doOnAudioPortListUpdate();
225 void onAudioPatchListUpdate();
226 void doOnAudioPatchListUpdate();
Eric Laurent951f4552014-05-20 10:48:17 -0700227
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700228 void onDynamicPolicyMixStateUpdate(const String8& regId, int32_t state);
229 void doOnDynamicPolicyMixStateUpdate(const String8& regId, int32_t state);
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800230 void onRecordingConfigurationUpdate(int event, const record_client_info_t *clientInfo,
231 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800232 const audio_config_base_t *deviceConfig, audio_patch_handle_t patchHandle);
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800233 void doOnRecordingConfigurationUpdate(int event, const record_client_info_t *clientInfo,
234 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800235 const audio_config_base_t *deviceConfig, audio_patch_handle_t patchHandle);
Jean-Michel Trivide801052015-04-14 19:10:14 -0700236
Mathias Agopian65ab4712010-07-14 17:59:35 -0700237private:
Mathias Agopiane762be92013-05-09 16:26:45 -0700238 AudioPolicyService() ANDROID_API;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700239 virtual ~AudioPolicyService();
240
241 status_t dumpInternals(int fd);
242
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800243 // Handles binder shell commands
244 virtual status_t shellCommand(int in, int out, int err, Vector<String16>& args);
245
246 // Sets whether the given UID records only silence
247 virtual void setRecordSilenced(uid_t uid, bool silenced);
248
249 // Overrides the UID state as if it is idle
250 status_t handleSetUidState(Vector<String16>& args, int err);
251
252 // Clears the override for the UID state
253 status_t handleResetUidState(Vector<String16>& args, int err);
254
255 // Gets the UID state
256 status_t handleGetUidState(Vector<String16>& args, int out, int err);
257
258 // Prints the shell command help
259 status_t printHelp(int out);
260
261 // If recording we need to make sure the UID is allowed to do that. If the UID is idle
262 // then it cannot record and gets buffers with zeros - silence. As soon as the UID
263 // transitions to an active state we will start reporting buffers with data. This approach
264 // transparently handles recording while the UID transitions between idle/active state
265 // avoiding to get stuck in a state receiving non-empty buffers while idle or in a state
266 // receiving empty buffers while active.
267 class UidPolicy : public BnUidObserver {
268 public:
269 explicit UidPolicy(wp<AudioPolicyService> service)
270 : mService(service) {}
271
272 void registerSelf();
273 void unregisterSelf();
274
275 bool isUidActive(uid_t uid);
276
277 void onUidGone(uid_t uid, bool disabled);
278 void onUidActive(uid_t uid);
279 void onUidIdle(uid_t uid, bool disabled);
280
281 void addOverrideUid(uid_t uid, bool active);
282 void removeOverrideUid(uid_t uid);
283
284 private:
285 bool isUidActiveLocked(uid_t uid);
286 void updateOverrideUid(uid_t uid, bool active, bool insert);
287
288 Mutex mUidLock;
289 wp<AudioPolicyService> mService;
290 std::unordered_set<uid_t> mActiveUids;
291 std::unordered_map<uid_t, bool> mOverrideUids;
292 };
293
Mathias Agopian65ab4712010-07-14 17:59:35 -0700294 // Thread used for tone playback and to send audio config commands to audio flinger
Glenn Kasten85ab62c2012-11-01 11:11:38 -0700295 // For tone playback, using a separate thread is necessary to avoid deadlock with mLock because
296 // startTone() and stopTone() are normally called with mLock locked and requesting a tone start
297 // or stop will cause calls to AudioPolicyService and an attempt to lock mLock.
298 // For audio config commands, it is necessary because audio flinger requires that the calling
299 // process (user) has permission to modify audio settings.
Mathias Agopian65ab4712010-07-14 17:59:35 -0700300 class AudioCommandThread : public Thread {
301 class AudioCommand;
302 public:
303
304 // commands for tone AudioCommand
305 enum {
306 START_TONE,
307 STOP_TONE,
308 SET_VOLUME,
309 SET_PARAMETERS,
Eric Laurentbfb1b832013-01-07 09:53:42 -0800310 SET_VOICE_VOLUME,
311 STOP_OUTPUT,
Eric Laurent951f4552014-05-20 10:48:17 -0700312 RELEASE_OUTPUT,
313 CREATE_AUDIO_PATCH,
314 RELEASE_AUDIO_PATCH,
Eric Laurentb52c1522014-05-20 11:27:36 -0700315 UPDATE_AUDIOPORT_LIST,
Eric Laurente1715a42014-05-20 11:30:42 -0700316 UPDATE_AUDIOPATCH_LIST,
317 SET_AUDIOPORT_CONFIG,
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800318 DYN_POLICY_MIX_STATE_UPDATE,
319 RECORDING_CONFIGURATION_UPDATE
Mathias Agopian65ab4712010-07-14 17:59:35 -0700320 };
321
Eric Laurentbfb1b832013-01-07 09:53:42 -0800322 AudioCommandThread (String8 name, const wp<AudioPolicyService>& service);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700323 virtual ~AudioCommandThread();
324
325 status_t dump(int fd);
326
327 // Thread virtuals
328 virtual void onFirstRef();
329 virtual bool threadLoop();
330
331 void exit();
Glenn Kasten3d2f8772012-01-27 15:25:25 -0800332 void startToneCommand(ToneGenerator::tone_type type,
333 audio_stream_type_t stream);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700334 void stopToneCommand();
Glenn Kasten72ef00d2012-01-17 11:09:42 -0800335 status_t volumeCommand(audio_stream_type_t stream, float volume,
336 audio_io_handle_t output, int delayMs = 0);
337 status_t parametersCommand(audio_io_handle_t ioHandle,
338 const char *keyValuePairs, int delayMs = 0);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700339 status_t voiceVolumeCommand(float volume, int delayMs = 0);
Eric Laurentbfb1b832013-01-07 09:53:42 -0800340 void stopOutputCommand(audio_io_handle_t output,
341 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -0800342 audio_session_t session);
343 void releaseOutputCommand(audio_io_handle_t output,
344 audio_stream_type_t stream,
345 audio_session_t session);
Eric Laurent0ede8922014-05-09 18:04:42 -0700346 status_t sendCommand(sp<AudioCommand>& command, int delayMs = 0);
347 void insertCommand_l(sp<AudioCommand>& command, int delayMs = 0);
Eric Laurent951f4552014-05-20 10:48:17 -0700348 status_t createAudioPatchCommand(const struct audio_patch *patch,
349 audio_patch_handle_t *handle,
350 int delayMs);
351 status_t releaseAudioPatchCommand(audio_patch_handle_t handle,
352 int delayMs);
Eric Laurentb52c1522014-05-20 11:27:36 -0700353 void updateAudioPortListCommand();
354 void updateAudioPatchListCommand();
Eric Laurente1715a42014-05-20 11:30:42 -0700355 status_t setAudioPortConfigCommand(const struct audio_port_config *config,
356 int delayMs);
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700357 void dynamicPolicyMixStateUpdateCommand(const String8& regId, int32_t state);
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800358 void recordingConfigurationUpdateCommand(
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800359 int event,
360 const record_client_info_t *clientInfo,
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800361 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800362 const audio_config_base_t *deviceConfig,
363 audio_patch_handle_t patchHandle);
Eric Laurent951f4552014-05-20 10:48:17 -0700364 void insertCommand_l(AudioCommand *command, int delayMs = 0);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700365 private:
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100366 class AudioCommandData;
367
Mathias Agopian65ab4712010-07-14 17:59:35 -0700368 // descriptor for requested tone playback event
Eric Laurent0ede8922014-05-09 18:04:42 -0700369 class AudioCommand: public RefBase {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700370
371 public:
372 AudioCommand()
Eric Laurent0ede8922014-05-09 18:04:42 -0700373 : mCommand(-1), mStatus(NO_ERROR), mWaitStatus(false) {}
Mathias Agopian65ab4712010-07-14 17:59:35 -0700374
375 void dump(char* buffer, size_t size);
376
377 int mCommand; // START_TONE, STOP_TONE ...
378 nsecs_t mTime; // time stamp
Eric Laurent0ede8922014-05-09 18:04:42 -0700379 Mutex mLock; // mutex associated to mCond
Mathias Agopian65ab4712010-07-14 17:59:35 -0700380 Condition mCond; // condition for status return
381 status_t mStatus; // command status
382 bool mWaitStatus; // true if caller is waiting for status
Eric Laurent0ede8922014-05-09 18:04:42 -0700383 sp<AudioCommandData> mParam; // command specific parameter data
Mathias Agopian65ab4712010-07-14 17:59:35 -0700384 };
385
Eric Laurent0ede8922014-05-09 18:04:42 -0700386 class AudioCommandData: public RefBase {
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100387 public:
388 virtual ~AudioCommandData() {}
389 protected:
390 AudioCommandData() {}
391 };
392
393 class ToneData : public AudioCommandData {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700394 public:
Glenn Kasten3d2f8772012-01-27 15:25:25 -0800395 ToneGenerator::tone_type mType; // tone type (START_TONE only)
Glenn Kastenfff6d712012-01-12 16:38:12 -0800396 audio_stream_type_t mStream; // stream type (START_TONE only)
Mathias Agopian65ab4712010-07-14 17:59:35 -0700397 };
398
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100399 class VolumeData : public AudioCommandData {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700400 public:
Glenn Kastenfff6d712012-01-12 16:38:12 -0800401 audio_stream_type_t mStream;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700402 float mVolume;
Glenn Kasten72ef00d2012-01-17 11:09:42 -0800403 audio_io_handle_t mIO;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700404 };
405
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100406 class ParametersData : public AudioCommandData {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700407 public:
Glenn Kasten72ef00d2012-01-17 11:09:42 -0800408 audio_io_handle_t mIO;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700409 String8 mKeyValuePairs;
410 };
411
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100412 class VoiceVolumeData : public AudioCommandData {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700413 public:
414 float mVolume;
415 };
416
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100417 class StopOutputData : public AudioCommandData {
Eric Laurentbfb1b832013-01-07 09:53:42 -0800418 public:
419 audio_io_handle_t mIO;
420 audio_stream_type_t mStream;
Eric Laurente83b55d2014-11-14 10:06:21 -0800421 audio_session_t mSession;
Eric Laurentbfb1b832013-01-07 09:53:42 -0800422 };
423
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100424 class ReleaseOutputData : public AudioCommandData {
Eric Laurentbfb1b832013-01-07 09:53:42 -0800425 public:
426 audio_io_handle_t mIO;
Eric Laurente83b55d2014-11-14 10:06:21 -0800427 audio_stream_type_t mStream;
428 audio_session_t mSession;
Eric Laurentbfb1b832013-01-07 09:53:42 -0800429 };
430
Eric Laurent951f4552014-05-20 10:48:17 -0700431 class CreateAudioPatchData : public AudioCommandData {
432 public:
433 struct audio_patch mPatch;
434 audio_patch_handle_t mHandle;
435 };
436
437 class ReleaseAudioPatchData : public AudioCommandData {
438 public:
439 audio_patch_handle_t mHandle;
440 };
441
Eric Laurente1715a42014-05-20 11:30:42 -0700442 class SetAudioPortConfigData : public AudioCommandData {
443 public:
444 struct audio_port_config mConfig;
445 };
446
Jean-Michel Trivide801052015-04-14 19:10:14 -0700447 class DynPolicyMixStateUpdateData : public AudioCommandData {
448 public:
449 String8 mRegId;
450 int32_t mState;
451 };
452
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800453 class RecordingConfigurationUpdateData : public AudioCommandData {
454 public:
455 int mEvent;
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800456 record_client_info_t mClientInfo;
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800457 struct audio_config_base mClientConfig;
458 struct audio_config_base mDeviceConfig;
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800459 audio_patch_handle_t mPatchHandle;
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800460 };
461
Mathias Agopian65ab4712010-07-14 17:59:35 -0700462 Mutex mLock;
463 Condition mWaitWorkCV;
Eric Laurent0ede8922014-05-09 18:04:42 -0700464 Vector < sp<AudioCommand> > mAudioCommands; // list of pending commands
Mathias Agopian65ab4712010-07-14 17:59:35 -0700465 ToneGenerator *mpToneGenerator; // the tone generator
Eric Laurent0ede8922014-05-09 18:04:42 -0700466 sp<AudioCommand> mLastCommand; // last processed command (used by dump)
Mathias Agopian65ab4712010-07-14 17:59:35 -0700467 String8 mName; // string used by wake lock fo delayed commands
Eric Laurentbfb1b832013-01-07 09:53:42 -0800468 wp<AudioPolicyService> mService;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700469 };
470
Eric Laurentdce54a12014-03-10 12:19:46 -0700471 class AudioPolicyClient : public AudioPolicyClientInterface
472 {
473 public:
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700474 explicit AudioPolicyClient(AudioPolicyService *service) : mAudioPolicyService(service) {}
Eric Laurentdce54a12014-03-10 12:19:46 -0700475 virtual ~AudioPolicyClient() {}
476
477 //
478 // Audio HW module functions
479 //
480
481 // loads a HW module.
482 virtual audio_module_handle_t loadHwModule(const char *name);
483
484 //
485 // Audio output Control functions
486 //
487
488 // opens an audio output with the requested parameters. The parameter values can indicate to use the default values
489 // in case the audio policy manager has no specific requirements for the output being opened.
490 // When the function returns, the parameter values reflect the actual values used by the audio hardware output stream.
491 // The audio policy manager can check if the proposed parameters are suitable or not and act accordingly.
Eric Laurentcf2c0212014-07-25 16:20:43 -0700492 virtual status_t openOutput(audio_module_handle_t module,
493 audio_io_handle_t *output,
494 audio_config_t *config,
495 audio_devices_t *devices,
496 const String8& address,
497 uint32_t *latencyMs,
498 audio_output_flags_t flags);
Eric Laurentdce54a12014-03-10 12:19:46 -0700499 // creates a special output that is duplicated to the two outputs passed as arguments. The duplication is performed by
500 // a special mixer thread in the AudioFlinger.
501 virtual audio_io_handle_t openDuplicateOutput(audio_io_handle_t output1, audio_io_handle_t output2);
502 // closes the output stream
503 virtual status_t closeOutput(audio_io_handle_t output);
504 // suspends the output. When an output is suspended, the corresponding audio hardware output stream is placed in
505 // standby and the AudioTracks attached to the mixer thread are still processed but the output mix is discarded.
506 virtual status_t suspendOutput(audio_io_handle_t output);
507 // restores a suspended output.
508 virtual status_t restoreOutput(audio_io_handle_t output);
509
510 //
511 // Audio input Control functions
512 //
513
514 // opens an audio input
515 virtual audio_io_handle_t openInput(audio_module_handle_t module,
Eric Laurentcf2c0212014-07-25 16:20:43 -0700516 audio_io_handle_t *input,
517 audio_config_t *config,
518 audio_devices_t *devices,
519 const String8& address,
520 audio_source_t source,
Glenn Kastenec40d282014-07-15 15:31:26 -0700521 audio_input_flags_t flags);
Eric Laurentdce54a12014-03-10 12:19:46 -0700522 // closes an audio input
523 virtual status_t closeInput(audio_io_handle_t input);
524 //
525 // misc control functions
526 //
527
528 // set a stream volume for a particular output. For the same user setting, a given stream type can have different volumes
529 // for each output (destination device) it is attached to.
530 virtual status_t setStreamVolume(audio_stream_type_t stream, float volume, audio_io_handle_t output, int delayMs = 0);
531
532 // invalidate a stream type, causing a reroute to an unspecified new output
533 virtual status_t invalidateStream(audio_stream_type_t stream);
534
535 // function enabling to send proprietary informations directly from audio policy manager to audio hardware interface.
536 virtual void setParameters(audio_io_handle_t ioHandle, const String8& keyValuePairs, int delayMs = 0);
537 // function enabling to receive proprietary informations directly from audio hardware interface to audio policy manager.
538 virtual String8 getParameters(audio_io_handle_t ioHandle, const String8& keys);
539
540 // request the playback of a tone on the specified stream: used for instance to replace notification sounds when playing
541 // over a telephony device during a phone call.
542 virtual status_t startTone(audio_policy_tone_t tone, audio_stream_type_t stream);
543 virtual status_t stopTone();
544
545 // set down link audio volume.
546 virtual status_t setVoiceVolume(float volume, int delayMs = 0);
547
548 // move effect to the specified output
Glenn Kastend848eb42016-03-08 13:42:11 -0800549 virtual status_t moveEffects(audio_session_t session,
Eric Laurentdce54a12014-03-10 12:19:46 -0700550 audio_io_handle_t srcOutput,
551 audio_io_handle_t dstOutput);
552
Eric Laurent951f4552014-05-20 10:48:17 -0700553 /* Create a patch between several source and sink ports */
554 virtual status_t createAudioPatch(const struct audio_patch *patch,
555 audio_patch_handle_t *handle,
556 int delayMs);
557
558 /* Release a patch */
559 virtual status_t releaseAudioPatch(audio_patch_handle_t handle,
560 int delayMs);
561
Eric Laurente1715a42014-05-20 11:30:42 -0700562 /* Set audio port configuration */
563 virtual status_t setAudioPortConfig(const struct audio_port_config *config, int delayMs);
564
Eric Laurentb52c1522014-05-20 11:27:36 -0700565 virtual void onAudioPortListUpdate();
566 virtual void onAudioPatchListUpdate();
Jean-Michel Trivide801052015-04-14 19:10:14 -0700567 virtual void onDynamicPolicyMixStateUpdate(String8 regId, int32_t state);
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800568 virtual void onRecordingConfigurationUpdate(int event,
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800569 const record_client_info_t *clientInfo,
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800570 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800571 const audio_config_base_t *deviceConfig, audio_patch_handle_t patchHandle);
Eric Laurentb52c1522014-05-20 11:27:36 -0700572
Glenn Kasteneeecb982016-02-26 10:44:04 -0800573 virtual audio_unique_id_t newAudioUniqueId(audio_unique_id_use_t use);
Eric Laurentde3f8392014-07-27 18:38:22 -0700574
Eric Laurentdce54a12014-03-10 12:19:46 -0700575 private:
576 AudioPolicyService *mAudioPolicyService;
577 };
578
Eric Laurentb52c1522014-05-20 11:27:36 -0700579 // --- Notification Client ---
580 class NotificationClient : public IBinder::DeathRecipient {
581 public:
582 NotificationClient(const sp<AudioPolicyService>& service,
583 const sp<IAudioPolicyServiceClient>& client,
584 uid_t uid);
585 virtual ~NotificationClient();
586
Jean-Michel Trivide801052015-04-14 19:10:14 -0700587 void onAudioPortListUpdate();
588 void onAudioPatchListUpdate();
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700589 void onDynamicPolicyMixStateUpdate(const String8& regId, int32_t state);
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800590 void onRecordingConfigurationUpdate(
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800591 int event, const record_client_info_t *clientInfo,
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800592 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800593 const audio_config_base_t *deviceConfig,
594 audio_patch_handle_t patchHandle);
Eric Laurente8726fe2015-06-26 09:39:24 -0700595 void setAudioPortCallbacksEnabled(bool enabled);
Eric Laurentb52c1522014-05-20 11:27:36 -0700596
597 // IBinder::DeathRecipient
598 virtual void binderDied(const wp<IBinder>& who);
599
600 private:
601 NotificationClient(const NotificationClient&);
602 NotificationClient& operator = (const NotificationClient&);
603
604 const wp<AudioPolicyService> mService;
605 const uid_t mUid;
606 const sp<IAudioPolicyServiceClient> mAudioPolicyServiceClient;
Eric Laurente8726fe2015-06-26 09:39:24 -0700607 bool mAudioPortCallbacksEnabled;
Eric Laurentb52c1522014-05-20 11:27:36 -0700608 };
609
Eric Laurentfee19762018-01-29 18:44:13 -0800610 // --- AudioRecordClient ---
611 // Information about each registered AudioRecord client
612 // (between calls to getInputForAttr() and releaseInput())
613 class AudioRecordClient : public RefBase {
614 public:
615 AudioRecordClient(const audio_attributes_t attributes,
616 const audio_io_handle_t input, uid_t uid, pid_t pid,
617 const String16& opPackageName, const audio_session_t session) :
618 attributes(attributes),
619 input(input), uid(uid), pid(pid),
620 opPackageName(opPackageName), session(session),
621 active(false), isConcurrent(false), isVirtualDevice(false) {}
622 virtual ~AudioRecordClient() {}
623
624 const audio_attributes_t attributes; // source, flags ...
625 const audio_io_handle_t input; // audio HAL input IO handle
626 const uid_t uid; // client UID
627 const pid_t pid; // client PID
628 const String16 opPackageName; // client package name
629 const audio_session_t session; // audio session ID
630 bool active; // Capture is active or inactive
631 bool isConcurrent; // is allowed to concurrent capture
632 bool isVirtualDevice; // uses vitual device: updated by APM::getInputForAttr()
633 };
634
Mathias Agopian65ab4712010-07-14 17:59:35 -0700635 // Internal dump utilities.
636 status_t dumpPermissionDenial(int fd);
637
638
Eric Laurenteda6c362011-02-02 09:33:30 -0800639 mutable Mutex mLock; // prevents concurrent access to AudioPolicy manager functions changing
640 // device connection state or routing
Haynes Mathew Georgebab7bf42015-10-30 18:02:23 -0700641 mutable Mutex mEffectsLock; // serialize access to Effect state within APM.
642 // Note: lock acquisition order is always mLock > mEffectsLock:
643 // mLock protects AudioPolicyManager methods that can call into audio flinger
644 // and possibly back in to audio policy service and acquire mEffectsLock.
Glenn Kastene53b9ea2012-03-12 16:29:55 -0700645 sp<AudioCommandThread> mAudioCommandThread; // audio commands thread
646 sp<AudioCommandThread> mTonePlaybackThread; // tone playback thread
Eric Laurentbfb1b832013-01-07 09:53:42 -0800647 sp<AudioCommandThread> mOutputCommandThread; // process stop and release output
Dima Zavinfce7a472011-04-19 22:30:36 -0700648 struct audio_policy_device *mpAudioPolicyDev;
649 struct audio_policy *mpAudioPolicy;
Eric Laurentf269b8e2014-06-09 20:01:29 -0700650 AudioPolicyInterface *mAudioPolicyManager;
Eric Laurentdce54a12014-03-10 12:19:46 -0700651 AudioPolicyClient *mAudioPolicyClient;
652
Eric Laurentb52c1522014-05-20 11:27:36 -0700653 DefaultKeyedVector< uid_t, sp<NotificationClient> > mNotificationClients;
Eric Laurent0ebd5f92014-11-19 19:04:52 -0800654 Mutex mNotificationClientsLock; // protects mNotificationClients
bryant_liuba2b4392014-06-11 16:49:30 +0800655 // Manage all effects configured in audio_effects.conf
656 sp<AudioPolicyEffects> mAudioPolicyEffects;
Eric Laurentbb6c9a02014-09-25 14:11:47 -0700657 audio_mode_t mPhoneState;
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800658
659 sp<UidPolicy> mUidPolicy;
Eric Laurentfee19762018-01-29 18:44:13 -0800660 DefaultKeyedVector< audio_port_handle_t, sp<AudioRecordClient> > mAudioRecordClients;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700661};
662
Mikhail Naganov1b2a7942017-12-08 10:18:09 -0800663} // namespace android
Mathias Agopian65ab4712010-07-14 17:59:35 -0700664
665#endif // ANDROID_AUDIOPOLICYSERVICE_H