IAudioPolicyService.h revision df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871
1c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent/* 2c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Copyright (C) 2009 The Android Open Source Project 3c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 4c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Licensed under the Apache License, Version 2.0 (the "License"); 5c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * you may not use this file except in compliance with the License. 6c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * You may obtain a copy of the License at 7c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 8c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * http://www.apache.org/licenses/LICENSE-2.0 9c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 10c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Unless required by applicable law or agreed to in writing, software 11c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * distributed under the License is distributed on an "AS IS" BASIS, 12c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * See the License for the specific language governing permissions and 14c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * limitations under the License. 15c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent */ 16c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 17c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#ifndef ANDROID_IAUDIOPOLICYSERVICE_H 18c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#define ANDROID_IAUDIOPOLICYSERVICE_H 19c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 20c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <stdint.h> 21c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <sys/types.h> 22c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <unistd.h> 23c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 24c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <utils/RefBase.h> 25c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <utils/Errors.h> 26c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <binder/IInterface.h> 27c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <media/AudioSystem.h> 28b52c152d553556b2d227ffc943489de0c60b4b02Eric Laurent#include <media/IAudioPolicyServiceClient.h> 29c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 307394a4f358fa9908a9f0a7c954b65c399f4268e6Dima Zavin#include <system/audio_policy.h> 31c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 32c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentnamespace android { 33c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 34c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent// ---------------------------------------------------------------------------- 35c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 36c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass IAudioPolicyService : public IInterface 37c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent{ 38c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentpublic: 39c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DECLARE_META_INTERFACE(AudioPolicyService); 40c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 41c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 42c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions) 43c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 44fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual status_t setDeviceConnectionState(audio_devices_t device, 45fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin audio_policy_dev_state_t state, 46c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent const char *device_address) = 0; 47fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device, 4885ab62c4b433df3f1a9826bed1c9bec07a86c750Glenn Kasten const char *device_address) = 0; 49f78aee70d15daf4690de7e7b4983ee68b0d1381dGlenn Kasten virtual status_t setPhoneState(audio_mode_t state) = 0; 5085ab62c4b433df3f1a9826bed1c9bec07a86c750Glenn Kasten virtual status_t setForceUse(audio_policy_force_use_t usage, 5185ab62c4b433df3f1a9826bed1c9bec07a86c750Glenn Kasten audio_policy_forced_cfg_t config) = 0; 52fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage) = 0; 53fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual audio_io_handle_t getOutput(audio_stream_type_t stream, 54c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate = 0, 5558f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t format = AUDIO_FORMAT_DEFAULT, 56254af180475346b6186b49c297f340c9c4817511Glenn Kasten audio_channel_mask_t channelMask = 0, 57ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, 58ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald const audio_offload_info_t *offloadInfo = NULL) = 0; 595bd3f38638acab633d181359cc9ec27b80f84d43Jean-Michel Trivi virtual audio_io_handle_t getOutputForAttr(const audio_attributes_t *attr, 605bd3f38638acab633d181359cc9ec27b80f84d43Jean-Michel Trivi uint32_t samplingRate = 0, 615bd3f38638acab633d181359cc9ec27b80f84d43Jean-Michel Trivi audio_format_t format = AUDIO_FORMAT_DEFAULT, 625bd3f38638acab633d181359cc9ec27b80f84d43Jean-Michel Trivi audio_channel_mask_t channelMask = 0, 635bd3f38638acab633d181359cc9ec27b80f84d43Jean-Michel Trivi audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, 645bd3f38638acab633d181359cc9ec27b80f84d43Jean-Michel Trivi const audio_offload_info_t *offloadInfo = NULL) = 0; 65de070137f11d346fba77605bd76a44c040a618fcEric Laurent virtual status_t startOutput(audio_io_handle_t output, 66fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin audio_stream_type_t stream, 67de070137f11d346fba77605bd76a44c040a618fcEric Laurent int session = 0) = 0; 68de070137f11d346fba77605bd76a44c040a618fcEric Laurent virtual status_t stopOutput(audio_io_handle_t output, 69fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin audio_stream_type_t stream, 70de070137f11d346fba77605bd76a44c040a618fcEric Laurent int session = 0) = 0; 71c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual void releaseOutput(audio_io_handle_t output) = 0; 72eba51fb3a361f67a6a64d5a16eba6084fe27d60eGlenn Kasten virtual audio_io_handle_t getInput(audio_source_t inputSource, 73b3b1660ecb67f61f9da54efced8677fa3a6f4863Glenn Kasten uint32_t samplingRate, 74b3b1660ecb67f61f9da54efced8677fa3a6f4863Glenn Kasten audio_format_t format, 75b3b1660ecb67f61f9da54efced8677fa3a6f4863Glenn Kasten audio_channel_mask_t channelMask, 76b3b1660ecb67f61f9da54efced8677fa3a6f4863Glenn Kasten int audioSession, 77b3b1660ecb67f61f9da54efced8677fa3a6f4863Glenn Kasten audio_input_flags_t flags) = 0; 784dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent virtual status_t startInput(audio_io_handle_t input, 794dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent audio_session_t session) = 0; 804dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent virtual status_t stopInput(audio_io_handle_t input, 814dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent audio_session_t session) = 0; 824dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent virtual void releaseInput(audio_io_handle_t input, 834dc680607181e6a76f4e91a39366c4f5dfb7b03eEric Laurent audio_session_t session) = 0; 84fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual status_t initStreamVolume(audio_stream_type_t stream, 85c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMin, 86c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMax) = 0; 8783844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent virtual status_t setStreamVolumeIndex(audio_stream_type_t stream, 8883844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent int index, 8983844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent audio_devices_t device) = 0; 9083844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent virtual status_t getStreamVolumeIndex(audio_stream_type_t stream, 9183844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent int *index, 9283844cc2f95dc279015b47fd1e18c7cb4eabe9a1Eric Laurent audio_devices_t device) = 0; 93fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin virtual uint32_t getStrategyForStream(audio_stream_type_t stream) = 0; 946374252107fd6539397598195ea6defd5870fafbEric Laurent virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream) = 0; 9558e5aa34f01d663654d8bafad65db1dda42161ffGlenn Kasten virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc) = 0; 9658e5aa34f01d663654d8bafad65db1dda42161ffGlenn Kasten virtual status_t registerEffect(const effect_descriptor_t *desc, 977c7f10bd4fda9a084e5e7f0eb3a040dfcbf01745Eric Laurent audio_io_handle_t io, 98de070137f11d346fba77605bd76a44c040a618fcEric Laurent uint32_t strategy, 99de070137f11d346fba77605bd76a44c040a618fcEric Laurent int session, 100de070137f11d346fba77605bd76a44c040a618fcEric Laurent int id) = 0; 101de070137f11d346fba77605bd76a44c040a618fcEric Laurent virtual status_t unregisterEffect(int id) = 0; 102db7c079f284f6e91266f6653ae0ec198b1c5006eEric Laurent virtual status_t setEffectEnabled(int id, bool enabled) = 0; 103fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual bool isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const = 0; 104272ab546940054ad7991bef4b3a36f15175721cdJean-Michel Trivi virtual bool isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0) 105272ab546940054ad7991bef4b3a36f15175721cdJean-Michel Trivi const = 0; 106d7086030fcf731e4bcef6c033cc6418cd04e6b91Jean-Michel Trivi virtual bool isSourceActive(audio_source_t source) const = 0; 10757dae99c9fcd6becd2b5ed0c53f277ba4d7dbcfcEric Laurent virtual status_t queryDefaultPreProcessing(int audioSession, 10857dae99c9fcd6becd2b5ed0c53f277ba4d7dbcfcEric Laurent effect_descriptor_t *descriptors, 10957dae99c9fcd6becd2b5ed0c53f277ba4d7dbcfcEric Laurent uint32_t *count) = 0; 110ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald // Check if offload is possible for given format, stream type, sample rate, 111ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald // bit rate, duration, video and streaming or offload property is enabled 112ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald virtual bool isOffloadSupported(const audio_offload_info_t& info) = 0; 113203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 114203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* List available audio ports and their attributes */ 115203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t listAudioPorts(audio_port_role_t role, 116203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent audio_port_type_t type, 117203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent unsigned int *num_ports, 118203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent struct audio_port *ports, 119203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent unsigned int *generation) = 0; 120203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 121203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Get attributes for a given audio port */ 122203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t getAudioPort(struct audio_port *port) = 0; 123203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 124203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Create an audio patch between several source and sink ports */ 125203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t createAudioPatch(const struct audio_patch *patch, 126203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent audio_patch_handle_t *handle) = 0; 127203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 128203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Release an audio patch */ 129203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t releaseAudioPatch(audio_patch_handle_t handle) = 0; 130203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 131203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* List existing audio patches */ 132203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t listAudioPatches(unsigned int *num_patches, 133203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent struct audio_patch *patches, 134203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent unsigned int *generation) = 0; 135203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent /* Set audio port configuration */ 136203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent virtual status_t setAudioPortConfig(const struct audio_port_config *config) = 0; 137203b1a18a806e2c56c701aac49cda963bccfad5bEric Laurent 138b52c152d553556b2d227ffc943489de0c60b4b02Eric Laurent virtual void registerClient(const sp<IAudioPolicyServiceClient>& client) = 0; 139df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent 140df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent virtual status_t acquireSoundTriggerSession(audio_session_t *session, 141df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent audio_io_handle_t *ioHandle, 142df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent audio_devices_t *device) = 0; 143df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent 144df3dc7e2fe6c639529b70e3f3a7d2bf0f4c6e871Eric Laurent virtual status_t releaseSoundTriggerSession(audio_session_t session) = 0; 145c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; 146c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 147c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 148c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent// ---------------------------------------------------------------------------- 149c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 150c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass BnAudioPolicyService : public BnInterface<IAudioPolicyService> 151c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent{ 152c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentpublic: 153c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t onTransact( uint32_t code, 154c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent const Parcel& data, 155c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent Parcel* reply, 156c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t flags = 0); 157c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; 158c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 159c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent// ---------------------------------------------------------------------------- 160c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 161c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; // namespace android 162c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 163c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#endif // ANDROID_IAUDIOPOLICYSERVICE_H 164