IAudioFlinger.h revision c2f1f07084818942352c6bbfb36af9b6b330eb4e
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> 30c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent#include <utils/String8.h> 3189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectnamespace android { 3389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 3589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass IAudioFlinger : public IInterface 3789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 3889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 3989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project DECLARE_META_INTERFACE(AudioFlinger); 4089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 4189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* create an audio track and registers it with AudioFlinger. 4289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * return null if the track cannot be created. 4389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 4489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual sp<IAudioTrack> createTrack( 4589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project pid_t pid, 4689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int streamType, 4789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate, 4889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int format, 4989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int channelCount, 5089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount, 5189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags, 5289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const sp<IMemory>& sharedBuffer, 53c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent void *output, 5489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t *status) = 0; 5589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 5689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual sp<IAudioRecord> openRecord( 5789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project pid_t pid, 58c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent void *input, 5989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate, 6089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int format, 6189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int channelCount, 6289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount, 6389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags, 6489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t *status) = 0; 6589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 6689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* query the audio hardware state. This state never changes, 6789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * and therefore can be cached. 6889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 69c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual uint32_t sampleRate(void *output) const = 0; 70c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual int channelCount(void *output) const = 0; 71c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual int format(void *output) const = 0; 72c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual size_t frameCount(void *output) const = 0; 73c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual uint32_t latency(void *output) const = 0; 7489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 7589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* set/get the audio hardware state. This will probably be used by 7689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * the preference panel, mostly. 7789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 7889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMasterVolume(float value) = 0; 7989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMasterMute(bool muted) = 0; 8089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual float masterVolume() const = 0; 8289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool masterMute() const = 0; 8389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* set/get stream type state. This will probably be used by 8589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * the preference panel, mostly. 8689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 87c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t setStreamVolume(int stream, float value, void *output) = 0; 8889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setStreamMute(int stream, bool muted) = 0; 8989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 90c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual float streamVolume(int stream, void *output) const = 0; 9189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool streamMute(int stream) const = 0; 9289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 93c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set audio mode 9489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMode(int mode) = 0; 9589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 9689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // mic mute/state 9789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t setMicMute(bool state) = 0; 9889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool getMicMute() const = 0; 9989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 10089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // is a music stream active? 10189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool isMusicActive() const = 0; 10289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 103c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t setParameters(void *ioHandle, const String8& keyValuePairs) = 0; 104c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual String8 getParameters(void *ioHandle, const String8& keys) = 0; 10589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 10689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // register a current process for audio output change notifications 10789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void registerClient(const sp<IAudioFlingerClient>& client) = 0; 10889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 10989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // retrieve the audio recording buffer size 11089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual size_t getInputBufferSize(uint32_t sampleRate, int format, int channelCount) = 0; 11189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 112c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual void *openOutput(uint32_t *pDevices, 113c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 114c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pFormat, 115c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 116c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pLatencyMs, 117c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t flags) = 0; 118c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual void *openDuplicateOutput(void *output1, void *output2) = 0; 119c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t closeOutput(void *output) = 0; 120c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t suspendOutput(void *output) = 0; 121c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t restoreOutput(void *output) = 0; 122c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 123c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual void *openInput(uint32_t *pDevices, 124c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pSamplingRate, 125c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pFormat, 126c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t *pChannels, 127c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t acoustics) = 0; 128c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t closeInput(void *input) = 0; 129c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 130c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual status_t setStreamOutput(uint32_t stream, void *output) = 0; 13189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 13289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 13389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 13489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 13589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 13689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass BnAudioFlinger : public BnInterface<IAudioFlinger> 13789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 13889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 13989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t onTransact( uint32_t code, 14089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const Parcel& data, 14189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project Parcel* reply, 14289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags = 0); 14389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 14489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 14589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 14689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 14789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 14889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 14989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif // ANDROID_IAUDIOFLINGER_H 150