blob: 413267b16b044db9bd628952442aa92f01933ccf [file] [log] [blame]
Eric Laurentc2f1f072009-07-17 12:17:14 -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_IAUDIOPOLICYSERVICE_H
18#define ANDROID_IAUDIOPOLICYSERVICE_H
19
20#include <stdint.h>
21#include <sys/types.h>
22#include <unistd.h>
23
24#include <utils/RefBase.h>
25#include <utils/Errors.h>
26#include <binder/IInterface.h>
27#include <media/AudioSystem.h>
Eric Laurentbaac1832014-12-01 17:52:59 -080028#include <media/AudioPolicy.h>
Eric Laurentb52c1522014-05-20 11:27:36 -070029#include <media/IAudioPolicyServiceClient.h>
Eric Laurentc2f1f072009-07-17 12:17:14 -070030
Dima Zavin7394a4f2011-06-13 18:16:26 -070031#include <system/audio_policy.h>
Eric Laurentc2f1f072009-07-17 12:17:14 -070032
33namespace android {
34
35// ----------------------------------------------------------------------------
36
37class IAudioPolicyService : public IInterface
38{
39public:
40 DECLARE_META_INTERFACE(AudioPolicyService);
41
42 //
43 // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions)
44 //
Dima Zavinfce7a472011-04-19 22:30:36 -070045 virtual status_t setDeviceConnectionState(audio_devices_t device,
46 audio_policy_dev_state_t state,
Paul McLeane743a472015-01-28 11:07:31 -080047 const char *device_address,
48 const char *device_name) = 0;
Dima Zavinfce7a472011-04-19 22:30:36 -070049 virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device,
Glenn Kasten85ab62c2012-11-01 11:11:38 -070050 const char *device_address) = 0;
Glenn Kastenf78aee72012-01-04 11:00:47 -080051 virtual status_t setPhoneState(audio_mode_t state) = 0;
Glenn Kasten85ab62c2012-11-01 11:11:38 -070052 virtual status_t setForceUse(audio_policy_force_use_t usage,
53 audio_policy_forced_cfg_t config) = 0;
Dima Zavinfce7a472011-04-19 22:30:36 -070054 virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage) = 0;
55 virtual audio_io_handle_t getOutput(audio_stream_type_t stream,
Eric Laurentc2f1f072009-07-17 12:17:14 -070056 uint32_t samplingRate = 0,
Glenn Kasten58f30212012-01-12 12:27:51 -080057 audio_format_t format = AUDIO_FORMAT_DEFAULT,
Glenn Kasten254af182012-07-03 14:59:05 -070058 audio_channel_mask_t channelMask = 0,
Richard Fitzgeraldad3af332013-03-25 16:54:37 +000059 audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE,
60 const audio_offload_info_t *offloadInfo = NULL) = 0;
Eric Laurente83b55d2014-11-14 10:06:21 -080061 virtual status_t getOutputForAttr(const audio_attributes_t *attr,
62 audio_io_handle_t *output,
63 audio_session_t session,
64 audio_stream_type_t *stream,
65 uint32_t samplingRate = 0,
66 audio_format_t format = AUDIO_FORMAT_DEFAULT,
67 audio_channel_mask_t channelMask = 0,
68 audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE,
Paul McLeanaa981192015-03-21 09:55:15 -070069 audio_port_handle_t selectedDeviceId = AUDIO_PORT_HANDLE_NONE,
Eric Laurente83b55d2014-11-14 10:06:21 -080070 const audio_offload_info_t *offloadInfo = NULL) = 0;
Eric Laurentde070132010-07-13 04:45:46 -070071 virtual status_t startOutput(audio_io_handle_t output,
Dima Zavinfce7a472011-04-19 22:30:36 -070072 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -080073 audio_session_t session) = 0;
Eric Laurentde070132010-07-13 04:45:46 -070074 virtual status_t stopOutput(audio_io_handle_t output,
Dima Zavinfce7a472011-04-19 22:30:36 -070075 audio_stream_type_t stream,
Eric Laurente83b55d2014-11-14 10:06:21 -080076 audio_session_t session) = 0;
77 virtual void releaseOutput(audio_io_handle_t output,
78 audio_stream_type_t stream,
79 audio_session_t session) = 0;
Eric Laurentcaf7f482014-11-25 17:50:47 -080080 virtual status_t getInputForAttr(const audio_attributes_t *attr,
81 audio_io_handle_t *input,
82 audio_session_t session,
83 uint32_t samplingRate,
84 audio_format_t format,
85 audio_channel_mask_t channelMask,
86 audio_input_flags_t flags) = 0;
Eric Laurent4dc68062014-07-28 17:26:49 -070087 virtual status_t startInput(audio_io_handle_t input,
88 audio_session_t session) = 0;
89 virtual status_t stopInput(audio_io_handle_t input,
90 audio_session_t session) = 0;
91 virtual void releaseInput(audio_io_handle_t input,
92 audio_session_t session) = 0;
Dima Zavinfce7a472011-04-19 22:30:36 -070093 virtual status_t initStreamVolume(audio_stream_type_t stream,
Eric Laurentc2f1f072009-07-17 12:17:14 -070094 int indexMin,
95 int indexMax) = 0;
Eric Laurent83844cc2011-11-18 16:43:31 -080096 virtual status_t setStreamVolumeIndex(audio_stream_type_t stream,
97 int index,
98 audio_devices_t device) = 0;
99 virtual status_t getStreamVolumeIndex(audio_stream_type_t stream,
100 int *index,
101 audio_devices_t device) = 0;
Dima Zavinfce7a472011-04-19 22:30:36 -0700102 virtual uint32_t getStrategyForStream(audio_stream_type_t stream) = 0;
Eric Laurent63742522012-03-08 13:42:42 -0800103 virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream) = 0;
Glenn Kasten58e5aa32012-06-20 14:08:14 -0700104 virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc) = 0;
105 virtual status_t registerEffect(const effect_descriptor_t *desc,
Eric Laurent7c7f10b2011-06-17 21:29:58 -0700106 audio_io_handle_t io,
Eric Laurentde070132010-07-13 04:45:46 -0700107 uint32_t strategy,
108 int session,
109 int id) = 0;
110 virtual status_t unregisterEffect(int id) = 0;
Eric Laurentdb7c0792011-08-10 10:37:50 -0700111 virtual status_t setEffectEnabled(int id, bool enabled) = 0;
Glenn Kastenfff6d712012-01-12 16:38:12 -0800112 virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const = 0;
Jean-Michel Trivi272ab542013-02-04 16:26:02 -0800113 virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0)
114 const = 0;
Jean-Michel Trivid7086032012-10-10 12:11:16 -0700115 virtual bool isSourceActive(audio_source_t source) const = 0;
Eric Laurent57dae992011-07-24 13:36:09 -0700116 virtual status_t queryDefaultPreProcessing(int audioSession,
117 effect_descriptor_t *descriptors,
118 uint32_t *count) = 0;
Richard Fitzgeraldad3af332013-03-25 16:54:37 +0000119 // Check if offload is possible for given format, stream type, sample rate,
120 // bit rate, duration, video and streaming or offload property is enabled
121 virtual bool isOffloadSupported(const audio_offload_info_t& info) = 0;
Eric Laurent203b1a12014-04-01 10:34:16 -0700122
123 /* List available audio ports and their attributes */
124 virtual status_t listAudioPorts(audio_port_role_t role,
125 audio_port_type_t type,
126 unsigned int *num_ports,
127 struct audio_port *ports,
128 unsigned int *generation) = 0;
129
130 /* Get attributes for a given audio port */
131 virtual status_t getAudioPort(struct audio_port *port) = 0;
132
133 /* Create an audio patch between several source and sink ports */
134 virtual status_t createAudioPatch(const struct audio_patch *patch,
135 audio_patch_handle_t *handle) = 0;
136
137 /* Release an audio patch */
138 virtual status_t releaseAudioPatch(audio_patch_handle_t handle) = 0;
139
140 /* List existing audio patches */
141 virtual status_t listAudioPatches(unsigned int *num_patches,
142 struct audio_patch *patches,
143 unsigned int *generation) = 0;
144 /* Set audio port configuration */
145 virtual status_t setAudioPortConfig(const struct audio_port_config *config) = 0;
146
Eric Laurentb52c1522014-05-20 11:27:36 -0700147 virtual void registerClient(const sp<IAudioPolicyServiceClient>& client) = 0;
Eric Laurentdf3dc7e2014-07-27 18:39:40 -0700148
149 virtual status_t acquireSoundTriggerSession(audio_session_t *session,
150 audio_io_handle_t *ioHandle,
151 audio_devices_t *device) = 0;
152
153 virtual status_t releaseSoundTriggerSession(audio_session_t session) = 0;
Eric Laurentbb6c9a02014-09-25 14:11:47 -0700154
155 virtual audio_mode_t getPhoneState() = 0;
Eric Laurentbaac1832014-12-01 17:52:59 -0800156
157 virtual status_t registerPolicyMixes(Vector<AudioMix> mixes, bool registration) = 0;
Eric Laurent554a2772015-04-10 11:29:24 -0700158
159 virtual status_t startAudioSource(const struct audio_port_config *source,
160 const audio_attributes_t *attributes,
161 audio_io_handle_t *handle) = 0;
162 virtual status_t stopAudioSource(audio_io_handle_t handle) = 0;
Eric Laurentc2f1f072009-07-17 12:17:14 -0700163};
164
165
166// ----------------------------------------------------------------------------
167
168class BnAudioPolicyService : public BnInterface<IAudioPolicyService>
169{
170public:
171 virtual status_t onTransact( uint32_t code,
172 const Parcel& data,
173 Parcel* reply,
174 uint32_t flags = 0);
175};
176
177// ----------------------------------------------------------------------------
178
179}; // namespace android
180
181#endif // ANDROID_IAUDIOPOLICYSERVICE_H