AudioSystem.java revision 7847211fb4699bf6018e29d214a918ed6657319b
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.media; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* IF YOU CHANGE ANY OF THE CONSTANTS IN THIS FILE, DO NOT FORGET 218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * TO UPDATE THE CORRESPONDING NATIVE GLUE AND AudioManager.java. 228b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * THANK YOU FOR YOUR COOPERATION. 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioSystem 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 305c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten /* These values must be kept in sync with AudioSystem.h */ 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If these are modified, please also update Settings.System.VOLUME_SETTINGS 338b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * and attrs.xml and AudioManager.java. 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* The audio stream for phone calls */ 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = 0; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* The audio stream for system sounds */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = 1; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* The audio stream for the phone ring and message alerts */ 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = 2; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* The audio stream for music playback */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = 3; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* The audio stream for alarms */ 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = 4; 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* The audio stream for notifications */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = 5; 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* @hide The audio stream for phone calls when connected on bluetooth */ 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = 6; 49a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /* @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 50a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = 7; 51a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /* @hide The audio stream for DTMF tones */ 52a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = 8; 53a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /* @hide The audio stream for text to speech (TTS) */ 54a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = 9; 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use {@link #numStreamTypes() instead} 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int NUM_STREAMS = 5; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Expose only the getter method publicly so we can change it in the future 61a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private static final int NUM_STREAM_TYPES = 10; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int getNumStreamTypes() { return NUM_STREAM_TYPES; } 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 67ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten * @param on set <var>true</var> to mute the microphone; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 69ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten * @return command completion status see AUDIO_STATUS_OK, see AUDIO_STATUS_ERROR 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static native int muteMicrophone(boolean on); 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 76ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten * @return true if microphone is muted, false if it's not 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static native boolean isMicrophoneMuted(); 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 80ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten /* modes for setPhoneState, must match AudioSystem.h audio_mode */ 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = -2; 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = -1; 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = 0; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = 1; 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = 2; 868f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = 3; 878f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int NUM_MODES = 4; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 90ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten /* Routing bits for the former setRouting/getRouting API */ 91a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @deprecated */ 92a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = (1 << 0); 93a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @deprecated */ 94a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = (1 << 1); 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @deprecated use {@link #ROUTE_BLUETOOTH_SCO} */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = (1 << 2); 97a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @deprecated */ 98a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = (1 << 2); 99a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @deprecated */ 100a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = (1 << 3); 101a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @deprecated */ 102a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = (1 << 4); 103a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @deprecated */ 104a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = 0xFFFFFFFF; 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 10723f25cda0c73f8eb878844dea32fb0bd419edca2Eric Laurent * Checks whether the specified stream type is active. 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10923f25cda0c73f8eb878844dea32fb0bd419edca2Eric Laurent * return true if any track playing on this stream is active. 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public static native boolean isStreamActive(int stream, int inPastMs); 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 114a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a group generic audio configuration parameters. The use of these parameters 115ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten * are platform dependent, see libaudio 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 117a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * param keyValuePairs list of parameters key value pairs in the form: 118a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 119a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 120a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native int setParameters(String keyValuePairs); 121a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 122a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /* 123a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Gets a group generic audio configuration parameters. The use of these parameters 124ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten * are platform dependent, see libaudio 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 126a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * param keys list of parameters 127a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * return value: list of parameters key value pairs in the form: 128a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 130a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native String getParameters(String keys); 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 132ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten // These match the enum AudioError in frameworks/base/core/jni/android_media_AudioSystem.cpp 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Command sucessful or Media server restarted. see ErrorCallback */ 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AUDIO_STATUS_OK = 0; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Command failed or unspecified audio error. see ErrorCallback */ 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AUDIO_STATUS_ERROR = 1; 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Media server died. see ErrorCallback */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int AUDIO_STATUS_SERVER_DIED = 100; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static ErrorCallback mErrorCallback; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handles the audio error callback. 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface ErrorCallback 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback for audio server errors. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param error error code: 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * - AUDIO_STATUS_OK 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * - AUDIO_STATUS_SERVER_DIED 152ef02827d4c3b9c0601eddc9c348fc2ea866420a2Eric Laurent * - AUDIO_STATUS_ERROR 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onError(int error); 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Registers a callback to be invoked when an error occurs. 159ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten * @param cb the callback to run 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void setErrorCallback(ErrorCallback cb) 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 163a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent synchronized (AudioSystem.class) { 164a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent mErrorCallback = cb; 165a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent } 166a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent // Calling a method on AudioFlinger here makes sure that we bind to IAudioFlinger 167a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent // binder interface death. Not doing that would result in not being notified of 168a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent // media_server process death if no other method is called on AudioSystem that reaches 169a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent // to AudioFlinger. 170a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent isMicrophoneMuted(); 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void errorCallbackFromNative(int error) 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 175a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent ErrorCallback errorCallback = null; 176a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent synchronized (AudioSystem.class) { 177a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent if (mErrorCallback != null) { 178a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent errorCallback = mErrorCallback; 179a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent } 180a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent } 181a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent if (errorCallback != null) { 182a25c5d88d17f251262307ce31e799c9cf361d145Eric Laurent errorCallback.onError(error); 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 185a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1869bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent 187a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /* 188a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * AudioPolicyService methods 189a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 190a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // output devices, be sure to update AudioManager.java also 192a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_EARPIECE = 0x1; 193a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_SPEAKER = 0x2; 194a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_WIRED_HEADSET = 0x4; 195a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_WIRED_HEADPHONE = 0x8; 196a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_BLUETOOTH_SCO = 0x10; 197a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 0x20; 198a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 0x40; 199a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_BLUETOOTH_A2DP = 0x80; 200a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100; 201a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 0x200; 202a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_AUX_DIGITAL = 0x400; 20321e941bf43362ddc6639a9f2d0828053360f53d7Praveen Bharathi public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = 0x800; 20421e941bf43362ddc6639a9f2d0828053360f53d7Praveen Bharathi public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = 0x1000; 20559f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_ACCESSORY = 0x2000; 20659f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_DEVICE = 0x4000; 20759f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent 208a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_OUT_DEFAULT = 0x8000; 2099bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final int DEVICE_OUT_ALL = (DEVICE_OUT_EARPIECE | 2109bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_SPEAKER | 2119bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_WIRED_HEADSET | 2129bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_WIRED_HEADPHONE | 2139bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_SCO | 2149bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_HEADSET | 2159bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_CARKIT | 2169bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP | 2179bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 2189bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER | 2199bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_AUX_DIGITAL | 2209bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_ANLG_DOCK_HEADSET | 2219bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_DGTL_DOCK_HEADSET | 22259f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent DEVICE_OUT_USB_ACCESSORY | 22359f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent DEVICE_OUT_USB_DEVICE | 2249bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_DEFAULT); 2259bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final int DEVICE_OUT_ALL_A2DP = (DEVICE_OUT_BLUETOOTH_A2DP | 2269bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 2279bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER); 22859f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_ALL_SCO = (DEVICE_OUT_BLUETOOTH_SCO | 22959f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_HEADSET | 23059f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent DEVICE_OUT_BLUETOOTH_SCO_CARKIT); 23159f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_ALL_USB = (DEVICE_OUT_USB_ACCESSORY | 23259f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent DEVICE_OUT_USB_DEVICE); 23359f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent 234a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent // input devices 235a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_COMMUNICATION = 0x10000; 236a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_AMBIENT = 0x20000; 237a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_BUILTIN_MIC1 = 0x40000; 238a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_BUILTIN_MIC2 = 0x80000; 239a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_MIC_ARRAY = 0x100000; 240a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_BLUETOOTH_SCO_HEADSET = 0x200000; 241a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_WIRED_HEADSET = 0x400000; 242a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_AUX_DIGITAL = 0x800000; 243a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_IN_DEFAULT = 0x80000000; 244a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 245ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten // device states, must match AudioSystem::device_connection_state 246a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_STATE_UNAVAILABLE = 0; 247a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int DEVICE_STATE_AVAILABLE = 1; 248ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten private static final int NUM_DEVICE_STATES = 1; 249a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 2509bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_EARPIECE_NAME = "earpiece"; 2519bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_SPEAKER_NAME = "speaker"; 2529bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_WIRED_HEADSET_NAME = "headset"; 2539bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_WIRED_HEADPHONE_NAME = "headphone"; 2549bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_BLUETOOTH_SCO_NAME = "bt_sco"; 2559bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_BLUETOOTH_SCO_HEADSET_NAME = "bt_sco_hs"; 2569bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_BLUETOOTH_SCO_CARKIT_NAME = "bt_sco_carkit"; 2579bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_BLUETOOTH_A2DP_NAME = "bt_a2dp"; 2589bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES_NAME = "bt_a2dp_hp"; 2599bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER_NAME = "bt_a2dp_spk"; 2609bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_AUX_DIGITAL_NAME = "aux_digital"; 2619bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_ANLG_DOCK_HEADSET_NAME = "analog_dock"; 2629bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static final String DEVICE_OUT_DGTL_DOCK_HEADSET_NAME = "digital_dock"; 263bffc3d1bd33eb2d8e00a9f8b6261d815db503311Eric Laurent public static final String DEVICE_OUT_USB_ACCESSORY_NAME = "usb_accessory"; 264bffc3d1bd33eb2d8e00a9f8b6261d815db503311Eric Laurent public static final String DEVICE_OUT_USB_DEVICE_NAME = "usb_device"; 2659bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent 2669bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static String getDeviceName(int device) 2679bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent { 2689bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent switch(device) { 2699bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_EARPIECE: 2709bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_EARPIECE_NAME; 2719bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_SPEAKER: 2729bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_SPEAKER_NAME; 2739bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_WIRED_HEADSET: 2749bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_WIRED_HEADSET_NAME; 2759bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_WIRED_HEADPHONE: 2769bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_WIRED_HEADPHONE_NAME; 2779bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_BLUETOOTH_SCO: 2789bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_BLUETOOTH_SCO_NAME; 2799bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_BLUETOOTH_SCO_HEADSET: 2809bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_BLUETOOTH_SCO_HEADSET_NAME; 2819bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_BLUETOOTH_SCO_CARKIT: 2829bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_BLUETOOTH_SCO_CARKIT_NAME; 2839bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_BLUETOOTH_A2DP: 2849bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_BLUETOOTH_A2DP_NAME; 2859bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES: 2869bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES_NAME; 2879bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER: 2889bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER_NAME; 2899bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_AUX_DIGITAL: 2909bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_AUX_DIGITAL_NAME; 2919bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_ANLG_DOCK_HEADSET: 2929bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_ANLG_DOCK_HEADSET_NAME; 2939bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent case DEVICE_OUT_DGTL_DOCK_HEADSET: 2949bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return DEVICE_OUT_DGTL_DOCK_HEADSET_NAME; 295bffc3d1bd33eb2d8e00a9f8b6261d815db503311Eric Laurent case DEVICE_OUT_USB_ACCESSORY: 296bffc3d1bd33eb2d8e00a9f8b6261d815db503311Eric Laurent return DEVICE_OUT_USB_ACCESSORY_NAME; 297bffc3d1bd33eb2d8e00a9f8b6261d815db503311Eric Laurent case DEVICE_OUT_USB_DEVICE: 298bffc3d1bd33eb2d8e00a9f8b6261d815db503311Eric Laurent return DEVICE_OUT_USB_DEVICE_NAME; 2999ac8d0c445a3ccde40c05f0f3ad0ec4e8265d4c6Eric Laurent case DEVICE_IN_DEFAULT: 3009bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent default: 3019bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent return ""; 3029bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent } 3039bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent } 3049bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent 305ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten // phone state, match audio_mode??? 306a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int PHONE_STATE_OFFCALL = 0; 307a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int PHONE_STATE_RINGING = 1; 308a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int PHONE_STATE_INCALL = 2; 309a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 310ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten // device categories config for setForceUse, must match AudioSystem::forced_config 311a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FORCE_NONE = 0; 312a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FORCE_SPEAKER = 1; 313a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FORCE_HEADPHONES = 2; 314a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FORCE_BT_SCO = 3; 315a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FORCE_BT_A2DP = 4; 316a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FORCE_WIRED_ACCESSORY = 5; 317eb14a783be073b5fd6e8c8c9bc87d2d1919f2c9eEric Laurent public static final int FORCE_BT_CAR_DOCK = 6; 318eb14a783be073b5fd6e8c8c9bc87d2d1919f2c9eEric Laurent public static final int FORCE_BT_DESK_DOCK = 7; 31921e941bf43362ddc6639a9f2d0828053360f53d7Praveen Bharathi public static final int FORCE_ANALOG_DOCK = 8; 32021e941bf43362ddc6639a9f2d0828053360f53d7Praveen Bharathi public static final int FORCE_DIGITAL_DOCK = 9; 3217847211fb4699bf6018e29d214a918ed6657319bEric Laurent public static final int FORCE_NO_BT_A2DP = 10; 3227847211fb4699bf6018e29d214a918ed6657319bEric Laurent private static final int NUM_FORCE_CONFIG = 11; 323a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FORCE_DEFAULT = FORCE_NONE; 324a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 325ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten // usage for setForceUse, must match AudioSystem::force_use 326a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FOR_COMMUNICATION = 0; 327a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FOR_MEDIA = 1; 328a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int FOR_RECORD = 2; 3296154412ee8e07e9cde129cccb944dd7ed9dcef53Jean-Michel Trivi public static final int FOR_DOCK = 3; 330ed0079ddddd4070f3369b13b274222da2e69f4b9Glenn Kasten private static final int NUM_FORCE_USE = 4; 331a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 332505e5c8859f596ed58489be565d6e029314b2ac8Eric Laurent // usage for AudioRecord.startRecordingSync(), must match AudioSystem::sync_event_t 333505e5c8859f596ed58489be565d6e029314b2ac8Eric Laurent public static final int SYNC_EVENT_NONE = 0; 334505e5c8859f596ed58489be565d6e029314b2ac8Eric Laurent public static final int SYNC_EVENT_PRESENTATION_COMPLETE = 1; 335505e5c8859f596ed58489be565d6e029314b2ac8Eric Laurent 336a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native int setDeviceConnectionState(int device, int state, String device_address); 337a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native int getDeviceConnectionState(int device, String device_address); 338a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native int setPhoneState(int state); 339a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native int setForceUse(int usage, int config); 340a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native int getForceUse(int usage); 341a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static native int initStreamVolume(int stream, int indexMin, int indexMax); 3429bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static native int setStreamVolumeIndex(int stream, int index, int device); 3439bc8358ddaa01c3490f9709991989633a6a3dd42Eric Laurent public static native int getStreamVolumeIndex(int stream, int device); 344cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood public static native int setMasterVolume(float value); 345cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood public static native float getMasterVolume(); 346cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood public static native int setMasterMute(boolean mute); 347cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood public static native boolean getMasterMute(); 3488b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static native int getDevicesForStream(int stream); 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 350