blob: ed3324b753cbdab96b02bf768daa39814919bc5c [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>
bryant_liuba2b4392014-06-11 16:49:30 +080038
Mathias Agopian65ab4712010-07-14 17:59:35 -070039namespace android {
40
Mathias Agopian65ab4712010-07-14 17:59:35 -070041// ----------------------------------------------------------------------------
42
Glenn Kastend2dcb082011-02-03 16:55:26 -080043class AudioPolicyService :
44 public BinderService<AudioPolicyService>,
45 public BnAudioPolicyService,
Eric Laurentde070132010-07-13 04:45:46 -070046 public IBinder::DeathRecipient
Mathias Agopian65ab4712010-07-14 17:59:35 -070047{
Glenn Kastend2dcb082011-02-03 16:55:26 -080048 friend class BinderService<AudioPolicyService>;
Mathias Agopian65ab4712010-07-14 17:59:35 -070049
50public:
Glenn Kastend2dcb082011-02-03 16:55:26 -080051 // for BinderService
Mathias Agopiane762be92013-05-09 16:26:45 -070052 static const char *getServiceName() ANDROID_API { return "media.audio_policy"; }
Mathias Agopian65ab4712010-07-14 17:59:35 -070053
54 virtual status_t dump(int fd, const Vector<String16>& args);
55
56 //
57 // BnAudioPolicyService (see AudioPolicyInterface for method descriptions)
58 //
59
Dima Zavinfce7a472011-04-19 22:30:36 -070060 virtual status_t setDeviceConnectionState(audio_devices_t device,
61 audio_policy_dev_state_t state,
Paul McLeane743a472015-01-28 11:07:31 -080062 const char *device_address,
63 const char *device_name);
Dima Zavinfce7a472011-04-19 22:30:36 -070064 virtual audio_policy_dev_state_t getDeviceConnectionState(
65 audio_devices_t device,
Eric Laurentde070132010-07-13 04:45:46 -070066 const char *device_address);
Pavlin Radoslavovf862bc62016-12-26 18:57:22 -080067 virtual status_t handleDeviceConfigChange(audio_devices_t device,
68 const char *device_address,
69 const char *device_name);
Glenn Kastenf78aee72012-01-04 11:00:47 -080070 virtual status_t setPhoneState(audio_mode_t state);
Dima Zavinfce7a472011-04-19 22:30:36 -070071 virtual status_t setForceUse(audio_policy_force_use_t usage, audio_policy_forced_cfg_t config);
72 virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage);
Eric Laurentf4e63452017-11-06 19:31:46 +000073 virtual audio_io_handle_t getOutput(audio_stream_type_t stream);
Eric Laurente83b55d2014-11-14 10:06:21 -080074 virtual status_t getOutputForAttr(const audio_attributes_t *attr,
75 audio_io_handle_t *output,
76 audio_session_t session,
77 audio_stream_type_t *stream,
Nadav Bar766fb022018-01-07 12:18:03 +020078 pid_t pid,
Eric Laurent8c7e6da2015-04-21 17:37:00 -070079 uid_t uid,
Eric Laurent20b9ef02016-12-05 11:03:16 -080080 const audio_config_t *config,
81 audio_output_flags_t flags,
Eric Laurent9ae8c592017-06-22 17:17:09 -070082 audio_port_handle_t *selectedDeviceId,
Eric Laurent20b9ef02016-12-05 11:03:16 -080083 audio_port_handle_t *portId);
Eric Laurentde070132010-07-13 04:45:46 -070084 virtual status_t startOutput(audio_io_handle_t output,
Dima Zavinfce7a472011-04-19 22:30:36 -070085 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -080086 audio_session_t session);
Eric Laurentde070132010-07-13 04:45:46 -070087 virtual status_t stopOutput(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);
90 virtual void releaseOutput(audio_io_handle_t output,
91 audio_stream_type_t stream,
92 audio_session_t session);
Eric Laurentcaf7f482014-11-25 17:50:47 -080093 virtual status_t getInputForAttr(const audio_attributes_t *attr,
94 audio_io_handle_t *input,
95 audio_session_t session,
Eric Laurentb2379ba2016-05-23 17:42:12 -070096 pid_t pid,
Eric Laurent8c7e6da2015-04-21 17:37:00 -070097 uid_t uid,
Eric Laurentfee19762018-01-29 18:44:13 -080098 const String16& opPackageName,
Eric Laurent20b9ef02016-12-05 11:03:16 -080099 const audio_config_base_t *config,
Paul McLean466dc8e2015-04-17 13:15:36 -0600100 audio_input_flags_t flags,
Eric Laurent9ae8c592017-06-22 17:17:09 -0700101 audio_port_handle_t *selectedDeviceId = NULL,
Eric Laurent20b9ef02016-12-05 11:03:16 -0800102 audio_port_handle_t *portId = NULL);
Eric Laurentfee19762018-01-29 18:44:13 -0800103 virtual status_t startInput(audio_port_handle_t portId,
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800104 bool *silenced);
Eric Laurentfee19762018-01-29 18:44:13 -0800105 virtual status_t stopInput(audio_port_handle_t portId);
106 virtual void releaseInput(audio_port_handle_t portId);
Dima Zavinfce7a472011-04-19 22:30:36 -0700107 virtual status_t initStreamVolume(audio_stream_type_t stream,
Mathias Agopian65ab4712010-07-14 17:59:35 -0700108 int indexMin,
109 int indexMax);
Eric Laurent83844cc2011-11-18 16:43:31 -0800110 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);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700116
Dima Zavinfce7a472011-04-19 22:30:36 -0700117 virtual uint32_t getStrategyForStream(audio_stream_type_t stream);
Eric Laurent63742522012-03-08 13:42:42 -0800118 virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream);
Eric Laurentde070132010-07-13 04:45:46 -0700119
Glenn Kasten58e5aa32012-06-20 14:08:14 -0700120 virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc);
121 virtual status_t registerEffect(const effect_descriptor_t *desc,
Eric Laurent7c7f10b2011-06-17 21:29:58 -0700122 audio_io_handle_t io,
Eric Laurentde070132010-07-13 04:45:46 -0700123 uint32_t strategy,
Glenn Kastend848eb42016-03-08 13:42:11 -0800124 audio_session_t session,
Eric Laurentde070132010-07-13 04:45:46 -0700125 int id);
126 virtual status_t unregisterEffect(int id);
Eric Laurentdb7c0792011-08-10 10:37:50 -0700127 virtual status_t setEffectEnabled(int id, bool enabled);
Glenn Kastenfff6d712012-01-12 16:38:12 -0800128 virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const;
Jean-Michel Trivi272ab542013-02-04 16:26:02 -0800129 virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) const;
Jean-Michel Trivid7086032012-10-10 12:11:16 -0700130 virtual bool isSourceActive(audio_source_t source) const;
Eric Laurentde070132010-07-13 04:45:46 -0700131
Glenn Kastend848eb42016-03-08 13:42:11 -0800132 virtual status_t queryDefaultPreProcessing(audio_session_t audioSession,
Eric Laurent57dae992011-07-24 13:36:09 -0700133 effect_descriptor_t *descriptors,
134 uint32_t *count);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700135 virtual status_t onTransact(
136 uint32_t code,
137 const Parcel& data,
138 Parcel* reply,
139 uint32_t flags);
140
141 // IBinder::DeathRecipient
142 virtual void binderDied(const wp<IBinder>& who);
143
Eric Laurentf5ada6e2014-10-09 17:49:00 -0700144 // RefBase
145 virtual void onFirstRef();
146
Mathias Agopian65ab4712010-07-14 17:59:35 -0700147 //
Dima Zavinfce7a472011-04-19 22:30:36 -0700148 // Helpers for the struct audio_policy_service_ops implementation.
149 // This is used by the audio policy manager for certain operations that
150 // are implemented by the policy service.
Mathias Agopian65ab4712010-07-14 17:59:35 -0700151 //
Dima Zavinfce7a472011-04-19 22:30:36 -0700152 virtual void setParameters(audio_io_handle_t ioHandle,
153 const char *keyValuePairs,
154 int delayMs);
155
156 virtual status_t setStreamVolume(audio_stream_type_t stream,
Eric Laurentde070132010-07-13 04:45:46 -0700157 float volume,
158 audio_io_handle_t output,
159 int delayMs = 0);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700160 virtual status_t setVoiceVolume(float volume, int delayMs = 0);
Richard Fitzgeraldad3af332013-03-25 16:54:37 +0000161 virtual bool isOffloadSupported(const audio_offload_info_t &config);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700162
Eric Laurent203b1a12014-04-01 10:34:16 -0700163 virtual status_t listAudioPorts(audio_port_role_t role,
164 audio_port_type_t type,
165 unsigned int *num_ports,
166 struct audio_port *ports,
167 unsigned int *generation);
168 virtual status_t getAudioPort(struct audio_port *port);
169 virtual status_t createAudioPatch(const struct audio_patch *patch,
170 audio_patch_handle_t *handle);
171 virtual status_t releaseAudioPatch(audio_patch_handle_t handle);
172 virtual status_t listAudioPatches(unsigned int *num_patches,
173 struct audio_patch *patches,
174 unsigned int *generation);
175 virtual status_t setAudioPortConfig(const struct audio_port_config *config);
176
Eric Laurentb52c1522014-05-20 11:27:36 -0700177 virtual void registerClient(const sp<IAudioPolicyServiceClient>& client);
178
Eric Laurente8726fe2015-06-26 09:39:24 -0700179 virtual void setAudioPortCallbacksEnabled(bool enabled);
180
Eric Laurentdf3dc7e2014-07-27 18:39:40 -0700181 virtual status_t acquireSoundTriggerSession(audio_session_t *session,
182 audio_io_handle_t *ioHandle,
183 audio_devices_t *device);
184
185 virtual status_t releaseSoundTriggerSession(audio_session_t session);
186
Eric Laurentbb6c9a02014-09-25 14:11:47 -0700187 virtual audio_mode_t getPhoneState();
188
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700189 virtual status_t registerPolicyMixes(const Vector<AudioMix>& mixes, bool registration);
Eric Laurentbaac1832014-12-01 17:52:59 -0800190
Eric Laurent554a2772015-04-10 11:29:24 -0700191 virtual status_t startAudioSource(const struct audio_port_config *source,
192 const audio_attributes_t *attributes,
Glenn Kasten559d4392016-03-29 13:42:57 -0700193 audio_patch_handle_t *handle);
194 virtual status_t stopAudioSource(audio_patch_handle_t handle);
Eric Laurent554a2772015-04-10 11:29:24 -0700195
Andy Hung2ddee192015-12-18 17:34:44 -0800196 virtual status_t setMasterMono(bool mono);
197 virtual status_t getMasterMono(bool *mono);
198
Eric Laurentac9cef52017-06-09 15:46:26 -0700199 virtual float getStreamVolumeDB(
200 audio_stream_type_t stream, int index, audio_devices_t device);
201
jiabin81772902018-04-02 17:52:27 -0700202 virtual status_t getSurroundFormats(unsigned int *numSurroundFormats,
203 audio_format_t *surroundFormats,
204 bool *surroundFormatsEnabled,
205 bool reported);
206 virtual status_t setSurroundFormatEnabled(audio_format_t audioFormat, bool enabled);
207
Eric Laurentbfb1b832013-01-07 09:53:42 -0800208 status_t doStopOutput(audio_io_handle_t output,
209 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -0800210 audio_session_t session);
211 void doReleaseOutput(audio_io_handle_t output,
212 audio_stream_type_t stream,
213 audio_session_t session);
Eric Laurentbfb1b832013-01-07 09:53:42 -0800214
Eric Laurent951f4552014-05-20 10:48:17 -0700215 status_t clientCreateAudioPatch(const struct audio_patch *patch,
216 audio_patch_handle_t *handle,
217 int delayMs);
218 status_t clientReleaseAudioPatch(audio_patch_handle_t handle,
219 int delayMs);
Eric Laurente1715a42014-05-20 11:30:42 -0700220 virtual status_t clientSetAudioPortConfig(const struct audio_port_config *config,
221 int delayMs);
222
Eric Laurentb52c1522014-05-20 11:27:36 -0700223 void removeNotificationClient(uid_t uid);
224 void onAudioPortListUpdate();
225 void doOnAudioPortListUpdate();
226 void onAudioPatchListUpdate();
227 void doOnAudioPatchListUpdate();
Eric Laurent951f4552014-05-20 10:48:17 -0700228
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700229 void onDynamicPolicyMixStateUpdate(const String8& regId, int32_t state);
230 void doOnDynamicPolicyMixStateUpdate(const String8& regId, int32_t state);
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800231 void onRecordingConfigurationUpdate(int event, const record_client_info_t *clientInfo,
232 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800233 const audio_config_base_t *deviceConfig, audio_patch_handle_t patchHandle);
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800234 void doOnRecordingConfigurationUpdate(int event, const record_client_info_t *clientInfo,
235 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800236 const audio_config_base_t *deviceConfig, audio_patch_handle_t patchHandle);
Jean-Michel Trivide801052015-04-14 19:10:14 -0700237
Mathias Agopian65ab4712010-07-14 17:59:35 -0700238private:
Mathias Agopiane762be92013-05-09 16:26:45 -0700239 AudioPolicyService() ANDROID_API;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700240 virtual ~AudioPolicyService();
241
242 status_t dumpInternals(int fd);
243
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800244 // Handles binder shell commands
245 virtual status_t shellCommand(int in, int out, int err, Vector<String16>& args);
246
247 // Sets whether the given UID records only silence
248 virtual void setRecordSilenced(uid_t uid, bool silenced);
249
250 // Overrides the UID state as if it is idle
251 status_t handleSetUidState(Vector<String16>& args, int err);
252
253 // Clears the override for the UID state
254 status_t handleResetUidState(Vector<String16>& args, int err);
255
256 // Gets the UID state
257 status_t handleGetUidState(Vector<String16>& args, int out, int err);
258
259 // Prints the shell command help
260 status_t printHelp(int out);
261
Eric Laurent99fcae42018-05-17 16:59:18 -0700262 std::string getDeviceTypeStrForPortId(audio_port_handle_t portId);
263
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800264 // If recording we need to make sure the UID is allowed to do that. If the UID is idle
265 // then it cannot record and gets buffers with zeros - silence. As soon as the UID
266 // transitions to an active state we will start reporting buffers with data. This approach
267 // transparently handles recording while the UID transitions between idle/active state
268 // avoiding to get stuck in a state receiving non-empty buffers while idle or in a state
269 // receiving empty buffers while active.
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700270 class UidPolicy : public BnUidObserver, public virtual IBinder::DeathRecipient {
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800271 public:
272 explicit UidPolicy(wp<AudioPolicyService> service)
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700273 : mService(service), mObserverRegistered(false) {}
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800274
275 void registerSelf();
276 void unregisterSelf();
277
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700278 // IBinder::DeathRecipient implementation
279 void binderDied(const wp<IBinder> &who) override;
280
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800281 bool isUidActive(uid_t uid);
282
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700283 // BnUidObserver implementation
284 void onUidActive(uid_t uid) override;
285 void onUidGone(uid_t uid, bool disabled) override;
286 void onUidIdle(uid_t uid, bool disabled) override;
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800287
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700288 void addOverrideUid(uid_t uid, bool active) { updateOverrideUid(uid, active, true); }
289 void removeOverrideUid(uid_t uid) { updateOverrideUid(uid, false, false); }
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800290
291 private:
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700292 void notifyService(uid_t uid, bool active);
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800293 void updateOverrideUid(uid_t uid, bool active, bool insert);
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700294 void updateUidCache(uid_t uid, bool active, bool insert);
295 void updateUidLocked(std::unordered_map<uid_t, bool> *uids,
296 uid_t uid, bool active, bool insert, bool *wasThere, bool *wasActive);
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800297
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800298 wp<AudioPolicyService> mService;
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700299 Mutex mLock;
300 bool mObserverRegistered;
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800301 std::unordered_map<uid_t, bool> mOverrideUids;
Mikhail Naganoveae73eb2018-04-03 16:57:36 -0700302 std::unordered_map<uid_t, bool> mCachedUids;
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800303 };
304
Eric Laurentdcd4ab12018-06-29 17:45:13 -0700305 // Thread used to send audio config commands to audio flinger
Glenn Kasten85ab62c2012-11-01 11:11:38 -0700306 // For audio config commands, it is necessary because audio flinger requires that the calling
307 // process (user) has permission to modify audio settings.
Mathias Agopian65ab4712010-07-14 17:59:35 -0700308 class AudioCommandThread : public Thread {
309 class AudioCommand;
310 public:
311
312 // commands for tone AudioCommand
313 enum {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700314 SET_VOLUME,
315 SET_PARAMETERS,
Eric Laurentbfb1b832013-01-07 09:53:42 -0800316 SET_VOICE_VOLUME,
317 STOP_OUTPUT,
Eric Laurent951f4552014-05-20 10:48:17 -0700318 RELEASE_OUTPUT,
319 CREATE_AUDIO_PATCH,
320 RELEASE_AUDIO_PATCH,
Eric Laurentb52c1522014-05-20 11:27:36 -0700321 UPDATE_AUDIOPORT_LIST,
Eric Laurente1715a42014-05-20 11:30:42 -0700322 UPDATE_AUDIOPATCH_LIST,
323 SET_AUDIOPORT_CONFIG,
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800324 DYN_POLICY_MIX_STATE_UPDATE,
325 RECORDING_CONFIGURATION_UPDATE
Mathias Agopian65ab4712010-07-14 17:59:35 -0700326 };
327
Eric Laurentbfb1b832013-01-07 09:53:42 -0800328 AudioCommandThread (String8 name, const wp<AudioPolicyService>& service);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700329 virtual ~AudioCommandThread();
330
331 status_t dump(int fd);
332
333 // Thread virtuals
334 virtual void onFirstRef();
335 virtual bool threadLoop();
336
337 void exit();
Glenn Kasten72ef00d2012-01-17 11:09:42 -0800338 status_t volumeCommand(audio_stream_type_t stream, float volume,
339 audio_io_handle_t output, int delayMs = 0);
340 status_t parametersCommand(audio_io_handle_t ioHandle,
341 const char *keyValuePairs, int delayMs = 0);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700342 status_t voiceVolumeCommand(float volume, int delayMs = 0);
Eric Laurentbfb1b832013-01-07 09:53:42 -0800343 void stopOutputCommand(audio_io_handle_t output,
344 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -0800345 audio_session_t session);
346 void releaseOutputCommand(audio_io_handle_t output,
347 audio_stream_type_t stream,
348 audio_session_t session);
Eric Laurent0ede8922014-05-09 18:04:42 -0700349 status_t sendCommand(sp<AudioCommand>& command, int delayMs = 0);
350 void insertCommand_l(sp<AudioCommand>& command, int delayMs = 0);
Eric Laurent951f4552014-05-20 10:48:17 -0700351 status_t createAudioPatchCommand(const struct audio_patch *patch,
352 audio_patch_handle_t *handle,
353 int delayMs);
354 status_t releaseAudioPatchCommand(audio_patch_handle_t handle,
355 int delayMs);
Eric Laurentb52c1522014-05-20 11:27:36 -0700356 void updateAudioPortListCommand();
357 void updateAudioPatchListCommand();
Eric Laurente1715a42014-05-20 11:30:42 -0700358 status_t setAudioPortConfigCommand(const struct audio_port_config *config,
359 int delayMs);
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700360 void dynamicPolicyMixStateUpdateCommand(const String8& regId, int32_t state);
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800361 void recordingConfigurationUpdateCommand(
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800362 int event,
363 const record_client_info_t *clientInfo,
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800364 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800365 const audio_config_base_t *deviceConfig,
366 audio_patch_handle_t patchHandle);
Eric Laurent951f4552014-05-20 10:48:17 -0700367 void insertCommand_l(AudioCommand *command, int delayMs = 0);
Mathias Agopian65ab4712010-07-14 17:59:35 -0700368 private:
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100369 class AudioCommandData;
370
Mathias Agopian65ab4712010-07-14 17:59:35 -0700371 // descriptor for requested tone playback event
Eric Laurent0ede8922014-05-09 18:04:42 -0700372 class AudioCommand: public RefBase {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700373
374 public:
375 AudioCommand()
Eric Laurent0ede8922014-05-09 18:04:42 -0700376 : mCommand(-1), mStatus(NO_ERROR), mWaitStatus(false) {}
Mathias Agopian65ab4712010-07-14 17:59:35 -0700377
378 void dump(char* buffer, size_t size);
379
Eric Laurentdcd4ab12018-06-29 17:45:13 -0700380 int mCommand; // SET_VOLUME, SET_PARAMETERS...
Mathias Agopian65ab4712010-07-14 17:59:35 -0700381 nsecs_t mTime; // time stamp
Eric Laurent0ede8922014-05-09 18:04:42 -0700382 Mutex mLock; // mutex associated to mCond
Mathias Agopian65ab4712010-07-14 17:59:35 -0700383 Condition mCond; // condition for status return
384 status_t mStatus; // command status
385 bool mWaitStatus; // true if caller is waiting for status
Eric Laurent0ede8922014-05-09 18:04:42 -0700386 sp<AudioCommandData> mParam; // command specific parameter data
Mathias Agopian65ab4712010-07-14 17:59:35 -0700387 };
388
Eric Laurent0ede8922014-05-09 18:04:42 -0700389 class AudioCommandData: public RefBase {
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100390 public:
391 virtual ~AudioCommandData() {}
392 protected:
393 AudioCommandData() {}
394 };
395
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100396 class VolumeData : public AudioCommandData {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700397 public:
Glenn Kastenfff6d712012-01-12 16:38:12 -0800398 audio_stream_type_t mStream;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700399 float mVolume;
Glenn Kasten72ef00d2012-01-17 11:09:42 -0800400 audio_io_handle_t mIO;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700401 };
402
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100403 class ParametersData : public AudioCommandData {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700404 public:
Glenn Kasten72ef00d2012-01-17 11:09:42 -0800405 audio_io_handle_t mIO;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700406 String8 mKeyValuePairs;
407 };
408
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100409 class VoiceVolumeData : public AudioCommandData {
Mathias Agopian65ab4712010-07-14 17:59:35 -0700410 public:
411 float mVolume;
412 };
413
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100414 class StopOutputData : public AudioCommandData {
Eric Laurentbfb1b832013-01-07 09:53:42 -0800415 public:
416 audio_io_handle_t mIO;
417 audio_stream_type_t mStream;
Eric Laurente83b55d2014-11-14 10:06:21 -0800418 audio_session_t mSession;
Eric Laurentbfb1b832013-01-07 09:53:42 -0800419 };
420
Jesper Tragardh48412dc2014-03-24 14:12:43 +0100421 class ReleaseOutputData : public AudioCommandData {
Eric Laurentbfb1b832013-01-07 09:53:42 -0800422 public:
423 audio_io_handle_t mIO;
Eric Laurente83b55d2014-11-14 10:06:21 -0800424 audio_stream_type_t mStream;
425 audio_session_t mSession;
Eric Laurentbfb1b832013-01-07 09:53:42 -0800426 };
427
Eric Laurent951f4552014-05-20 10:48:17 -0700428 class CreateAudioPatchData : public AudioCommandData {
429 public:
430 struct audio_patch mPatch;
431 audio_patch_handle_t mHandle;
432 };
433
434 class ReleaseAudioPatchData : public AudioCommandData {
435 public:
436 audio_patch_handle_t mHandle;
437 };
438
Eric Laurente1715a42014-05-20 11:30:42 -0700439 class SetAudioPortConfigData : public AudioCommandData {
440 public:
441 struct audio_port_config mConfig;
442 };
443
Jean-Michel Trivide801052015-04-14 19:10:14 -0700444 class DynPolicyMixStateUpdateData : public AudioCommandData {
445 public:
446 String8 mRegId;
447 int32_t mState;
448 };
449
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800450 class RecordingConfigurationUpdateData : public AudioCommandData {
451 public:
452 int mEvent;
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800453 record_client_info_t mClientInfo;
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800454 struct audio_config_base mClientConfig;
455 struct audio_config_base mDeviceConfig;
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800456 audio_patch_handle_t mPatchHandle;
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800457 };
458
Mathias Agopian65ab4712010-07-14 17:59:35 -0700459 Mutex mLock;
460 Condition mWaitWorkCV;
Eric Laurent0ede8922014-05-09 18:04:42 -0700461 Vector < sp<AudioCommand> > mAudioCommands; // list of pending commands
Eric Laurent0ede8922014-05-09 18:04:42 -0700462 sp<AudioCommand> mLastCommand; // last processed command (used by dump)
Mathias Agopian65ab4712010-07-14 17:59:35 -0700463 String8 mName; // string used by wake lock fo delayed commands
Eric Laurentbfb1b832013-01-07 09:53:42 -0800464 wp<AudioPolicyService> mService;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700465 };
466
Eric Laurentdce54a12014-03-10 12:19:46 -0700467 class AudioPolicyClient : public AudioPolicyClientInterface
468 {
469 public:
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700470 explicit AudioPolicyClient(AudioPolicyService *service) : mAudioPolicyService(service) {}
Eric Laurentdce54a12014-03-10 12:19:46 -0700471 virtual ~AudioPolicyClient() {}
472
473 //
474 // Audio HW module functions
475 //
476
477 // loads a HW module.
478 virtual audio_module_handle_t loadHwModule(const char *name);
479
480 //
481 // Audio output Control functions
482 //
483
484 // opens an audio output with the requested parameters. The parameter values can indicate to use the default values
485 // in case the audio policy manager has no specific requirements for the output being opened.
486 // When the function returns, the parameter values reflect the actual values used by the audio hardware output stream.
487 // The audio policy manager can check if the proposed parameters are suitable or not and act accordingly.
Eric Laurentcf2c0212014-07-25 16:20:43 -0700488 virtual status_t openOutput(audio_module_handle_t module,
489 audio_io_handle_t *output,
490 audio_config_t *config,
491 audio_devices_t *devices,
492 const String8& address,
493 uint32_t *latencyMs,
494 audio_output_flags_t flags);
Eric Laurentdce54a12014-03-10 12:19:46 -0700495 // creates a special output that is duplicated to the two outputs passed as arguments. The duplication is performed by
496 // a special mixer thread in the AudioFlinger.
497 virtual audio_io_handle_t openDuplicateOutput(audio_io_handle_t output1, audio_io_handle_t output2);
498 // closes the output stream
499 virtual status_t closeOutput(audio_io_handle_t output);
500 // suspends the output. When an output is suspended, the corresponding audio hardware output stream is placed in
501 // standby and the AudioTracks attached to the mixer thread are still processed but the output mix is discarded.
502 virtual status_t suspendOutput(audio_io_handle_t output);
503 // restores a suspended output.
504 virtual status_t restoreOutput(audio_io_handle_t output);
505
506 //
507 // Audio input Control functions
508 //
509
510 // opens an audio input
511 virtual audio_io_handle_t openInput(audio_module_handle_t module,
Eric Laurentcf2c0212014-07-25 16:20:43 -0700512 audio_io_handle_t *input,
513 audio_config_t *config,
514 audio_devices_t *devices,
515 const String8& address,
516 audio_source_t source,
Glenn Kastenec40d282014-07-15 15:31:26 -0700517 audio_input_flags_t flags);
Eric Laurentdce54a12014-03-10 12:19:46 -0700518 // closes an audio input
519 virtual status_t closeInput(audio_io_handle_t input);
520 //
521 // misc control functions
522 //
523
524 // set a stream volume for a particular output. For the same user setting, a given stream type can have different volumes
525 // for each output (destination device) it is attached to.
526 virtual status_t setStreamVolume(audio_stream_type_t stream, float volume, audio_io_handle_t output, int delayMs = 0);
527
528 // invalidate a stream type, causing a reroute to an unspecified new output
529 virtual status_t invalidateStream(audio_stream_type_t stream);
530
531 // function enabling to send proprietary informations directly from audio policy manager to audio hardware interface.
532 virtual void setParameters(audio_io_handle_t ioHandle, const String8& keyValuePairs, int delayMs = 0);
533 // function enabling to receive proprietary informations directly from audio hardware interface to audio policy manager.
534 virtual String8 getParameters(audio_io_handle_t ioHandle, const String8& keys);
535
Eric Laurentdce54a12014-03-10 12:19:46 -0700536 // set down link audio volume.
537 virtual status_t setVoiceVolume(float volume, int delayMs = 0);
538
539 // move effect to the specified output
Glenn Kastend848eb42016-03-08 13:42:11 -0800540 virtual status_t moveEffects(audio_session_t session,
Eric Laurentdce54a12014-03-10 12:19:46 -0700541 audio_io_handle_t srcOutput,
542 audio_io_handle_t dstOutput);
543
Eric Laurent951f4552014-05-20 10:48:17 -0700544 /* Create a patch between several source and sink ports */
545 virtual status_t createAudioPatch(const struct audio_patch *patch,
546 audio_patch_handle_t *handle,
547 int delayMs);
548
549 /* Release a patch */
550 virtual status_t releaseAudioPatch(audio_patch_handle_t handle,
551 int delayMs);
552
Eric Laurente1715a42014-05-20 11:30:42 -0700553 /* Set audio port configuration */
554 virtual status_t setAudioPortConfig(const struct audio_port_config *config, int delayMs);
555
Eric Laurentb52c1522014-05-20 11:27:36 -0700556 virtual void onAudioPortListUpdate();
557 virtual void onAudioPatchListUpdate();
Jean-Michel Trivide801052015-04-14 19:10:14 -0700558 virtual void onDynamicPolicyMixStateUpdate(String8 regId, int32_t state);
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800559 virtual void onRecordingConfigurationUpdate(int event,
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800560 const record_client_info_t *clientInfo,
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800561 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800562 const audio_config_base_t *deviceConfig, audio_patch_handle_t patchHandle);
Eric Laurentb52c1522014-05-20 11:27:36 -0700563
Glenn Kasteneeecb982016-02-26 10:44:04 -0800564 virtual audio_unique_id_t newAudioUniqueId(audio_unique_id_use_t use);
Eric Laurentde3f8392014-07-27 18:38:22 -0700565
Eric Laurentdce54a12014-03-10 12:19:46 -0700566 private:
567 AudioPolicyService *mAudioPolicyService;
568 };
569
Eric Laurentb52c1522014-05-20 11:27:36 -0700570 // --- Notification Client ---
571 class NotificationClient : public IBinder::DeathRecipient {
572 public:
573 NotificationClient(const sp<AudioPolicyService>& service,
574 const sp<IAudioPolicyServiceClient>& client,
575 uid_t uid);
576 virtual ~NotificationClient();
577
Jean-Michel Trivide801052015-04-14 19:10:14 -0700578 void onAudioPortListUpdate();
579 void onAudioPatchListUpdate();
Chih-Hung Hsiehe964d4e2016-08-09 14:31:32 -0700580 void onDynamicPolicyMixStateUpdate(const String8& regId, int32_t state);
Jean-Michel Trivi2f4fe9f2015-12-04 16:20:59 -0800581 void onRecordingConfigurationUpdate(
Jean-Michel Triviac4e4292016-12-22 11:39:31 -0800582 int event, const record_client_info_t *clientInfo,
Jean-Michel Trivi7281aa92016-02-17 15:33:40 -0800583 const audio_config_base_t *clientConfig,
Jean-Michel Trivi8c7cf3b2016-02-25 17:08:24 -0800584 const audio_config_base_t *deviceConfig,
585 audio_patch_handle_t patchHandle);
Eric Laurente8726fe2015-06-26 09:39:24 -0700586 void setAudioPortCallbacksEnabled(bool enabled);
Eric Laurentb52c1522014-05-20 11:27:36 -0700587
588 // IBinder::DeathRecipient
589 virtual void binderDied(const wp<IBinder>& who);
590
591 private:
592 NotificationClient(const NotificationClient&);
593 NotificationClient& operator = (const NotificationClient&);
594
595 const wp<AudioPolicyService> mService;
596 const uid_t mUid;
597 const sp<IAudioPolicyServiceClient> mAudioPolicyServiceClient;
Eric Laurente8726fe2015-06-26 09:39:24 -0700598 bool mAudioPortCallbacksEnabled;
Eric Laurentb52c1522014-05-20 11:27:36 -0700599 };
600
Eric Laurentfee19762018-01-29 18:44:13 -0800601 // --- AudioRecordClient ---
602 // Information about each registered AudioRecord client
603 // (between calls to getInputForAttr() and releaseInput())
604 class AudioRecordClient : public RefBase {
605 public:
606 AudioRecordClient(const audio_attributes_t attributes,
607 const audio_io_handle_t input, uid_t uid, pid_t pid,
608 const String16& opPackageName, const audio_session_t session) :
609 attributes(attributes),
610 input(input), uid(uid), pid(pid),
611 opPackageName(opPackageName), session(session),
612 active(false), isConcurrent(false), isVirtualDevice(false) {}
613 virtual ~AudioRecordClient() {}
614
615 const audio_attributes_t attributes; // source, flags ...
616 const audio_io_handle_t input; // audio HAL input IO handle
617 const uid_t uid; // client UID
618 const pid_t pid; // client PID
619 const String16 opPackageName; // client package name
620 const audio_session_t session; // audio session ID
621 bool active; // Capture is active or inactive
622 bool isConcurrent; // is allowed to concurrent capture
Eric Laurent99fcae42018-05-17 16:59:18 -0700623 bool isVirtualDevice; // uses virtual device: updated by APM::getInputForAttr()
624 audio_port_handle_t deviceId; // selected input device port ID
Eric Laurentfee19762018-01-29 18:44:13 -0800625 };
626
Eric Laurent10b71232018-04-13 18:14:44 -0700627 // A class automatically clearing and restoring binder caller identity inside
628 // a code block (scoped variable)
629 // Declare one systematically before calling AudioPolicyManager methods so that they are
630 // executed with the same level of privilege as audioserver process.
631 class AutoCallerClear {
632 public:
633 AutoCallerClear() :
634 mToken(IPCThreadState::self()->clearCallingIdentity()) {}
635 ~AutoCallerClear() {
636 IPCThreadState::self()->restoreCallingIdentity(mToken);
637 }
638
639 private:
640 const int64_t mToken;
641 };
642
Mathias Agopian65ab4712010-07-14 17:59:35 -0700643 // Internal dump utilities.
644 status_t dumpPermissionDenial(int fd);
645
646
Eric Laurenteda6c362011-02-02 09:33:30 -0800647 mutable Mutex mLock; // prevents concurrent access to AudioPolicy manager functions changing
648 // device connection state or routing
Haynes Mathew Georgebab7bf42015-10-30 18:02:23 -0700649 mutable Mutex mEffectsLock; // serialize access to Effect state within APM.
650 // Note: lock acquisition order is always mLock > mEffectsLock:
651 // mLock protects AudioPolicyManager methods that can call into audio flinger
652 // and possibly back in to audio policy service and acquire mEffectsLock.
Glenn Kastene53b9ea2012-03-12 16:29:55 -0700653 sp<AudioCommandThread> mAudioCommandThread; // audio commands thread
Eric Laurentbfb1b832013-01-07 09:53:42 -0800654 sp<AudioCommandThread> mOutputCommandThread; // process stop and release output
Dima Zavinfce7a472011-04-19 22:30:36 -0700655 struct audio_policy_device *mpAudioPolicyDev;
656 struct audio_policy *mpAudioPolicy;
Eric Laurentf269b8e2014-06-09 20:01:29 -0700657 AudioPolicyInterface *mAudioPolicyManager;
Eric Laurentdce54a12014-03-10 12:19:46 -0700658 AudioPolicyClient *mAudioPolicyClient;
659
Eric Laurentb52c1522014-05-20 11:27:36 -0700660 DefaultKeyedVector< uid_t, sp<NotificationClient> > mNotificationClients;
Eric Laurent0ebd5f92014-11-19 19:04:52 -0800661 Mutex mNotificationClientsLock; // protects mNotificationClients
bryant_liuba2b4392014-06-11 16:49:30 +0800662 // Manage all effects configured in audio_effects.conf
663 sp<AudioPolicyEffects> mAudioPolicyEffects;
Eric Laurentbb6c9a02014-09-25 14:11:47 -0700664 audio_mode_t mPhoneState;
Svet Ganovf4ddfef2018-01-16 07:37:58 -0800665
666 sp<UidPolicy> mUidPolicy;
Eric Laurentfee19762018-01-29 18:44:13 -0800667 DefaultKeyedVector< audio_port_handle_t, sp<AudioRecordClient> > mAudioRecordClients;
Mathias Agopian65ab4712010-07-14 17:59:35 -0700668};
669
Mikhail Naganov1b2a7942017-12-08 10:18:09 -0800670} // namespace android
Mathias Agopian65ab4712010-07-14 17:59:35 -0700671
672#endif // ANDROID_AUDIOPOLICYSERVICE_H