IAudioFlinger.h revision 65b65459e6ac59f8a257009df8014467ae0838ee
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#ifndef ANDROID_IAUDIOFLINGER_H 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#define ANDROID_IAUDIOFLINGER_H 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <stdint.h> 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <sys/types.h> 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <unistd.h> 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <utils/RefBase.h> 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <utils/Errors.h> 260795272aa226f4e965968a03daddc53ce30b7cdaMathias Agopian#include <binder/IInterface.h> 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <media/IAudioTrack.h> 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <media/IAudioRecord.h> 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <media/IAudioFlingerClient.h> 3065b65459e6ac59f8a257009df8014467ae0838eeEric Laurent#include <media/EffectApi.h> 3165b65459e6ac59f8a257009df8014467ae0838eeEric Laurent#include <media/IEffect.h> 3265b65459e6ac59f8a257009df8014467ae0838eeEric Laurent#include <media/IEffectClient.h> 33a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent#include <utils/String8.h> 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectnamespace android { 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// ---------------------------------------------------------------------------- 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectclass IAudioFlinger : public IInterface 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DECLARE_META_INTERFACE(AudioFlinger); 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* create an audio track and registers it with AudioFlinger. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return null if the track cannot be created. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual sp<IAudioTrack> createTrack( 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pid_t pid, 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int streamType, 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint32_t sampleRate, 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int format, 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelCount, 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int frameCount, 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint32_t flags, 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const sp<IMemory>& sharedBuffer, 56ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent int output, 5765b65459e6ac59f8a257009df8014467ae0838eeEric Laurent int *sessionId, 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t *status) = 0; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual sp<IAudioRecord> openRecord( 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pid_t pid, 62ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent int input, 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint32_t sampleRate, 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int format, 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelCount, 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int frameCount, 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint32_t flags, 6865b65459e6ac59f8a257009df8014467ae0838eeEric Laurent int *sessionId, 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t *status) = 0; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* query the audio hardware state. This state never changes, 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and therefore can be cached. 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 74ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual uint32_t sampleRate(int output) const = 0; 75ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual int channelCount(int output) const = 0; 76ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual int format(int output) const = 0; 77ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual size_t frameCount(int output) const = 0; 78ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual uint32_t latency(int output) const = 0; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* set/get the audio hardware state. This will probably be used by 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the preference panel, mostly. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual status_t setMasterVolume(float value) = 0; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual status_t setMasterMute(bool muted) = 0; 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual float masterVolume() const = 0; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual bool masterMute() const = 0; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* set/get stream type state. This will probably be used by 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the preference panel, mostly. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 92ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual status_t setStreamVolume(int stream, float value, int output) = 0; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual status_t setStreamMute(int stream, bool muted) = 0; 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 95ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual float streamVolume(int stream, int output) const = 0; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual bool streamMute(int stream) const = 0; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 98a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent // set audio mode 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual status_t setMode(int mode) = 0; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mic mute/state 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual status_t setMicMute(bool state) = 0; 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual bool getMicMute() const = 0; 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10523f25cda0c73f8eb878844dea32fb0bd419edca2Eric Laurent // is any track active on this stream? 10623f25cda0c73f8eb878844dea32fb0bd419edca2Eric Laurent virtual bool isStreamActive(int stream) const = 0; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 108ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual status_t setParameters(int ioHandle, const String8& keyValuePairs) = 0; 109ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual String8 getParameters(int ioHandle, const String8& keys) = 0; 110415f3e2875b8b0b860d0dd6a69ff6868571c36bbEric Laurent 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // register a current process for audio output change notifications 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual void registerClient(const sp<IAudioFlingerClient>& client) = 0; 113415f3e2875b8b0b860d0dd6a69ff6868571c36bbEric Laurent 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // retrieve the audio recording buffer size 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual size_t getInputBufferSize(uint32_t sampleRate, int format, int channelCount) = 0; 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 117ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual int openOutput(uint32_t *pDevices, 118a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t *pSamplingRate, 119a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t *pFormat, 120a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t *pChannels, 121a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t *pLatencyMs, 122a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t flags) = 0; 123ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual int openDuplicateOutput(int output1, int output2) = 0; 124ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual status_t closeOutput(int output) = 0; 125ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual status_t suspendOutput(int output) = 0; 126ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual status_t restoreOutput(int output) = 0; 127a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 128ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual int openInput(uint32_t *pDevices, 129a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t *pSamplingRate, 130a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t *pFormat, 131a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t *pChannels, 132a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent uint32_t acoustics) = 0; 133ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual status_t closeInput(int input) = 0; 134a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 135ddb78e7753be03937ad57ce7c3c842c52bdad65eEric Laurent virtual status_t setStreamOutput(uint32_t stream, int output) = 0; 136415f3e2875b8b0b860d0dd6a69ff6868571c36bbEric Laurent 137415f3e2875b8b0b860d0dd6a69ff6868571c36bbEric Laurent virtual status_t setVoiceVolume(float volume) = 0; 13847d0a9264fa5297db6333697ad750e6bc06822aaEric Laurent 1390986e7907ffc8387b04fb201e285784bcd11b9b7Eric Laurent virtual status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames, int output) = 0; 14047d0a9264fa5297db6333697ad750e6bc06822aaEric Laurent 14147d0a9264fa5297db6333697ad750e6bc06822aaEric Laurent virtual unsigned int getInputFramesLost(int ioHandle) = 0; 14265b65459e6ac59f8a257009df8014467ae0838eeEric Laurent 14365b65459e6ac59f8a257009df8014467ae0838eeEric Laurent virtual int newAudioSessionId() = 0; 14465b65459e6ac59f8a257009df8014467ae0838eeEric Laurent 14565b65459e6ac59f8a257009df8014467ae0838eeEric Laurent virtual status_t loadEffectLibrary(const char *libPath, int *handle) = 0; 14665b65459e6ac59f8a257009df8014467ae0838eeEric Laurent 14765b65459e6ac59f8a257009df8014467ae0838eeEric Laurent virtual status_t unloadEffectLibrary(int handle) = 0; 14865b65459e6ac59f8a257009df8014467ae0838eeEric Laurent 14965b65459e6ac59f8a257009df8014467ae0838eeEric Laurent virtual status_t queryNumberEffects(uint32_t *numEffects) = 0; 15065b65459e6ac59f8a257009df8014467ae0838eeEric Laurent 15165b65459e6ac59f8a257009df8014467ae0838eeEric Laurent virtual status_t queryNextEffect(effect_descriptor_t *pDescriptor) = 0; 15265b65459e6ac59f8a257009df8014467ae0838eeEric Laurent 15365b65459e6ac59f8a257009df8014467ae0838eeEric Laurent virtual status_t getEffectDescriptor(effect_uuid_t *pEffectUUID, effect_descriptor_t *pDescriptor) = 0; 15465b65459e6ac59f8a257009df8014467ae0838eeEric Laurent 15565b65459e6ac59f8a257009df8014467ae0838eeEric Laurent virtual sp<IEffect> createEffect(pid_t pid, 15665b65459e6ac59f8a257009df8014467ae0838eeEric Laurent effect_descriptor_t *pDesc, 15765b65459e6ac59f8a257009df8014467ae0838eeEric Laurent const sp<IEffectClient>& client, 15865b65459e6ac59f8a257009df8014467ae0838eeEric Laurent int32_t priority, 15965b65459e6ac59f8a257009df8014467ae0838eeEric Laurent int output, 16065b65459e6ac59f8a257009df8014467ae0838eeEric Laurent int sessionId, 16165b65459e6ac59f8a257009df8014467ae0838eeEric Laurent status_t *status, 16265b65459e6ac59f8a257009df8014467ae0838eeEric Laurent int *id, 16365b65459e6ac59f8a257009df8014467ae0838eeEric Laurent int *enabled) = 0; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// ---------------------------------------------------------------------------- 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectclass BnAudioFlinger : public BnInterface<IAudioFlinger> 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual status_t onTransact( uint32_t code, 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const Parcel& data, 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel* reply, 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint32_t flags = 0); 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// ---------------------------------------------------------------------------- 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; // namespace android 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#endif // ANDROID_IAUDIOFLINGER_H 183