Eric Laurent | c2f1f07 | 2009-07-17 12:17:14 -0700 | [diff] [blame] | 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 | #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 Laurent | baac183 | 2014-12-01 17:52:59 -0800 | [diff] [blame] | 28 | #include <media/AudioPolicy.h> |
Eric Laurent | b52c152 | 2014-05-20 11:27:36 -0700 | [diff] [blame] | 29 | #include <media/IAudioPolicyServiceClient.h> |
Eric Laurent | c2f1f07 | 2009-07-17 12:17:14 -0700 | [diff] [blame] | 30 | |
Dima Zavin | 7394a4f | 2011-06-13 18:16:26 -0700 | [diff] [blame] | 31 | #include <system/audio_policy.h> |
Eric Laurent | c2f1f07 | 2009-07-17 12:17:14 -0700 | [diff] [blame] | 32 | |
| 33 | namespace android { |
| 34 | |
| 35 | // ---------------------------------------------------------------------------- |
| 36 | |
| 37 | class IAudioPolicyService : public IInterface |
| 38 | { |
| 39 | public: |
| 40 | DECLARE_META_INTERFACE(AudioPolicyService); |
| 41 | |
| 42 | // |
| 43 | // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions) |
| 44 | // |
Dima Zavin | fce7a47 | 2011-04-19 22:30:36 -0700 | [diff] [blame] | 45 | virtual status_t setDeviceConnectionState(audio_devices_t device, |
| 46 | audio_policy_dev_state_t state, |
Paul McLean | e743a47 | 2015-01-28 11:07:31 -0800 | [diff] [blame] | 47 | const char *device_address, |
| 48 | const char *device_name) = 0; |
Dima Zavin | fce7a47 | 2011-04-19 22:30:36 -0700 | [diff] [blame] | 49 | virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device, |
Glenn Kasten | 85ab62c | 2012-11-01 11:11:38 -0700 | [diff] [blame] | 50 | const char *device_address) = 0; |
Glenn Kasten | f78aee7 | 2012-01-04 11:00:47 -0800 | [diff] [blame] | 51 | virtual status_t setPhoneState(audio_mode_t state) = 0; |
Glenn Kasten | 85ab62c | 2012-11-01 11:11:38 -0700 | [diff] [blame] | 52 | virtual status_t setForceUse(audio_policy_force_use_t usage, |
| 53 | audio_policy_forced_cfg_t config) = 0; |
Dima Zavin | fce7a47 | 2011-04-19 22:30:36 -0700 | [diff] [blame] | 54 | 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 Laurent | c2f1f07 | 2009-07-17 12:17:14 -0700 | [diff] [blame] | 56 | uint32_t samplingRate = 0, |
Glenn Kasten | 58f3021 | 2012-01-12 12:27:51 -0800 | [diff] [blame] | 57 | audio_format_t format = AUDIO_FORMAT_DEFAULT, |
Glenn Kasten | 254af18 | 2012-07-03 14:59:05 -0700 | [diff] [blame] | 58 | audio_channel_mask_t channelMask = 0, |
Richard Fitzgerald | ad3af33 | 2013-03-25 16:54:37 +0000 | [diff] [blame] | 59 | audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, |
| 60 | const audio_offload_info_t *offloadInfo = NULL) = 0; |
Eric Laurent | e83b55d | 2014-11-14 10:06:21 -0800 | [diff] [blame] | 61 | virtual status_t getOutputForAttr(const audio_attributes_t *attr, |
Glenn Kasten | d848eb4 | 2016-03-08 13:42:11 -0800 | [diff] [blame] | 62 | audio_io_handle_t *output, |
| 63 | audio_session_t session, |
| 64 | audio_stream_type_t *stream, |
| 65 | uid_t uid, |
| 66 | uint32_t samplingRate = 0, |
| 67 | audio_format_t format = AUDIO_FORMAT_DEFAULT, |
| 68 | audio_channel_mask_t channelMask = 0, |
| 69 | audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, |
| 70 | audio_port_handle_t selectedDeviceId = AUDIO_PORT_HANDLE_NONE, |
| 71 | const audio_offload_info_t *offloadInfo = NULL) = 0; |
Eric Laurent | de07013 | 2010-07-13 04:45:46 -0700 | [diff] [blame] | 72 | virtual status_t startOutput(audio_io_handle_t output, |
Dima Zavin | fce7a47 | 2011-04-19 22:30:36 -0700 | [diff] [blame] | 73 | audio_stream_type_t stream, |
Eric Laurent | e83b55d | 2014-11-14 10:06:21 -0800 | [diff] [blame] | 74 | audio_session_t session) = 0; |
Eric Laurent | de07013 | 2010-07-13 04:45:46 -0700 | [diff] [blame] | 75 | virtual status_t stopOutput(audio_io_handle_t output, |
Dima Zavin | fce7a47 | 2011-04-19 22:30:36 -0700 | [diff] [blame] | 76 | audio_stream_type_t stream, |
Eric Laurent | e83b55d | 2014-11-14 10:06:21 -0800 | [diff] [blame] | 77 | audio_session_t session) = 0; |
| 78 | virtual void releaseOutput(audio_io_handle_t output, |
| 79 | audio_stream_type_t stream, |
| 80 | audio_session_t session) = 0; |
Eric Laurent | caf7f48 | 2014-11-25 17:50:47 -0800 | [diff] [blame] | 81 | virtual status_t getInputForAttr(const audio_attributes_t *attr, |
Paul McLean | 466dc8e | 2015-04-17 13:15:36 -0600 | [diff] [blame] | 82 | audio_io_handle_t *input, |
| 83 | audio_session_t session, |
Eric Laurent | b2379ba | 2016-05-23 17:42:12 -0700 | [diff] [blame^] | 84 | pid_t pid, |
Eric Laurent | 8c7e6da | 2015-04-21 17:37:00 -0700 | [diff] [blame] | 85 | uid_t uid, |
Paul McLean | 466dc8e | 2015-04-17 13:15:36 -0600 | [diff] [blame] | 86 | uint32_t samplingRate, |
| 87 | audio_format_t format, |
| 88 | audio_channel_mask_t channelMask, |
| 89 | audio_input_flags_t flags, |
| 90 | audio_port_handle_t selectedDeviceId = AUDIO_PORT_HANDLE_NONE) = 0; |
Eric Laurent | 4dc6806 | 2014-07-28 17:26:49 -0700 | [diff] [blame] | 91 | virtual status_t startInput(audio_io_handle_t input, |
| 92 | audio_session_t session) = 0; |
| 93 | virtual status_t stopInput(audio_io_handle_t input, |
| 94 | audio_session_t session) = 0; |
| 95 | virtual void releaseInput(audio_io_handle_t input, |
| 96 | audio_session_t session) = 0; |
Dima Zavin | fce7a47 | 2011-04-19 22:30:36 -0700 | [diff] [blame] | 97 | virtual status_t initStreamVolume(audio_stream_type_t stream, |
Eric Laurent | c2f1f07 | 2009-07-17 12:17:14 -0700 | [diff] [blame] | 98 | int indexMin, |
| 99 | int indexMax) = 0; |
Eric Laurent | 83844cc | 2011-11-18 16:43:31 -0800 | [diff] [blame] | 100 | virtual status_t setStreamVolumeIndex(audio_stream_type_t stream, |
| 101 | int index, |
| 102 | audio_devices_t device) = 0; |
| 103 | virtual status_t getStreamVolumeIndex(audio_stream_type_t stream, |
| 104 | int *index, |
| 105 | audio_devices_t device) = 0; |
Dima Zavin | fce7a47 | 2011-04-19 22:30:36 -0700 | [diff] [blame] | 106 | virtual uint32_t getStrategyForStream(audio_stream_type_t stream) = 0; |
Eric Laurent | 6374252 | 2012-03-08 13:42:42 -0800 | [diff] [blame] | 107 | virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream) = 0; |
Glenn Kasten | 58e5aa3 | 2012-06-20 14:08:14 -0700 | [diff] [blame] | 108 | virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc) = 0; |
| 109 | virtual status_t registerEffect(const effect_descriptor_t *desc, |
Eric Laurent | 7c7f10b | 2011-06-17 21:29:58 -0700 | [diff] [blame] | 110 | audio_io_handle_t io, |
Eric Laurent | de07013 | 2010-07-13 04:45:46 -0700 | [diff] [blame] | 111 | uint32_t strategy, |
Glenn Kasten | d848eb4 | 2016-03-08 13:42:11 -0800 | [diff] [blame] | 112 | audio_session_t session, |
Eric Laurent | de07013 | 2010-07-13 04:45:46 -0700 | [diff] [blame] | 113 | int id) = 0; |
| 114 | virtual status_t unregisterEffect(int id) = 0; |
Eric Laurent | db7c079 | 2011-08-10 10:37:50 -0700 | [diff] [blame] | 115 | virtual status_t setEffectEnabled(int id, bool enabled) = 0; |
Glenn Kasten | fff6d71 | 2012-01-12 16:38:12 -0800 | [diff] [blame] | 116 | virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const = 0; |
Jean-Michel Trivi | 272ab54 | 2013-02-04 16:26:02 -0800 | [diff] [blame] | 117 | virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) |
| 118 | const = 0; |
Jean-Michel Trivi | d708603 | 2012-10-10 12:11:16 -0700 | [diff] [blame] | 119 | virtual bool isSourceActive(audio_source_t source) const = 0; |
Glenn Kasten | d848eb4 | 2016-03-08 13:42:11 -0800 | [diff] [blame] | 120 | virtual status_t queryDefaultPreProcessing(audio_session_t audioSession, |
Eric Laurent | 57dae99 | 2011-07-24 13:36:09 -0700 | [diff] [blame] | 121 | effect_descriptor_t *descriptors, |
| 122 | uint32_t *count) = 0; |
Richard Fitzgerald | ad3af33 | 2013-03-25 16:54:37 +0000 | [diff] [blame] | 123 | // Check if offload is possible for given format, stream type, sample rate, |
| 124 | // bit rate, duration, video and streaming or offload property is enabled |
| 125 | virtual bool isOffloadSupported(const audio_offload_info_t& info) = 0; |
Eric Laurent | 203b1a1 | 2014-04-01 10:34:16 -0700 | [diff] [blame] | 126 | |
| 127 | /* List available audio ports and their attributes */ |
| 128 | virtual status_t listAudioPorts(audio_port_role_t role, |
| 129 | audio_port_type_t type, |
| 130 | unsigned int *num_ports, |
| 131 | struct audio_port *ports, |
| 132 | unsigned int *generation) = 0; |
| 133 | |
| 134 | /* Get attributes for a given audio port */ |
| 135 | virtual status_t getAudioPort(struct audio_port *port) = 0; |
| 136 | |
| 137 | /* Create an audio patch between several source and sink ports */ |
| 138 | virtual status_t createAudioPatch(const struct audio_patch *patch, |
| 139 | audio_patch_handle_t *handle) = 0; |
| 140 | |
| 141 | /* Release an audio patch */ |
| 142 | virtual status_t releaseAudioPatch(audio_patch_handle_t handle) = 0; |
| 143 | |
| 144 | /* List existing audio patches */ |
| 145 | virtual status_t listAudioPatches(unsigned int *num_patches, |
| 146 | struct audio_patch *patches, |
| 147 | unsigned int *generation) = 0; |
| 148 | /* Set audio port configuration */ |
| 149 | virtual status_t setAudioPortConfig(const struct audio_port_config *config) = 0; |
| 150 | |
Eric Laurent | b52c152 | 2014-05-20 11:27:36 -0700 | [diff] [blame] | 151 | virtual void registerClient(const sp<IAudioPolicyServiceClient>& client) = 0; |
Eric Laurent | df3dc7e | 2014-07-27 18:39:40 -0700 | [diff] [blame] | 152 | |
Eric Laurent | e8726fe | 2015-06-26 09:39:24 -0700 | [diff] [blame] | 153 | virtual void setAudioPortCallbacksEnabled(bool enabled) = 0; |
| 154 | |
Eric Laurent | df3dc7e | 2014-07-27 18:39:40 -0700 | [diff] [blame] | 155 | virtual status_t acquireSoundTriggerSession(audio_session_t *session, |
| 156 | audio_io_handle_t *ioHandle, |
| 157 | audio_devices_t *device) = 0; |
| 158 | |
| 159 | virtual status_t releaseSoundTriggerSession(audio_session_t session) = 0; |
Eric Laurent | bb6c9a0 | 2014-09-25 14:11:47 -0700 | [diff] [blame] | 160 | |
| 161 | virtual audio_mode_t getPhoneState() = 0; |
Eric Laurent | baac183 | 2014-12-01 17:52:59 -0800 | [diff] [blame] | 162 | |
| 163 | virtual status_t registerPolicyMixes(Vector<AudioMix> mixes, bool registration) = 0; |
Eric Laurent | 554a277 | 2015-04-10 11:29:24 -0700 | [diff] [blame] | 164 | |
| 165 | virtual status_t startAudioSource(const struct audio_port_config *source, |
| 166 | const audio_attributes_t *attributes, |
| 167 | audio_io_handle_t *handle) = 0; |
| 168 | virtual status_t stopAudioSource(audio_io_handle_t handle) = 0; |
Andy Hung | 2ddee19 | 2015-12-18 17:34:44 -0800 | [diff] [blame] | 169 | |
| 170 | virtual status_t setMasterMono(bool mono) = 0; |
| 171 | virtual status_t getMasterMono(bool *mono) = 0; |
Eric Laurent | c2f1f07 | 2009-07-17 12:17:14 -0700 | [diff] [blame] | 172 | }; |
| 173 | |
| 174 | |
| 175 | // ---------------------------------------------------------------------------- |
| 176 | |
| 177 | class BnAudioPolicyService : public BnInterface<IAudioPolicyService> |
| 178 | { |
| 179 | public: |
| 180 | virtual status_t onTransact( uint32_t code, |
| 181 | const Parcel& data, |
| 182 | Parcel* reply, |
| 183 | uint32_t flags = 0); |
| 184 | }; |
| 185 | |
| 186 | // ---------------------------------------------------------------------------- |
| 187 | |
| 188 | }; // namespace android |
| 189 | |
| 190 | #endif // ANDROID_IAUDIOPOLICYSERVICE_H |