IAudioFlinger.h revision 58f30210ea540b6ce5aa6a46330cd3499483cb97
189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project/* 289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * you may not use this file except in compliance with the License. 689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * You may obtain a copy of the License at 789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 1089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 1189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 1289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * See the License for the specific language governing permissions and 1489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * limitations under the License. 1589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 1689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 1789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#ifndef ANDROID_IAUDIOFLINGER_H 1889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#define ANDROID_IAUDIOFLINGER_H 1989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <stdint.h> 2189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <sys/types.h> 2289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <unistd.h> 2389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/RefBase.h> 2589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/Errors.h> 267562408b2261d38415453378b6188f74fda99d88Mathias Agopian#include <binder/IInterface.h> 2789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <media/IAudioTrack.h> 2889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <media/IAudioRecord.h> 2989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <media/IAudioFlingerClient.h> 30e1315cf0b63b4c14a77046519e6b01f6f60d74b0Eric Laurent#include <hardware/audio_effect.h> 31be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent#include <media/IEffect.h> 32be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent#include <media/IEffectClient.h> 33c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <utils/String8.h> 3489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectnamespace android { 3689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 3889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass IAudioFlinger : public IInterface 4089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 4189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 4289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project DECLARE_META_INTERFACE(AudioFlinger); 4389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 4489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* create an audio track and registers it with AudioFlinger. 4589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * return null if the track cannot be created. 4689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 4789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual sp<IAudioTrack> createTrack( 4889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project pid_t pid, 49fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten audio_stream_type_t streamType, 5089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate, 5158f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t format, 520d255b2d9061ba31f13ada3fc0f7e51916407176Jean-Michel Trivi uint32_t channelMask, 5389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount, 5489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags, 5589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const sp<IMemory>& sharedBuffer, 56fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent int output, 57be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *sessionId, 5889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t *status) = 0; 5989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 6089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual sp<IAudioRecord> openRecord( 6189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project pid_t pid, 62fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent int input, 6389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate, 6458f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t format, 650d255b2d9061ba31f13ada3fc0f7e51916407176Jean-Michel Trivi uint32_t channelMask, 6689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount, 6789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags, 68be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *sessionId, 6989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t *status) = 0; 7089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 7189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* query the audio hardware state. This state never changes, 7289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * and therefore can be cached. 7389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 74fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual uint32_t sampleRate(int output) const = 0; 75fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int channelCount(int output) const = 0; 7658f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten virtual audio_format_t format(int output) const = 0; 77fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual size_t frameCount(int output) const = 0; 78fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual uint32_t latency(int output) const = 0; 7989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* set/get the audio hardware state. This will probably be used by 8189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * the preference panel, mostly. 8289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 8389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMasterVolume(float value) = 0; 8489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMasterMute(bool muted) = 0; 8589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual float masterVolume() const = 0; 8789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool masterMute() const = 0; 8889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* set/get stream type state. This will probably be used by 9089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * the preference panel, mostly. 9189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 92fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual status_t setStreamVolume(audio_stream_type_t stream, float value, int output) = 0; 93fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual status_t setStreamMute(audio_stream_type_t stream, bool muted) = 0; 9489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 95fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual float streamVolume(audio_stream_type_t stream, int output) const = 0; 96fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual bool streamMute(audio_stream_type_t stream) const = 0; 9789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 98c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set audio mode 99f78aee70d15daf4690de7e7b4983ee68b0d1381dGlenn Kasten virtual status_t setMode(audio_mode_t mode) = 0; 10089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 10189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // mic mute/state 10289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMicMute(bool state) = 0; 10389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool getMicMute() const = 0; 10489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 105fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t setParameters(int ioHandle, const String8& keyValuePairs) = 0; 106fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual String8 getParameters(int ioHandle, const String8& keys) = 0; 107f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 10889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // register a current process for audio output change notifications 10989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void registerClient(const sp<IAudioFlingerClient>& client) = 0; 110f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 11189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // retrieve the audio recording buffer size 11258f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten virtual size_t getInputBufferSize(uint32_t sampleRate, audio_format_t format, int channelCount) = 0; 11389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 114fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int openOutput(uint32_t *pDevices, 115c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 11658f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t *pFormat, 117c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 118c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pLatencyMs, 119c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t flags) = 0; 120fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int openDuplicateOutput(int output1, int output2) = 0; 121fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t closeOutput(int output) = 0; 122fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t suspendOutput(int output) = 0; 123fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t restoreOutput(int output) = 0; 124c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 125fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int openInput(uint32_t *pDevices, 126c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 12758f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t *pFormat, 128c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 129c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t acoustics) = 0; 130fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t closeInput(int input) = 0; 131c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 132fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual status_t setStreamOutput(audio_stream_type_t stream, int output) = 0; 133f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 134f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent virtual status_t setVoiceVolume(float volume) = 0; 13505bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent 136342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent virtual status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames, int output) = 0; 13705bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent 13805bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent virtual unsigned int getInputFramesLost(int ioHandle) = 0; 139be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 140be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual int newAudioSessionId() = 0; 141be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 1423a34befc6fb04a4945a849e8bda8b84e4bf973feMarco Nelissen virtual void acquireAudioSessionId(int audioSession) = 0; 1433a34befc6fb04a4945a849e8bda8b84e4bf973feMarco Nelissen virtual void releaseAudioSessionId(int audioSession) = 0; 1443a34befc6fb04a4945a849e8bda8b84e4bf973feMarco Nelissen 145be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t queryNumberEffects(uint32_t *numEffects) = 0; 146be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 147ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent virtual status_t queryEffect(uint32_t index, effect_descriptor_t *pDescriptor) = 0; 148be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 149be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t getEffectDescriptor(effect_uuid_t *pEffectUUID, effect_descriptor_t *pDescriptor) = 0; 150be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 151be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual sp<IEffect> createEffect(pid_t pid, 152be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent effect_descriptor_t *pDesc, 153be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent const sp<IEffectClient>& client, 154be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int32_t priority, 155be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int output, 156be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int sessionId, 157be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent status_t *status, 158be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *id, 159be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *enabled) = 0; 160de070137f11d346fba77605bd76a44c040a618fcEric Laurent 161de070137f11d346fba77605bd76a44c040a618fcEric Laurent virtual status_t moveEffects(int session, int srcOutput, int dstOutput) = 0; 16289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 16389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 16489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 16589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 16689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 16789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass BnAudioFlinger : public BnInterface<IAudioFlinger> 16889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 16989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 17089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t onTransact( uint32_t code, 17189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const Parcel& data, 17289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project Parcel* reply, 17389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags = 0); 17489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 17589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 17689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 17789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 17889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 17989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 18089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif // ANDROID_IAUDIOFLINGER_H 181