AudioManager.java revision 178889eff7fa3361a5cb08d6d43846a1baf5216b
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.media; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant.SdkConstantType; 21d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.content.ComponentName; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.ContentObserver; 24178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Triviimport android.graphics.Bitmap; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 28d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Looper; 29d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Message; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 3186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.os.SystemClock; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.ServiceManager; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.provider.Settings; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 35d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.view.KeyEvent; 3686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.view.VolumePanel; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 38d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport java.util.Iterator; 39d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport java.util.HashMap; 40d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioManager provides access to volume and ringer mode control. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use <code>Context.getSystemService(Context.AUDIO_SERVICE)</code> to get 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an instance of this class. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioManager { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Context mContext; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mHandler; 5186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato private long mVolumeKeyUpTime; 52402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent private int mVolumeControlStream = -1; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String TAG = "AudioManager"; 5443a17654cf4bfe7f1ec22bd8b7b32daccdf27c09Joe Onorato private static boolean localLOGV = false; 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent, a hint for applications that audio is about to become 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'noisy' due to a change in audio outputs. For example, this intent may 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent when a wired headset is unplugged, or when an A2DP audio 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sink is disconnected, and the audio system is about to automatically 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch audio route to the speaker. Applications that are controlling 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * audio streams may consider pausing, reducing volume or some other action 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on receipt of this intent so as not to surprise the user with audio 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the speaker. 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sticky broadcast intent action indicating that the ringer mode has 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the new ringer mode. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_RINGER_MODE 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new ringer mode. 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_CHANGED_ACTION 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_NORMAL 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_SILENT 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_VIBRATE 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the vibrate setting has 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the vibrate type and its new setting. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_SETTING 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VIBRATE_SETTING_CHANGED_ACTION = "android.media.VIBRATE_SETTING_CHANGED"; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Broadcast intent when the volume for a particular stream type changes. 1009ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * Includes the stream, the new volume and previous volumes 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_TYPE 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_VALUE 1049ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @see #EXTRA_PREV_VOLUME_STREAM_VALUE 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new vibrate setting for a particular type. 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ON 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_OFF 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ONLY_SILENT 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The vibrate type whose setting has changed. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_NOTIFICATION 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_RINGER 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The stream type for the volume changed intent. 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The volume associated with the stream for the volume changed intent. 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_VALUE = 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.media.EXTRA_VOLUME_STREAM_VALUE"; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1409ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent /** 1419ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @hide The previous volume associated with the stream for the volume changed intent. 1429ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent */ 1439ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = 1449ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; 1459ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for phone calls */ 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for system sounds */ 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for the phone ring */ 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = AudioSystem.STREAM_RING; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for music playback */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for alarms */ 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for notifications */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide The audio stream for phone calls when connected to bluetooth */ 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; 160a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 161a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; 162a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** The audio stream for DTMF Tones */ 163a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; 164a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for text to speech (TTS) */ 165a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = AudioSystem.STREAM_TTS; 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Number of audio streams */ 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use AudioSystem.getNumStreamTypes() instead 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 170a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide Default volume index values for audio streams */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int[] DEFAULT_STREAM_VOLUME = new int[] { 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4, // STREAM_VOICE_CALL 1769d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_RING 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11, // STREAM_MUSIC 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6, // STREAM_ALARM 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_NOTIFICATION 181a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 7, // STREAM_BLUETOOTH_SCO 1829d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM_ENFORCED 183a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11, // STREAM_DTMF 184a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11 // STREAM_TTS 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Increase the ringer volume. 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_RAISE = 1; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decrease the ringer volume. 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_LOWER = -1; 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maintain the previous ringer volume. This may be useful when needing to 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * show the volume toast without actually modifying the volume. 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_SAME = 0; 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Flags should be powers of 2! 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Show a toast containing the current volume. 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_SHOW_UI = 1 << 0; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to include ringer modes as possible options when changing volume. 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if true and volume level is 0 and the volume is adjusted 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate mode. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * By default this is on for the ring stream. If this flag is included, 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this behavior will be present regardless of the stream type being 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affected by the ringer mode. 233105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to play a sound when changing the volume. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is given to {@link #adjustVolume(int, int)} or 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in some cases (for example, the decided stream type is not 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_RING}, or the volume is being adjusted 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * downward). 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_PLAY_SOUND = 1 << 2; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any sounds/vibrate that may be in the queue, or are playing (related to 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changing volume). 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to vibrate if going into the vibrate ringer mode. 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_VIBRATE = 1 << 4; 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 266402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces use of specified stream 267402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 268402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 269402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public static final int FLAG_FORCE_STREAM = 1 << 5; 270402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 271402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 272402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will not vibrate. (This overrides the 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate setting.) 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_SILENT = 0; 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will vibrate. (This will cause the 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone ringer to always vibrate, but the notification vibrate to only 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate if set.) 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_VIBRATE = 1; 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that may be audible and may vibrate. It will be audible if 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the volume before changing out of this mode was audible. It will vibrate 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the vibrate setting is on. 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_NORMAL = 2; 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 30172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent // maximum valid ringer mode value. Values must start from 0 and be contiguous. 30272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent private static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; 30372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to the ringer. 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_RINGER = 0; 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to notifications. 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_NOTIFICATION = 1; 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to never vibrate. 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_OFF = 0; 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to vibrate when possible. 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ON = 1; 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to only vibrate when in the vibrate ringer 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ONLY_SILENT = 2; 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Suggests using the default stream type. This may not be used in all 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * places a stream type is needed. 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService sService; 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioManager(Context context) { 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContext = context; 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = new Handler(context.getMainLooper()); 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService getService() 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sService != null) { 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sService = IAudioService.Stub.asInterface(b); 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 37486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 37586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 37686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato public void preDispatchKeyEvent(int keyCode, int stream) { 37786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 37886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * If the user hits another key within the play sound delay, then 37986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * cancel the sound 38086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 38186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP 38286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE 38386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && mVolumeKeyUpTime + VolumePanel.PLAY_SOUND_DELAY 38486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato > SystemClock.uptimeMillis()) { 38586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 38686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * The user has hit another key during the delay (e.g., 300ms) 38786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * since the last volume key up, so cancel any sounds. 38886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 38986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato adjustSuggestedStreamVolume(AudioManager.ADJUST_SAME, 39086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 39186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 39286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 39386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 39486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 39586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 39686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 39786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato public void handleKeyDown(int keyCode, int stream) { 39886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 39986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 40086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 40186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 40286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Adjust the volume in on key down since it is more 40386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * responsive to the user. 40486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 405402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent int flags = FLAG_SHOW_UI | FLAG_VIBRATE; 406402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent if (mVolumeControlStream != -1) { 407402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent stream = mVolumeControlStream; 408402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent flags |= FLAG_FORCE_STREAM; 409402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 41086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato adjustSuggestedStreamVolume( 41186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato keyCode == KeyEvent.KEYCODE_VOLUME_UP 41225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent ? ADJUST_RAISE 41325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent : ADJUST_LOWER, 41486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato stream, 415402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent flags); 41686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 41786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 41886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato // TODO: Actually handle MUTE. 41986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 42086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 42186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 42286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 42386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 42486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 42586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 42686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato public void handleKeyUp(int keyCode, int stream) { 42786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 42886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 42986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 43086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 43186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Play a sound. This is done on key up since we don't want the 43286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * sound to play when a user holds down volume down to mute. 43386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 434402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent int flags = FLAG_PLAY_SOUND; 435402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent if (mVolumeControlStream != -1) { 436402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent stream = mVolumeControlStream; 437402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent flags |= FLAG_FORCE_STREAM; 438402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 43925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent adjustSuggestedStreamVolume( 44025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent ADJUST_SAME, 44125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent stream, 442402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent flags); 44325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 44486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato mVolumeKeyUpTime = SystemClock.uptimeMillis(); 44586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 44686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 44786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato // TODO: Actually handle MUTE. 44886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 44986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 45086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 45186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 45286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of a particular stream by one step in a direction. 454fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 455fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 456fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_ALARM} 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustStreamVolume(int streamType, int direction, int flags) { 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.adjustStreamVolume(streamType, direction, flags); 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustStreamVolume", e); 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream. For example, if a call is 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active, it will have the highest priority regardless of if the in-call 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen is showing. Another example, if music is playing in the background 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and a call is not active, the music stream will be adjusted. 482fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 483fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 484fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustSuggestedStreamVolume(int, int, int) 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustVolume(int direction, int flags) { 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.adjustVolume(direction, flags); 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustVolume", e); 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream, or the given fallback 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stream. 506fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 507fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 508fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param suggestedStreamType The stream type that will be used if there 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is valid here. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.adjustSuggestedStreamVolume(direction, suggestedStreamType, flags); 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustVolume", e); 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current ringtone mode. 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRingerMode() { 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getRingerMode(); 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getRingerMode", e); 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return RINGER_MODE_NORMAL; 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 54772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * Checks valid ringer mode values. 54872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 54972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @return true if the ringer mode indicated is valid, false otherwise. 55072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 55172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @see #setRingerMode(int) 55272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @hide 55372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent */ 55472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent public static boolean isValidRingerMode(int ringerMode) { 55572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { 55672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return false; 55772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 55872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return true; 55972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 56072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 56172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent /** 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum volume index for a particular stream. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose maximum volume index is returned. 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The maximum valid volume index for the stream. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamMaxVolume(int streamType) { 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getStreamMaxVolume(streamType); 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamMaxVolume", e); 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current volume index for a particular stream. 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose volume index is returned. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current volume index for the stream. 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamVolume(int streamType) { 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getStreamVolume(streamType); 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamVolume", e); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 59725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * Get last audible volume before stream was muted. 59825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 59925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 60025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 60125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public int getLastAudibleStreamVolume(int streamType) { 60225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 60325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 60425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return service.getLastAudibleStreamVolume(streamType); 60525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 60625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); 60725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return 0; 60825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 60925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 61025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 61125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the ringer mode. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Silent mode will mute the volume and will not vibrate. Vibrate mode will 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mute the volume and vibrate. Normal mode will be audible and may vibrate 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * according to user settings. 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRingerMode(int ringerMode) { 62372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (!isValidRingerMode(ringerMode)) { 62472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return; 62572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setRingerMode(ringerMode); 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setRingerMode", e); 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the volume index for a particular stream. 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream whose volume index should be set. 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The volume index to set. See 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getStreamMaxVolume(int)} for the largest valid value. 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamVolume(int streamType, int index, int flags) { 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamVolume(streamType, index, flags); 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamVolume", e); 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Solo or unsolo a particular stream. All other streams are muted. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo command is protected against client process death: if a process 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active solo request on a stream dies, all streams that were muted 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because of this request will be unmuted automatically. 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo requests for a given stream are cumulative: the AudioManager 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several solo requests from one or more clients and the stream 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unsoloed only when the same number of unsolo requests are received. 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unsolo a soloed stream 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and solo is again in onResume() if appropriate. 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be soloed/unsoloed. 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required solo state: true for solo ON, false for solo OFF 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamSolo(int streamType, boolean state) { 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamSolo(streamType, state, mICallBack); 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamSolo", e); 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mute or unmute an audio stream. 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute command is protected against client process death: if a process 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active mute request on a stream dies, this stream will be unmuted 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * automatically. 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute requests for a given stream are cumulative: the AudioManager 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several mute requests from one or more clients and the stream 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unmuted only when the same number of unmute requests are received. 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unmute a muted stream 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and mute is again in onResume() if appropriate. 692fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 693fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 694fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be muted/unmuted. 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required mute state: true for mute ON, false for mute OFF 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamMute(int streamType, boolean state) { 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamMute(streamType, state, mICallBack); 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamMute", e); 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 70925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * get stream mute state. 71025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 71125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 71225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 71325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public boolean isStreamMute(int streamType) { 71425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 71525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 71625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return service.isStreamMute(streamType); 71725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 71825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in isStreamMute", e); 71925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return false; 72025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 72125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 72225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 72325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 724402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces the stream controlled by hard volume keys 725402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * specifying streamType == -1 releases control to the 726402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * logic. 727402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * 728402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 729402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 730402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public void forceVolumeControlStream(int streamType) { 731402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent mVolumeControlStream = streamType; 732402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 733402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 734402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether a particular type should vibrate according to user 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings and the current ringer mode. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that use notifications to 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate. The notification manager will not vibrate if the policy doesn't 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it, so the client should always set a vibrate pattern and let the 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * notification manager control whether or not to actually vibrate. 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether the type should vibrate at the instant this method is 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldVibrate(int vibrateType) { 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.shouldVibrate(vibrateType); 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in shouldVibrate", e); 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether the user's vibrate setting for a vibrate type. 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that want to vibrate, instead 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link #shouldVibrate(int)}. 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getVibrateSetting(int vibrateType) { 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getVibrateSetting(vibrateType); 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getVibrateSetting", e); 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return VIBRATE_SETTING_OFF; 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the setting for when the vibrate type should vibrate. 788fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 789fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 790fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateSetting The vibrate setting, one of 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ON}, 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setVibrateSetting(int vibrateType, int vibrateSetting) { 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setVibrateSetting(vibrateType, vibrateSetting); 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setVibrateSetting", e); 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the speakerphone on or off. 813fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 814fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 815fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to turn on speakerphone; 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn it off 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpeakerphoneOn(boolean on){ 821c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 822c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 823c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setSpeakerphoneOn(on); 824c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 825c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setSpeakerphoneOn", e); 826a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the speakerphone is on or off. 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if speakerphone is on, false if it's off 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSpeakerphoneOn() { 835c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 836c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 837c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isSpeakerphoneOn(); 838c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 839c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isSpeakerphoneOn", e); 840a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 841a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent //==================================================================== 8453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent // Bluetooth SCO control 8463def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 8473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 84895b88fbe744d8ce53b5f54f6fcd90c55094a8d14Eric Laurent * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} 8493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} 8503def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * or {@link #SCO_AUDIO_STATE_CONNECTED} 8513def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * 8523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 853dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead 8543def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 855dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @Deprecated 8563def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 8573def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_CHANGED = 8583def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.SCO_AUDIO_STATE_CHANGED"; 859dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 860dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 861dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 862dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * connection state has been updated. 863dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>This intent has two extras: 864dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 865dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_STATE} - The new SCO audio state. </li> 866dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE}- The previous SCO audio state. </li> 867dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 868dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p> EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: 869dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 870dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_DISCONNECTED}, </li> 871dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTING} or </li> 872dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTED}, </li> 873dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 874dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #startBluetoothSco() 875dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 876dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 877dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_UPDATED = 878dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; 879dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 8803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 881dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or 882dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. 8833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 8843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String EXTRA_SCO_AUDIO_STATE = 8853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.extra.SCO_AUDIO_STATE"; 8863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 8873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 888dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous 889dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * bluetooth SCO connection state. 890dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 891dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = 892dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; 893dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 894dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 895dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 896dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is not established 8973def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 8983def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; 8993def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 900dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} 901dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is established 9023def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9033def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTED = 1; 9043def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 905dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 906dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is being established 907dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 908dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTING = 2; 909dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 910dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE indicating that 9113def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * there was an error trying to obtain the state 9123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_ERROR = -1; 9143def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9153def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9163def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 9173def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Indicates if current platform supports use of SCO for off call use cases. 9183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Application wanted to use bluetooth SCO audio when the phone is not in call 9193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * must first call thsi method to make sure that the platform supports this 9203def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * feature. 9213def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @return true if bluetooth SCO can be used for audio when not in call 9223def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * false otherwise 9233def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 9243def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9253def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public boolean isBluetoothScoAvailableOffCall() { 9263def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent return mContext.getResources().getBoolean( 9273def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent com.android.internal.R.bool.config_bluetooth_sco_off_call); 9283def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 9293def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9303def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 9313def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Start bluetooth SCO audio connection. 9323def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 9333def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 9343def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method can be used by applications wanting to send and received audio 9353def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * to/from a bluetooth SCO headset while the phone is not in call. 9363def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>As the SCO connection establishment can take several seconds, 9373def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * applications should not rely on the connection to be available when the method 938dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} 9393def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. 940dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO 941dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * audio state before calling startBluetoothSco() by reading the intent returned by the receiver 942dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * registration. If the state is already CONNECTED, no state change will be received via the 943dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() 944dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * so that the connection stays active in case the current initiator stops the connection. 945dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>Unless the connection is already active as described above, the state will always 946dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection 947dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). 948dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>When finished with the SCO connection or if the establishment fails, the application must 949dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. 9503def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Even if a SCO connection is established, the following restrictions apply on audio 9513def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * output streams so that they can be routed to SCO headset: 952dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 953dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the stream type must be {@link #STREAM_VOICE_CALL} </li> 954dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 955dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 16kHz or 8kHz </li> 956dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 9573def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>The following restrictions apply on input streams: 958dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 959dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 960dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 8kHz </li> 961dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 9623def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Note that the phone application always has the priority on the usage of the SCO 9633def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * connection for telephony. If this method is called while the phone is in call 9643def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * it will be ignored. Similarly, if a call is received or sent while an application 9653def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * is using the SCO connection, the connection will be lost for the application and NOT 9663def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * returned automatically when the call ends. 9673def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #stopBluetoothSco() 968dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 9693def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9703def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void startBluetoothSco(){ 9713def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 9723def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 9733def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.startBluetoothSco(mICallBack); 9743def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 9753def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in startBluetoothSco", e); 9763def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 9773def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 9783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 9803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Stop bluetooth SCO audio connection. 9813def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 9823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 9833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method must be called by applications having requested the use of 9843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * bluetooth SCO audio with {@link #startBluetoothSco()} 985dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * when finished with the SCO connection or if connection fails. 9863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 9873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9883def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void stopBluetoothSco(){ 9893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 9903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 9913def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.stopBluetoothSco(mICallBack); 9923def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 9933def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in stopBluetoothSco", e); 9943def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 9953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 9963def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 998a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Request use of Bluetooth SCO headset for communications. 999fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1000fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1001fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1003a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param on set <var>true</var> to use bluetooth SCO for communications; 1004a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * <var>false</var> to not use bluetooth SCO for communications 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBluetoothScoOn(boolean on){ 1007c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1008c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1009c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setBluetoothScoOn(on); 1010c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1011c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setBluetoothScoOn", e); 1012a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1016a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Checks whether communications use Bluetooth SCO. 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1018a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return true if SCO is used for communications; 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothScoOn() { 1022c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1023c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1024c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isBluetoothScoOn(); 1025c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1026c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isBluetoothScoOn", e); 1027a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1028a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route A2DP audio to/from Bluetooth 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable A2DP audio 1034a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1036a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setBluetoothA2dpOn(boolean on){ 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether A2DP audio routing to the Bluetooth headset is on or off. 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if A2DP audio is being routed to/from Bluetooth headset; 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothA2dpOn() { 10468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") 1047a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1048a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1049a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1050a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1051a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets audio routing to the wired headset on or off. 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route audio to/from wired 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable wired headset audio 1059a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1061a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setWiredHeadsetOn(boolean on){ 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1065497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * Checks whether a wired headset is connected or not. 1066497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * <p>This is not a valid indication that audio playback is 1067497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * actually over the wired headset as audio routing depends on other conditions. 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1069497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @return true if a wired headset is connected. 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 1071497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @deprecated Use only to check is a headset is connected or not. 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWiredHeadsetOn() { 10748b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") 10756015a9715421a339c2b7bb63f9166504e3488179Eric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE && 10768b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") 1077a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1078a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1079a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1080a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1081a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 1086fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1087fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1088fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to mute the microphone; 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMicrophoneMute(boolean on){ 1094a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.muteMicrophone(on); 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if microphone is muted, false if it's not 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMicrophoneMute() { 1103a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.isMicrophoneMuted(); 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio mode. 1108fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1109fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * The audio mode encompasses audio routing AND the behavior of 1110fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * the telephony layer. Therefore this method should only be used by applications that 1111fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * replace the platform-wide management of audio settings or the main telephony application. 1112fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony 1113fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * application when it places a phone call, as it will cause signals from the radio layer 1114fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * to feed the platform mixer. 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11168aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 11178aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Informs the HAL about the current audio state so that 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it can route the audio appropriately. 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMode(int mode) { 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11249272b4b4a44fe1f33e3030810618194f817caaecEric Laurent service.setMode(mode, mICallBack); 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setMode", e); 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio mode. 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11338aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 11348aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current current audio state from the HAL. 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMode() { 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getMode(); 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getMode", e); 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return MODE_INVALID; 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* modes for setMode/getMode/setRoute/getRoute */ 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Audio harware modes. 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalid audio mode. 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = AudioSystem.MODE_INVALID; 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Current audio mode. Used to apply audio routing to current mode. 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normal audio mode: not ringing and no call established. 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringing audio mode. An incoming is being signaled. 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11688f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In call audio mode. A telephony call is established. 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; 11718f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi /** 11728f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In communication audio mode. An audio/video chat or VoIP call is established. 11738f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi */ 11748f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Routing bits for setRouting/getRouting API */ 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to earpiece 11794a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 11804a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1182a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11844a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * Routing audio output to speaker 11854a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 11864a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1188a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} 11914a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 11924a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth SCO 11974a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 11984a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1200a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to headset 12034a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12044a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1206a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth A2DP 12094a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12104a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1212a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used for mask parameter of {@link #setRouting(int,int,int)}. 12154a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12164a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1218a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio routing for a specified mode 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to change route. E.g., MODE_RINGTONE. 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param routes bit vector of routes requested, created from one or 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more of ROUTE_xxx types. Set bits indicate that route should be on 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mask bit vector of routes to change, created from one or more of 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ROUTE_xxx types. Unset bits indicate the route should be left unchanged 1228b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * 1229b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 1230a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * setBluetoothScoOn() methods instead. 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1232a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRouting(int mode, int routes, int mask) { 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio routing bit vector for a specified mode. 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to get route (e.g., MODE_RINGTONE) 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an audio route bit vector that can be compared with ROUTE_xxx 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bits 1242b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), 1243b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1245b9c9d260f21b321527c4622a123af9767630d94dEric Laurent @Deprecated 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRouting(int mode) { 1247a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return -1; 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether any music is active. 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if any music tracks are active. 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMusicActive() { 125625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return AudioSystem.isStreamActive(STREAM_MUSIC, 0); 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a generic audio configuration parameter. The use of these parameters 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are platform dependant, see libaudio 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Temporary interface - DO NOT USE 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * TODO: Replace with a more generic key:value get/set mechanism 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param key name of parameter to set. Must not be null. 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param value value of parameter. Must not be null. 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1272a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Use {@link #setPrameters(String)} instead 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1274a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setParameter(String key, String value) { 1275a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent setParameters(key+"="+value); 1276a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1277a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1278a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1279a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a variable number of parameter values to audio hardware. 1280a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1281a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keyValuePairs list of parameters key value pairs in the form: 1282a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1283a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1284a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1285a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public void setParameters(String keyValuePairs) { 1286a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.setParameters(keyValuePairs); 1287a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1288a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1289a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1290a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a varaible number of parameter values to audio hardware. 1291a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1292a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keys list of parameters 1293a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return list of parameters key value pairs in the form: 1294a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1295a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1296a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public String getParameters(String keys) { 1297a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.getParameters(keys); 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Sound effect identifiers */ 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Keyboard and direction pad click sound 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEY_CLICK = 0; 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved up 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_UP = 1; 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved down 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_DOWN = 2; 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved left 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_LEFT = 3; 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved right 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME standard keypress sound 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_STANDARD = 5; 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME spacebar keypress sound 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_SPACEBAR = 6; 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME delete keypress sound 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_DELETE = 7; 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME return_keypress sound 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_RETURN = 8; 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Number of sound effects 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int NUM_SOUND_EFFECTS = 9; 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1359105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1360105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1361105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1362105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version uses the UI settings to determine 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whether sounds are heard or not. 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType) { 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!querySoundEffectsEnabled()) { 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffect(effectType); 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1391105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1392105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1393105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1394105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1395a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * @param volume Sound effect volume. 1396a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * The volume value is a raw scalar so UI controls should be scaled logarithmically. 1397a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version is for applications that have their own 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings panel for enabling and controlling volume. 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType, float volume) { 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffectVolume(effectType, volume); 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings has an in memory cache, so this is fast. 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean querySoundEffectsEnabled() { 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Settings.System.getInt(mContext.getContentResolver(), Settings.System.SOUND_EFFECTS_ENABLED, 0) != 0; 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Load Sound effects. 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method must be called when sound effects are enabled. 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void loadSoundEffects() { 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.loadSoundEffects(); 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in loadSoundEffects"+e); 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unload Sound effects. 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method can be called to free some memory when 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sound effects are disabled. 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unloadSoundEffects() { 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.unloadSoundEffects(); 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in unloadSoundEffects"+e); 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14494050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent /** 1450d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. 14517f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1452d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1453d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1454d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN = 1; 1455d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1456d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a temporary gain or request of audio focus, anticipated to last a short 1457d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * amount of time. Examples of temporary changes are the playback of driving directions, or an 1458d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * event notification. 14597f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1460d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1461d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1462d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; 1463078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1464078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 1465983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * amount of time, and where it is acceptable for other audio applications to keep playing 1466983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * after having lowered their output level (also referred to as "ducking"). 1467078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Examples of temporary changes are the playback of driving directions where playback of music 1468078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * in the background is acceptable. 14697f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1470078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1471078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1472078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; 1473078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1474078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a loss of audio focus of unknown duration. 14757f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1476078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1477078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; 1478078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1479078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus. 14807f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1481078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1482078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; 1483078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1484078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus where the loser of the audio focus can 1485983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * lower its output volume if it wants to continue playing (also referred to as "ducking"), as 1486983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the new focus owner doesn't require others to be silent. 14877f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1488078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1489078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = 1490078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; 1491d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1492d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1493d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Interface definition for a callback to be invoked when the audio focus of the system is 1494d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * updated. 1495d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1496d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public interface OnAudioFocusChangeListener { 1497d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1498d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Called on the listener to notify it the audio focus for this listener has been changed. 1499d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * The focusChange value indicates whether the focus was gained, 1500d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * whether the focus was lost, and whether that loss is transient, or whether the new focus 1501d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * holder will hold it for an unknown amount of time. 1502983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * When losing focus, listeners can use the focus change information to decide what 1503983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * behavior to adopt when losing focus. A music player could for instance elect to lower 1504983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the volume of its music stream (duck) for transient focus losses, and pause otherwise. 1505983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, 1506078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} 1507983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. 1508d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 15097f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi public void onAudioFocusChange(int focusChange); 1510d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1511d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1512d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1513d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, 1514d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * to actual listener objects. 1515d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1516d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private HashMap<String, OnAudioFocusChangeListener> mAudioFocusIdListenerMap = 1517d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi new HashMap<String, OnAudioFocusChangeListener>(); 1518d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1519d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager 1520d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * instance. 1521d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1522d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Object mFocusListenerLock = new Object(); 1523d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1524d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private OnAudioFocusChangeListener findFocusListener(String id) { 1525d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi return mAudioFocusIdListenerMap.get(id); 1526d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1527d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1528d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1529d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Handler for audio focus events coming from the audio service. 1530d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1531d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = 1532d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi new FocusEventHandlerDelegate(); 1533078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi 1534d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1535d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Helper class to handle the forwarding of audio focus events to the appropriate listener 1536d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1537d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private class FocusEventHandlerDelegate { 1538d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Handler mHandler; 1539d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1540d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi FocusEventHandlerDelegate() { 1541d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Looper looper; 1542d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if ((looper = Looper.myLooper()) == null) { 1543d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi looper = Looper.getMainLooper(); 1544d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1545d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1546d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (looper != null) { 1547d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // implement the event handler delegate to receive audio focus events 1548d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = new Handler(looper) { 1549d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi @Override 1550d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void handleMessage(Message msg) { 1551d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi OnAudioFocusChangeListener listener = null; 1552d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1553d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi listener = findFocusListener((String)msg.obj); 1554d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1555d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (listener != null) { 15567f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi listener.onAudioFocusChange(msg.what); 1557d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1558d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1559d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1560d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1561d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = null; 1562d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1563d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1564d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1565d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Handler getHandler() { 1566d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return mHandler; 1567d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1568d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1569d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1570d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { 1571d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1572d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void dispatchAudioFocusChange(int focusChange, String id) { 1573d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); 1574d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); 1575d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1576d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1577d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1578d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1579d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { 1580d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (l == null) { 1581308e9a5d0975489982f93fd1f3728e6ed7a778d0Jean-Michel Trivi return new String(this.toString()); 1582d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1583d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return new String(this.toString() + l.toString()); 1584d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1585d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1586d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1587d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 15885f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 158946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Registers a listener to be called when audio focus changes. Calling this method is optional 159046b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it 159146b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * will register the listener as well if it wasn't registered already. 159246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to be notified of audio focus changes. 1593d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1594d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void registerAudioFocusListener(OnAudioFocusChangeListener l) { 1595d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1596d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { 1597d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return; 1598d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1599d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); 1600d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1601d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1602d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1603d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 16045f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 160546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Causes the specified listener to not be called anymore when focus is gained or lost. 160646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to unregister. 1607d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1608d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { 1609392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi 1610d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // remove locally 1611d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1612d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); 1613d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1614d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1615d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1616d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1617d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 161846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A failed focus change request. 1619d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1620d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_FAILED = 0; 1621d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 162246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A successful focus change request. 1623d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1624d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; 1625d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1626d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1627d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1628d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Request audio focus. 162946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Send a request to obtain the audio focus 1630d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param l the listener to be notified of audio focus changes 1631d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param streamType the main audio stream type affected by the focus request 1632d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 1633d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 1634078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * for the playback of driving directions, or notifications sounds. 1635983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 1636983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 1637078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 1638d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * as the playback of a song or a video. 1639d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 1640d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1641d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { 1642d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 164355d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi if ((durationHint < AUDIOFOCUS_GAIN) || (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK)) 164455d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi { 164555d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi Log.e(TAG, "Invalid duration hint, audio focus request denied"); 164655d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi return status; 164755d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi } 1648d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi registerAudioFocusListener(l); 1649d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi //TODO protect request by permission check? 1650d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 1651d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 1652d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi status = service.requestAudioFocus(streamType, durationHint, mICallBack, 16538f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mAudioFocusDispatcher, getIdForAudioFocusListener(l), 16548f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mContext.getPackageName() /* package name */); 1655d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 1656d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocus() from AudioService due to "+e); 1657d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1658d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 1659d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1660d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1661d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1662d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 166346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 166446b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener with which focus was requested. 1665d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 1666d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1667d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l) { 1668d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 1669392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi unregisterAudioFocusListener(l); 1670d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 1671d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 1672d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi status = service.abandonAudioFocus(mAudioFocusDispatcher, 1673d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi getIdForAudioFocusListener(l)); 1674d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 1675d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocus() from AudioService due to "+e); 1676d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1677d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 1678d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1679d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1680d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1681d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi //==================================================================== 1682d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi // Remote Control 1683d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 168446b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Register a component to be the sole receiver of MEDIA_BUTTON intents. 1685d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 1686d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * that will receive the media button intent. This broadcast receiver must be declared 1687d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * in the application manifest. 1688d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 1689d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { 16908f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 16918f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 16928f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 1693d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 1694d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 1695d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi service.registerMediaButtonEventReceiver(eventReceiver); 1696d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 1697d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Log.e(TAG, "Dead object in registerMediaButtonEventReceiver"+e); 1698d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1699d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1700d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 1701d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 170246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Unregister the receiver of MEDIA_BUTTON intents. 170346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 170446b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. 1705d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 1706d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { 17078f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 17088f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 17098f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 1710d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 1711d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 1712d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi service.unregisterMediaButtonEventReceiver(eventReceiver); 1713d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 1714d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterMediaButtonEventReceiver"+e); 1715d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1716d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1717d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 1718d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 1719178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Acts as a proxy between AudioService and the RemoteControlClient 1720178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi */ 1721178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi private IRemoteControlClientDispatcher mRcClientDispatcher = 1722178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi new IRemoteControlClientDispatcher.Stub() { 1723178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1724178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public String getMetadataStringForClient(String clientName, int field) { 1725178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi RemoteControlClient realClient; 1726178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi synchronized(mRcClientMap) { 1727178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi realClient = mRcClientMap.get(clientName); 1728178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1729178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if (realClient != null) { 1730178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return realClient.getMetadataString(field); 1731178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } else { 1732178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return null; 1733178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1734178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1735178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1736178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public int getPlaybackStateForClient(String clientName) { 1737178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi RemoteControlClient realClient; 1738178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi synchronized(mRcClientMap) { 1739178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi realClient = mRcClientMap.get(clientName); 1740178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1741178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if (realClient != null) { 1742178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return realClient.getPlaybackState(); 1743178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } else { 1744178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return 0; 1745178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1746178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1747178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1748178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public int getTransportControlFlagsForClient(String clientName) { 1749178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi RemoteControlClient realClient; 1750178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi synchronized(mRcClientMap) { 1751178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi realClient = mRcClientMap.get(clientName); 1752178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1753178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if (realClient != null) { 1754178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return realClient.getTransportControlFlags(); 1755178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } else { 1756178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return 0; 1757178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1758178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1759178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1760178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public Bitmap getAlbumArtForClient(String clientName, int maxWidth, int maxHeight) { 1761178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi RemoteControlClient realClient; 1762178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi synchronized(mRcClientMap) { 1763178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi realClient = mRcClientMap.get(clientName); 1764178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1765178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if (realClient != null) { 1766178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return realClient.getAlbumArt(maxWidth, maxHeight); 1767178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } else { 1768178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return null; 1769178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1770178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1771178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi }; 1772178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1773178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi private HashMap<String, RemoteControlClient> mRcClientMap = 1774178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi new HashMap<String, RemoteControlClient>(); 1775178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1776178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi private String getIdForRcClient(RemoteControlClient client) { 1777178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi // client is guaranteed to be non-null 1778178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return client.toString(); 1779178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1780178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1781178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 17828f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @hide 1783178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Registers the remote control client for providing information to display on the remote 1784178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * controls. 17858f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 17868f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * that will receive the media button intent, and associated with the remote control 17878f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * client. This method has no effect if 17888f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * {@link #registerMediaButtonEventReceiver(ComponentName)} hasn't been called 17898f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * with the same eventReceiver, or if 17908f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * {@link #unregisterMediaButtonEventReceiver(ComponentName)} has been called. 1791178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @param rcClient the remote control client associated with the event receiver, responsible 1792178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * for providing the information to display on the remote control. 17938f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 17948f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi public void registerRemoteControlClient(ComponentName eventReceiver, 1795178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi RemoteControlClient rcClient) { 1796178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if ((eventReceiver == null) || (rcClient == null)) { 17978f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 17988f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 1799178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi String clientKey = getIdForRcClient(rcClient); 1800178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi synchronized(mRcClientMap) { 1801178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if (mRcClientMap.containsKey(clientKey)) { 1802178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return; 1803178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1804178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi mRcClientMap.put(clientKey, rcClient); 1805178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 18068f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 18078f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 1808178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi service.registerRemoteControlClient(eventReceiver, mRcClientDispatcher, clientKey, 18098f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi // used to match media button event receiver and audio focus 18108f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mContext.getPackageName()); 18118f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 18128f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlClient"+e); 1813178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi synchronized(mRcClientMap) { 1814178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi mRcClientMap.remove(clientKey); 1815178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 18168f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18178f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18188f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 18198f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 18208f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @hide 1821fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * Unregisters the remote control client that was providing information to display on the 1822fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * remotes. 1823fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 1824fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * that receives the media button intent, and associated with the remote control 1825fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * client. 1826178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @param rcClient the remote control client to unregister 1827178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @see #registerRemoteControlClient(ComponentName, RemoteControlClient) 18288f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 1829178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public void unregisterRemoteControlClient(ComponentName eventReceiver, 1830178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi RemoteControlClient rcClient) { 1831178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if ((eventReceiver == null) || (rcClient == null)) { 18328f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 18338f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18348f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 18358f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 1836178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi // remove locally 1837178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi boolean unregister = true; 1838178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi synchronized(mRcClientMap) { 1839178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if (mRcClientMap.remove(getIdForRcClient(rcClient)) == null) { 1840178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi unregister = false; 1841178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1842178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 1843178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi if (unregister) { 1844178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi // unregistering a RemoteControlClient is equivalent to setting it to null 1845178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi service.registerRemoteControlClient(eventReceiver, null, null, 1846178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi mContext.getPackageName()); 1847178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi } 18488f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 18498f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlClient"+e); 18508f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18518f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18528f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 18538f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 18548f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @hide 1855ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh * Returns the current remote control client. 1856178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @param rcClientId the generation counter that matches the extra 1857178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * {@link AudioManager#EXTRA_REMOTE_CONTROL_CLIENT_GENERATION} in the 1858ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh * {@link AudioManager#REMOTE_CONTROL_CLIENT_CHANGED} event 1859178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @return the current RemoteControlClient from which information to display on the remote 1860ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh * control can be retrieved, or null if rcClientId doesn't match the current generation 1861ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh * counter. 1862ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh */ 1863178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public IRemoteControlClientDispatcher getRemoteControlClientDispatcher(int rcClientId) { 1864ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh IAudioService service = getService(); 1865ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh try { 1866178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi return service.getRemoteControlClientDispatcher(rcClientId); 1867ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh } catch (RemoteException e) { 1868ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh Log.e(TAG, "Dead object in getRemoteControlClient "+e); 1869ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh return null; 1870ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh } 1871ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh } 1872ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh 1873ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh /** 1874ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh * @hide 18758f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * Broadcast intent action indicating that the displays on the remote controls 18768f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * should be updated because a new remote control client is now active. If there is no 18778f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * {@link #EXTRA_REMOTE_CONTROL_CLIENT}, the remote control display should be cleared 18788f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * because there is no valid client to supply it with information. 18798f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * 18808f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @see #EXTRA_REMOTE_CONTROL_CLIENT 18818f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 18828f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi public static final String REMOTE_CONTROL_CLIENT_CHANGED = 18838f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi "android.media.REMOTE_CONTROL_CLIENT_CHANGED"; 18848f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 18858f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 18868f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @hide 1887178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * The IRemoteControlClientDispatcher monotonically increasing generation counter. 1888178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * 1889178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 1890178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi */ 1891178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_CLIENT_GENERATION = 1892178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_CLIENT_GENERATION"; 1893178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 1894178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 1895178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @hide 1896178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * The name of the RemoteControlClient. 1897178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * This String is passed as the client name when calling methods from the 1898178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * IRemoteControlClientDispatcher interface. 18998f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * 19008f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 19018f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 1902178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_CLIENT_NAME = 1903178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_CLIENT_NAME"; 19048f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 19058f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 19068f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @hide 1907178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * The media button event receiver associated with the RemoteControlClient. 19080a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * The {@link android.content.ComponentName} value of the event receiver can be retrieved with 19090a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * {@link android.content.ComponentName#unflattenFromString(String)} 19100a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * 19110a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 19120a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi */ 19130a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_EVENT_RECEIVER = 19140a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_EVENT_RECEIVER"; 19150a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi 19160a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi /** 19170a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * @hide 1918b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi * The flags describing what information has changed in the current remote control client. 1919b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi * 1920b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 1921b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi */ 1922b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_CLIENT_INFO_CHANGED = 1923b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_CLIENT_INFO_CHANGED"; 1924b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi 1925b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi /** 1926b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi * @hide 1927a30a21cf2ef37b490e3790aad3105cda115124d6Jean-Michel Trivi * Notifies the users of the associated remote control client that the information to display 1928a30a21cf2ef37b490e3790aad3105cda115124d6Jean-Michel Trivi * has changed. 19297b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 19307b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * that will receive the media button intent, and associated with the remote control 19317b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * client. This method has no effect if 19327b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * {@link #registerMediaButtonEventReceiver(ComponentName)} hasn't been called 19337b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * with the same eventReceiver, or if 19347b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * {@link #unregisterMediaButtonEventReceiver(ComponentName)} has been called. 19357b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * @param infoFlag the type of information that has changed since this method was last called, 19367b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * or the event receiver was registered. Use one or multiple of the following flags to 19377b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi * describe what changed: 1938178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * {@link RemoteControlClient#FLAG_INFORMATION_CHANGED_METADATA}, 1939178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * {@link RemoteControlClient#FLAG_INFORMATION_CHANGED_KEY_MEDIA}, 1940178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * {@link RemoteControlClient#FLAG_INFORMATION_CHANGED_PLAYSTATE}, 1941178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * {@link RemoteControlClient#FLAG_INFORMATION_CHANGED_ALBUM_ART}. 19427b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi */ 19437b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi public void notifyRemoteControlInformationChanged(ComponentName eventReceiver, int infoFlag) { 19448f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 19458f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 19467b6198cacc3e7dd31ef91537d809857d826fb7faJean-Michel Trivi service.notifyRemoteControlInformationChanged(eventReceiver, infoFlag); 19478f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 19488f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in refreshRemoteControlDisplay"+e); 19498f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 19508f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 19518f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 19528f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 19534050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * @hide 19544050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * Reload audio settings. This method is called by Settings backup 19554050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * agent when audio settings are restored and causes the AudioService 19564050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * to read and apply restored settings. 19574050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent */ 19584050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent public void reloadAudioSettings() { 19594050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent IAudioService service = getService(); 19604050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent try { 19614050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent service.reloadAudioSettings(); 19624050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } catch (RemoteException e) { 19634050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent Log.e(TAG, "Dead object in reloadAudioSettings"+e); 19644050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 19654050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 19664050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent 19679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 19699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private IBinder mICallBack = new Binder(); 19717f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 19727f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten /** 19737f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * Checks whether the phone is in silent mode, with or without vibrate. 19747f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 19757f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @return true if phone is in silent mode, with or without vibrate. 19767f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 19777f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @see #getRingerMode() 19787f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 19797f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @hide pending API Council approval 19807f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten */ 19817f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten public boolean isSilentMode() { 19827f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten int ringerMode = getRingerMode(); 19837f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten boolean silentMode = 19847f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_SILENT) || 19857f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_VIBRATE); 19867f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten return silentMode; 19877f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten } 19887f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 19898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // This section re-defines new output device constants from AudioSystem, because the AudioSystem 19908b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // class is not used by other parts of the framework, which instead use definitions and methods 19918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. 19928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 19938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the small speaker at the front of the device used 19948b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * when placing calls. Does not refer to an in-ear headphone without attached microphone, 19958b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a 19968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}. 19978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 19988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; 19998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the built-in speaker */ 20008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; 20018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headset with attached microphone */ 20028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; 20038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headphone without attached microphone */ 20048b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; 20058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth SCO, for voice */ 20068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; 20078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO Headset Profile (HSP) and 20088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Hands-Free Profile (HFP), for voice 20098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20108b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 20118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; 20128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO car audio, for voice */ 20138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 20148b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; 20158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth A2DP, for music */ 20168b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; 20178b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP headphones, for music */ 20188b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 20198b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; 20208b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP external speaker, for music */ 20218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 20228b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; 20238b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for S/PDIF or HDMI */ 20248b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; 20258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for an analog wired headset attached via a 20268b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 20278b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; 20298b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a digital wired headset attached via a 20308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 20318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20328b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; 20338b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} This is not used as a returned value from {@link #getDevicesForStream}, but could be 20348b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * used in the future in a set method to select whatever default device is chosen by the 20358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * platform-specific implementation. 20368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; 20388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 20398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** 20408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Return the enabled devices for the specified output stream type. 20418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @param streamType The stream type to query. One of 20438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_VOICE_CALL}, 20448b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_SYSTEM}, 20458b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_RING}, 20468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_MUSIC}, 20478b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_ALARM}, 20488b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_NOTIFICATION}, 20498b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_DTMF}. 20508b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20518b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @return The bit-mask "or" of audio output device codes for all enabled devices on this 20528b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * stream. Zero or more of 20538b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_EARPIECE}, 20548b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_SPEAKER}, 20558b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADSET}, 20568b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}, 20578b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO}, 20588b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, 20598b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, 20608b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, 20618b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, 20628b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, 20638b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_AUX_DIGITAL}, 20648b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, 20658b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. 20668b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DEFAULT} is not used here. 20678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20688b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * The implementation may support additional device codes beyond those listed, so 20698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * the application should ignore any bits which it does not recognize. 20708b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Note that the information may be imprecise when the implementation 20718b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * cannot distinguish whether a particular device is enabled. 20728b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20738b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@hide} 20748b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20758b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public int getDevicesForStream(int streamType) { 20768b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten switch (streamType) { 20778b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_VOICE_CALL: 20788b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_SYSTEM: 20798b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_RING: 20808b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_MUSIC: 20818b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_ALARM: 20828b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_NOTIFICATION: 20838b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_DTMF: 20848b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return AudioSystem.getDevicesForStream(streamType); 20858b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten default: 20868b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return 0; 20878b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 20888b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 20898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 20909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2091