AudioSystem.h revision be916aa1267e2e6b1c148f51d11bcbbc79cb864c
189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project/* 289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Copyright (C) 2008 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_AUDIOSYSTEM_H_ 1889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#define ANDROID_AUDIOSYSTEM_H_ 1989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/RefBase.h> 2189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/threads.h> 2289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <media/IAudioFlinger.h> 23135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent#include <media/AudioCommon.h> 2489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectnamespace android { 2689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projecttypedef void (*audio_error_callback)(status_t err); 28fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurenttypedef int audio_io_handle_t; 29c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 30c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass IAudioPolicyService; 31c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass String8; 3289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass AudioSystem 3489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 3589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 3689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum stream_type { 38c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEFAULT =-1, 39c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent VOICE_CALL = 0, 40c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent SYSTEM = 1, 41c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent RING = 2, 42c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent MUSIC = 3, 43c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent ALARM = 4, 44c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NOTIFICATION = 5, 45c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent BLUETOOTH_SCO = 6, 4629a65006e517ae5bb164e973b2d805ebfa834a2eEric Laurent ENFORCED_AUDIBLE = 7, // Sounds that cannot be muted by user and must be routed to speaker 47c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DTMF = 8, 48c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent TTS = 9, 4989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NUM_STREAM_TYPES 5089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 5189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 52c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Audio sub formats (see AudioSystem::audio_format). 53c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum pcm_sub_format { 54135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent PCM_SUB_16_BIT = PCM_FORMAT_S15, // must be 1 for backward compatibility 55135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent PCM_SUB_8_BIT = PCM_FORMAT_U8, // must be 2 for backward compatibility 56c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 57c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 58c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // MP3 sub format field definition : can use 11 LSBs in the same way as MP3 frame header to specify 59c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // bit rate, stereo mode, version... 60c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum mp3_sub_format { 61c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 62c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 63c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 64c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // AMR NB/WB sub format field definition: specify frame block interleaving, bandwidth efficient or octet aligned, 65c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // encoding mode for recording... 66c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum amr_sub_format { 67c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 68c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 69c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 70c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // AAC sub format field definition: specify profile or bitrate for recording... 71c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum aac_sub_format { 72c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 7389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 7489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 75c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // VORBIS sub format field definition: specify quality for recording... 76c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum vorbis_sub_format { 77c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 78c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 79c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 80c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Audio format consists in a main format field (upper 8 bits) and a sub format field (lower 24 bits). 81c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // The main format indicates the main codec type. The sub format field indicates options and parameters 82c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // for each format. The sub format is mainly used for record to indicate for instance the requested bitrate 83c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // or profile. It can also be used for certain formats to give informations not present in the encoded 84c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // audio stream (e.g. octet alignement for AMR). 8589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum audio_format { 86c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INVALID_FORMAT = -1, 87c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORMAT_DEFAULT = 0, 88c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent PCM = 0x00000000, // must be 0 for backward compatibility 89c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent MP3 = 0x01000000, 90c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AMR_NB = 0x02000000, 91c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AMR_WB = 0x03000000, 92c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AAC = 0x04000000, 93c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent HE_AAC_V1 = 0x05000000, 94c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent HE_AAC_V2 = 0x06000000, 95c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent VORBIS = 0x07000000, 96c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent MAIN_FORMAT_MASK = 0xFF000000, 97c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent SUB_FORMAT_MASK = 0x00FFFFFF, 98c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Aliases 99c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent PCM_16_BIT = (PCM|PCM_SUB_16_BIT), 100c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent PCM_8_BIT = (PCM|PCM_SUB_8_BIT) 101c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 102c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 103c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 104c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Channel mask definitions must be kept in sync with JAVA values in /media/java/android/media/AudioFormat.java 105c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum audio_channels { 106c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // output channels 107135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_FRONT_LEFT = CHANNEL_FRONT_LEFT, 108135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_FRONT_RIGHT = CHANNEL_FRONT_RIGHT, 109135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_FRONT_CENTER = CHANNEL_FRONT_CENTER, 110135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_LOW_FREQUENCY = CHANNEL_LOW_FREQUENCY, 111135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_BACK_LEFT = CHANNEL_BACK_LEFT, 112135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_BACK_RIGHT = CHANNEL_BACK_RIGHT, 113135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_FRONT_LEFT_OF_CENTER = CHANNEL_FRONT_LEFT_OF_CENTER, 114135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_FRONT_RIGHT_OF_CENTER = CHANNEL_FRONT_RIGHT_OF_CENTER, 115135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_BACK_CENTER = CHANNEL_BACK_CENTER, 116135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_MONO = CHANNEL_MONO, 117135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_STEREO = CHANNEL_STEREO, 118135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_QUAD = CHANNEL_QUAD, 119135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_SURROUND = CHANNEL_SURROUND, 120135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_5POINT1 = CHANNEL_5POINT1, 121135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent CHANNEL_OUT_7POINT1 = CHANNEL_7POINT1, 122c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_OUT_ALL = (CHANNEL_OUT_FRONT_LEFT | CHANNEL_OUT_FRONT_RIGHT | 123c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_OUT_FRONT_CENTER | CHANNEL_OUT_LOW_FREQUENCY | CHANNEL_OUT_BACK_LEFT | CHANNEL_OUT_BACK_RIGHT | 124c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_OUT_FRONT_LEFT_OF_CENTER | CHANNEL_OUT_FRONT_RIGHT_OF_CENTER | CHANNEL_OUT_BACK_CENTER), 125c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 126c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // input channels 1279a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_LEFT = 0x4, 1289a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_RIGHT = 0x8, 1299a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_FRONT = 0x10, 1309a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_BACK = 0x20, 1319a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_LEFT_PROCESSED = 0x40, 1329a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_RIGHT_PROCESSED = 0x80, 1339a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_FRONT_PROCESSED = 0x100, 1349a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_BACK_PROCESSED = 0x200, 1359a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_PRESSURE = 0x400, 1369a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_X_AXIS = 0x800, 1379a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_Y_AXIS = 0x1000, 1389a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_Z_AXIS = 0x2000, 1399a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_VOICE_UPLINK = 0x4000, 1409a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_VOICE_DNLINK = 0x8000, 141c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_MONO = CHANNEL_IN_FRONT, 142c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_STEREO = (CHANNEL_IN_LEFT | CHANNEL_IN_RIGHT), 143c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_ALL = (CHANNEL_IN_LEFT | CHANNEL_IN_RIGHT | CHANNEL_IN_FRONT | CHANNEL_IN_BACK| 144c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_LEFT_PROCESSED | CHANNEL_IN_RIGHT_PROCESSED | CHANNEL_IN_FRONT_PROCESSED | CHANNEL_IN_BACK_PROCESSED| 145c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_PRESSURE | CHANNEL_IN_X_AXIS | CHANNEL_IN_Y_AXIS | CHANNEL_IN_Z_AXIS | 146c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_VOICE_UPLINK | CHANNEL_IN_VOICE_DNLINK) 14789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 14889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 14989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum audio_mode { 15089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_INVALID = -2, 15189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_CURRENT = -1, 15289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_NORMAL = 0, 15389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_RINGTONE, 15489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_IN_CALL, 15589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NUM_MODES // not a valid entry, denotes end-of-list 15689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 15789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 15889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum audio_in_acoustics { 15989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AGC_ENABLE = 0x0001, 16089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AGC_DISABLE = 0, 16189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NS_ENABLE = 0x0002, 16289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NS_DISABLE = 0, 16389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project TX_IIR_ENABLE = 0x0004, 16489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project TX_DISABLE = 0 16589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 16689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 16789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* These are static methods to control the system-wide AudioFlinger 16889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * only privileged processes can have access to them 16989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 17089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 171c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mute/unmute microphone 17289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t muteMicrophone(bool state); 17389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t isMicrophoneMuted(bool *state); 17489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 175c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set/get master volume 17689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t setMasterVolume(float value); 17789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getMasterVolume(float* volume); 178c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mute/unmute audio outputs 179c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setMasterMute(bool mute); 18089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getMasterMute(bool* mute); 18189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 182c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set/get stream volume on specified output 183fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent static status_t setStreamVolume(int stream, float value, int output); 184fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent static status_t getStreamVolume(int stream, float* volume, int output); 185c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 186c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mute/unmute stream 18789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t setStreamMute(int stream, bool mute); 18889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getStreamMute(int stream, bool* mute); 18989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 190c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set audio mode in audio hardware (see AudioSystem::audio_mode) 19189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t setMode(int mode); 19289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 193b72a396826da8bd934b9531bbd40f86d7509e71cEric Laurent // returns true in *state if tracks are active on the specified stream 194b72a396826da8bd934b9531bbd40f86d7509e71cEric Laurent static status_t isStreamActive(int stream, bool *state); 19589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 196c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set/get audio hardware parameters. The function accepts a list of parameters 197c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // key value pairs in the form: key1=value1;key2=value2;... 198c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Some keys are reserved for standard parameters (See AudioParameter class). 199c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setParameters(audio_io_handle_t ioHandle, const String8& keyValuePairs); 200c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static String8 getParameters(audio_io_handle_t ioHandle, const String8& keys); 201c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 20289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static void setErrorCallback(audio_error_callback cb); 20389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 20489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // helper function to obtain AudioFlinger service handle 20589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static const sp<IAudioFlinger>& get_audio_flinger(); 20689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 20789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static float linearToLog(int volume); 20889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static int logToLinear(float volume); 20989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 21089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getOutputSamplingRate(int* samplingRate, int stream = DEFAULT); 21189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getOutputFrameCount(int* frameCount, int stream = DEFAULT); 21289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getOutputLatency(uint32_t* latency, int stream = DEFAULT); 21389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 21489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static bool routedToA2dpOutput(int streamType); 215c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 216c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t getInputBufferSize(uint32_t sampleRate, int format, int channelCount, 21789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project size_t* buffSize); 21889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 219f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent static status_t setVoiceVolume(float volume); 220c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 221342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // return the number of audio frames written by AudioFlinger to audio HAL and 222342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // audio dsp to DAC since the output on which the specificed stream is playing 223342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // has exited standby. 224342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // returned status (from utils/Errors.h) can be: 225342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // - NO_ERROR: successful operation, halFrames and dspFrames point to valid data 226342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // - INVALID_OPERATION: Not supported on current hardware platform 227342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // - BAD_VALUE: invalid parameter 228342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // NOTE: this feature is not supported on all hardware platforms and it is 229342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // necessary to check returned status before using the returned values. 230342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent static status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames, int stream = DEFAULT); 231342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent 23205bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent static unsigned int getInputFramesLost(audio_io_handle_t ioHandle); 233be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 234be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent static int newAudioSessionId(); 235c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 236c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // AudioPolicyService interface 237c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 238c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 239c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum audio_devices { 240c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // output devices 241135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_EARPIECE = DEVICE_EARPIECE, 242135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_SPEAKER = DEVICE_SPEAKER, 243135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_WIRED_HEADSET = DEVICE_WIRED_HEADSET, 244135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_WIRED_HEADPHONE = DEVICE_WIRED_HEADPHONE, 245135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_BLUETOOTH_SCO = DEVICE_BLUETOOTH_SCO, 246135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_HEADSET = DEVICE_BLUETOOTH_SCO_HEADSET, 247135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_CARKIT = DEVICE_BLUETOOTH_SCO_CARKIT, 248135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP = DEVICE_BLUETOOTH_A2DP, 249135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = DEVICE_BLUETOOTH_A2DP_HEADPHONES, 250135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = DEVICE_BLUETOOTH_A2DP_SPEAKER, 251135ad07e33d30e5202deb21061a0e3ecf0ffad35Eric Laurent DEVICE_OUT_AUX_DIGITAL = DEVICE_AUX_DIGITAL, 252c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_DEFAULT = 0x8000, 253c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_ALL = (DEVICE_OUT_EARPIECE | DEVICE_OUT_SPEAKER | DEVICE_OUT_WIRED_HEADSET | 254c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_WIRED_HEADPHONE | DEVICE_OUT_BLUETOOTH_SCO | DEVICE_OUT_BLUETOOTH_SCO_HEADSET | 255c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_BLUETOOTH_SCO_CARKIT | DEVICE_OUT_BLUETOOTH_A2DP | DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 2560f2d1e2dd7601e06fdf834f3f942eeb5c8b33a15Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER | DEVICE_OUT_AUX_DIGITAL | DEVICE_OUT_DEFAULT), 257492e666e47795326f4b12b87b150b550e6074bd8Eric Laurent DEVICE_OUT_ALL_A2DP = (DEVICE_OUT_BLUETOOTH_A2DP | DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 258492e666e47795326f4b12b87b150b550e6074bd8Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER), 259c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 260c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // input devices 261c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_COMMUNICATION = 0x10000, 262c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_AMBIENT = 0x20000, 263c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_BUILTIN_MIC = 0x40000, 264c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_BLUETOOTH_SCO_HEADSET = 0x80000, 265c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_WIRED_HEADSET = 0x100000, 266c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_AUX_DIGITAL = 0x200000, 267c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_VOICE_CALL = 0x400000, 26890b75fbd19571784c8ceee4841a28b8333a8198eEric Laurent DEVICE_IN_BACK_MIC = 0x800000, 269c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_DEFAULT = 0x80000000, 270c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 271c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_ALL = (DEVICE_IN_COMMUNICATION | DEVICE_IN_AMBIENT | DEVICE_IN_BUILTIN_MIC | 272c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_BLUETOOTH_SCO_HEADSET | DEVICE_IN_WIRED_HEADSET | DEVICE_IN_AUX_DIGITAL | 27390b75fbd19571784c8ceee4841a28b8333a8198eEric Laurent DEVICE_IN_VOICE_CALL | DEVICE_IN_BACK_MIC | DEVICE_IN_DEFAULT) 274c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 275c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 276c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // device connection states used for setDeviceConnectionState() 277c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum device_connection_state { 278c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_STATE_UNAVAILABLE, 279c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_STATE_AVAILABLE, 280c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_DEVICE_STATES 281c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 282c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 283c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // request to open a direct output with getOutput() (by opposition to sharing an output with other AudioTracks) 284c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum output_flags { 285c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_FLAG_INDIRECT = 0x0, 286c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_FLAG_DIRECT = 0x1 287c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 288c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 289c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // device categories used for setForceUse() 290c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum forced_config { 291c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_NONE, 292c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_SPEAKER, 293c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_HEADPHONES, 294c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_BT_SCO, 295c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_BT_A2DP, 296c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_WIRED_ACCESSORY, 2977ddd450f91dc508b26cc550f5b42fded8a731654Eric Laurent FORCE_BT_CAR_DOCK, 2987ddd450f91dc508b26cc550f5b42fded8a731654Eric Laurent FORCE_BT_DESK_DOCK, 299c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_FORCE_CONFIG, 300c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_DEFAULT = FORCE_NONE 301c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 302c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 303c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // usages used for setForceUse() 304c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum force_use { 305c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FOR_COMMUNICATION, 306c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FOR_MEDIA, 307c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FOR_RECORD, 30848643f38c9e92dd0a3d4a31c293c954f3df4db1bJean-Michel Trivi FOR_DOCK, 309c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_FORCE_USE 310c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 311c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 312c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // types of io configuration change events received with ioConfigChanged() 313c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum io_config_event { 314c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_OPENED, 315c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_CLOSED, 316c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_CONFIG_CHANGED, 317c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INPUT_OPENED, 318c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INPUT_CLOSED, 319c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INPUT_CONFIG_CHANGED, 320c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent STREAM_CONFIG_CHANGED, 321c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_CONFIG_EVENTS 322c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 323c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 324c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // audio output descritor used to cache output configurations in client process to avoid frequent calls 325c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // through IAudioFlinger 326c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent class OutputDescriptor { 327c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent public: 328c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OutputDescriptor() 329c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent : samplingRate(0), format(0), channels(0), frameCount(0), latency(0) {} 330c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 331c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate; 332c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int32_t format; 333c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int32_t channels; 334c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent size_t frameCount; 335c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t latency; 336c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 337c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 338c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 339c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions) 340c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 341c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setDeviceConnectionState(audio_devices device, device_connection_state state, const char *device_address); 342c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static device_connection_state getDeviceConnectionState(audio_devices device, const char *device_address); 343c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setPhoneState(int state); 344c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setRingerMode(uint32_t mode, uint32_t mask); 345c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setForceUse(force_use usage, forced_config config); 346c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static forced_config getForceUse(force_use usage); 347c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static audio_io_handle_t getOutput(stream_type stream, 348c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate = 0, 349c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t format = FORMAT_DEFAULT, 350c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t channels = CHANNEL_OUT_STEREO, 351c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent output_flags flags = OUTPUT_FLAG_INDIRECT); 352c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t startOutput(audio_io_handle_t output, AudioSystem::stream_type stream); 353c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t stopOutput(audio_io_handle_t output, AudioSystem::stream_type stream); 354c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static void releaseOutput(audio_io_handle_t output); 355c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static audio_io_handle_t getInput(int inputSource, 356c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate = 0, 357c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t format = FORMAT_DEFAULT, 358c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t channels = CHANNEL_IN_MONO, 359c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent audio_in_acoustics acoustics = (audio_in_acoustics)0); 360c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t startInput(audio_io_handle_t input); 361c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t stopInput(audio_io_handle_t input); 362c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static void releaseInput(audio_io_handle_t input); 363c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t initStreamVolume(stream_type stream, 364c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMin, 365c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMax); 366c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setStreamVolumeIndex(stream_type stream, int index); 367c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t getStreamVolumeIndex(stream_type stream, int *index); 368c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 369c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static const sp<IAudioPolicyService>& get_audio_policy_service(); 370c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 37189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // ---------------------------------------------------------------------------- 37289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 373c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static uint32_t popCount(uint32_t u); 374c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isOutputDevice(audio_devices device); 375c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isInputDevice(audio_devices device); 376c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isA2dpDevice(audio_devices device); 377c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isBluetoothScoDevice(audio_devices device); 378c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isLowVisibility(stream_type stream); 379c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isOutputChannel(uint32_t channel); 380c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isInputChannel(uint32_t channel); 381c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isValidFormat(uint32_t format); 382c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isLinearPCM(uint32_t format); 383c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 38489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectprivate: 38589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 38689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project class AudioFlingerClient: public IBinder::DeathRecipient, public BnAudioFlingerClient 38789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project { 38889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project public: 389c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AudioFlingerClient() { 39089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project } 391c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 39289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // DeathRecipient 39389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void binderDied(const wp<IBinder>& who); 394c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 39589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // IAudioFlingerClient 396c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 397c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // indicate a change in the configuration of an output or input: keeps the cached 398c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // values for output/input parameters upto date in client process 399fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual void ioConfigChanged(int event, int ioHandle, void *param2); 40089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 40189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 402c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent class AudioPolicyServiceClient: public IBinder::DeathRecipient 403c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent { 404c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent public: 405c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AudioPolicyServiceClient() { 406c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent } 40789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 408c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // DeathRecipient 409c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual void binderDied(const wp<IBinder>& who); 410c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 411c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 412c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static sp<AudioFlingerClient> gAudioFlingerClient; 413c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static sp<AudioPolicyServiceClient> gAudioPolicyServiceClient; 41489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project friend class AudioFlingerClient; 415c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent friend class AudioPolicyServiceClient; 41689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 41789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static Mutex gLock; 41889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static sp<IAudioFlinger> gAudioFlinger; 41989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static audio_error_callback gAudioErrorCallback; 420c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 42189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static size_t gInBuffSize; 42289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // previous parameters for recording buffer size queries 42389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static uint32_t gPrevInSamplingRate; 42489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static int gPrevInFormat; 42589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static int gPrevInChannelCount; 42689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 427c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static sp<IAudioPolicyService> gAudioPolicyService; 428c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 429c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mapping between stream types and outputs 430c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static DefaultKeyedVector<int, audio_io_handle_t> gStreamOutputMap; 431c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // list of output descritor containing cached parameters (sampling rate, framecount, channel count...) 432c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static DefaultKeyedVector<audio_io_handle_t, OutputDescriptor *> gOutputs; 433c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; 434c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 435c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass AudioParameter { 436c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 437c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentpublic: 438c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AudioParameter() {} 439c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AudioParameter(const String8& keyValuePairs); 440c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual ~AudioParameter(); 441c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 442c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // reserved parameter keys for changeing standard parameters with setParameters() function. 443c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Using these keys is mandatory for AudioFlinger to properly monitor audio output/input 444c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // configuration changes and act accordingly. 445c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // keyRouting: to change audio routing, value is an int in AudioSystem::audio_devices 446c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // keySamplingRate: to change sampling rate routing, value is an int 447c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // keyFormat: to change audio format, value is an int in AudioSystem::audio_format 448c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // keyChannels: to change audio channel configuration, value is an int in AudioSystem::audio_channels 449c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // keyFrameCount: to change audio output frame count, value is an int 450c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static const char *keyRouting; 451c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static const char *keySamplingRate; 452c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static const char *keyFormat; 453c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static const char *keyChannels; 454c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static const char *keyFrameCount; 455c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 456c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent String8 toString(); 457c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 458c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent status_t add(const String8& key, const String8& value); 459c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent status_t addInt(const String8& key, const int value); 460c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent status_t addFloat(const String8& key, const float value); 461c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 462c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent status_t remove(const String8& key); 463c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 464c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent status_t get(const String8& key, String8& value); 465c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent status_t getInt(const String8& key, int& value); 466c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent status_t getFloat(const String8& key, float& value); 467a9c322e398a1f5fdcace3b8b73967f010b1c31caEric Laurent status_t getAt(size_t index, String8& key, String8& value); 468c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 469c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent size_t size() { return mParameters.size(); } 470c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 471c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentprivate: 472c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent String8 mKeyValuePairs; 473c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent KeyedVector <String8, String8> mParameters; 47489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 47589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 47689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 47789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 47889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif /*ANDROID_AUDIOSYSTEM_H_*/ 479