IAudioFlinger.h revision 688aac7675f18bdd7bff13334759e20bc4e6c390
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> 3072ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten#include <system/audio.h> 31e1315cf0b63b4c14a77046519e6b01f6f60d74b0Eric Laurent#include <hardware/audio_effect.h> 32be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent#include <media/IEffect.h> 33be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent#include <media/IEffectClient.h> 34c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <utils/String8.h> 3589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectnamespace android { 3789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 3989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 4089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass IAudioFlinger : public IInterface 4189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 4289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 4389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project DECLARE_META_INTERFACE(AudioFlinger); 4489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 4589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* create an audio track and registers it with AudioFlinger. 4689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * return null if the track cannot be created. 4789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 4889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual sp<IAudioTrack> createTrack( 4989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project pid_t pid, 50fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten audio_stream_type_t streamType, 5189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate, 5258f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t format, 530d255b2d9061ba31f13ada3fc0f7e51916407176Jean-Michel Trivi uint32_t channelMask, 5489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount, 5589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags, 5689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const sp<IMemory>& sharedBuffer, 5772ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t output, 584ff14bae91075eb274eb1c2975982358946e7e63John Grossman bool isTimed, 59be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *sessionId, 6089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t *status) = 0; 6189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 6289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual sp<IAudioRecord> openRecord( 6389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project pid_t pid, 6472ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t input, 6589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate, 6658f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t format, 670d255b2d9061ba31f13ada3fc0f7e51916407176Jean-Michel Trivi uint32_t channelMask, 6889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount, 6989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags, 70be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *sessionId, 7189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t *status) = 0; 7289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 7389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* query the audio hardware state. This state never changes, 7489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * and therefore can be cached. 7589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 7672ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual uint32_t sampleRate(audio_io_handle_t output) const = 0; 7772ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual int channelCount(audio_io_handle_t output) const = 0; 7872ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual audio_format_t format(audio_io_handle_t output) const = 0; 7972ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual size_t frameCount(audio_io_handle_t output) const = 0; 80688aac7675f18bdd7bff13334759e20bc4e6c390Glenn Kasten 81688aac7675f18bdd7bff13334759e20bc4e6c390Glenn Kasten // return estimated latency in milliseconds 8272ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual uint32_t latency(audio_io_handle_t output) const = 0; 8389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* set/get the audio hardware state. This will probably be used by 8589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * the preference panel, mostly. 8689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 8789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMasterVolume(float value) = 0; 8889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMasterMute(bool muted) = 0; 8989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 9089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual float masterVolume() const = 0; 9189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool masterMute() const = 0; 9289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 9389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* set/get stream type state. This will probably be used by 9489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * the preference panel, mostly. 9589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 9672ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t setStreamVolume(audio_stream_type_t stream, float value, 9772ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t output) = 0; 98fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual status_t setStreamMute(audio_stream_type_t stream, bool muted) = 0; 9989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 10072ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual float streamVolume(audio_stream_type_t stream, 10172ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t output) const = 0; 102fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten virtual bool streamMute(audio_stream_type_t stream) const = 0; 10389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 104c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set audio mode 105f78aee70d15daf4690de7e7b4983ee68b0d1381dGlenn Kasten virtual status_t setMode(audio_mode_t mode) = 0; 10689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 10789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // mic mute/state 10889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMicMute(bool state) = 0; 10989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool getMicMute() const = 0; 11089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 11172ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t setParameters(audio_io_handle_t ioHandle, 11272ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten const String8& keyValuePairs) = 0; 11372ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual String8 getParameters(audio_io_handle_t ioHandle, const String8& keys) const = 0; 114f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 11589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // register a current process for audio output change notifications 11689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void registerClient(const sp<IAudioFlingerClient>& client) = 0; 117f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 11889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // retrieve the audio recording buffer size 119f587ba5b991c7cd91e4df093d0d796bd419e5d67Glenn Kasten virtual size_t getInputBufferSize(uint32_t sampleRate, audio_format_t format, int channelCount) const = 0; 12089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 12172ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual audio_io_handle_t openOutput(uint32_t *pDevices, 122c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 12358f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t *pFormat, 124c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 125c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pLatencyMs, 126c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t flags) = 0; 12772ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual audio_io_handle_t openDuplicateOutput(audio_io_handle_t output1, 12872ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t output2) = 0; 12972ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t closeOutput(audio_io_handle_t output) = 0; 13072ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t suspendOutput(audio_io_handle_t output) = 0; 13172ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t restoreOutput(audio_io_handle_t output) = 0; 132c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 13372ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual audio_io_handle_t openInput(uint32_t *pDevices, 134c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 13558f30210ea540b6ce5aa6a46330cd3499483cb97Glenn Kasten audio_format_t *pFormat, 136c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 137de9719b3ec71472e6bf75117152176af51d1a515Glenn Kasten audio_in_acoustics_t acoustics) = 0; 13872ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t closeInput(audio_io_handle_t input) = 0; 139c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 14072ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t setStreamOutput(audio_stream_type_t stream, audio_io_handle_t output) = 0; 141f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 142f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent virtual status_t setVoiceVolume(float volume) = 0; 14305bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent 14472ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames, 14572ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t output) const = 0; 14605bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent 14772ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual unsigned int getInputFramesLost(audio_io_handle_t ioHandle) const = 0; 148be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 149be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual int newAudioSessionId() = 0; 150be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 1513a34befc6fb04a4945a849e8bda8b84e4bf973feMarco Nelissen virtual void acquireAudioSessionId(int audioSession) = 0; 1523a34befc6fb04a4945a849e8bda8b84e4bf973feMarco Nelissen virtual void releaseAudioSessionId(int audioSession) = 0; 1533a34befc6fb04a4945a849e8bda8b84e4bf973feMarco Nelissen 154f587ba5b991c7cd91e4df093d0d796bd419e5d67Glenn Kasten virtual status_t queryNumberEffects(uint32_t *numEffects) const = 0; 155be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 156f587ba5b991c7cd91e4df093d0d796bd419e5d67Glenn Kasten virtual status_t queryEffect(uint32_t index, effect_descriptor_t *pDescriptor) const = 0; 157be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 1585e92a7861196ddae14638d4b7a63fc4892b7ef59Glenn Kasten virtual status_t getEffectDescriptor(const effect_uuid_t *pEffectUUID, 159f587ba5b991c7cd91e4df093d0d796bd419e5d67Glenn Kasten effect_descriptor_t *pDescriptor) const = 0; 160be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 161be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual sp<IEffect> createEffect(pid_t pid, 162be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent effect_descriptor_t *pDesc, 163be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent const sp<IEffectClient>& client, 164be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int32_t priority, 16572ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t output, 166be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int sessionId, 167be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent status_t *status, 168be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *id, 169be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *enabled) = 0; 170de070137f11d346fba77605bd76a44c040a618fcEric Laurent 17172ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten virtual status_t moveEffects(int session, audio_io_handle_t srcOutput, 17272ef00de10fa95bfcb948ed88ab9b7a177ed0b48Glenn Kasten audio_io_handle_t dstOutput) = 0; 17389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 17489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 17589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 17689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 17789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 17889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass BnAudioFlinger : public BnInterface<IAudioFlinger> 17989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 18089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 18189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t onTransact( uint32_t code, 18289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const Parcel& data, 18389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project Parcel* reply, 18489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags = 0); 18589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 18689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 18789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 18889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 18989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 19089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 19189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif // ANDROID_IAUDIOFLINGER_H 192