IAudioFlinger.h revision be916aa1267e2e6b1c148f51d11bcbbc79cb864c
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> 30be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent#include <media/EffectApi.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, 4989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int streamType, 5089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate, 5189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int format, 5289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int channelCount, 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, 6489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int format, 6589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int channelCount, 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; 76fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int 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 */ 92fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t setStreamVolume(int stream, float value, int output) = 0; 9389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setStreamMute(int stream, bool muted) = 0; 9489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 95fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual float streamVolume(int stream, int output) const = 0; 9689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool streamMute(int stream) const = 0; 9789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 98c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set audio mode 9989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMode(int 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 105b72a396826da8bd934b9531bbd40f86d7509e71cEric Laurent // is any track active on this stream? 106b72a396826da8bd934b9531bbd40f86d7509e71cEric Laurent virtual bool isStreamActive(int stream) const = 0; 10789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 108fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t setParameters(int ioHandle, const String8& keyValuePairs) = 0; 109fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual String8 getParameters(int ioHandle, const String8& keys) = 0; 110f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 11189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // register a current process for audio output change notifications 11289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void registerClient(const sp<IAudioFlingerClient>& client) = 0; 113f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 11489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // retrieve the audio recording buffer size 11589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual size_t getInputBufferSize(uint32_t sampleRate, int format, int channelCount) = 0; 11689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 117fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int openOutput(uint32_t *pDevices, 118c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 119c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pFormat, 120c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 121c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pLatencyMs, 122c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t flags) = 0; 123fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int openDuplicateOutput(int output1, int output2) = 0; 124fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t closeOutput(int output) = 0; 125fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t suspendOutput(int output) = 0; 126fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t restoreOutput(int output) = 0; 127c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 128fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual int openInput(uint32_t *pDevices, 129c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 130c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pFormat, 131c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 132c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t acoustics) = 0; 133fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t closeInput(int input) = 0; 134c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 135fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual status_t setStreamOutput(uint32_t stream, int output) = 0; 136f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent 137f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent virtual status_t setVoiceVolume(float volume) = 0; 13805bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent 139342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent virtual status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames, int output) = 0; 14005bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent 14105bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent virtual unsigned int getInputFramesLost(int ioHandle) = 0; 142be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 143be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual int newAudioSessionId() = 0; 144be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 145be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t loadEffectLibrary(const char *libPath, int *handle) = 0; 146be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 147be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t unloadEffectLibrary(int handle) = 0; 148be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 149be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t queryNumberEffects(uint32_t *numEffects) = 0; 150be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 151be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t queryNextEffect(effect_descriptor_t *pDescriptor) = 0; 152be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 153be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t getEffectDescriptor(effect_uuid_t *pEffectUUID, effect_descriptor_t *pDescriptor) = 0; 154be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 155be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual sp<IEffect> createEffect(pid_t pid, 156be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent effect_descriptor_t *pDesc, 157be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent const sp<IEffectClient>& client, 158be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int32_t priority, 159be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int output, 160be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int sessionId, 161be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent status_t *status, 162be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *id, 163be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int *enabled) = 0; 16489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 16589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 16689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 16789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 16889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 16989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass BnAudioFlinger : public BnInterface<IAudioFlinger> 17089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 17189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 17289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t onTransact( uint32_t code, 17389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const Parcel& data, 17489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project Parcel* reply, 17589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags = 0); 17689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 17789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 17889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 17989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 18089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 18189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 18289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif // ANDROID_IAUDIOFLINGER_H 183