AudioSystem.h revision db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903
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> 2389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 24db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin/* XXX: Should be include by all the users instead */ 25db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin#include <media/AudioParameter.h> 26db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 2789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectnamespace android { 2889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projecttypedef void (*audio_error_callback)(status_t err); 30fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurenttypedef int audio_io_handle_t; 31c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 32c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass IAudioPolicyService; 33c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurentclass String8; 3489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass AudioSystem 3689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 3789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 3889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 394bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten // must match android/media/AudioSystem.java STREAM_* constants 4089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum stream_type { 41c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEFAULT =-1, 42c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent VOICE_CALL = 0, 43c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent SYSTEM = 1, 44c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent RING = 2, 45c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent MUSIC = 3, 46c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent ALARM = 4, 47c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NOTIFICATION = 5, 48c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent BLUETOOTH_SCO = 6, 4929a65006e517ae5bb164e973b2d805ebfa834a2eEric Laurent ENFORCED_AUDIBLE = 7, // Sounds that cannot be muted by user and must be routed to speaker 50c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DTMF = 8, 51c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent TTS = 9, 5289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NUM_STREAM_TYPES 5389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 5489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 55c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Audio sub formats (see AudioSystem::audio_format). 56c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum pcm_sub_format { 57ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent PCM_SUB_16_BIT = 0x1, // must be 1 for backward compatibility 58ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent PCM_SUB_8_BIT = 0x2, // must be 2 for backward compatibility 59c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 60c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 614bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten // FIXME These sub_format enums are currently unused 624bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten 63c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // MP3 sub format field definition : can use 11 LSBs in the same way as MP3 frame header to specify 64c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // bit rate, stereo mode, version... 65c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum mp3_sub_format { 66c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 67c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 68c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 69c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // AMR NB/WB sub format field definition: specify frame block interleaving, bandwidth efficient or octet aligned, 70c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // encoding mode for recording... 71c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum amr_sub_format { 72c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 73c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 74c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 75c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // AAC sub format field definition: specify profile or bitrate for recording... 76c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum aac_sub_format { 77c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 7889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 7989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 80c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // VORBIS sub format field definition: specify quality for recording... 81c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum vorbis_sub_format { 82c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent //TODO 83c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 84c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 85c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Audio format consists in a main format field (upper 8 bits) and a sub format field (lower 24 bits). 86c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // The main format indicates the main codec type. The sub format field indicates options and parameters 87c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // for each format. The sub format is mainly used for record to indicate for instance the requested bitrate 88c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // or profile. It can also be used for certain formats to give informations not present in the encoded 89c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // audio stream (e.g. octet alignement for AMR). 9089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum audio_format { 91c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INVALID_FORMAT = -1, 92c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORMAT_DEFAULT = 0, 93c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent PCM = 0x00000000, // must be 0 for backward compatibility 94c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent MP3 = 0x01000000, 95c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AMR_NB = 0x02000000, 96c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AMR_WB = 0x03000000, 97c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AAC = 0x04000000, 98c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent HE_AAC_V1 = 0x05000000, 99c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent HE_AAC_V2 = 0x06000000, 100c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent VORBIS = 0x07000000, 101c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent MAIN_FORMAT_MASK = 0xFF000000, 102c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent SUB_FORMAT_MASK = 0x00FFFFFF, 103c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Aliases 104c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent PCM_16_BIT = (PCM|PCM_SUB_16_BIT), 105c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent PCM_8_BIT = (PCM|PCM_SUB_8_BIT) 106c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 107c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 108c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 1094bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten // Channel mask definitions must be kept in sync with values in /media/java/android/media/AudioFormat.java 110c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum audio_channels { 111c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // output channels 112ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_LEFT = 0x4, 113ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_RIGHT = 0x8, 114ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_CENTER = 0x10, 115ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_LOW_FREQUENCY = 0x20, 116ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_BACK_LEFT = 0x40, 117ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_BACK_RIGHT = 0x80, 118ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_LEFT_OF_CENTER = 0x100, 119ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_RIGHT_OF_CENTER = 0x200, 120ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_BACK_CENTER = 0x400, 121ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_MONO = CHANNEL_OUT_FRONT_LEFT, 122ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_STEREO = (CHANNEL_OUT_FRONT_LEFT | CHANNEL_OUT_FRONT_RIGHT), 123ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_QUAD = (CHANNEL_OUT_FRONT_LEFT | CHANNEL_OUT_FRONT_RIGHT | 124ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_BACK_LEFT | CHANNEL_OUT_BACK_RIGHT), 125ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_SURROUND = (CHANNEL_OUT_FRONT_LEFT | CHANNEL_OUT_FRONT_RIGHT | 126ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_CENTER | CHANNEL_OUT_BACK_CENTER), 127ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_5POINT1 = (CHANNEL_OUT_FRONT_LEFT | CHANNEL_OUT_FRONT_RIGHT | 128ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_CENTER | CHANNEL_OUT_LOW_FREQUENCY | CHANNEL_OUT_BACK_LEFT | CHANNEL_OUT_BACK_RIGHT), 129ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_7POINT1 = (CHANNEL_OUT_FRONT_LEFT | CHANNEL_OUT_FRONT_RIGHT | 130ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_CENTER | CHANNEL_OUT_LOW_FREQUENCY | CHANNEL_OUT_BACK_LEFT | CHANNEL_OUT_BACK_RIGHT | 131ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent CHANNEL_OUT_FRONT_LEFT_OF_CENTER | CHANNEL_OUT_FRONT_RIGHT_OF_CENTER), 132c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_OUT_ALL = (CHANNEL_OUT_FRONT_LEFT | CHANNEL_OUT_FRONT_RIGHT | 133c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_OUT_FRONT_CENTER | CHANNEL_OUT_LOW_FREQUENCY | CHANNEL_OUT_BACK_LEFT | CHANNEL_OUT_BACK_RIGHT | 134c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_OUT_FRONT_LEFT_OF_CENTER | CHANNEL_OUT_FRONT_RIGHT_OF_CENTER | CHANNEL_OUT_BACK_CENTER), 135c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 136c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // input channels 1379a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_LEFT = 0x4, 1389a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_RIGHT = 0x8, 1399a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_FRONT = 0x10, 1409a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_BACK = 0x20, 1419a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_LEFT_PROCESSED = 0x40, 1429a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_RIGHT_PROCESSED = 0x80, 1439a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_FRONT_PROCESSED = 0x100, 1449a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_BACK_PROCESSED = 0x200, 1459a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_PRESSURE = 0x400, 1469a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_X_AXIS = 0x800, 1479a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_Y_AXIS = 0x1000, 1489a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_Z_AXIS = 0x2000, 1499a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_VOICE_UPLINK = 0x4000, 1509a92037bd6477533062d635b676a6c9833aab96eEric Laurent CHANNEL_IN_VOICE_DNLINK = 0x8000, 151c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_MONO = CHANNEL_IN_FRONT, 152c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_STEREO = (CHANNEL_IN_LEFT | CHANNEL_IN_RIGHT), 153c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_ALL = (CHANNEL_IN_LEFT | CHANNEL_IN_RIGHT | CHANNEL_IN_FRONT | CHANNEL_IN_BACK| 154c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_LEFT_PROCESSED | CHANNEL_IN_RIGHT_PROCESSED | CHANNEL_IN_FRONT_PROCESSED | CHANNEL_IN_BACK_PROCESSED| 155c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_PRESSURE | CHANNEL_IN_X_AXIS | CHANNEL_IN_Y_AXIS | CHANNEL_IN_Z_AXIS | 156c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent CHANNEL_IN_VOICE_UPLINK | CHANNEL_IN_VOICE_DNLINK) 15789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 15889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 1594bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten // must match android/media/AudioSystem.java MODE_* values 16089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum audio_mode { 16189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_INVALID = -2, 16289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_CURRENT = -1, 16389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_NORMAL = 0, 16489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_RINGTONE, 16589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MODE_IN_CALL, 166f1fb01a7f00b8da90a36268aba8584a872e99175Jean-Michel Trivi MODE_IN_COMMUNICATION, 16789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NUM_MODES // not a valid entry, denotes end-of-list 16889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 16989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 17089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum audio_in_acoustics { 17189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AGC_ENABLE = 0x0001, 17289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AGC_DISABLE = 0, 17389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NS_ENABLE = 0x0002, 17489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project NS_DISABLE = 0, 17589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project TX_IIR_ENABLE = 0x0004, 17689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project TX_DISABLE = 0 17789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 17889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 179de070137f11d346fba77605bd76a44c040a618fcEric Laurent // special audio session values 180de070137f11d346fba77605bd76a44c040a618fcEric Laurent enum audio_sessions { 181de070137f11d346fba77605bd76a44c040a618fcEric Laurent SESSION_OUTPUT_STAGE = -1, // session for effects attached to a particular output stream 182de070137f11d346fba77605bd76a44c040a618fcEric Laurent // (value must be less than 0) 183de070137f11d346fba77605bd76a44c040a618fcEric Laurent SESSION_OUTPUT_MIX = 0, // session for effects applied to output mix. These effects can 184de070137f11d346fba77605bd76a44c040a618fcEric Laurent // be moved by audio policy manager to another output stream 185de070137f11d346fba77605bd76a44c040a618fcEric Laurent // (value must be 0) 186de070137f11d346fba77605bd76a44c040a618fcEric Laurent }; 187de070137f11d346fba77605bd76a44c040a618fcEric Laurent 18889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* These are static methods to control the system-wide AudioFlinger 18989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * only privileged processes can have access to them 19089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 19189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 192c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mute/unmute microphone 19389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t muteMicrophone(bool state); 19489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t isMicrophoneMuted(bool *state); 19589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 196c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set/get master volume 19789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t setMasterVolume(float value); 19889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getMasterVolume(float* volume); 1994bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten 200c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mute/unmute audio outputs 201c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setMasterMute(bool mute); 20289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getMasterMute(bool* mute); 20389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 204c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set/get stream volume on specified output 205fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent static status_t setStreamVolume(int stream, float value, int output); 206fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent static status_t getStreamVolume(int stream, float* volume, int output); 207c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 208c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mute/unmute stream 20989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t setStreamMute(int stream, bool mute); 21089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getStreamMute(int stream, bool* mute); 21189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 212c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set audio mode in audio hardware (see AudioSystem::audio_mode) 21389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t setMode(int mode); 21489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 215eda6c364c253ba97ee45a3adeb8c2b45db1f81dbEric Laurent // returns true in *state if tracks are active on the specified stream or has been active 216eda6c364c253ba97ee45a3adeb8c2b45db1f81dbEric Laurent // in the past inPastMs milliseconds 217eda6c364c253ba97ee45a3adeb8c2b45db1f81dbEric Laurent static status_t isStreamActive(int stream, bool *state, uint32_t inPastMs = 0); 21889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 219c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // set/get audio hardware parameters. The function accepts a list of parameters 220c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // key value pairs in the form: key1=value1;key2=value2;... 221c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // Some keys are reserved for standard parameters (See AudioParameter class). 222c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setParameters(audio_io_handle_t ioHandle, const String8& keyValuePairs); 223c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static String8 getParameters(audio_io_handle_t ioHandle, const String8& keys); 224c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 22589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static void setErrorCallback(audio_error_callback cb); 22689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 22789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // helper function to obtain AudioFlinger service handle 22889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static const sp<IAudioFlinger>& get_audio_flinger(); 22989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 23089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static float linearToLog(int volume); 23189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static int logToLinear(float volume); 23289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 23389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getOutputSamplingRate(int* samplingRate, int stream = DEFAULT); 23489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getOutputFrameCount(int* frameCount, int stream = DEFAULT); 23589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static status_t getOutputLatency(uint32_t* latency, int stream = DEFAULT); 23689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 23789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static bool routedToA2dpOutput(int streamType); 238c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 239c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t getInputBufferSize(uint32_t sampleRate, int format, int channelCount, 24089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project size_t* buffSize); 24189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 242f0ee6f4055e26fb35d9c526a596668a4dc9da5baEric Laurent static status_t setVoiceVolume(float volume); 243c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 244342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // return the number of audio frames written by AudioFlinger to audio HAL and 2454bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten // audio dsp to DAC since the output on which the specified stream is playing 246342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // has exited standby. 247342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // returned status (from utils/Errors.h) can be: 248342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // - NO_ERROR: successful operation, halFrames and dspFrames point to valid data 249342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // - INVALID_OPERATION: Not supported on current hardware platform 250342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // - BAD_VALUE: invalid parameter 251342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // NOTE: this feature is not supported on all hardware platforms and it is 252342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent // necessary to check returned status before using the returned values. 253342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent static status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames, int stream = DEFAULT); 254342e9cf388cceb807def720e40e8b0a217f4bcaaEric Laurent 25505bca2fde53bfe3063d2a0a877f2b6bfdd6052cfEric Laurent static unsigned int getInputFramesLost(audio_io_handle_t ioHandle); 256be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 257be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent static int newAudioSessionId(); 258c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 259c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // AudioPolicyService interface 260c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 261c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 262c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum audio_devices { 263c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // output devices 264ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_EARPIECE = 0x1, 265ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_SPEAKER = 0x2, 266ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_WIRED_HEADSET = 0x4, 267ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_WIRED_HEADPHONE = 0x8, 268ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_BLUETOOTH_SCO = 0x10, 269ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 0x20, 270ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 0x40, 271ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP = 0x80, 272ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100, 273ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 0x200, 274ffe9c25ce85e1af55d58ec025adc6367d70db7e8Eric Laurent DEVICE_OUT_AUX_DIGITAL = 0x400, 275b235dee7be544a6c990ba4f8d89ab03e38c826f8Praveen Bharathi DEVICE_OUT_ANLG_DOCK_HEADSET = 0x800, 276b235dee7be544a6c990ba4f8d89ab03e38c826f8Praveen Bharathi DEVICE_OUT_DGTL_DOCK_HEADSET = 0x1000, 277c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_DEFAULT = 0x8000, 278c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_ALL = (DEVICE_OUT_EARPIECE | DEVICE_OUT_SPEAKER | DEVICE_OUT_WIRED_HEADSET | 279c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_WIRED_HEADPHONE | DEVICE_OUT_BLUETOOTH_SCO | DEVICE_OUT_BLUETOOTH_SCO_HEADSET | 280c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_OUT_BLUETOOTH_SCO_CARKIT | DEVICE_OUT_BLUETOOTH_A2DP | DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 281b235dee7be544a6c990ba4f8d89ab03e38c826f8Praveen Bharathi DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER | DEVICE_OUT_AUX_DIGITAL | 282b235dee7be544a6c990ba4f8d89ab03e38c826f8Praveen Bharathi DEVICE_OUT_ANLG_DOCK_HEADSET | DEVICE_OUT_DGTL_DOCK_HEADSET | 283b235dee7be544a6c990ba4f8d89ab03e38c826f8Praveen Bharathi DEVICE_OUT_DEFAULT), 284492e666e47795326f4b12b87b150b550e6074bd8Eric Laurent DEVICE_OUT_ALL_A2DP = (DEVICE_OUT_BLUETOOTH_A2DP | DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 285492e666e47795326f4b12b87b150b550e6074bd8Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER), 286c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 287c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // input devices 288c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_COMMUNICATION = 0x10000, 289c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_AMBIENT = 0x20000, 290c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_BUILTIN_MIC = 0x40000, 291c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_BLUETOOTH_SCO_HEADSET = 0x80000, 292c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_WIRED_HEADSET = 0x100000, 293c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_AUX_DIGITAL = 0x200000, 294c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_VOICE_CALL = 0x400000, 29590b75fbd19571784c8ceee4841a28b8333a8198eEric Laurent DEVICE_IN_BACK_MIC = 0x800000, 296c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_DEFAULT = 0x80000000, 297c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 298c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_ALL = (DEVICE_IN_COMMUNICATION | DEVICE_IN_AMBIENT | DEVICE_IN_BUILTIN_MIC | 299c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_IN_BLUETOOTH_SCO_HEADSET | DEVICE_IN_WIRED_HEADSET | DEVICE_IN_AUX_DIGITAL | 30090b75fbd19571784c8ceee4841a28b8333a8198eEric Laurent DEVICE_IN_VOICE_CALL | DEVICE_IN_BACK_MIC | DEVICE_IN_DEFAULT) 301c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 302c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 303c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // device connection states used for setDeviceConnectionState() 304c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum device_connection_state { 305c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_STATE_UNAVAILABLE, 306c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent DEVICE_STATE_AVAILABLE, 307c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_DEVICE_STATES 308c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 309c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 310c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // request to open a direct output with getOutput() (by opposition to sharing an output with other AudioTracks) 311c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum output_flags { 312c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_FLAG_INDIRECT = 0x0, 313c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_FLAG_DIRECT = 0x1 314c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 315c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 316c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // device categories used for setForceUse() 317c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum forced_config { 318c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_NONE, 319c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_SPEAKER, 320c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_HEADPHONES, 321c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_BT_SCO, 322c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_BT_A2DP, 323c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_WIRED_ACCESSORY, 3247ddd450f91dc508b26cc550f5b42fded8a731654Eric Laurent FORCE_BT_CAR_DOCK, 3257ddd450f91dc508b26cc550f5b42fded8a731654Eric Laurent FORCE_BT_DESK_DOCK, 326b235dee7be544a6c990ba4f8d89ab03e38c826f8Praveen Bharathi FORCE_ANALOG_DOCK, 327b235dee7be544a6c990ba4f8d89ab03e38c826f8Praveen Bharathi FORCE_DIGITAL_DOCK, 328c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_FORCE_CONFIG, 329c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FORCE_DEFAULT = FORCE_NONE 330c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 331c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 3324bcae82f9b07d1a39956c45a6f5bec0b696c4dd1Glenn Kasten // usages used for setForceUse(), must match AudioSystem.java 333c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum force_use { 334c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FOR_COMMUNICATION, 335c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FOR_MEDIA, 336c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent FOR_RECORD, 33748643f38c9e92dd0a3d4a31c293c954f3df4db1bJean-Michel Trivi FOR_DOCK, 338c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_FORCE_USE 339c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 340c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 341c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // types of io configuration change events received with ioConfigChanged() 342c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent enum io_config_event { 343c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_OPENED, 344c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_CLOSED, 345c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OUTPUT_CONFIG_CHANGED, 346c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INPUT_OPENED, 347c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INPUT_CLOSED, 348c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent INPUT_CONFIG_CHANGED, 349c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent STREAM_CONFIG_CHANGED, 350c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent NUM_CONFIG_EVENTS 351c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 352c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 353c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // audio output descritor used to cache output configurations in client process to avoid frequent calls 354c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // through IAudioFlinger 355c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent class OutputDescriptor { 356c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent public: 357c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent OutputDescriptor() 358c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent : samplingRate(0), format(0), channels(0), frameCount(0), latency(0) {} 359c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 360c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate; 361c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int32_t format; 362c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int32_t channels; 363c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent size_t frameCount; 364c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t latency; 365c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 366c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 367c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 368c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions) 369c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // 370c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setDeviceConnectionState(audio_devices device, device_connection_state state, const char *device_address); 371c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static device_connection_state getDeviceConnectionState(audio_devices device, const char *device_address); 372c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setPhoneState(int state); 373c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setRingerMode(uint32_t mode, uint32_t mask); 374c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setForceUse(force_use usage, forced_config config); 375c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static forced_config getForceUse(force_use usage); 376c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static audio_io_handle_t getOutput(stream_type stream, 377c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate = 0, 378c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t format = FORMAT_DEFAULT, 379c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t channels = CHANNEL_OUT_STEREO, 380c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent output_flags flags = OUTPUT_FLAG_INDIRECT); 381de070137f11d346fba77605bd76a44c040a618fcEric Laurent static status_t startOutput(audio_io_handle_t output, 382de070137f11d346fba77605bd76a44c040a618fcEric Laurent AudioSystem::stream_type stream, 383de070137f11d346fba77605bd76a44c040a618fcEric Laurent int session = 0); 384de070137f11d346fba77605bd76a44c040a618fcEric Laurent static status_t stopOutput(audio_io_handle_t output, 385de070137f11d346fba77605bd76a44c040a618fcEric Laurent AudioSystem::stream_type stream, 386de070137f11d346fba77605bd76a44c040a618fcEric Laurent int session = 0); 387c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static void releaseOutput(audio_io_handle_t output); 388c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static audio_io_handle_t getInput(int inputSource, 389c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t samplingRate = 0, 390c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t format = FORMAT_DEFAULT, 391c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent uint32_t channels = CHANNEL_IN_MONO, 392c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent audio_in_acoustics acoustics = (audio_in_acoustics)0); 393c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t startInput(audio_io_handle_t input); 394c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t stopInput(audio_io_handle_t input); 395c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static void releaseInput(audio_io_handle_t input); 396c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t initStreamVolume(stream_type stream, 397c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMin, 398c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent int indexMax); 399c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t setStreamVolumeIndex(stream_type stream, int index); 400c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static status_t getStreamVolumeIndex(stream_type stream, int *index); 401c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 402de070137f11d346fba77605bd76a44c040a618fcEric Laurent static uint32_t getStrategyForStream(stream_type stream); 4036b2718c67aa7b1a8e3b0f25a73a0d5f72c59ffc3Glenn Kasten static uint32_t getDevicesForStream(stream_type stream); 404de070137f11d346fba77605bd76a44c040a618fcEric Laurent 405de070137f11d346fba77605bd76a44c040a618fcEric Laurent static audio_io_handle_t getOutputForEffect(effect_descriptor_t *desc); 406de070137f11d346fba77605bd76a44c040a618fcEric Laurent static status_t registerEffect(effect_descriptor_t *desc, 407de070137f11d346fba77605bd76a44c040a618fcEric Laurent audio_io_handle_t output, 408de070137f11d346fba77605bd76a44c040a618fcEric Laurent uint32_t strategy, 409de070137f11d346fba77605bd76a44c040a618fcEric Laurent int session, 410de070137f11d346fba77605bd76a44c040a618fcEric Laurent int id); 411de070137f11d346fba77605bd76a44c040a618fcEric Laurent static status_t unregisterEffect(int id); 412de070137f11d346fba77605bd76a44c040a618fcEric Laurent 413c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static const sp<IAudioPolicyService>& get_audio_policy_service(); 414c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 41589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // ---------------------------------------------------------------------------- 41689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 417c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static uint32_t popCount(uint32_t u); 418c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isOutputDevice(audio_devices device); 419c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isInputDevice(audio_devices device); 420c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isA2dpDevice(audio_devices device); 421c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isBluetoothScoDevice(audio_devices device); 422c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isLowVisibility(stream_type stream); 423c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isOutputChannel(uint32_t channel); 424c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isInputChannel(uint32_t channel); 425c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isValidFormat(uint32_t format); 426c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static bool isLinearPCM(uint32_t format); 427c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 42889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectprivate: 42989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 43089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project class AudioFlingerClient: public IBinder::DeathRecipient, public BnAudioFlingerClient 43189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project { 43289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project public: 433c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AudioFlingerClient() { 43489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project } 435c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 43689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // DeathRecipient 43789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void binderDied(const wp<IBinder>& who); 438c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 43989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // IAudioFlingerClient 440c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 441c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // indicate a change in the configuration of an output or input: keeps the cached 442c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // values for output/input parameters upto date in client process 443fa2877b9ea48baed934b866d2ab3658b69c4c869Eric Laurent virtual void ioConfigChanged(int event, int ioHandle, void *param2); 44489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 44589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 446c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent class AudioPolicyServiceClient: public IBinder::DeathRecipient 447c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent { 448c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent public: 449c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent AudioPolicyServiceClient() { 450c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent } 45189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 452c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // DeathRecipient 453c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent virtual void binderDied(const wp<IBinder>& who); 454c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent }; 455c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 456c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static sp<AudioFlingerClient> gAudioFlingerClient; 457c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static sp<AudioPolicyServiceClient> gAudioPolicyServiceClient; 45889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project friend class AudioFlingerClient; 459c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent friend class AudioPolicyServiceClient; 46089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 46189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static Mutex gLock; 46289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static sp<IAudioFlinger> gAudioFlinger; 46389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static audio_error_callback gAudioErrorCallback; 464c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 46589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static size_t gInBuffSize; 46689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project // previous parameters for recording buffer size queries 46789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static uint32_t gPrevInSamplingRate; 46889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static int gPrevInFormat; 46989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project static int gPrevInChannelCount; 47089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 471c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static sp<IAudioPolicyService> gAudioPolicyService; 472c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 473c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // mapping between stream types and outputs 474c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static DefaultKeyedVector<int, audio_io_handle_t> gStreamOutputMap; 475c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent // list of output descritor containing cached parameters (sampling rate, framecount, channel count...) 476c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent static DefaultKeyedVector<audio_io_handle_t, OutputDescriptor *> gOutputs; 477c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent}; 478c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 47989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 48089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 48189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif /*ANDROID_AUDIOSYSTEM_H_*/ 482