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 19a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Triviimport android.Manifest; 20958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Triviimport android.annotation.NonNull; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant.SdkConstantType; 23e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heoimport android.annotation.SystemApi; 24f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Triviimport android.app.PendingIntent; 25b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurentimport android.bluetooth.BluetoothDevice; 26d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.content.ComponentName; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 28f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Triviimport android.content.Intent; 29a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Triviimport android.media.audiopolicy.AudioPolicy; 30b214efbb9170a9f6a4991684a63ca59680074cc7RoboErikimport android.media.session.MediaController; 31b214efbb9170a9f6a4991684a63ca59680074cc7RoboErikimport android.media.session.MediaSession; 32f1372428f2df781c71c71caa2f6a4db6f847cf10RoboErikimport android.media.session.MediaSessionLegacyHelper; 33b214efbb9170a9f6a4991684a63ca59680074cc7RoboErikimport android.media.session.MediaSessionManager; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 37d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Looper; 38d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Message; 390c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monkimport android.os.Process; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 4186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.os.SystemClock; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.ServiceManager; 4370e0c58c2269cd29dfd6420d690da13dc03fd457Kenny Guyimport android.os.UserHandle; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.provider.Settings; 45e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLeanimport android.util.ArrayMap; 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 47e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLeanimport android.util.Pair; 48d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.view.KeyEvent; 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 50a198a29250acb7c3e918f1566727190966bb336fEric Laurentimport java.util.ArrayList; 51e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLeanimport java.util.Collection; 52b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kimimport java.util.HashMap; 53b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kimimport java.util.Iterator; 54700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioManager provides access to volume and ringer mode control. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use <code>Context.getSystemService(Context.AUDIO_SERVICE)</code> to get 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an instance of this class. 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioManager { 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6329f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen private Context mOriginalContext; 6429f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen private Context mApplicationContext; 6586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato private long mVolumeKeyUpTime; 66b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate private final boolean mUseVolumeKeySounds; 67ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent private final boolean mUseFixedVolume; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String TAG = "AudioManager"; 69f076db407029e734703d8676f806bea94393e824Eric Laurent private static final AudioPortEventHandler sAudioPortEventHandler = new AudioPortEventHandler(); 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent, a hint for applications that audio is about to become 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'noisy' due to a change in audio outputs. For example, this intent may 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent when a wired headset is unplugged, or when an A2DP audio 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sink is disconnected, and the audio system is about to automatically 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch audio route to the speaker. Applications that are controlling 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * audio streams may consider pausing, reducing volume or some other action 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on receipt of this intent so as not to surprise the user with audio 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the speaker. 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sticky broadcast intent action indicating that the ringer mode has 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the new ringer mode. 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_RINGER_MODE 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 94bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * @hide 95bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * Sticky broadcast intent action indicating that the internal ringer mode has 96bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * changed. Includes the new ringer mode. 97bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * 98bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * @see #EXTRA_RINGER_MODE 99bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock */ 100bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 101bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock public static final String INTERNAL_RINGER_MODE_CHANGED_ACTION = 102bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock "android.media.INTERNAL_RINGER_MODE_CHANGED_ACTION"; 103bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock 104bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock /** 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new ringer mode. 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_CHANGED_ACTION 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_NORMAL 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_SILENT 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_VIBRATE 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the vibrate setting has 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the vibrate type and its new setting. 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_SETTING 120cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 121cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1240dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String VIBRATE_SETTING_CHANGED_ACTION = 1250dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.VIBRATE_SETTING_CHANGED"; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Broadcast intent when the volume for a particular stream type changes. 1293114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Includes the stream, the new volume and previous volumes. 1303114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Notes: 1313114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - for internal platform use only, do not make public, 1323114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - never used for "remote" volume changes 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_TYPE 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_VALUE 1369ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @see #EXTRA_PREV_VOLUME_STREAM_VALUE 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1428a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * @hide Broadcast intent when the devices for a particular stream type changes. 1438a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * Includes the stream, the new devices and previous devices. 1448a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * Notes: 1458a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * - for internal platform use only, do not make public, 1468a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * - never used for "remote" volume changes 1478a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * 1488a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * @see #EXTRA_VOLUME_STREAM_TYPE 1498a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * @see #EXTRA_VOLUME_STREAM_DEVICES 1508a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * @see #EXTRA_PREV_VOLUME_STREAM_DEVICES 1518a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * @see #getDevicesForStream 1528a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock */ 1538a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1548a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock public static final String STREAM_DEVICES_CHANGED_ACTION = 1558a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock "android.media.STREAM_DEVICES_CHANGED_ACTION"; 1568a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock 1578a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock /** 1587c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @hide Broadcast intent when a stream mute state changes. 1597c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * Includes the stream that changed and the new mute state 1607c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * 1617c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @see #EXTRA_VOLUME_STREAM_TYPE 1627c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @see #EXTRA_STREAM_VOLUME_MUTED 1637c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik */ 1647c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1657c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik public static final String STREAM_MUTE_CHANGED_ACTION = 1667c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik "android.media.STREAM_MUTE_CHANGED_ACTION"; 1677c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik 1687c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik /** 1690dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master mute state changes. 1700dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the the new volume 1710dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1720dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_MUTED 1730dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1740dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1750dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_MUTE_CHANGED_ACTION = 1760dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_MUTE_CHANGED_ACTION"; 1770dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1780dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new vibrate setting for a particular type. 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ON 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_OFF 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ONLY_SILENT 186cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 187cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The vibrate type whose setting has changed. 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_NOTIFICATION 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_RINGER 197cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 198cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The stream type for the volume changed intent. 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 208560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi * @hide 209560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi * The stream type alias for the volume changed intent. 210560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi * For instance the intent may indicate a change of the {@link #STREAM_NOTIFICATION} stream 211560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi * type (as indicated by the {@link #EXTRA_VOLUME_STREAM_TYPE} extra), but this is also 212560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi * reflected by a change of the volume of its alias, {@link #STREAM_RING} on some devices, 213560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi * {@link #STREAM_MUSIC} on others (e.g. a television). 214560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi */ 215560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi public static final String EXTRA_VOLUME_STREAM_TYPE_ALIAS = 216560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi "android.media.EXTRA_VOLUME_STREAM_TYPE_ALIAS"; 217560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi 218560877d498b3b142bb0d555bb2fe48ead3fa9b0fJean-Michel Trivi /** 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The volume associated with the stream for the volume changed intent. 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_VALUE = 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.media.EXTRA_VOLUME_STREAM_VALUE"; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2249ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent /** 2259ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @hide The previous volume associated with the stream for the volume changed intent. 2269ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent */ 2279ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = 2289ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; 2290dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 2300dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 2318a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * @hide The devices associated with the stream for the stream devices changed intent. 2328a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock */ 2338a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock public static final String EXTRA_VOLUME_STREAM_DEVICES = 2348a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock "android.media.EXTRA_VOLUME_STREAM_DEVICES"; 2358a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock 2368a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock /** 2378a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock * @hide The previous devices associated with the stream for the stream devices changed intent. 2388a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock */ 2398a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock public static final String EXTRA_PREV_VOLUME_STREAM_DEVICES = 2408a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock "android.media.EXTRA_PREV_VOLUME_STREAM_DEVICES"; 2418a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock 2428a52c4491dfbb8354a92c0a1e6abc86848e187c6John Spurlock /** 2430dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume mute state for the master mute changed intent. 2440dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is boolean 2450dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 2460dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_MUTED = 2470dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_MUTED"; 2489ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent 249c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 2507c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @hide The new stream volume mute state for the stream mute changed intent. 2517c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * Value is boolean 2527c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik */ 2537c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik public static final String EXTRA_STREAM_VOLUME_MUTED = 2547c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik "android.media.EXTRA_STREAM_VOLUME_MUTED"; 2557c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik 2567c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik /** 257c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Broadcast Action: Wired Headset plugged in or unplugged. 258c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * 259c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * You <em>cannot</em> receive this through components declared 260c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * in manifests, only by explicitly registering for it with 261c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter) 262c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Context.registerReceiver()}. 263c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * 264c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <p>The intent will have the following extra values: 265c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <ul> 266c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <li><em>state</em> - 0 for unplugged, 1 for plugged. </li> 267c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <li><em>name</em> - Headset type, human readable string </li> 268c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <li><em>microphone</em> - 1 if headset has a microphone, 0 otherwise </li> 269c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * </ul> 270c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * </ul> 271c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 272c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 273c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi public static final String ACTION_HEADSET_PLUG = 274c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi "android.intent.action.HEADSET_PLUG"; 275c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 276c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 277bc68256fea95c25258d8faad6bb697c364ad5a90Eemi Haukkala * Broadcast Action: A sticky broadcast indicating an HDMI cable was plugged or unplugged. 278c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * 279c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * The intent will have the following extra values: {@link #EXTRA_AUDIO_PLUG_STATE}, 280c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link #EXTRA_MAX_CHANNEL_COUNT}, {@link #EXTRA_ENCODINGS}. 281c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <p>It can only be received by explicitly registering for it with 282c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)}. 283c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 284c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 285c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi public static final String ACTION_HDMI_AUDIO_PLUG = 286c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi "android.media.action.HDMI_AUDIO_PLUG"; 287c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 288c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 289c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Extra used in {@link #ACTION_HDMI_AUDIO_PLUG} to communicate whether HDMI is plugged in 290c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * or unplugged. 291c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * An integer value of 1 indicates a plugged-in state, 0 is unplugged. 292c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 293deddda5d62498bbaa9789c622be7a08be83f2f51Jean-Michel Trivi public static final String EXTRA_AUDIO_PLUG_STATE = "android.media.extra.AUDIO_PLUG_STATE"; 294c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 295c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 296c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Extra used in {@link #ACTION_HDMI_AUDIO_PLUG} to define the maximum number of channels 297c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * supported by the HDMI device. 298c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * The corresponding integer value is only available when the device is plugged in (as expressed 299c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * by {@link #EXTRA_AUDIO_PLUG_STATE}). 300c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 301deddda5d62498bbaa9789c622be7a08be83f2f51Jean-Michel Trivi public static final String EXTRA_MAX_CHANNEL_COUNT = "android.media.extra.MAX_CHANNEL_COUNT"; 302c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 303c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 304c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Extra used in {@link #ACTION_HDMI_AUDIO_PLUG} to define the audio encodings supported by 305c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * the connected HDMI device. 306c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * The corresponding array of encoding values is only available when the device is plugged in 307c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * (as expressed by {@link #EXTRA_AUDIO_PLUG_STATE}). Encoding values are defined in 308c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link AudioFormat} (for instance see {@link AudioFormat#ENCODING_PCM_16BIT}). Use 309c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link android.content.Intent#getIntArrayExtra(String)} to retrieve the encoding values. 310c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 311deddda5d62498bbaa9789c622be7a08be83f2f51Jean-Michel Trivi public static final String EXTRA_ENCODINGS = "android.media.extra.ENCODINGS"; 312c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for phone calls */ 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for system sounds */ 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for the phone ring */ 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = AudioSystem.STREAM_RING; 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for music playback */ 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for alarms */ 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for notifications */ 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide The audio stream for phone calls when connected to bluetooth */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; 327a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 328a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; 329a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** The audio stream for DTMF Tones */ 330a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; 331a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for text to speech (TTS) */ 332a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = AudioSystem.STREAM_TTS; 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Number of audio streams */ 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use AudioSystem.getNumStreamTypes() instead 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 337a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Increase the ringer volume. 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_RAISE = 1; 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decrease the ringer volume. 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_LOWER = -1; 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maintain the previous ringer volume. This may be useful when needing to 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * show the volume toast without actually modifying the volume. 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_SAME = 0; 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3644197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik /** 3654197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Mute the volume. Has no effect if the stream is already muted. 3664197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 3674197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustVolume(int, int) 3684197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 3694197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik */ 3704197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik public static final int ADJUST_MUTE = -100; 3714197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik 3724197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik /** 3734197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Unmute the volume. Has no effect if the stream is not muted. 3744197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 3754197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustVolume(int, int) 3764197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 3774197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik */ 3784197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik public static final int ADJUST_UNMUTE = 100; 3794197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik 3804197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik /** 3814197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Toggle the mute state. If muted the stream will be unmuted. If not muted 3824197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * the stream will be muted. 3834197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 3844197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustVolume(int, int) 3854197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 3864197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik */ 3874197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik public static final int ADJUST_TOGGLE_MUTE = 101; 3884197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Flags should be powers of 2! 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Show a toast containing the current volume. 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_SHOW_UI = 1 << 0; 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to include ringer modes as possible options when changing volume. 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if true and volume level is 0 and the volume is adjusted 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate mode. 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * By default this is on for the ring stream. If this flag is included, 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this behavior will be present regardless of the stream type being 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affected by the ringer mode. 410105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to play a sound when changing the volume. 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is given to {@link #adjustVolume(int, int)} or 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in some cases (for example, the decided stream type is not 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_RING}, or the volume is being adjusted 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * downward). 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_PLAY_SOUND = 1 << 2; 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any sounds/vibrate that may be in the queue, or are playing (related to 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changing volume). 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to vibrate if going into the vibrate ringer mode. 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_VIBRATE = 1 << 4; 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4434bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * Indicates to VolumePanel that the volume slider should be disabled as user 4444bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * cannot change the stream volume 4454bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * @hide 4464bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent */ 4474bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent public static final int FLAG_FIXED_VOLUME = 1 << 5; 4484bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent 4494bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent /** 450c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * Indicates the volume set/adjust call is for Bluetooth absolute volume 451c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * @hide 452c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie */ 453c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie public static final int FLAG_BLUETOOTH_ABS_VOLUME = 1 << 6; 454c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie 455c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie /** 456a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock * Adjusting the volume was prevented due to silent mode, display a hint in the UI. 457a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock * @hide 458a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock */ 459a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock public static final int FLAG_SHOW_SILENT_HINT = 1 << 7; 460a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock 461a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock /** 46241d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * Indicates the volume call is for Hdmi Cec system audio volume 46341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @hide 46441d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang */ 46541d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang public static final int FLAG_HDMI_SYSTEM_AUDIO_VOLUME = 1 << 8; 46641d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang 46741d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang /** 4683c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik * Indicates that this should only be handled if media is actively playing. 4693c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik * @hide 4703c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik */ 4713c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik public static final int FLAG_ACTIVE_MEDIA_ONLY = 1 << 9; 4723c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik 4733c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik /** 474351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock * Like FLAG_SHOW_UI, but only dialog warnings and confirmations, no sliders. 475351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock * @hide 476351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock */ 477351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock public static final int FLAG_SHOW_UI_WARNINGS = 1 << 10; 478351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock 479351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock /** 480661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * Adjusting the volume down from vibrated was prevented, display a hint in the UI. 481661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * @hide 482661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock */ 483661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public static final int FLAG_SHOW_VIBRATE_HINT = 1 << 11; 484661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 485b94f2d6cad92c4f6ad184920e06a260d87eb3b6aJohn Spurlock /** 486b94f2d6cad92c4f6ad184920e06a260d87eb3b6aJohn Spurlock * Adjusting the volume due to a hardware key press. 487b94f2d6cad92c4f6ad184920e06a260d87eb3b6aJohn Spurlock * @hide 488b94f2d6cad92c4f6ad184920e06a260d87eb3b6aJohn Spurlock */ 489b94f2d6cad92c4f6ad184920e06a260d87eb3b6aJohn Spurlock public static final int FLAG_FROM_KEY = 1 << 12; 490b94f2d6cad92c4f6ad184920e06a260d87eb3b6aJohn Spurlock 491661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock private static final String[] FLAG_NAMES = { 492661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_UI", 493661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_ALLOW_RINGER_MODES", 494661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_PLAY_SOUND", 495661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_REMOVE_SOUND_AND_VIBRATE", 496661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_VIBRATE", 497661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_FIXED_VOLUME", 498661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_BLUETOOTH_ABS_VOLUME", 499661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_SILENT_HINT", 500661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_HDMI_SYSTEM_AUDIO_VOLUME", 501661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_ACTIVE_MEDIA_ONLY", 502661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_UI_WARNINGS", 503661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_VIBRATE_HINT", 504b94f2d6cad92c4f6ad184920e06a260d87eb3b6aJohn Spurlock "FLAG_FROM_KEY", 505661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock }; 506661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 507661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** @hide */ 508661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public static String flagsToString(int flags) { 509661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock final StringBuilder sb = new StringBuilder(); 510661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock for (int i = 0; i < FLAG_NAMES.length; i++) { 511661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock final int flag = 1 << i; 512661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if ((flags & flag) != 0) { 513661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if (sb.length() > 0) { 514661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(','); 515661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 516661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(FLAG_NAMES[i]); 517661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock flags &= ~flag; 518661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 519661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 520661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if (flags != 0) { 521661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if (sb.length() > 0) { 522661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(','); 523661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 524661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(flags); 525661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 526661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return sb.toString(); 527661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 528661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 529661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will not vibrate. (This overrides the 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate setting.) 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_SILENT = 0; 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will vibrate. (This will cause the 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone ringer to always vibrate, but the notification vibrate to only 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate if set.) 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_VIBRATE = 1; 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that may be audible and may vibrate. It will be audible if 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the volume before changing out of this mode was audible. It will vibrate 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the vibrate setting is on. 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_NORMAL = 2; 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5589755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock /** 5599755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock * Maximum valid ringer mode value. Values must start from 0 and be contiguous. 5609755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock * @hide 5619755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock */ 5629755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock public static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; 56372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to the ringer. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 570cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 571cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_RINGER = 0; 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to notifications. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 581cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 582cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_NOTIFICATION = 1; 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to never vibrate. 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 591cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 592cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_OFF = 0; 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to vibrate when possible. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 601cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 602cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ON = 1; 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to only vibrate when in the vibrate ringer 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 612cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 613cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ONLY_SILENT = 2; 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Suggests using the default stream type. This may not be used in all 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * places a stream type is needed. 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService sService; 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioManager(Context context) { 62929f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen setContext(context); 63029f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen mUseVolumeKeySounds = getContext().getResources().getBoolean( 631b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate com.android.internal.R.bool.config_useVolumeKeySounds); 63229f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen mUseFixedVolume = getContext().getResources().getBoolean( 633ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent com.android.internal.R.bool.config_useFixedVolume); 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 63629f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen private Context getContext() { 63729f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen if (mApplicationContext == null) { 63829f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen setContext(mOriginalContext); 63929f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen } 64029f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen if (mApplicationContext != null) { 64129f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen return mApplicationContext; 64229f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen } 64329f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen return mOriginalContext; 64429f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen } 64529f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen 64629f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen private void setContext(Context context) { 64729f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen mApplicationContext = context.getApplicationContext(); 64829f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen if (mApplicationContext != null) { 64929f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen mOriginalContext = null; 65029f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen } else { 65129f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen mOriginalContext = context; 65229f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen } 65329f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen } 65429f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService getService() 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sService != null) { 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sService = IAudioService.Stub.asInterface(b); 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 666a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Sends a simulated key event for a media button. 667a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * To simulate a key press, you must first send a KeyEvent built with a 668a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#ACTION_DOWN} action, then another event with the {@link KeyEvent#ACTION_UP} 669a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * action. 670a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * <p>The key event will be sent to the current media key event consumer which registered with 671a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link AudioManager#registerMediaButtonEventReceiver(PendingIntent)}. 672a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param keyEvent a {@link KeyEvent} instance whose key code is one of 673a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MUTE}, 674a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_HEADSETHOOK}, 675a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY}, 676a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PAUSE}, 677a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY_PAUSE}, 678a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_STOP}, 679a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_NEXT}, 680a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PREVIOUS}, 681a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_REWIND}, 682a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_RECORD}, 683a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_FAST_FORWARD}, 684a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_CLOSE}, 685a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_EJECT}, 686a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * or {@link KeyEvent#KEYCODE_MEDIA_AUDIO_TRACK}. 687a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi */ 688a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi public void dispatchMediaKeyEvent(KeyEvent keyEvent) { 68929f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(getContext()); 690430fc48865e5a371b08f180390946b96d73848feRoboErik helper.sendMediaButtonEvent(keyEvent, false); 6917ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 6927ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 6937ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 6947ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 69586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 696ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void preDispatchKeyEvent(KeyEvent event, int stream) { 69786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 69886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * If the user hits another key within the play sound delay, then 69986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * cancel the sound 70086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 701ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 70286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP 70386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE 7046156017c2217d0fbbbb03434986250ec6bbd69d8John Spurlock && mVolumeKeyUpTime + AudioSystem.PLAY_SOUND_DELAY > SystemClock.uptimeMillis()) { 70586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 70686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * The user has hit another key during the delay (e.g., 300ms) 70786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * since the last volume key up, so cancel any sounds. 70886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 709ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock adjustSuggestedStreamVolume(ADJUST_SAME, 710ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 71186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 71286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 71386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 71486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 71586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 71686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 717ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyDown(KeyEvent event, int stream) { 718ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 71986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 72086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 72186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 72286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 72386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Adjust the volume in on key down since it is more 72486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * responsive to the user. 72586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 726ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock adjustSuggestedStreamVolume( 727ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock keyCode == KeyEvent.KEYCODE_VOLUME_UP 728ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock ? ADJUST_RAISE 729ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock : ADJUST_LOWER, 730ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock stream, 731ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock FLAG_SHOW_UI | FLAG_VIBRATE); 73286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 73386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 734ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (event.getRepeatCount() == 0) { 73529f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen MediaSessionLegacyHelper.getHelper(getContext()) 736926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen .sendVolumeKeyEvent(event, false); 737ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 73886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 73986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 74086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 74186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 74286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 74386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 74486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 745ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyUp(KeyEvent event, int stream) { 746ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 74786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 74886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 74986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 75086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 75186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Play a sound. This is done on key up since we don't want the 75286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * sound to play when a user holds down volume down to mute. 75386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 754b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseVolumeKeySounds) { 755ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock adjustSuggestedStreamVolume( 756ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock ADJUST_SAME, 757ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock stream, 758ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock FLAG_PLAY_SOUND); 759402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 76086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato mVolumeKeyUpTime = SystemClock.uptimeMillis(); 76186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 7627c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik case KeyEvent.KEYCODE_VOLUME_MUTE: 76329f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen MediaSessionLegacyHelper.getHelper(getContext()) 764926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen .sendVolumeKeyEvent(event, false); 7657c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik break; 76686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 76786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 76886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 76986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 770ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * Indicates if the device implements a fixed volume policy. 771ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>Some devices may not have volume control and may operate at a fixed volume, 772ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * and may not enable muting or changing the volume of audio streams. 773ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * This method will return true on such devices. 774ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>The following APIs have no effect when volume is fixed: 775ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <ul> 776ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustVolume(int, int)} 777ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustSuggestedStreamVolume(int, int, int)} 778ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustStreamVolume(int, int, int)} 779ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamVolume(int, int, int)} 780ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setRingerMode(int)} 781ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamSolo(int, boolean)} 782ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamMute(int, boolean)} 783ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * </ul> 784ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent */ 785ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent public boolean isVolumeFixed() { 786ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent return mUseFixedVolume; 787ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent } 788ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent 789ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent /** 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of a particular stream by one step in a direction. 791fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 792fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 793fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_ALARM} 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustStreamVolume(int streamType, int direction, int flags) { 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 808ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock service.adjustStreamVolume(streamType, direction, flags, 8098dc50416a209e76bca38694d59d5779ffcf08d92Marco Nelissen getContext().getOpPackageName()); 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustStreamVolume", e); 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream. For example, if a call is 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active, it will have the highest priority regardless of if the in-call 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen is showing. Another example, if music is playing in the background 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and a call is not active, the music stream will be adjusted. 820fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 8214197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method should only be used by applications that replace the 8224197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * platform-wide management of audio settings or the main telephony 8234197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * application. 8244197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <p> 8254197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method has no effect if the device implements a fixed volume policy 826ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 8274197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 8294197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, 8304197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_SAME}, {@link #ADJUST_MUTE}, 8314197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_UNMUTE}, or {@link #ADJUST_TOGGLE_MUTE}. 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustSuggestedStreamVolume(int, int, int) 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 836ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustVolume(int direction, int flags) { 8398dc50416a209e76bca38694d59d5779ffcf08d92Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(getContext()); 840ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock helper.sendAdjustVolumeBy(USE_DEFAULT_STREAM_TYPE, direction, flags); 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream, or the given fallback 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stream. 846fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 8474197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method should only be used by applications that replace the 8484197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * platform-wide management of audio settings or the main telephony 8494197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * application. 8504197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <p> 8514197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method has no effect if the device implements a fixed volume policy 852ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 8534197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 8554197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, 8564197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_SAME}, {@link #ADJUST_MUTE}, 8574197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_UNMUTE}, or {@link #ADJUST_TOGGLE_MUTE}. 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param suggestedStreamType The stream type that will be used if there 8594197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is 8604197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * valid here. 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 865ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { 8688dc50416a209e76bca38694d59d5779ffcf08d92Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(getContext()); 869ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock helper.sendAdjustVolumeBy(suggestedStreamType, direction, flags); 870cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 871cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood 872ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock /** @hide */ 873ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock public void setMasterMute(boolean mute, int flags) { 874cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood IAudioService service = getService(); 875cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood try { 87670e0c58c2269cd29dfd6420d690da13dc03fd457Kenny Guy service.setMasterMute(mute, flags, getContext().getOpPackageName(), 87770e0c58c2269cd29dfd6420d690da13dc03fd457Kenny Guy UserHandle.getCallingUserId()); 878cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } catch (RemoteException e) { 879ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock Log.e(TAG, "Dead object in setMasterMute", e); 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current ringtone mode. 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRingerMode() { 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 893661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return service.getRingerModeExternal(); 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getRingerMode", e); 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return RINGER_MODE_NORMAL; 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 90172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * Checks valid ringer mode values. 90272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 90372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @return true if the ringer mode indicated is valid, false otherwise. 90472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 90572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @see #setRingerMode(int) 90672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @hide 90772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent */ 90872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent public static boolean isValidRingerMode(int ringerMode) { 90972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { 91072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return false; 91172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 9129755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock IAudioService service = getService(); 9139755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock try { 9149755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock return service.isValidRingerMode(ringerMode); 9159755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock } catch (RemoteException e) { 9169755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock Log.e(TAG, "Dead object in isValidRingerMode", e); 9179755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock return false; 9189755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock } 91972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 92072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 92172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent /** 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum volume index for a particular stream. 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose maximum volume index is returned. 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The maximum valid volume index for the stream. 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamMaxVolume(int streamType) { 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 931ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getStreamMaxVolume(streamType); 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamMaxVolume", e); 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 939b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * Returns the minimum volume index for a particular stream. 940b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * 941b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @param streamType The stream type whose minimum volume index is returned. 942b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @return The minimum valid volume index for the stream. 943b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @see #getStreamVolume(int) 944b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @hide 945b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock */ 946b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock public int getStreamMinVolume(int streamType) { 947b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock IAudioService service = getService(); 948b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock try { 949b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock return service.getStreamMinVolume(streamType); 950b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock } catch (RemoteException e) { 951b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock Log.e(TAG, "Dead object in getStreamMinVolume", e); 952b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock return 0; 953b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock } 954b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock } 955b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock 956b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock /** 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current volume index for a particular stream. 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose volume index is returned. 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current volume index for the stream. 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamVolume(int streamType) { 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 967ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getStreamVolume(streamType); 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamVolume", e); 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 97525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * Get last audible volume before stream was muted. 97625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 97725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 97825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 97925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public int getLastAudibleStreamVolume(int streamType) { 98025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 98125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 982ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getLastAudibleStreamVolume(streamType); 98325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 98425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); 98525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return 0; 98625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 98725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 98825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 98925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 9906d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * Get the stream type whose volume is driving the UI sounds volume. 9916d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * UI sounds are screen lock/unlock, camera shutter, key clicks... 9924f0f120316cfcee5880191264885772677fff921John Spurlock * It is assumed that this stream type is also tied to ringer mode changes. 9936d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * @hide 9946d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent */ 995ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock public int getUiSoundsStreamType() { 9966d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent IAudioService service = getService(); 9976d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent try { 998ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getUiSoundsStreamType(); 9996d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } catch (RemoteException e) { 1000ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock Log.e(TAG, "Dead object in getUiSoundsStreamType", e); 10016d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return STREAM_RING; 10026d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 10036d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 10046d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent 10056d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent /** 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the ringer mode. 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Silent mode will mute the volume and will not vibrate. Vibrate mode will 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mute the volume and vibrate. Normal mode will be audible and may vibrate 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * according to user settings. 1011ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 1012ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 1016ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRingerMode(int ringerMode) { 101972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (!isValidRingerMode(ringerMode)) { 102072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return; 102172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 102429f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen service.setRingerModeExternal(ringerMode, getContext().getOpPackageName()); 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setRingerMode", e); 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the volume index for a particular stream. 1032ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 1033ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream whose volume index should be set. 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The volume index to set. See 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getStreamMaxVolume(int)} for the largest valid value. 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 1040ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamVolume(int streamType, int index, int flags) { 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10458dc50416a209e76bca38694d59d5779ffcf08d92Marco Nelissen service.setStreamVolume(streamType, index, flags, getContext().getOpPackageName()); 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamVolume", e); 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10524197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Solo or unsolo a particular stream. 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10544197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Do not use. This method has been deprecated and is now a no-op. 10554197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #requestAudioFocus} should be used for exclusive audio playback. 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be soloed/unsoloed. 10584197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @param state The required solo state: true for solo ON, false for solo 10594197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * OFF 1060ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 10614197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @deprecated Do not use. If you need exclusive audio playback use 10624197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #requestAudioFocus}. 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10644197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik @Deprecated 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamSolo(int streamType, boolean state) { 10664197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik Log.w(TAG, "setStreamSolo has been deprecated. Do not use."); 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mute or unmute an audio stream. 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10724197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method should only be used by applications that replace the 10734197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * platform-wide management of audio settings or the main telephony 10744197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * application. 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10764197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method has no effect if the device implements a fixed volume policy 1077ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 10784197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <p> 10794197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method was deprecated in API level 22. Prior to API level 22 this 10804197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * method had significantly different behavior and should be used carefully. 10814197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * The following applies only to pre-22 platforms: 10824197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <ul> 10834197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <li>The mute command is protected against client process death: if a 10844197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * process with an active mute request on a stream dies, this stream will be 10854197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * unmuted automatically.</li> 10864197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <li>The mute requests for a given stream are cumulative: the AudioManager 10874197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * can receive several mute requests from one or more clients and the stream 10884197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * will be unmuted only when the same number of unmute requests are 10894197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * received.</li> 10904197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <li>For a better user experience, applications MUST unmute a muted stream 10914197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * in onPause() and mute is again in onResume() if appropriate.</li> 10924197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * </ul> 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be muted/unmuted. 10954197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @param state The required mute state: true for mute ON, false for mute 10964197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * OFF 1097ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 10984197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @deprecated Use {@link #adjustStreamVolume(int, int, int)} with 10994197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_MUTE} or {@link #ADJUST_UNMUTE} instead. 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11014197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik @Deprecated 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamMute(int streamType, boolean state) { 11034197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik Log.w(TAG, "setStreamMute is deprecated. adjustStreamVolume should be used instead."); 11044197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik int direction = state ? ADJUST_MUTE : ADJUST_UNMUTE; 11054197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik if (streamType == AudioManager.USE_DEFAULT_STREAM_TYPE) { 11064197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik adjustSuggestedStreamVolume(direction, streamType, 0); 11074197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik } else { 11084197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik adjustStreamVolume(streamType, direction, 0); 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11134197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Returns the current mute state for a particular stream. 111425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 11154197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @param streamType The stream to get mute state for. 11164197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @return The mute state for the given stream. 11174197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 111825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 111925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public boolean isStreamMute(int streamType) { 112025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 112125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 1122ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.isStreamMute(streamType); 112325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 112425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in isStreamMute", e); 112525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return false; 112625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 112725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 112825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 112925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 1130ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * get master mute state. 1131ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 1132ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 1133ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 1134ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public boolean isMasterMute() { 1135ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 1136ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 1137ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.isMasterMute(); 1138ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 1139ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in isMasterMute", e); 1140ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return false; 1141ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1142ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1143ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 1144ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 1145402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces the stream controlled by hard volume keys 1146402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * specifying streamType == -1 releases control to the 1147402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * logic. 1148402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * 1149402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 1150402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 1151402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public void forceVolumeControlStream(int streamType) { 115245c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent IAudioService service = getService(); 115345c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent try { 115445c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent service.forceVolumeControlStream(streamType, mICallBack); 115545c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } catch (RemoteException e) { 115645c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent Log.e(TAG, "Dead object in forceVolumeControlStream", e); 115745c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } 1158402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 1159402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 1160402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether a particular type should vibrate according to user 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings and the current ringer mode. 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that use notifications to 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate. The notification manager will not vibrate if the policy doesn't 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it, so the client should always set a vibrate pattern and let the 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * notification manager control whether or not to actually vibrate. 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether the type should vibrate at the instant this method is 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 1176cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1177cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldVibrate(int vibrateType) { 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.shouldVibrate(vibrateType); 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in shouldVibrate", e); 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether the user's vibrate setting for a vibrate type. 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that want to vibrate, instead 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link #shouldVibrate(int)}. 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1203cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1204cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getVibrateSetting(int vibrateType) { 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getVibrateSetting(vibrateType); 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getVibrateSetting", e); 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return VIBRATE_SETTING_OFF; 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the setting for when the vibrate type should vibrate. 1218fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1219fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1220fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateSetting The vibrate setting, one of 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ON}, 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1231cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1232cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setVibrateSetting(int vibrateType, int vibrateSetting) { 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setVibrateSetting(vibrateType, vibrateSetting); 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setVibrateSetting", e); 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the speakerphone on or off. 1245fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1246fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1247fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to turn on speakerphone; 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn it off 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpeakerphoneOn(boolean on){ 1253c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1254c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1255c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setSpeakerphoneOn(on); 1256c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1257c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setSpeakerphoneOn", e); 1258a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the speakerphone is on or off. 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if speakerphone is on, false if it's off 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSpeakerphoneOn() { 1267c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1268c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1269c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isSpeakerphoneOn(); 1270c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1271c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isSpeakerphoneOn", e); 1272a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1273a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12763def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent //==================================================================== 12773def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent // Bluetooth SCO control 12783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 128095b88fbe744d8ce53b5f54f6fcd90c55094a8d14Eric Laurent * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} 12813def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} 12823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * or {@link #SCO_AUDIO_STATE_CONNECTED} 12833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * 12843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 1285dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead 12863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 1287dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @Deprecated 12883def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 12893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_CHANGED = 12903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.SCO_AUDIO_STATE_CHANGED"; 1291dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1292dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1293dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 1294dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * connection state has been updated. 1295dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>This intent has two extras: 1296dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1297dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_STATE} - The new SCO audio state. </li> 1298dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE}- The previous SCO audio state. </li> 1299dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1300dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p> EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: 1301dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1302dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_DISCONNECTED}, </li> 1303dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTING} or </li> 1304dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTED}, </li> 1305dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1306dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #startBluetoothSco() 1307dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1308dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1309dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_UPDATED = 1310dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; 1311dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 13123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1313dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or 1314dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. 13153def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13163def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String EXTRA_SCO_AUDIO_STATE = 13173def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.extra.SCO_AUDIO_STATE"; 13183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1320dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous 1321dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * bluetooth SCO connection state. 1322dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1323dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = 1324dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; 1325dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1326dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1327dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1328dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is not established 13293def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13303def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; 13313def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1332dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} 1333dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is established 13343def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13353def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTED = 1; 13363def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1337dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1338dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is being established 1339dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1340dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTING = 2; 1341dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1342dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE indicating that 13433def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * there was an error trying to obtain the state 13443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_ERROR = -1; 13463def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 13493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Indicates if current platform supports use of SCO for off call use cases. 13503def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Application wanted to use bluetooth SCO audio when the phone is not in call 13512ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi * must first call this method to make sure that the platform supports this 13523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * feature. 13533def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @return true if bluetooth SCO can be used for audio when not in call 13543def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * false otherwise 13553def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 13563def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13573def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public boolean isBluetoothScoAvailableOffCall() { 135829f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen return getContext().getResources().getBoolean( 13593def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent com.android.internal.R.bool.config_bluetooth_sco_off_call); 13603def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13613def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13623def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 13633def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Start bluetooth SCO audio connection. 13643def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 13653def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 13663def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method can be used by applications wanting to send and received audio 13673def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * to/from a bluetooth SCO headset while the phone is not in call. 13683def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>As the SCO connection establishment can take several seconds, 13693def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * applications should not rely on the connection to be available when the method 1370dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} 13713def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. 1372dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO 1373dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * audio state before calling startBluetoothSco() by reading the intent returned by the receiver 1374dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * registration. If the state is already CONNECTED, no state change will be received via the 1375dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() 1376dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * so that the connection stays active in case the current initiator stops the connection. 1377dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>Unless the connection is already active as described above, the state will always 1378dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection 1379dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). 1380dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>When finished with the SCO connection or if the establishment fails, the application must 1381dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. 13823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Even if a SCO connection is established, the following restrictions apply on audio 13833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * output streams so that they can be routed to SCO headset: 1384dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1385dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the stream type must be {@link #STREAM_VOICE_CALL} </li> 1386dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1387dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 16kHz or 8kHz </li> 1388dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 13893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>The following restrictions apply on input streams: 1390dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1391dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1392dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 8kHz </li> 1393dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 13943def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Note that the phone application always has the priority on the usage of the SCO 13953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * connection for telephony. If this method is called while the phone is in call 13963def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * it will be ignored. Similarly, if a call is received or sent while an application 13973def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * is using the SCO connection, the connection will be lost for the application and NOT 13983def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * returned automatically when the call ends. 139983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>NOTE: up to and including API version 140083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1}, this method initiates a virtual 140183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * voice call to the bluetooth headset. 140283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * After API version {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR2} only a raw SCO audio 140383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * connection is established. 14043def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #stopBluetoothSco() 1405dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 14063def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 14073def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void startBluetoothSco(){ 14083def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 14093def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 1410926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen service.startBluetoothSco(mICallBack, 141129f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen getContext().getApplicationInfo().targetSdkVersion); 14123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 14133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in startBluetoothSco", e); 14143def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 14153def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 14163def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 14173def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 14180daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * @hide 141983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Start bluetooth SCO audio connection in virtual call mode. 142083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>Requires Permission: 142183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 142283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>Similar to {@link #startBluetoothSco()} with explicit selection of virtual call mode. 142383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Telephony and communication applications (VoIP, Video Chat) should preferably select 142483900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * virtual call mode. 142583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Applications using voice input for search or commands should first try raw audio connection 142683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * with {@link #startBluetoothSco()} and fall back to startBluetoothScoVirtualCall() in case of 142783900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * failure. 142883900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #startBluetoothSco() 142983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #stopBluetoothSco() 143083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 143183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent */ 143283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent public void startBluetoothScoVirtualCall() { 143383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent IAudioService service = getService(); 143483900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent try { 143583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent service.startBluetoothScoVirtualCall(mICallBack); 143683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } catch (RemoteException e) { 143783900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent Log.e(TAG, "Dead object in startBluetoothScoVirtualCall", e); 143883900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } 143983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } 144083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent 144183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent /** 14423def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Stop bluetooth SCO audio connection. 14433def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 14443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 14453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method must be called by applications having requested the use of 14460daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * bluetooth SCO audio with {@link #startBluetoothSco()} when finished with the SCO 14470daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * connection or if connection fails. 14483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 14493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 14500daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi // Also used for connections started with {@link #startBluetoothScoVirtualCall()} 14513def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void stopBluetoothSco(){ 14523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 14533def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 14543def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.stopBluetoothSco(mICallBack); 14553def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 14563def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in stopBluetoothSco", e); 14573def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 14583def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 14593def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1461a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Request use of Bluetooth SCO headset for communications. 1462fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1463fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1464fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1466a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param on set <var>true</var> to use bluetooth SCO for communications; 1467a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * <var>false</var> to not use bluetooth SCO for communications 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBluetoothScoOn(boolean on){ 1470c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1471c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1472c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setBluetoothScoOn(on); 1473c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1474c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setBluetoothScoOn", e); 1475a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1479a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Checks whether communications use Bluetooth SCO. 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1481a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return true if SCO is used for communications; 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothScoOn() { 1485c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1486c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1487c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isBluetoothScoOn(); 1488c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1489c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isBluetoothScoOn", e); 1490a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1491a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1495242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @param on set <var>true</var> to route A2DP audio to/from Bluetooth 1496242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * headset; <var>false</var> disable A2DP audio 1497a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1499a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setBluetoothA2dpOn(boolean on){ 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1503242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * Checks whether A2DP audio routing to the Bluetooth headset is on or off. 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1505242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @return true if A2DP audio is being routed to/from Bluetooth headset; 1506242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * false if otherwise 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothA2dpOn() { 1509242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") 1510242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1511a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1512242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent } else { 1513242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent return true; 1514a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets audio routing to the wired headset on or off. 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route audio to/from wired 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable wired headset audio 1522a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1524a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setWiredHeadsetOn(boolean on){ 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1528497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * Checks whether a wired headset is connected or not. 1529497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * <p>This is not a valid indication that audio playback is 1530497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * actually over the wired headset as audio routing depends on other conditions. 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1532497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @return true if a wired headset is connected. 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 1534497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @deprecated Use only to check is a headset is connected or not. 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWiredHeadsetOn() { 15378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") 15386015a9715421a339c2b7bb63f9166504e3488179Eric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE && 15398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") 1540a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1541a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1542a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1543a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1544a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 1549fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1550fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1551fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to mute the microphone; 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 155670e0c58c2269cd29dfd6420d690da13dc03fd457Kenny Guy public void setMicrophoneMute(boolean on) { 155722c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier IAudioService service = getService(); 155822c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier try { 155970e0c58c2269cd29dfd6420d690da13dc03fd457Kenny Guy service.setMicrophoneMute(on, getContext().getOpPackageName(), 156070e0c58c2269cd29dfd6420d690da13dc03fd457Kenny Guy UserHandle.getCallingUserId()); 156122c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier } catch (RemoteException e) { 156222c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier Log.e(TAG, "Dead object in setMicrophoneMute", e); 156322c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier } 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if microphone is muted, false if it's not 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMicrophoneMute() { 1572a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.isMicrophoneMuted(); 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio mode. 1577fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1578fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * The audio mode encompasses audio routing AND the behavior of 1579fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * the telephony layer. Therefore this method should only be used by applications that 1580fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * replace the platform-wide management of audio settings or the main telephony application. 1581fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony 1582fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * application when it places a phone call, as it will cause signals from the radio layer 1583fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * to feed the platform mixer. 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15858aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 15868aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Informs the HAL about the current audio state so that 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it can route the audio appropriately. 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMode(int mode) { 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1593a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen service.setMode(mode, mICallBack, mApplicationContext.getOpPackageName()); 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setMode", e); 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio mode. 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16028aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 16038aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current current audio state from the HAL. 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMode() { 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getMode(); 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getMode", e); 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return MODE_INVALID; 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* modes for setMode/getMode/setRoute/getRoute */ 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Audio harware modes. 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalid audio mode. 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = AudioSystem.MODE_INVALID; 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Current audio mode. Used to apply audio routing to current mode. 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normal audio mode: not ringing and no call established. 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringing audio mode. An incoming is being signaled. 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16378f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In call audio mode. A telephony call is established. 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; 16408f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi /** 16418f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In communication audio mode. An audio/video chat or VoIP call is established. 16428f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi */ 16438f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Routing bits for setRouting/getRouting API */ 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to earpiece 16484a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16494a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1651a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16534a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * Routing audio output to speaker 16544a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16554a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1657a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} 16604a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16614a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth SCO 16664a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16674a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1669a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to headset 16724a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16734a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1675a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth A2DP 16784a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16794a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1681a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used for mask parameter of {@link #setRouting(int,int,int)}. 16844a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16854a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1687a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio routing for a specified mode 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to change route. E.g., MODE_RINGTONE. 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param routes bit vector of routes requested, created from one or 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more of ROUTE_xxx types. Set bits indicate that route should be on 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mask bit vector of routes to change, created from one or more of 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ROUTE_xxx types. Unset bits indicate the route should be left unchanged 1697b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * 1698b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 1699a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * setBluetoothScoOn() methods instead. 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1701a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRouting(int mode, int routes, int mask) { 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio routing bit vector for a specified mode. 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to get route (e.g., MODE_RINGTONE) 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an audio route bit vector that can be compared with ROUTE_xxx 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bits 1711b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), 1712b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1714b9c9d260f21b321527c4622a123af9767630d94dEric Laurent @Deprecated 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRouting(int mode) { 1716a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return -1; 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether any music is active. 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if any music tracks are active. 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMusicActive() { 172525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return AudioSystem.isStreamActive(STREAM_MUSIC, 0); 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17283114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi /** 17293114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * @hide 1730679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * Checks whether any music or media is actively playing on a remote device (e.g. wireless 1731679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * display). Note that BT audio sinks are not considered remote devices. 1732679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @return true if {@link AudioManager#STREAM_MUSIC} is active on a remote device 1733679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi */ 1734679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi public boolean isMusicActiveRemotely() { 1735679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi return AudioSystem.isStreamActiveRemotely(STREAM_MUSIC, 0); 1736679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi } 1737679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi 1738679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi /** 1739679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @hide 17402380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Checks whether the current audio focus is exclusive. 17412380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @return true if the top of the audio focus stack requested focus 17422380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * with {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} 17432380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 17442380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public boolean isAudioFocusExclusive() { 17452380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi IAudioService service = getService(); 17462380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi try { 17472380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return service.getCurrentAudioFocus() == AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE; 17482380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } catch (RemoteException e) { 17492380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi Log.e(TAG, "Dead object in isAudioFocusExclusive()", e); 17502380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return false; 17512380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 17522380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 17532380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 17542380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 17558a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * Return a new audio session identifier not associated with any player or effect. 17569e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * An audio session identifier is a system wide unique identifier for a set of audio streams 17579e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * (one or more mixed together). 17589e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * <p>The primary use of the audio session ID is to associate audio effects to audio players, 17599e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * such as {@link MediaPlayer} or {@link AudioTrack}: all audio effects sharing the same audio 17609e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * session ID will be applied to the mixed audio content of the players that share the same 17619e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * audio session. 17629e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * <p>This method can for instance be used when creating one of the 17639e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * {@link android.media.audiofx.AudioEffect} objects to define the audio session of the effect, 17649e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * or to specify a session for a speech synthesis utterance 17659e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * in {@link android.speech.tts.TextToSpeech.Engine}. 17668a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * @return a new unclaimed and unused audio session identifier, or {@link #ERROR} when the 17679e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * system failed to generate a new session, a condition in which audio playback or recording 17689e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * will subsequently fail as well. 17698a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi */ 1770289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi public int generateAudioSessionId() { 17718a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi int session = AudioSystem.newAudioSessionId(); 17728a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi if (session > 0) { 17738a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi return session; 17748a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } else { 1775289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi Log.e(TAG, "Failure to generate a new audio session ID"); 17768a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi return ERROR; 17778a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } 17788a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } 17798a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi 1780289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi /** 1781289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * A special audio session ID to indicate that the audio session ID isn't known and the 1782289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * framework should generate a new value. This can be used when building a new 1783289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioTrack} instance with 1784289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioTrack#AudioTrack(AudioAttributes, AudioFormat, int, int, int)}. 1785289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi */ 1786289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi public static final int AUDIO_SESSION_ID_GENERATE = AudioSystem.AUDIO_SESSION_ALLOCATE; 1787289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi 17888a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a generic audio configuration parameter. The use of these parameters 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are platform dependant, see libaudio 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Temporary interface - DO NOT USE 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * TODO: Replace with a more generic key:value get/set mechanism 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param key name of parameter to set. Must not be null. 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param value value of parameter. Must not be null. 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1802ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @deprecated Use {@link #setParameters(String)} instead 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1804a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setParameter(String key, String value) { 1805a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent setParameters(key+"="+value); 1806a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1807a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1808a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1809a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a variable number of parameter values to audio hardware. 1810a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1811a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keyValuePairs list of parameters key value pairs in the form: 1812a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1813a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1814a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1815a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public void setParameters(String keyValuePairs) { 1816a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.setParameters(keyValuePairs); 1817a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1818a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1819a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1820aac753dcf8862b416773eabaabb9d938a30f5896John Spurlock * Gets a variable number of parameter values from audio hardware. 1821a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1822a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keys list of parameters 1823a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return list of parameters key value pairs in the form: 1824a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1825a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1826a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public String getParameters(String keys) { 1827a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.getParameters(keys); 18289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Sound effect identifiers */ 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Keyboard and direction pad click sound 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEY_CLICK = 0; 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved up 18389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_UP = 1; 18419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved down 18439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_DOWN = 2; 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved left 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_LEFT = 3; 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved right 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME standard keypress sound 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_STANDARD = 5; 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME spacebar keypress sound 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_SPACEBAR = 6; 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME delete keypress sound 18689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_DELETE = 7; 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME return_keypress sound 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_RETURN = 8; 1876cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh 1877cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh /** 1878cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * Invalid keypress sound 1879cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * @see #playSoundEffect(int) 1880cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh */ 1881cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int FX_KEYPRESS_INVALID = 9; 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Number of sound effects 18849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1885cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int NUM_SOUND_EFFECTS = 10; 18869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 18899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 18919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 18929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 18939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 18949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1895105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1896105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1897105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1898105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1899cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version uses the UI settings to determine 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whether sounds are heard or not. 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType) { 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 19059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19080c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk if (!querySoundEffectsEnabled(Process.myUserHandle().getIdentifier())) { 19090c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk return; 19100c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 19110c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk 19120c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk IAudioService service = getService(); 19130c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk try { 19140c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk service.playSoundEffect(effectType); 19150c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } catch (RemoteException e) { 19160c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk Log.e(TAG, "Dead object in playSoundEffect"+e); 19170c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 19180c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 19190c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk 19200c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk /** 19210c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * Plays a sound effect (Key clicks, lid open/close...) 19220c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * @param effectType The type of sound effect. One of 19230c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEY_CLICK}, 19240c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_UP}, 19250c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_DOWN}, 19260c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_LEFT}, 19270c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 19280c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_STANDARD}, 19290c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_SPACEBAR}, 19300c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_DELETE}, 19310c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_RETURN}, 19320c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_INVALID}, 19330c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * @param userId The current user to pull sound settings from 19340c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * NOTE: This version uses the UI settings to determine 19350c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * whether sounds are heard or not. 19360c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * @hide 19370c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk */ 19380c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk public void playSoundEffect(int effectType, int userId) { 19390c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 19400c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk return; 19410c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 19420c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk 19430c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk if (!querySoundEffectsEnabled(userId)) { 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 19459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffect(effectType); 19509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 19519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 19529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 19599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 19609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 19619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 19629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1963105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1964105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1965105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1966105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1967cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 1968a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * @param volume Sound effect volume. 1969a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * The volume value is a raw scalar so UI controls should be scaled logarithmically. 1970a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. 19719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version is for applications that have their own 19729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings panel for enabling and controlling volume. 19739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType, float volume) { 19759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 19769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 19779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 19809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffectVolume(effectType, volume); 19829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 19839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 19849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings has an in memory cache, so this is fast. 19899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19900c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk private boolean querySoundEffectsEnabled(int user) { 199129f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen return Settings.System.getIntForUser(getContext().getContentResolver(), 19920c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk Settings.System.SOUND_EFFECTS_ENABLED, 0, user) != 0; 19939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Load Sound effects. 19989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method must be called when sound effects are enabled. 19999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void loadSoundEffects() { 20019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 20029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 20039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.loadSoundEffects(); 20049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 20059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in loadSoundEffects"+e); 20069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unload Sound effects. 20119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method can be called to free some memory when 20129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sound effects are disabled. 20139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unloadSoundEffects() { 20159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 20169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 20179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.unloadSoundEffects(); 20189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 20199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in unloadSoundEffects"+e); 20209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20234050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent /** 20242380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @hide 20252380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate no audio focus has been gained or lost. 20262380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 20272380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_NONE = 0; 20282380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 20292380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 2030d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. 20317f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 2032d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 2033d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2034d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN = 1; 2035d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2036d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a temporary gain or request of audio focus, anticipated to last a short 2037d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * amount of time. Examples of temporary changes are the playback of driving directions, or an 2038d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * event notification. 20397f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 2040d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 2041d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2042d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; 2043078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 2044078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 2045983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * amount of time, and where it is acceptable for other audio applications to keep playing 2046983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * after having lowered their output level (also referred to as "ducking"). 2047078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Examples of temporary changes are the playback of driving directions where playback of music 2048078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * in the background is acceptable. 20497f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 2050078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 2051078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 2052078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; 2053078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 20542380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 20552380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * amount of time, during which no other applications, or system components, should play 20562380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * anything. Examples of exclusive and transient audio focus requests are voice 20572380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * memo recording and speech recognition, during which the system shouldn't play any 20582380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * notifications, and media playback should have paused. 20592380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 20602380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 20612380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE = 4; 20622380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 2063078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a loss of audio focus of unknown duration. 20647f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 2065078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 2066078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; 2067078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 2068078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus. 20697f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 2070078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 2071078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; 2072078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 2073078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus where the loser of the audio focus can 2074983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * lower its output volume if it wants to continue playing (also referred to as "ducking"), as 2075983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the new focus owner doesn't require others to be silent. 20767f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 2077078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 2078078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = 2079078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; 2080d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2081d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2082d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Interface definition for a callback to be invoked when the audio focus of the system is 2083d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * updated. 2084d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2085d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public interface OnAudioFocusChangeListener { 2086d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2087d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Called on the listener to notify it the audio focus for this listener has been changed. 2088d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * The focusChange value indicates whether the focus was gained, 2089d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * whether the focus was lost, and whether that loss is transient, or whether the new focus 2090d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * holder will hold it for an unknown amount of time. 2091983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * When losing focus, listeners can use the focus change information to decide what 2092983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * behavior to adopt when losing focus. A music player could for instance elect to lower 2093983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the volume of its music stream (duck) for transient focus losses, and pause otherwise. 2094983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, 2095078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} 2096983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. 2097d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 20987f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi public void onAudioFocusChange(int focusChange); 2099d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2100d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2101d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2102d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, 2103d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * to actual listener objects. 2104d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 210530c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final HashMap<String, OnAudioFocusChangeListener> mAudioFocusIdListenerMap = 2106d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi new HashMap<String, OnAudioFocusChangeListener>(); 2107d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2108d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager 2109d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * instance. 2110d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2111d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Object mFocusListenerLock = new Object(); 2112d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2113d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private OnAudioFocusChangeListener findFocusListener(String id) { 2114d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi return mAudioFocusIdListenerMap.get(id); 2115d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2116d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2117d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2118d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Handler for audio focus events coming from the audio service. 2119d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 212030c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = 2121d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi new FocusEventHandlerDelegate(); 2122078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi 2123d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2124d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Helper class to handle the forwarding of audio focus events to the appropriate listener 2125d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2126d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private class FocusEventHandlerDelegate { 2127d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Handler mHandler; 2128d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2129d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi FocusEventHandlerDelegate() { 2130d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Looper looper; 2131d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if ((looper = Looper.myLooper()) == null) { 2132d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi looper = Looper.getMainLooper(); 2133d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2134d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2135d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (looper != null) { 2136d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // implement the event handler delegate to receive audio focus events 2137d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = new Handler(looper) { 2138d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi @Override 2139d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void handleMessage(Message msg) { 2140d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi OnAudioFocusChangeListener listener = null; 2141d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2142d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi listener = findFocusListener((String)msg.obj); 2143d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2144d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (listener != null) { 2145fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi Log.d(TAG, "AudioManager dispatching onAudioFocusChange(" 2146fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi + msg.what + ") for " + msg.obj); 21477f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi listener.onAudioFocusChange(msg.what); 2148d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2149d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2150d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 2151d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 2152d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = null; 2153d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2154d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2155d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2156d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Handler getHandler() { 2157d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return mHandler; 2158d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2159d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2160d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 216130c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { 2162d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2163d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void dispatchAudioFocusChange(int focusChange, String id) { 2164d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); 2165d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); 2166d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2167d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2168d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 2169d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2170d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { 2171d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (l == null) { 2172308e9a5d0975489982f93fd1f3728e6ed7a778d0Jean-Michel Trivi return new String(this.toString()); 2173d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 2174d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return new String(this.toString() + l.toString()); 2175d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2176d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2177d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2178d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 21795f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 218046b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Registers a listener to be called when audio focus changes. Calling this method is optional 218146b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it 218246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * will register the listener as well if it wasn't registered already. 218346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to be notified of audio focus changes. 2184d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2185d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void registerAudioFocusListener(OnAudioFocusChangeListener l) { 2186d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2187d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { 2188d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return; 2189d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2190d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); 2191d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2192d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2193d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2194d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 21955f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 219646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Causes the specified listener to not be called anymore when focus is gained or lost. 219746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to unregister. 2198d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2199d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { 2200392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi 2201d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // remove locally 2202d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2203d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); 2204d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2205d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2206d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2207d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2208d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 220946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A failed focus change request. 2210d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2211d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_FAILED = 0; 2212d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 221346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A successful focus change request. 2214d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2215d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; 2216fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi /** 2217fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @hide 2218fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * A focus change request whose granting is delayed: the request was successful, but the 2219fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * requester will only be granted audio focus once the condition that prevented immediate 2220fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * granting has ended. 2221fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * See {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2222fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi */ 2223fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_DELAYED = 2; 2224d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2225d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2226d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2227d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Request audio focus. 222846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Send a request to obtain the audio focus 2229d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param l the listener to be notified of audio focus changes 2230d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param streamType the main audio stream type affected by the focus request 2231d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 2232d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 2233078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * for the playback of driving directions, or notifications sounds. 2234983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 2235983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 22369171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * Alternatively use {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} for a temporary request 22379171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * that benefits from the system not playing disruptive sounds like notifications, for 22389171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * usecases such as voice memo recording, or speech recognition. 2239078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 2240d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * as the playback of a song or a video. 2241d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2242d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2243d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { 2244d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2245fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2246fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi try { 2247fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // status is guaranteed to be either AUDIOFOCUS_REQUEST_FAILED or 2248fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // AUDIOFOCUS_REQUEST_GRANTED as focus is requested without the 2249fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // AUDIOFOCUS_FLAG_DELAY_OK flag 2250fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi status = requestAudioFocus(l, 2251fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi new AudioAttributes.Builder() 2252fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi .setInternalLegacyStreamType(streamType).build(), 2253fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi durationHint, 2254fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 0 /* flags, legacy behavior */); 2255fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } catch (IllegalArgumentException e) { 2256fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi Log.e(TAG, "Audio focus request denied due to ", e); 2257fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2258fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2259fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi return status; 2260fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2261fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2262958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi // when adding new flags, add them to the relevant AUDIOFOCUS_FLAGS_APPS or SYSTEM masks 22630212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi /** 22640212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @hide 22650212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * Use this flag when requesting audio focus to indicate it is ok for the requester to not be 22660212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * granted audio focus immediately (as indicated by {@link #AUDIOFOCUS_REQUEST_DELAYED}) when 22670212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * the system is in a state where focus cannot change, but be granted focus later when 22680212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * this condition ends. 22690212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi */ 2270958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 2271fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi public static final int AUDIOFOCUS_FLAG_DELAY_OK = 0x1 << 0; 22720212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi /** 22730212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @hide 22740212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * Use this flag when requesting audio focus to indicate that the requester 22750212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * will pause its media playback (if applicable) when losing audio focus with 22760212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link #AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}, rather than ducking. 22770212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * <br>On some platforms, the ducking may be handled without the application being aware of it 22780212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * (i.e. it will not transiently lose focus). For applications that for instance play spoken 22790212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * content, such as audio book or podcast players, ducking may never be acceptable, and will 22800212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * thus always pause. This flag enables them to be declared as such whenever they request focus. 22810212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi */ 22820212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi @SystemApi 22830212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi public static final int AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS = 0x1 << 1; 22840212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi /** 22850212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @hide 22860212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * Use this flag to lock audio focus so granting is temporarily disabled. 22870212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * <br>This flag can only be used by owners of a registered 22880212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link android.media.audiopolicy.AudioPolicy} in 22890212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int, AudioPolicy)} 22900212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi */ 2291958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 22920212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi public static final int AUDIOFOCUS_FLAG_LOCK = 0x1 << 2; 2293958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** @hide */ 22940212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi public static final int AUDIOFOCUS_FLAGS_APPS = AUDIOFOCUS_FLAG_DELAY_OK 22950212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi | AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS; 2296958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** @hide */ 2297958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi public static final int AUDIOFOCUS_FLAGS_SYSTEM = AUDIOFOCUS_FLAG_DELAY_OK 22980212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi | AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS | AUDIOFOCUS_FLAG_LOCK; 2299fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2300fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi /** 2301fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @hide 2302958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Request audio focus. 2303958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Send a request to obtain the audio focus. This method differs from 2304958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)} in that it can express 2305958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * that the requester accepts delayed grants of audio focus. 2306fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @param l the listener to be notified of audio focus changes. It is not allowed to be null 2307fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * when the request is flagged with {@link #AUDIOFOCUS_FLAG_DELAY_OK}. 2308fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @param requestAttributes non null {@link AudioAttributes} describing the main reason for 2309fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * requesting audio focus. 2310fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 2311fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 2312fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * for the playback of driving directions, or notifications sounds. 2313fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 2314fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 2315fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * Alternatively use {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} for a temporary request 2316fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * that benefits from the system not playing disruptive sounds like notifications, for 2317fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * usecases such as voice memo recording, or speech recognition. 2318fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 2319fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * as the playback of a song or a video. 23200212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @param flags 0 or a combination of {link #AUDIOFOCUS_FLAG_DELAY_OK} 23210212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * and {@link #AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS}. 2322958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * <br>Use 0 when not using any flags for the request, which behaves like 2323958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, where either audio 2324958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * focus is granted immediately, or the grant request fails because the system is in a 2325958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * state where focus cannot change (e.g. a phone call). 2326fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED}, {@link #AUDIOFOCUS_REQUEST_GRANTED} 2327fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * or {@link #AUDIOFOCUS_REQUEST_DELAYED}. 2328fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * The return value is never {@link #AUDIOFOCUS_REQUEST_DELAYED} when focus is requested 2329fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * without the {@link #AUDIOFOCUS_FLAG_DELAY_OK} flag. 2330fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @throws IllegalArgumentException 2331fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi */ 2332958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 2333fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, 2334958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @NonNull AudioAttributes requestAttributes, 2335fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi int durationHint, 2336fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi int flags) throws IllegalArgumentException { 2337958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi if (flags != (flags & AUDIOFOCUS_FLAGS_APPS)) { 2338958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi throw new IllegalArgumentException("Invalid flags 0x" 2339958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi + Integer.toHexString(flags).toUpperCase()); 2340958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2341958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi return requestAudioFocus(l, requestAttributes, durationHint, 2342958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi flags & AUDIOFOCUS_FLAGS_APPS, 2343958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi null /* no AudioPolicy*/); 2344958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2345958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi 2346958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** 2347958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @hide 2348958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Request or lock audio focus. 2349958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * This method is to be used by system components that have registered an 2350958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link android.media.audiopolicy.AudioPolicy} to request audio focus, but also to "lock" it 2351958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * so focus granting is temporarily disabled. 2352958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param l see the description of the same parameter in 2353958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2354958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param requestAttributes non null {@link AudioAttributes} describing the main reason for 2355958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * requesting audio focus. 2356958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param durationHint see the description of the same parameter in 2357958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2358958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param flags 0 or a combination of {link #AUDIOFOCUS_FLAG_DELAY_OK}, 23590212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link #AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS}, and {@link #AUDIOFOCUS_FLAG_LOCK}. 2360958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * <br>Use 0 when not using any flags for the request, which behaves like 2361958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, where either audio 2362958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * focus is granted immediately, or the grant request fails because the system is in a 2363958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * state where focus cannot change (e.g. a phone call). 2364958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param ap a registered {@link android.media.audiopolicy.AudioPolicy} instance when locking 2365958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * focus, or null. 2366958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @return see the description of the same return value in 2367958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2368958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @throws IllegalArgumentException 2369958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi */ 23701b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi @SystemApi 2371958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, 2372958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @NonNull AudioAttributes requestAttributes, 2373958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi int durationHint, 2374958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi int flags, 2375958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi AudioPolicy ap) throws IllegalArgumentException { 2376fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // parameter checking 2377fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi if (requestAttributes == null) { 2378fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes argument"); 2379fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 23802380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi if ((durationHint < AUDIOFOCUS_GAIN) || 23812380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE)) { 2382fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException("Invalid duration hint"); 2383fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2384958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi if (flags != (flags & AUDIOFOCUS_FLAGS_SYSTEM)) { 2385fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException("Illegal flags 0x" 2386fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi + Integer.toHexString(flags).toUpperCase()); 238755d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi } 2388fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi if (((flags & AUDIOFOCUS_FLAG_DELAY_OK) == AUDIOFOCUS_FLAG_DELAY_OK) && (l == null)) { 2389fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException( 2390fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi "Illegal null focus listener when flagged as accepting delayed focus grant"); 2391fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2392958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi if (((flags & AUDIOFOCUS_FLAG_LOCK) == AUDIOFOCUS_FLAG_LOCK) && (ap == null)) { 2393958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi throw new IllegalArgumentException( 2394958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi "Illegal null audio policy when locking audio focus"); 2395958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2396fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2397fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2398d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi registerAudioFocusListener(l); 2399d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2400d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2401fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi status = service.requestAudioFocus(requestAttributes, durationHint, mICallBack, 24028f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mAudioFocusDispatcher, getIdForAudioFocusListener(l), 240329f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen getContext().getOpPackageName() /* package name */, flags, 24040212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi ap != null ? ap.cb() : null); 2405d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 2406958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocus() on AudioService:", e); 2407d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2408d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2409d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2410d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 24114dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 24124dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 24134dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to request audio focus. Will cause the focus request 24144dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to be associated with the "voice communication" identifier only used in AudioService 24154dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to identify this use case. 24164dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param streamType use STREAM_RING for focus requests when ringing, VOICE_CALL for 24174dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * the establishment of the call 24184dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param durationHint the type of focus request. AUDIOFOCUS_GAIN_TRANSIENT is recommended so 24194dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * media applications resume after a call 24204dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 24214dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void requestAudioFocusForCall(int streamType, int durationHint) { 24224dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 24234dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 2424fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi service.requestAudioFocus(new AudioAttributes.Builder() 2425fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi .setInternalLegacyStreamType(streamType).build(), 2426fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi durationHint, mICallBack, null, 24276156017c2217d0fbbbb03434986250ec6bbd69d8John Spurlock AudioSystem.IN_VOICE_COMM_FOCUS_ID, 242829f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen getContext().getOpPackageName(), 2429958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi AUDIOFOCUS_FLAG_LOCK, 2430958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi null /* policy token */); 24314dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 2432958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocusForCall() on AudioService:", e); 24334dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 24344dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 24354dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi 24364dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 24374dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 24384dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to abandon audio focus, typically after a call or 24394dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * when ringing ends and the call is rejected or not answered. 24404dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Should match one or more calls to {@link #requestAudioFocusForCall(int, int)}. 24414dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 24424dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void abandonAudioFocusForCall() { 24434dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 24444dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 24456156017c2217d0fbbbb03434986250ec6bbd69d8John Spurlock service.abandonAudioFocus(null, AudioSystem.IN_VOICE_COMM_FOCUS_ID, 2446958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi null /*AudioAttributes, legacy behavior*/); 24474dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 2448958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocusForCall() on AudioService:", e); 24494dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 24504dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 2451d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2452d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 245346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 245446b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener with which focus was requested. 2455d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2456d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2457d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l) { 2458958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi return abandonAudioFocus(l, null /*AudioAttributes, legacy behavior*/); 2459958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2460958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi 2461958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** 2462958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @hide 2463958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 2464958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param l the listener with which focus was requested. 2465958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param aa the {@link AudioAttributes} with which audio focus was requested 2466958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2467958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi */ 2468958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 2469958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l, AudioAttributes aa) { 2470d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2471392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi unregisterAudioFocusListener(l); 2472d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2473d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2474d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi status = service.abandonAudioFocus(mAudioFocusDispatcher, 2475958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi getIdForAudioFocusListener(l), aa); 2476d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 2477958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocus() on AudioService:", e); 2478d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2479d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2480d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2481d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2482d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi //==================================================================== 2483d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi // Remote Control 2484d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 248546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Register a component to be the sole receiver of MEDIA_BUTTON intents. 2486d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 2487d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * that will receive the media button intent. This broadcast receiver must be declared 2488f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * in the application manifest. The package of the component must match that of 2489f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * the context you're registering from. 2490b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession#setMediaButtonReceiver(PendingIntent)} instead. 2491d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2492b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2493d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { 24948f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 24958f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 24968f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 249729f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen if (!eventReceiver.getPackageName().equals(getContext().getPackageName())) { 2498f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "registerMediaButtonEventReceiver() error: " + 2499f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi "receiver and context package names don't match"); 2500f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2501f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2502f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and register it 2503f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2504f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2505f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 250629f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen PendingIntent pi = PendingIntent.getBroadcast(getContext(), 2507f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2508f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi registerMediaButtonIntent(pi, eventReceiver); 2509f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2510f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2511f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2512961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Register a component to be the sole receiver of MEDIA_BUTTON intents. This is like 2513961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(android.content.ComponentName)}, but allows 2514961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * the buttons to go to any PendingIntent. Note that you should only use this form if 2515961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * you know you will continue running for the full time until unregistering the 2516961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * PendingIntent. 2517961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver target that will receive media button intents. The PendingIntent 2518b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * will be sent an {@link Intent#ACTION_MEDIA_BUTTON} event when a media button action 2519b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * occurs, with {@link Intent#EXTRA_KEY_EVENT} added and holding the key code of the 2520b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * media button that was pressed. 2521b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession#setMediaButtonReceiver(PendingIntent)} instead. 2522961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2523b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2524961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void registerMediaButtonEventReceiver(PendingIntent eventReceiver) { 2525961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2526961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2527961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2528961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn registerMediaButtonIntent(eventReceiver, null); 2529961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2530961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2531961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2532f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2533f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * no-op if (pi == null) or (eventReceiver == null) 2534f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2535f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi public void registerMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { 2536961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (pi == null) { 2537f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Cannot call registerMediaButtonIntent() with a null parameter"); 2538f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2539f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 254029f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(getContext()); 254129f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen helper.addMediaButtonListener(pi, eventReceiver, getContext()); 2542722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2543722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi 2544722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi /** 254546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Unregister the receiver of MEDIA_BUTTON intents. 254646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 254746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. 2548b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 2549d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2550b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2551d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { 25528f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 25538f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 25548f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2555f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and unregister it 2556f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2557f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2558f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 255929f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen PendingIntent pi = PendingIntent.getBroadcast(getContext(), 2560f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2561b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(pi); 2562f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2563f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2564f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2565961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Unregister the receiver of MEDIA_BUTTON intents. 2566961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver same PendingIntent that was registed with 2567961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(PendingIntent)}. 2568b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 2569961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2570b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2571961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void unregisterMediaButtonEventReceiver(PendingIntent eventReceiver) { 2572961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2573961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2574961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2575b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(eventReceiver); 2576961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2577961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2578961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2579f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2580f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2581b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi public void unregisterMediaButtonIntent(PendingIntent pi) { 258229f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(getContext()); 2583430fc48865e5a371b08f180390946b96d73848feRoboErik helper.removeMediaButtonListener(pi); 2584d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2585d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 2586178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 2587178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Registers the remote control client for providing information to display on the remote 2588178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * controls. 2589466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client from which remote controls will receive 2590466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * information to display. 2591466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @see RemoteControlClient 2592b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 25938f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 2594b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 25954426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void registerRemoteControlClient(RemoteControlClient rcClient) { 2596f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 25978f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 25988f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 259929f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen rcClient.registerWithSession(MediaSessionLegacyHelper.getHelper(getContext())); 26008f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 26018f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 26028f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 2603fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * Unregisters the remote control client that was providing information to display on the 2604466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * remote controls. 2605466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client to unregister. 26064426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi * @see #registerRemoteControlClient(RemoteControlClient) 2607b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 26088f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 2609b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 26104426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void unregisterRemoteControlClient(RemoteControlClient rcClient) { 2611f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 26128f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 26138f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 261429f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen rcClient.unregisterWithSession(MediaSessionLegacyHelper.getHelper(getContext())); 26158f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 26168f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 261744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 2618a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * Registers a {@link RemoteController} instance for it to receive media 2619a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * metadata updates and playback state information from applications using 2620a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * {@link RemoteControlClient}, and control their playback. 2621a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * <p> 2622ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock * Registration requires the {@link RemoteController.OnClientUpdateListener} listener to be 2623a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * one of the enabled notification listeners (see 2624f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * {@link android.service.notification.NotificationListenerService}). 2625a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * 2626a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to register. 2627a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * @return true if the {@link RemoteController} was successfully registered, 2628a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * false if an error occurred, due to an internal system error, or 2629a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * insufficient permissions. 2630b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use 2631a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * {@link MediaSessionManager#addOnActiveSessionsChangedListener(android.media.session.MediaSessionManager.OnActiveSessionsChangedListener, ComponentName)} 2632a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * and {@link MediaController} instead. 26337ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 2634b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 26357ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public boolean registerRemoteController(RemoteController rctlr) { 26367ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 26377ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return false; 26387ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 2639430fc48865e5a371b08f180390946b96d73848feRoboErik rctlr.startListeningToSessions(); 2640430fc48865e5a371b08f180390946b96d73848feRoboErik return true; 26417ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 26427ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 26437ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 2644a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * Unregisters a {@link RemoteController}, causing it to no longer receive 2645a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * media metadata and playback state information, and no longer be capable 2646a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * of controlling playback. 2647a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * 2648a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to unregister. 2649b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use 2650a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * {@link MediaSessionManager#removeOnActiveSessionsChangedListener(android.media.session.MediaSessionManager.OnActiveSessionsChangedListener)} 2651a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * instead. 26527ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 2653b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 26547ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public void unregisterRemoteController(RemoteController rctlr) { 26557ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 26567ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return; 26577ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 2658430fc48865e5a371b08f180390946b96d73848feRoboErik rctlr.stopListeningToSessions(); 26597ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 26607ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 26617ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 26627ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 266344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 26644a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Use this method if your IRemoteControlDisplay is not going to display artwork, otherwise 26654a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * use {@link #registerRemoteControlDisplay(IRemoteControlDisplay, int, int)} to pass the 26664a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * artwork size directly, or 26674a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * {@link #remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay, int, int)} later if artwork 26684a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * is not yet needed. 2669f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * <p>Registration requires the {@link Manifest.permission#MEDIA_CONTENT_CONTROL} permission. 26704a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd the IRemoteControlDisplay 267144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 267244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd) { 26734a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi // passing a negative value for art work width and height as they are unknown at this stage 26744a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi registerRemoteControlDisplay(rcd, /*w*/-1, /*h*/ -1); 26754a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi } 26764a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi 26774a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi /** 26784a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @hide 26794a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 2680f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * <p>Registration requires the {@link Manifest.permission#MEDIA_CONTENT_CONTROL} permission. 26814a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd 26824a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 26834a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 26844a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 26854a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 26864a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi */ 26874a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd, int w, int h) { 268844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 268944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 269044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 269144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 269244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 26934a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi service.registerRemoteControlDisplay(rcd, w, h); 269444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 269544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); 269644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 269744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 269844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 269944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 270044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 270144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Unregisters a remote control display that was sent information by remote control clients. 270244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 270344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 270444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void unregisterRemoteControlDisplay(IRemoteControlDisplay rcd) { 270544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 270644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 270744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 270844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 270944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 271044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.unregisterRemoteControlDisplay(rcd); 271144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 271244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); 271344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 271444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 271544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 271644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 271744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 271844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Sets the artwork size a remote control display expects when receiving bitmaps. 271944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 272044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 272144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 272244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 272344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 272444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 272544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay rcd, int w, int h) { 272644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 272744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 272844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 272944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 273044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 273144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.remoteControlDisplayUsesBitmapSize(rcd, w, h); 273244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 273344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayUsesBitmapSize " + e); 273444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 273544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 2736ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh 2737b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi /** 27383261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @hide 2739c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * Controls whether a remote control display needs periodic checks of the RemoteControlClient 2740c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * playback position to verify that the estimated position has not drifted from the actual 2741c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position. By default the check is not performed. 2742c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * The IRemoteControlDisplay must have been previously registered for this to have any effect. 2743c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param rcd the IRemoteControlDisplay for which the anti-drift mechanism will be enabled 2744c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * or disabled. No effect is null. 2745c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param wantsSync if true, RemoteControlClient instances which expose their playback position 2746c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * to the framework will regularly compare the estimated playback position with the actual 2747c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position, and will update the IRemoteControlDisplay implementation whenever a drift is 2748c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * detected. 2749c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi */ 2750c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi public void remoteControlDisplayWantsPlaybackPositionSync(IRemoteControlDisplay rcd, 2751c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi boolean wantsSync) { 2752c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi if (rcd == null) { 2753c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi return; 2754c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2755c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi IAudioService service = getService(); 2756c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi try { 2757c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi service.remoteControlDisplayWantsPlaybackPositionSync(rcd, wantsSync); 2758c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } catch (RemoteException e) { 2759c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayWantsPlaybackPositionSync " + e); 2760c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2761c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2762c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi 2763c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi /** 2764a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @hide 2765a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * Register the given {@link AudioPolicy}. 2766a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * This call is synchronous and blocks until the registration process successfully completed 2767a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * or failed to complete. 27681b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi * @param policy the non-null {@link AudioPolicy} to register. 2769a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @return {@link #ERROR} if there was an error communicating with the registration service 2770a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * or if the user doesn't have the required 2771a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * {@link android.Manifest.permission#MODIFY_AUDIO_ROUTING} permission, 2772a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * {@link #SUCCESS} otherwise. 2773a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi */ 27741b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi @SystemApi 27751b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi public int registerAudioPolicy(@NonNull AudioPolicy policy) { 2776a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi if (policy == null) { 2777a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioPolicy argument"); 2778a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2779a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi IAudioService service = getService(); 2780a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi try { 27810212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi String regId = service.registerAudioPolicy(policy.getConfig(), policy.cb(), 27820212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi policy.hasFocusListener()); 27838fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi if (regId == null) { 2784a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return ERROR; 27858fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi } else { 27868fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi policy.setRegistration(regId); 2787a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 27888fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi // successful registration 2789a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } catch (RemoteException e) { 2790a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi Log.e(TAG, "Dead object in registerAudioPolicyAsync()", e); 2791a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return ERROR; 2792a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2793a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return SUCCESS; 2794a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2795a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2796a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi /** 2797a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @hide 27981b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi * @param policy the non-null {@link AudioPolicy} to unregister. 2799a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi */ 28001b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi @SystemApi 28011b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi public void unregisterAudioPolicyAsync(@NonNull AudioPolicy policy) { 2802a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi if (policy == null) { 2803a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioPolicy argument"); 2804a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2805a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi IAudioService service = getService(); 2806a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi try { 28070212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi service.unregisterAudioPolicyAsync(policy.cb()); 28081b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi policy.setRegistration(null); 2809a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } catch (RemoteException e) { 2810a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterAudioPolicyAsync()", e); 2811a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2812a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2813a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2814a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2815a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi /** 28164050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * @hide 28174050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * Reload audio settings. This method is called by Settings backup 28184050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * agent when audio settings are restored and causes the AudioService 28194050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * to read and apply restored settings. 28204050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent */ 28214050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent public void reloadAudioSettings() { 28224050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent IAudioService service = getService(); 28234050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent try { 28244050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent service.reloadAudioSettings(); 28254050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } catch (RemoteException e) { 28264050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent Log.e(TAG, "Dead object in reloadAudioSettings"+e); 28274050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 28284050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 28294050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent 28305a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du /** 28315a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * @hide 28325a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * Notifies AudioService that it is connected to an A2DP device that supports absolute volume, 28335a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * so that AudioService can send volume change events to the A2DP device, rather than handling 28345a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * them. 28355a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du */ 28365a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du public void avrcpSupportsAbsoluteVolume(String address, boolean support) { 28375a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du IAudioService service = getService(); 28385a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du try { 28395a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du service.avrcpSupportsAbsoluteVolume(address, support); 28405a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } catch (RemoteException e) { 28415a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du Log.e(TAG, "Dead object in avrcpSupportsAbsoluteVolume", e); 28425a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 28435a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 28445a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du 28459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 28469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 28479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 284830c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IBinder mICallBack = new Binder(); 28497f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 28507f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten /** 28517f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * Checks whether the phone is in silent mode, with or without vibrate. 28527f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 28537f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @return true if phone is in silent mode, with or without vibrate. 28547f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 28557f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @see #getRingerMode() 28567f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 28577f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @hide pending API Council approval 28587f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten */ 28597f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten public boolean isSilentMode() { 28607f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten int ringerMode = getRingerMode(); 28617f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten boolean silentMode = 28627f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_SILENT) || 28637f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_VIBRATE); 28647f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten return silentMode; 28657f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten } 28667f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 28678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // This section re-defines new output device constants from AudioSystem, because the AudioSystem 28688b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // class is not used by other parts of the framework, which instead use definitions and methods 28698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. 28708b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2871948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2872d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim * The audio device code for representing "no device." */ 2873d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim public static final int DEVICE_NONE = AudioSystem.DEVICE_NONE; 2874d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim /** @hide 2875948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for the small speaker at the front of the device used 28768b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * when placing calls. Does not refer to an in-ear headphone without attached microphone, 28778b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a 28788b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}. 28798b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28808b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; 2881948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2882948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for the built-in speaker */ 28838b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; 2884948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2885948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a wired headset with attached microphone */ 28868b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; 2887948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2888948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a wired headphone without attached microphone */ 28898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; 2890948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2891948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for generic Bluetooth SCO, for voice */ 28928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; 2893948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2894948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth SCO Headset Profile (HSP) and 2895948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Hands-Free Profile (HFP), for voice 28968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 28988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; 2899948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2900948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth SCO car audio, for voice */ 29018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 29028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; 2903948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2904948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for generic Bluetooth A2DP, for music */ 29058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; 2906948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2907948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth A2DP headphones, for music */ 29088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 29098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; 2910948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2911948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth A2DP external speaker, for music */ 29128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 29138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; 2914948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2915948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for S/PDIF (legacy) or HDMI 2916948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Deprecated: replaced by {@link #DEVICE_OUT_HDMI} */ 29178b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; 2918948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2919948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for HDMI */ 2920948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_HDMI = AudioSystem.DEVICE_OUT_HDMI; 2921948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2922948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for an analog wired headset attached via a 29238b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 29248b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 29258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; 2926948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2927948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a digital wired headset attached via a 29288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 29298b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 29308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; 2931948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2932948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a USB audio accessory. The accessory is in USB host 293359f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB device mode 293459f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 293559f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_ACCESSORY = AudioSystem.DEVICE_OUT_USB_ACCESSORY; 2936948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2937948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a USB audio device. The device is in USB device 293859f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB host mode 293959f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 294059f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_DEVICE = AudioSystem.DEVICE_OUT_USB_DEVICE; 2941948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2942948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for projection output. 2943948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2944948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_REMOTE_SUBMIX = AudioSystem.DEVICE_OUT_REMOTE_SUBMIX; 2945948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2946948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code the telephony voice TX path. 2947948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2948948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_TELEPHONY_TX = AudioSystem.DEVICE_OUT_TELEPHONY_TX; 2949948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2950948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for an analog jack with line impedance detected. 2951948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2952948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_LINE = AudioSystem.DEVICE_OUT_LINE; 2953948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2954948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for HDMI Audio Return Channel. 2955948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2956948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_HDMI_ARC = AudioSystem.DEVICE_OUT_HDMI_ARC; 2957948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2958948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for S/PDIF digital connection. 2959948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2960948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_SPDIF = AudioSystem.DEVICE_OUT_SPDIF; 2961948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2962948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for built-in FM transmitter. 2963948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2964948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_FM = AudioSystem.DEVICE_OUT_FM; 2965948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2966948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * This is not used as a returned value from {@link #getDevicesForStream}, but could be 29678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * used in the future in a set method to select whatever default device is chosen by the 29688b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * platform-specific implementation. 29698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 29708b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; 29718b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2972948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2973948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for default built-in microphone 2974948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2975948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BUILTIN_MIC = AudioSystem.DEVICE_IN_BUILTIN_MIC; 2976948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2977948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a Bluetooth SCO headset 2978948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2979948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BLUETOOTH_SCO_HEADSET = 2980948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_BLUETOOTH_SCO_HEADSET; 2981948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2982948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for wired headset microphone 2983948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2984948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_WIRED_HEADSET = 2985948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_WIRED_HEADSET; 2986948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2987948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for HDMI 2988948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2989948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_HDMI = 2990948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_HDMI; 2991948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2992948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for telephony voice RX path 2993948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2994948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_TELEPHONY_RX = 2995948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_TELEPHONY_RX; 2996948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2997948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for built-in microphone pointing to the back 2998948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2999948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BACK_MIC = 3000948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_BACK_MIC; 3001948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3002948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for analog from a docking station 3003948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3004948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_ANLG_DOCK_HEADSET = 3005948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_ANLG_DOCK_HEADSET; 3006948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3007948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for digital from a docking station 3008948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3009948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_DGTL_DOCK_HEADSET = 3010948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_DGTL_DOCK_HEADSET; 3011948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3012948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a USB audio accessory. The accessory is in USB host 3013948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * mode and the Android device in USB device mode 3014948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3015948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_USB_ACCESSORY = 3016948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_USB_ACCESSORY; 3017948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3018948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a USB audio device. The device is in USB device 3019948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * mode and the Android device in USB host mode 3020948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3021948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_USB_DEVICE = 3022948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_USB_DEVICE; 3023948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3024948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a FM radio tuner 3025948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3026948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_FM_TUNER = AudioSystem.DEVICE_IN_FM_TUNER; 3027948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3028948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a TV tuner 3029948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3030948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_TV_TUNER = AudioSystem.DEVICE_IN_TV_TUNER; 3031948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3032948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for an analog jack with line impedance detected 3033948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3034948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_LINE = AudioSystem.DEVICE_IN_LINE; 3035948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 3036948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a S/PDIF digital connection 3037948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3038948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_SPDIF = AudioSystem.DEVICE_IN_SPDIF; 3039112c19ee8b459439c3462767199832e5394b37a8Terry Heo /** @hide 3040112c19ee8b459439c3462767199832e5394b37a8Terry Heo * The audio input device code for audio loopback 3041112c19ee8b459439c3462767199832e5394b37a8Terry Heo */ 3042112c19ee8b459439c3462767199832e5394b37a8Terry Heo public static final int DEVICE_IN_LOOPBACK = AudioSystem.DEVICE_IN_LOOPBACK; 3043948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 3044948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** 3045948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Return true if the device code corresponds to an output device. 3046948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * @hide 3047948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3048948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static boolean isOutputDevice(int device) 3049948d32748caaac5be06c991ebf00f74265a7849fEric Laurent { 3050948d32748caaac5be06c991ebf00f74265a7849fEric Laurent return (device & AudioSystem.DEVICE_BIT_IN) == 0; 3051948d32748caaac5be06c991ebf00f74265a7849fEric Laurent } 3052948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 3053948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** 3054948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Return true if the device code corresponds to an input device. 3055948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * @hide 3056948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 3057948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static boolean isInputDevice(int device) 3058948d32748caaac5be06c991ebf00f74265a7849fEric Laurent { 3059948d32748caaac5be06c991ebf00f74265a7849fEric Laurent return (device & AudioSystem.DEVICE_BIT_IN) == AudioSystem.DEVICE_BIT_IN; 3060948d32748caaac5be06c991ebf00f74265a7849fEric Laurent } 3061948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 3062948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 30638b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** 30648b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Return the enabled devices for the specified output stream type. 30658b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 30668b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @param streamType The stream type to query. One of 30678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_VOICE_CALL}, 30688b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_SYSTEM}, 30698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_RING}, 30708b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_MUSIC}, 30718b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_ALARM}, 30728b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_NOTIFICATION}, 30738b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_DTMF}. 30748b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 30758b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @return The bit-mask "or" of audio output device codes for all enabled devices on this 30768b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * stream. Zero or more of 30778b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_EARPIECE}, 30788b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_SPEAKER}, 30798b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADSET}, 30808b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}, 30818b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO}, 30828b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, 30838b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, 30848b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, 30858b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, 30868b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, 3087948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_HDMI}, 30888b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, 30898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. 3090948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_USB_ACCESSORY}. 3091948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_USB_DEVICE}. 3092948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_REMOTE_SUBMIX}. 3093948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_TELEPHONY_TX}. 3094948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_LINE}. 3095948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_HDMI_ARC}. 3096948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_SPDIF}. 3097948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_FM}. 30988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DEFAULT} is not used here. 30998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 31008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * The implementation may support additional device codes beyond those listed, so 31018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * the application should ignore any bits which it does not recognize. 31028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Note that the information may be imprecise when the implementation 31038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * cannot distinguish whether a particular device is enabled. 31048b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 31058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@hide} 31068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 31078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public int getDevicesForStream(int streamType) { 31088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten switch (streamType) { 31098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_VOICE_CALL: 31108b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_SYSTEM: 31118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_RING: 31128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_MUSIC: 31138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_ALARM: 31148b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_NOTIFICATION: 31158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_DTMF: 31168b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return AudioSystem.getDevicesForStream(streamType); 31178b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten default: 31188b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return 0; 31198b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 31208b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 31218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 3122b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 3123b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * Indicate wired accessory connection state change. 3124b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device type of device connected/disconnected (AudioManager.DEVICE_OUT_xxx) 3125b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state: 1 connected, 0 disconnected 3126b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param name device name 3127b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 3128b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 312910804eb2818ab59b763a37b4f6151693c2ebba7bPaul McLean public void setWiredDeviceConnectionState(int type, int state, String address, String name) { 3130b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 3131b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 31329087433753a5068819dcd3e86bdc2cce82bb8040John Spurlock service.setWiredDeviceConnectionState(type, state, address, name, 3133a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen mApplicationContext.getOpPackageName()); 3134b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 3135b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setWiredDeviceConnectionState "+e); 3136b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3137b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3138b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 3139b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 31400a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * Indicate A2DP source or sink connection state change. 3141b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device Bluetooth device connected/disconnected 3142b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state (BluetoothProfile.STATE_xxx) 31430a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * @param profile profile for the A2DP device 31440a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * (either {@link android.bluetooth.BluetoothProfile.A2DP} or 31450a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * {@link android.bluetooth.BluetoothProfile.A2DP_SINK}) 3146b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @return a delay in ms that the caller should wait before broadcasting 3147b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED intent. 3148b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 3149b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 31500a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood public int setBluetoothA2dpDeviceConnectionState(BluetoothDevice device, int state, 31510a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood int profile) { 3152b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 3153b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent int delay = 0; 3154b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 31550a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood delay = service.setBluetoothA2dpDeviceConnectionState(device, state, profile); 3156b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 3157b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setBluetoothA2dpDeviceConnectionState "+e); 3158b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3159b304ba5bc8fbc6034cf232cbbeeb3a34a5ce5b9fEric Laurent return delay; 3160b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3161b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 3162098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey /** {@hide} */ 3163098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey public IRingtonePlayer getRingtonePlayer() { 3164098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey try { 3165098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return getService().getRingtonePlayer(); 3166098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } catch (RemoteException e) { 3167098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return null; 3168098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 3169098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 3170228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 3171228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 317262796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output sample rate 317362796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal Hz. 3174228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 3175228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_SAMPLE_RATE = 3176228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_SAMPLE_RATE"; 3177228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 3178228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 317962796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output buffer size 318062796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal PCM frames. 3181228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 3182228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_FRAMES_PER_BUFFER = 3183228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_FRAMES_PER_BUFFER"; 3184228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 3185228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 3186d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra * Used as a key for {@link #getProperty} to determine if the default microphone audio source 3187d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra * supports near-ultrasound frequencies (range of 18 - 21 kHz). 3188d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra */ 3189d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra public static final String PROPERTY_SUPPORT_MIC_NEAR_ULTRASOUND = 3190d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra "android.media.property.SUPPORT_MIC_NEAR_ULTRASOUND"; 3191d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra 3192d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra /** 3193d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra * Used as a key for {@link #getProperty} to determine if the default speaker audio path 3194d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra * supports near-ultrasound frequencies (range of 18 - 21 kHz). 3195d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra */ 3196d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra public static final String PROPERTY_SUPPORT_SPEAKER_NEAR_ULTRASOUND = 3197d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra "android.media.property.SUPPORT_SPEAKER_NEAR_ULTRASOUND"; 3198d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra 3199d08715e50342af02751a93735cca9d1bf76798dfArunesh Mishra /** 320062796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Returns the value of the property with the specified key. 3201228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @param key One of the strings corresponding to a property key: either 320262796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_SAMPLE_RATE} or 320362796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_FRAMES_PER_BUFFER} 3204228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @return A string representing the associated value for that property key, 3205228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * or null if there is no value for that key. 3206228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 3207228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public String getProperty(String key) { 3208c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten if (PROPERTY_OUTPUT_SAMPLE_RATE.equals(key)) { 3209c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputSampleRate = AudioSystem.getPrimaryOutputSamplingRate(); 3210c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputSampleRate > 0 ? Integer.toString(outputSampleRate) : null; 3211c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else if (PROPERTY_OUTPUT_FRAMES_PER_BUFFER.equals(key)) { 3212c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputFramesPerBuffer = AudioSystem.getPrimaryOutputFrameCount(); 3213c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputFramesPerBuffer > 0 ? Integer.toString(outputFramesPerBuffer) : null; 3214bc92227d6cd8380ae49815ac08220de4997d5e50Arunesh Mishra } else if (PROPERTY_SUPPORT_MIC_NEAR_ULTRASOUND.equals(key)) { 32156e4fb34e27546c0ff96d1257233e5b702236658aArunesh Mishra // Will throw a RuntimeException Resources.NotFoundException if this config value is 32166e4fb34e27546c0ff96d1257233e5b702236658aArunesh Mishra // not found. 32176e4fb34e27546c0ff96d1257233e5b702236658aArunesh Mishra return String.valueOf(getContext().getResources().getBoolean( 32186e4fb34e27546c0ff96d1257233e5b702236658aArunesh Mishra com.android.internal.R.bool.config_supportMicNearUltrasound)); 3219bc92227d6cd8380ae49815ac08220de4997d5e50Arunesh Mishra } else if (PROPERTY_SUPPORT_SPEAKER_NEAR_ULTRASOUND.equals(key)) { 32206e4fb34e27546c0ff96d1257233e5b702236658aArunesh Mishra return String.valueOf(getContext().getResources().getBoolean( 32216e4fb34e27546c0ff96d1257233e5b702236658aArunesh Mishra com.android.internal.R.bool.config_supportSpeakerNearUltrasound)); 3222c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else { 3223c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten // null or unknown key 3224c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return null; 3225c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } 3226228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten } 3227228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 322861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 322961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns the estimated latency for the given stream type in milliseconds. 323061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 323161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 323261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 323361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 323461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 323561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getOutputLatency(int streamType) { 323661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return AudioSystem.getOutputLatency(streamType); 323761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 323861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 32393346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 32403346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Registers a global volume controller interface. Currently limited to SystemUI. 32413346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * 32423346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 32433346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 32443346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public void setVolumeController(IVolumeController controller) { 32453346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 32463346a802087f621c6441bc512dfcc17b07143fc6John Spurlock getService().setVolumeController(controller); 32473346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 32483346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error setting volume controller", e); 32493346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 32503346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 32513346a802087f621c6441bc512dfcc17b07143fc6John Spurlock 32523346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 325333f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * Notify audio manager about volume controller visibility changes. 325433f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * Currently limited to SystemUI. 325533f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * 325633f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * @hide 325733f4e04e32fac42f158733d6a731e50490fa9951John Spurlock */ 325833f4e04e32fac42f158733d6a731e50490fa9951John Spurlock public void notifyVolumeControllerVisible(IVolumeController controller, boolean visible) { 325933f4e04e32fac42f158733d6a731e50490fa9951John Spurlock try { 326033f4e04e32fac42f158733d6a731e50490fa9951John Spurlock getService().notifyVolumeControllerVisible(controller, visible); 326133f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } catch (RemoteException e) { 326233f4e04e32fac42f158733d6a731e50490fa9951John Spurlock Log.w(TAG, "Error notifying about volume controller visibility", e); 326333f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } 326433f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } 326533f4e04e32fac42f158733d6a731e50490fa9951John Spurlock 326633f4e04e32fac42f158733d6a731e50490fa9951John Spurlock /** 32673346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Only useful for volume controllers. 32683346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 32693346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 32703346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public boolean isStreamAffectedByRingerMode(int streamType) { 32713346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 32723346a802087f621c6441bc512dfcc17b07143fc6John Spurlock return getService().isStreamAffectedByRingerMode(streamType); 32733346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 32743346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error calling isStreamAffectedByRingerMode", e); 32753346a802087f621c6441bc512dfcc17b07143fc6John Spurlock return false; 32763346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 32773346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 32783346a802087f621c6441bc512dfcc17b07143fc6John Spurlock 32793346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 32803346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Only useful for volume controllers. 32813346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 32823346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 3283a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock public boolean isStreamAffectedByMute(int streamType) { 3284a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock try { 3285a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock return getService().isStreamAffectedByMute(streamType); 3286a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock } catch (RemoteException e) { 3287a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock Log.w(TAG, "Error calling isStreamAffectedByMute", e); 3288a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock return false; 3289a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock } 3290a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock } 3291a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock 3292a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock /** 3293a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock * Only useful for volume controllers. 3294a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock * @hide 3295a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock */ 32963346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public void disableSafeMediaVolume() { 32973346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 3298a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen getService().disableSafeMediaVolume(mApplicationContext.getOpPackageName()); 32993346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 33003346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error disabling safe media volume", e); 33013346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 33023346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 3303a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3304a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3305661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * Only useful for volume controllers. 3306661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * @hide 3307661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock */ 3308661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public void setRingerModeInternal(int ringerMode) { 3309661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock try { 331029f16933a8a93753c83bb5f1e0b5a410ea3a29f2Marco Nelissen getService().setRingerModeInternal(ringerMode, getContext().getOpPackageName()); 3311661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } catch (RemoteException e) { 3312661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock Log.w(TAG, "Error calling setRingerModeInternal", e); 3313661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3314661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3315661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 3316661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** 3317661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * Only useful for volume controllers. 3318661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * @hide 3319661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock */ 3320661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public int getRingerModeInternal() { 3321661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock try { 3322661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return getService().getRingerModeInternal(); 3323661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } catch (RemoteException e) { 3324661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock Log.w(TAG, "Error calling getRingerModeInternal", e); 3325661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return RINGER_MODE_NORMAL; 3326661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3327661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3328661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 3329661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** 3330a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock * Only useful for volume controllers. 3331a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock * @hide 3332a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock */ 3333a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock public void setVolumePolicy(VolumePolicy policy) { 3334a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock try { 3335a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock getService().setVolumePolicy(policy); 3336a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock } catch (RemoteException e) { 3337a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock Log.w(TAG, "Error calling setVolumePolicy", e); 3338a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock } 3339a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock } 3340a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock 3341a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock /** 334241d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * Set Hdmi Cec system audio mode. 334341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * 334441d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @param on whether to be on system audio mode 33456f34f5ab8ab1b1db7887e5405d8b0031e105ab05Jungshik Jang * @return output device type. 0 (DEVICE_NONE) if failed to set device. 334641d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @hide 334741d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang */ 334812307ca810e8100981b2b60e3f2c6a7e451b9774Jungshik Jang public int setHdmiSystemAudioSupported(boolean on) { 334941d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang try { 335012307ca810e8100981b2b60e3f2c6a7e451b9774Jungshik Jang return getService().setHdmiSystemAudioSupported(on); 335141d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } catch (RemoteException e) { 335241d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang Log.w(TAG, "Error setting system audio mode", e); 33536f34f5ab8ab1b1db7887e5405d8b0031e105ab05Jungshik Jang return AudioSystem.DEVICE_NONE; 335441d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } 335541d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } 335641d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang 335741d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang /** 3358e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo * Returns true if Hdmi Cec system audio mode is supported. 3359e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo * 3360e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo * @hide 3361e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo */ 3362e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo @SystemApi 3363e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo public boolean isHdmiSystemAudioSupported() { 3364e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo try { 3365e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo return getService().isHdmiSystemAudioSupported(); 3366e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo } catch (RemoteException e) { 3367e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo Log.w(TAG, "Error querying system audio mode", e); 3368e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo return false; 3369e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo } 3370e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo } 3371e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo 3372e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo /** 3373a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Return codes for listAudioPorts(), createAudioPatch() ... 3374a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3375a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3376a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3377a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 3378a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3379a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int SUCCESS = AudioSystem.SUCCESS; 33808a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi /** 33818a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * A default error code. 3382a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3383a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR = AudioSystem.ERROR; 3384a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3385a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 3386a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3387a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_BAD_VALUE = AudioSystem.BAD_VALUE; 3388a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3389a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3390a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_INVALID_OPERATION = AudioSystem.INVALID_OPERATION; 3391a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3392a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3393a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_PERMISSION_DENIED = AudioSystem.PERMISSION_DENIED; 3394a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3395a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3396a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_NO_INIT = AudioSystem.NO_INIT; 3397ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent /** 3398ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * An error code indicating that the object reporting it is no longer valid and needs to 3399ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * be recreated. 3400a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3401a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_DEAD_OBJECT = AudioSystem.DEAD_OBJECT; 3402a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3403a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3404a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Returns a list of descriptors for all audio ports managed by the audio framework. 3405a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Audio ports are nodes in the audio framework or audio hardware that can be configured 3406a198a29250acb7c3e918f1566727190966bb336fEric Laurent * or connected and disconnected with createAudioPatch() or releaseAudioPatch(). 3407a198a29250acb7c3e918f1566727190966bb336fEric Laurent * See AudioPort for a list of attributes of each audio port. 3408a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param ports An AudioPort ArrayList where the list will be returned. 3409a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3410a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 34114bcdba848449b33d7022de527c526943aff1f5fdEric Laurent public static int listAudioPorts(ArrayList<AudioPort> ports) { 34128a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent return updateAudioPortCache(ports, null, null); 34138a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 34148a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent 34158a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent /** 34168a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent * Returns a list of descriptors for all audio ports managed by the audio framework as 34178a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent * it was before the last update calback. 34188a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent * @param ports An AudioPort ArrayList where the list will be returned. 34198a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent * @hide 34208a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent */ 34218a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent public static int listPreviousAudioPorts(ArrayList<AudioPort> ports) { 34228a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent return updateAudioPortCache(null, null, ports); 3423a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3424a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3425a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3426a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Specialized version of listAudioPorts() listing only audio devices (AudioDevicePort) 3427a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @see listAudioPorts(ArrayList<AudioPort>) 3428a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3429a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 34304bcdba848449b33d7022de527c526943aff1f5fdEric Laurent public static int listAudioDevicePorts(ArrayList<AudioDevicePort> devices) { 34318a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent if (devices == null) { 34328a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent return ERROR_BAD_VALUE; 34338a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 3434b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPort> ports = new ArrayList<AudioPort>(); 34358a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent int status = updateAudioPortCache(ports, null, null); 3436b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status == SUCCESS) { 34378a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent filterDevicePorts(ports, devices); 34388a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 34398a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent return status; 34408a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 34418a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent 34428a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent /** 34438a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent * Specialized version of listPreviousAudioPorts() listing only audio devices (AudioDevicePort) 34448a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent * @see listPreviousAudioPorts(ArrayList<AudioPort>) 34458a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent * @hide 34468a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent */ 34478a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent public static int listPreviousAudioDevicePorts(ArrayList<AudioDevicePort> devices) { 34488a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent if (devices == null) { 34498a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent return ERROR_BAD_VALUE; 34508a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 34518a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent ArrayList<AudioPort> ports = new ArrayList<AudioPort>(); 34528a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent int status = updateAudioPortCache(null, null, ports); 34538a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent if (status == SUCCESS) { 34548a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent filterDevicePorts(ports, devices); 3455b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3456b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3457a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3458a198a29250acb7c3e918f1566727190966bb336fEric Laurent 34598a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent private static void filterDevicePorts(ArrayList<AudioPort> ports, 34608a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent ArrayList<AudioDevicePort> devices) { 34618a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent devices.clear(); 34628a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent for (int i = 0; i < ports.size(); i++) { 34638a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent if (ports.get(i) instanceof AudioDevicePort) { 34648a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent devices.add((AudioDevicePort)ports.get(i)); 34658a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 34668a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 34678a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 34688a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent 3469a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3470a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Create a connection between two or more devices. The framework will reject the request if 3471a198a29250acb7c3e918f1566727190966bb336fEric Laurent * device types are not compatible or the implementation does not support the requested 3472a198a29250acb7c3e918f1566727190966bb336fEric Laurent * configuration. 3473a198a29250acb7c3e918f1566727190966bb336fEric Laurent * NOTE: current implementation is limited to one source and one sink per patch. 3474a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patch AudioPatch array where the newly created patch will be returned. 3475a198a29250acb7c3e918f1566727190966bb336fEric Laurent * As input, if patch[0] is not null, the specified patch will be replaced by the 3476a198a29250acb7c3e918f1566727190966bb336fEric Laurent * new patch created. This avoids calling releaseAudioPatch() when modifying a 3477a198a29250acb7c3e918f1566727190966bb336fEric Laurent * patch and allows the implementation to optimize transitions. 3478a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param sources List of source audio ports. All must be AudioPort.ROLE_SOURCE. 3479a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param sinks List of sink audio ports. All must be AudioPort.ROLE_SINK. 3480a198a29250acb7c3e918f1566727190966bb336fEric Laurent * 3481a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @return - {@link #SUCCESS} if connection is successful. 3482a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_BAD_VALUE} if incompatible device types are passed. 3483a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_INVALID_OPERATION} if the requested connection is not supported. 3484a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_PERMISSION_DENIED} if the client does not have permission to create 3485a198a29250acb7c3e918f1566727190966bb336fEric Laurent * a patch. 3486a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_DEAD_OBJECT} if the server process is dead 3487a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR} if patch cannot be connected for any other reason. 3488a198a29250acb7c3e918f1566727190966bb336fEric Laurent * 3489a198a29250acb7c3e918f1566727190966bb336fEric Laurent * patch[0] contains the newly created patch 3490a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3491a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 34924bcdba848449b33d7022de527c526943aff1f5fdEric Laurent public static int createAudioPatch(AudioPatch[] patch, 3493a198a29250acb7c3e918f1566727190966bb336fEric Laurent AudioPortConfig[] sources, 3494a198a29250acb7c3e918f1566727190966bb336fEric Laurent AudioPortConfig[] sinks) { 3495b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return AudioSystem.createAudioPatch(patch, sources, sinks); 3496a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3497a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3498a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3499a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Releases an existing audio patch connection. 3500a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patch The audio patch to disconnect. 3501a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @return - {@link #SUCCESS} if disconnection is successful. 3502a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_BAD_VALUE} if the specified patch does not exist. 3503a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_PERMISSION_DENIED} if the client does not have permission to release 3504a198a29250acb7c3e918f1566727190966bb336fEric Laurent * a patch. 3505a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_DEAD_OBJECT} if the server process is dead 3506a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR} if patch cannot be released for any other reason. 3507a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3508a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 35094bcdba848449b33d7022de527c526943aff1f5fdEric Laurent public static int releaseAudioPatch(AudioPatch patch) { 3510b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return AudioSystem.releaseAudioPatch(patch); 3511a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3512a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3513a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3514a198a29250acb7c3e918f1566727190966bb336fEric Laurent * List all existing connections between audio ports. 3515a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patches An AudioPatch array where the list will be returned. 3516a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3517a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 35184bcdba848449b33d7022de527c526943aff1f5fdEric Laurent public static int listAudioPatches(ArrayList<AudioPatch> patches) { 35198a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent return updateAudioPortCache(null, patches, null); 3520a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3521a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3522a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3523a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Set the gain on the specified AudioPort. The AudioGainConfig config is build by 3524a198a29250acb7c3e918f1566727190966bb336fEric Laurent * AudioGain.buildConfig() 3525a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3526a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 35274bcdba848449b33d7022de527c526943aff1f5fdEric Laurent public static int setAudioPortGain(AudioPort port, AudioGainConfig gain) { 35283a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent if (port == null || gain == null) { 35293a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent return ERROR_BAD_VALUE; 35303a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent } 35313a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent AudioPortConfig activeConfig = port.activeConfig(); 35323a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent AudioPortConfig config = new AudioPortConfig(port, activeConfig.samplingRate(), 35333a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent activeConfig.channelMask(), activeConfig.format(), gain); 35343a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent config.mConfigMask = AudioPortConfig.GAIN; 35353a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent return AudioSystem.setAudioPortConfig(config); 3536a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3537a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3538a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3539a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Listener registered by client to be notified upon new audio port connections, 3540a198a29250acb7c3e918f1566727190966bb336fEric Laurent * disconnections or attributes update. 3541a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3542a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3543a198a29250acb7c3e918f1566727190966bb336fEric Laurent public interface OnAudioPortUpdateListener { 3544a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3545a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called upon audio port list update. 3546a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param portList the updated list of audio ports 3547a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3548fdaed9dcb63171379fd7c5a6208014bac505dbc6Eric Laurent public void onAudioPortListUpdate(AudioPort[] portList); 3549a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3550a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3551a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called upon audio patch list update. 3552a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patchList the updated list of audio patches 3553a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3554fdaed9dcb63171379fd7c5a6208014bac505dbc6Eric Laurent public void onAudioPatchListUpdate(AudioPatch[] patchList); 3555a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3556a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3557a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called when the mediaserver dies 3558a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3559fdaed9dcb63171379fd7c5a6208014bac505dbc6Eric Laurent public void onServiceDied(); 3560a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3561a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3562a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3563700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent * Register an audio port list update listener. 3564a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3565a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3566a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void registerAudioPortUpdateListener(OnAudioPortUpdateListener l) { 3567c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent sAudioPortEventHandler.init(); 3568f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortEventHandler.registerListener(l); 3569a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3570a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3571a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3572700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent * Unregister an audio port list update listener. 3573a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3574a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3575a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void unregisterAudioPortUpdateListener(OnAudioPortUpdateListener l) { 3576f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortEventHandler.unregisterListener(l); 3577a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3578b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3579b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // 3580b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // AudioPort implementation 3581b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // 3582b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3583b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent static final int AUDIOPORT_GENERATION_INIT = 0; 3584f076db407029e734703d8676f806bea94393e824Eric Laurent static Integer sAudioPortGeneration = new Integer(AUDIOPORT_GENERATION_INIT); 3585f076db407029e734703d8676f806bea94393e824Eric Laurent static ArrayList<AudioPort> sAudioPortsCached = new ArrayList<AudioPort>(); 35868a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent static ArrayList<AudioPort> sPreviousAudioPortsCached = new ArrayList<AudioPort>(); 3587f076db407029e734703d8676f806bea94393e824Eric Laurent static ArrayList<AudioPatch> sAudioPatchesCached = new ArrayList<AudioPatch>(); 3588b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3589f076db407029e734703d8676f806bea94393e824Eric Laurent static int resetAudioPortGeneration() { 3590b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int generation; 3591f076db407029e734703d8676f806bea94393e824Eric Laurent synchronized (sAudioPortGeneration) { 3592f076db407029e734703d8676f806bea94393e824Eric Laurent generation = sAudioPortGeneration; 3593f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortGeneration = AUDIOPORT_GENERATION_INIT; 3594b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3595b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return generation; 3596b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3597b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 35988a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent static int updateAudioPortCache(ArrayList<AudioPort> ports, ArrayList<AudioPatch> patches, 35998a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent ArrayList<AudioPort> previousPorts) { 3600c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent sAudioPortEventHandler.init(); 3601f076db407029e734703d8676f806bea94393e824Eric Laurent synchronized (sAudioPortGeneration) { 3602b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3603f076db407029e734703d8676f806bea94393e824Eric Laurent if (sAudioPortGeneration == AUDIOPORT_GENERATION_INIT) { 3604b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int[] patchGeneration = new int[1]; 3605b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int[] portGeneration = new int[1]; 3606b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int status; 3607b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPort> newPorts = new ArrayList<AudioPort>(); 3608b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPatch> newPatches = new ArrayList<AudioPatch>(); 3609b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3610b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent do { 3611b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPorts.clear(); 3612b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent status = AudioSystem.listAudioPorts(newPorts, portGeneration); 3613b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status != SUCCESS) { 3614b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim Log.w(TAG, "updateAudioPortCache: listAudioPorts failed"); 3615b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3616b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3617b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPatches.clear(); 3618b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent status = AudioSystem.listAudioPatches(newPatches, patchGeneration); 3619b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status != SUCCESS) { 3620b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim Log.w(TAG, "updateAudioPortCache: listAudioPatches failed"); 3621b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3622b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3623b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } while (patchGeneration[0] != portGeneration[0]); 3624b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3625b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int i = 0; i < newPatches.size(); i++) { 3626b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int j = 0; j < newPatches.get(i).sources().length; j++) { 3627b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent AudioPortConfig portCfg = updatePortConfig(newPatches.get(i).sources()[j], 3628b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent newPorts); 3629b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPatches.get(i).sources()[j] = portCfg; 3630b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3631b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int j = 0; j < newPatches.get(i).sinks().length; j++) { 3632b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent AudioPortConfig portCfg = updatePortConfig(newPatches.get(i).sinks()[j], 3633b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent newPorts); 3634b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim newPatches.get(i).sinks()[j] = portCfg; 3635b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3636b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3637b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim for (Iterator<AudioPatch> i = newPatches.iterator(); i.hasNext(); ) { 3638b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim AudioPatch newPatch = i.next(); 3639b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim boolean hasInvalidPort = false; 3640b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim for (AudioPortConfig portCfg : newPatch.sources()) { 3641b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (portCfg == null) { 3642b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim hasInvalidPort = true; 3643b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim break; 3644b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3645b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3646b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim for (AudioPortConfig portCfg : newPatch.sinks()) { 3647b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim if (portCfg == null) { 3648b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim hasInvalidPort = true; 3649b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim break; 3650b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3651b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3652b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim if (hasInvalidPort) { 3653b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim // Temporarily remove patches with invalid ports. One who created the patch 3654b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim // is responsible for dealing with the port change. 3655b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim i.remove(); 3656b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3657b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3658b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 36598a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent sPreviousAudioPortsCached = sAudioPortsCached; 3660f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortsCached = newPorts; 3661f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPatchesCached = newPatches; 3662f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortGeneration = portGeneration[0]; 3663b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3664b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports != null) { 3665b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ports.clear(); 3666f076db407029e734703d8676f806bea94393e824Eric Laurent ports.addAll(sAudioPortsCached); 3667b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3668b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (patches != null) { 3669b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent patches.clear(); 3670f076db407029e734703d8676f806bea94393e824Eric Laurent patches.addAll(sAudioPatchesCached); 3671b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 36728a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent if (previousPorts != null) { 36738a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent previousPorts.clear(); 36748a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent previousPorts.addAll(sPreviousAudioPortsCached); 36758a1e7a881ee73b9b1e492e7014c3eaefe81cfbd7Eric Laurent } 3676b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3677b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return SUCCESS; 3678b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3679b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3680f076db407029e734703d8676f806bea94393e824Eric Laurent static AudioPortConfig updatePortConfig(AudioPortConfig portCfg, ArrayList<AudioPort> ports) { 3681b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioPort port = portCfg.port(); 3682b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int k; 3683b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (k = 0; k < ports.size(); k++) { 3684b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // compare handles because the port returned by JNI is not of the correct 3685b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // subclass 3686b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports.get(k).handle().equals(port.handle())) { 3687b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent port = ports.get(k); 3688b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent break; 3689b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3690b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3691b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (k == ports.size()) { 3692b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // this hould never happen 3693b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent Log.e(TAG, "updatePortConfig port not found for handle: "+port.handle().id()); 3694b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return null; 3695b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3696b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioGainConfig gainCfg = portCfg.gain(); 3697b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (gainCfg != null) { 3698b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioGain gain = port.gain(gainCfg.index()); 3699b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg = gain.buildConfig(gainCfg.mode(), 3700b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.channelMask(), 3701b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.values(), 3702b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.rampDurationMs()); 3703b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3704b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return port.buildConfig(portCfg.samplingRate(), 3705b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent portCfg.channelMask(), 3706b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent portCfg.format(), 3707b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg); 3708b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3709e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3710e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean private OnAmPortUpdateListener mPortListener = null; 3711e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3712e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3713e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * The message sent to apps when the contents of the device list changes if they provide 3714e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * a {#link Handler} object to addOnAudioDeviceConnectionListener(). 3715e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3716cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean private final static int MSG_DEVICES_CALLBACK_REGISTERED = 0; 3717cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean private final static int MSG_DEVICES_DEVICES_ADDED = 1; 3718cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean private final static int MSG_DEVICES_DEVICES_REMOVED = 2; 3719e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 37208e6c9f46172458624349755c9b1bc051f420d36dPaul McLean /** 37218e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * The list of {@link AudioDeviceCallback} objects to receive add/remove notifications. 37228e6c9f46172458624349755c9b1bc051f420d36dPaul McLean */ 3723033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean private ArrayMap<AudioDeviceCallback, NativeEventHandlerDelegate> 3724033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean mDeviceCallbacks = 3725033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean new ArrayMap<AudioDeviceCallback, NativeEventHandlerDelegate>(); 3726e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3727e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 37288e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * The following are flags to allow users of {@link AudioManager#getDevices(int)} to filter 37298e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * the results list to only those device types they are interested in. 37308e6c9f46172458624349755c9b1bc051f420d36dPaul McLean */ 37318e6c9f46172458624349755c9b1bc051f420d36dPaul McLean /** 3732e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Specifies to the {@link AudioManager#getDevices(int)} method to include 3733e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * source (i.e. input) audio devices. 3734e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3735e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public static final int GET_DEVICES_INPUTS = 0x0001; 3736e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3737e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3738e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Specifies to the {@link AudioManager#getDevices(int)} method to include 3739e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * sink (i.e. output) audio devices. 3740e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3741e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public static final int GET_DEVICES_OUTPUTS = 0x0002; 3742e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3743e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3744e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Specifies to the {@link AudioManager#getDevices(int)} method to include both 3745e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * source and sink devices. 3746e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3747e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public static final int GET_DEVICES_ALL = GET_DEVICES_OUTPUTS | GET_DEVICES_INPUTS; 3748e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3749e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3750e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Determines if a given AudioDevicePort meets the specified filter criteria. 3751e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * @param port The port to test. 3752e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * @param flags A set of bitflags specifying the criteria to test. 3753e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * @see {@link GET_DEVICES_OUTPUTS} and {@link GET_DEVICES_INPUTS} 3754e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean **/ 3755e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean private static boolean checkFlags(AudioDevicePort port, int flags) { 3756e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean return port.role() == AudioPort.ROLE_SINK && (flags & GET_DEVICES_OUTPUTS) != 0 || 3757e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean port.role() == AudioPort.ROLE_SOURCE && (flags & GET_DEVICES_INPUTS) != 0; 3758e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3759e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 37601135457a3d656057fc65effd706ae238a5f99a50Paul McLean private static boolean checkTypes(AudioDevicePort port) { 37611135457a3d656057fc65effd706ae238a5f99a50Paul McLean return AudioDeviceInfo.convertInternalDeviceToDeviceType(port.type()) != 37621135457a3d656057fc65effd706ae238a5f99a50Paul McLean AudioDeviceInfo.TYPE_UNKNOWN && 37631135457a3d656057fc65effd706ae238a5f99a50Paul McLean port.type() != AudioSystem.DEVICE_IN_BACK_MIC; 37641135457a3d656057fc65effd706ae238a5f99a50Paul McLean } 37651135457a3d656057fc65effd706ae238a5f99a50Paul McLean 3766e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 37678e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Returns an array of {@link AudioDeviceInfo} objects corresponding to the audio devices 37688e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * currently connected to the system and meeting the criteria specified in the 37698e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * <code>flags</code> parameter. 3770e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * @param flags A set of bitflags specifying the criteria to test. 37718e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @see {@link GET_DEVICES_OUTPUTS}, {@link GET_DEVICES_INPUTS} and {@link GET_DEVICES_ALL}. 3772e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * @return A (possibly zero-length) array of AudioDeviceInfo objects. 3773e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3774e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public AudioDeviceInfo[] getDevices(int flags) { 3775e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean return getDevicesStatic(flags); 3776e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3777e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 37788e6c9f46172458624349755c9b1bc051f420d36dPaul McLean /** 37798e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Does the actual computation to generate an array of (externally-visible) AudioDeviceInfo 37808e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * objects from the current (internal) AudioDevicePort list. 37818e6c9f46172458624349755c9b1bc051f420d36dPaul McLean */ 3782033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean private static AudioDeviceInfo[] 3783033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean infoListFromPortList(ArrayList<AudioDevicePort> ports, int flags) { 3784e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 37858e6c9f46172458624349755c9b1bc051f420d36dPaul McLean // figure out how many AudioDeviceInfo we need space for... 3786e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean int numRecs = 0; 3787e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean for (AudioDevicePort port : ports) { 37881135457a3d656057fc65effd706ae238a5f99a50Paul McLean if (checkTypes(port) && checkFlags(port, flags)) { 3789e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean numRecs++; 3790e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3791e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3792e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 37938e6c9f46172458624349755c9b1bc051f420d36dPaul McLean // Now load them up... 3794e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean AudioDeviceInfo[] deviceList = new AudioDeviceInfo[numRecs]; 3795e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean int slot = 0; 3796e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean for (AudioDevicePort port : ports) { 37971135457a3d656057fc65effd706ae238a5f99a50Paul McLean if (checkTypes(port) && checkFlags(port, flags)) { 3798e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean deviceList[slot++] = new AudioDeviceInfo(port); 3799e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3800e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3801e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3802e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean return deviceList; 3803e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3804e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3805033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean /* 38068e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Calculate the list of ports that are in ports_B, but not in ports_A. This is used by 38078e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * the add/remove callback mechanism to provide a list of the newly added or removed devices 38088e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * rather than the whole list and make the app figure it out. 38098e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Note that calling this method with: 38108e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * ports_A == PREVIOUS_ports and ports_B == CURRENT_ports will calculated ADDED ports. 38118e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * ports_A == CURRENT_ports and ports_B == PREVIOUS_ports will calculated REMOVED ports. 3812033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean */ 3813033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean private static AudioDeviceInfo[] calcListDeltas( 3814033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean ArrayList<AudioDevicePort> ports_A, ArrayList<AudioDevicePort> ports_B, int flags) { 3815033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3816033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean ArrayList<AudioDevicePort> delta_ports = new ArrayList<AudioDevicePort>(); 3817033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3818033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean AudioDevicePort cur_port = null; 3819033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean for (int cur_index = 0; cur_index < ports_B.size(); cur_index++) { 3820033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean boolean cur_port_found = false; 3821033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean cur_port = ports_B.get(cur_index); 3822033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean for (int prev_index = 0; 3823033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean prev_index < ports_A.size() && !cur_port_found; 3824033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean prev_index++) { 3825033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean cur_port_found = (cur_port.id() == ports_A.get(prev_index).id()); 3826033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3827033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3828033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean if (!cur_port_found) { 3829033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean delta_ports.add(cur_port); 3830033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3831033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3832033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3833033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean return infoListFromPortList(delta_ports, flags); 3834033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3835033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3836033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean /** 3837033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean * Generates a list of AudioDeviceInfo objects corresponding to the audio devices currently 3838033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean * connected to the system and meeting the criteria specified in the <code>flags</code> 3839033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean * parameter. 38408e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * This is an internal function. The public API front is getDevices(int). 3841033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean * @param flags A set of bitflags specifying the criteria to test. 3842033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean * @see {@link GET_DEVICES_OUTPUTS}, {@link GET_DEVICES_INPUTS} and {@link GET_DEVICES_ALL}. 3843033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean * @return A (possibly zero-length) array of AudioDeviceInfo objects. 3844033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean * @hide 3845033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean */ 3846033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean public static AudioDeviceInfo[] getDevicesStatic(int flags) { 3847033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean ArrayList<AudioDevicePort> ports = new ArrayList<AudioDevicePort>(); 3848033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean int status = AudioManager.listAudioDevicePorts(ports); 3849033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean if (status != AudioManager.SUCCESS) { 3850033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean // fail and bail! 38518e6c9f46172458624349755c9b1bc051f420d36dPaul McLean return new AudioDeviceInfo[0]; // Always return an array. 3852033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3853033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3854033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean return infoListFromPortList(ports, flags); 3855033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3856033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3857e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 38588e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Registers an {@link AudioDeviceCallback} object to receive notifications of changes 3859e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * to the set of connected audio devices. 38608e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param callback The {@link AudioDeviceCallback} object to receive connect/disconnect 38618e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * notifications. 38628e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param handler Specifies the {@link Handler} object for the thread on which to execute 38638e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * the callback. If <code>null</code>, the {@link Handler} associated with the main 38648e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * {@link Looper} will be used. 3865e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3866033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean public void registerAudioDeviceCallback(AudioDeviceCallback callback, 3867e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean android.os.Handler handler) { 38681691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent synchronized (mDeviceCallbacks) { 38691691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent if (callback != null && !mDeviceCallbacks.containsKey(callback)) { 3870c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent if (mDeviceCallbacks.size() == 0) { 3871c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent if (mPortListener == null) { 3872c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent mPortListener = new OnAmPortUpdateListener(); 3873c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent } 3874c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent registerAudioPortUpdateListener(mPortListener); 3875c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent } 3876cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean NativeEventHandlerDelegate delegate = 3877cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean new NativeEventHandlerDelegate(callback, handler); 3878cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean mDeviceCallbacks.put(callback, delegate); 3879cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean broadcastDeviceListChange(delegate.getHandler()); 3880e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3881e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3882e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3883e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3884e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 38858e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Unregisters an {@link AudioDeviceCallback} object which has been previously registered 3886e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * to receive notifications of changes to the set of connected audio devices. 38878e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param callback The {@link AudioDeviceCallback} object that was previously registered 38888e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * with {@link AudioManager#registerAudioDeviceCallback) to be unregistered. 3889e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3890033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean public void unregisterAudioDeviceCallback(AudioDeviceCallback callback) { 3891033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean synchronized (mDeviceCallbacks) { 3892033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean if (mDeviceCallbacks.containsKey(callback)) { 3893033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean mDeviceCallbacks.remove(callback); 3894c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent if (mDeviceCallbacks.size() == 0) { 3895c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent unregisterAudioPortUpdateListener(mPortListener); 3896c573bc5d3da12b52b0c45416f884d8d21b0ef500Eric Laurent } 3897e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3898e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3899e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3900e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3901cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean // Since we need to calculate the changes since THE LAST NOTIFICATION, and not since the 3902cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean // (unpredictable) last time updateAudioPortCache() was called by someone, keep a list 3903cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean // of the ports that exist at the time of the last notification. 3904cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean private ArrayList<AudioDevicePort> mPreviousPorts = new ArrayList<AudioDevicePort>(); 3905cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean 3906e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 39078e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Internal method to compute and generate add/remove messages and then send to any 39088e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * registered callbacks. 3909e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3910cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean private void broadcastDeviceListChange(Handler handler) { 3911033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean int status; 3912033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3913cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean // Get the new current set of ports 3914033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean ArrayList<AudioDevicePort> current_ports = new ArrayList<AudioDevicePort>(); 3915033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean status = AudioManager.listAudioDevicePorts(current_ports); 3916033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean if (status != AudioManager.SUCCESS) { 3917033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean return; 3918033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3919033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 3920cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean if (handler != null) { 3921cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean // This is the callback for the registration, so send the current list 3922cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean AudioDeviceInfo[] deviceList = 3923cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean infoListFromPortList(current_ports, GET_DEVICES_ALL); 3924cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean handler.sendMessage( 3925cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean Message.obtain(handler, MSG_DEVICES_CALLBACK_REGISTERED, deviceList)); 3926cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean } else { 3927cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean AudioDeviceInfo[] added_devices = 3928cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean calcListDeltas(mPreviousPorts, current_ports, GET_DEVICES_ALL); 3929cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean AudioDeviceInfo[] removed_devices = 3930cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean calcListDeltas(current_ports, mPreviousPorts, GET_DEVICES_ALL); 3931cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean 3932cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean if (added_devices.length != 0 || removed_devices.length != 0) { 3933cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean synchronized (mDeviceCallbacks) { 39341691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent for (int i = 0; i < mDeviceCallbacks.size(); i++) { 39351691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent handler = mDeviceCallbacks.valueAt(i).getHandler(); 39361691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent if (handler != null) { 39371691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent if (added_devices.length != 0) { 39381691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent handler.sendMessage(Message.obtain(handler, 39391691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent MSG_DEVICES_DEVICES_ADDED, 39401691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent added_devices)); 39411691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent } 39421691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent if (removed_devices.length != 0) { 39431691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent handler.sendMessage(Message.obtain(handler, 39441691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent MSG_DEVICES_DEVICES_REMOVED, 39451691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent removed_devices)); 39461691f73de547e1bb7a6130a8d9f159452ed83d99Eric Laurent } 3947cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean } 3948033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3949033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 3950e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3951e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3952cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean 3953cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean mPreviousPorts = current_ports; 3954e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3955e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3956e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3957e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Handles Port list update notifications from the AudioManager 3958e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3959e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean private class OnAmPortUpdateListener implements AudioManager.OnAudioPortUpdateListener { 3960e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean static final String TAG = "OnAmPortUpdateListener"; 3961e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void onAudioPortListUpdate(AudioPort[] portList) { 3962cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean broadcastDeviceListChange(null); 3963e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3964e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3965e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3966e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Callback method called upon audio patch list update. 39678e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Note: We don't do anything with Patches at this time, so ignore this notification. 39688e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param patchList the updated list of audio patches. 3969e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3970e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void onAudioPatchListUpdate(AudioPatch[] patchList) {} 3971e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3972e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3973e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Callback method called when the mediaserver dies 3974e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3975e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void onServiceDied() { 3976cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean broadcastDeviceListChange(null); 3977e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3978e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 3979e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3980e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean //--------------------------------------------------------- 3981e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean // Inner classes 3982e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean //-------------------- 3983e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 3984e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Helper class to handle the forwarding of native events to the appropriate listener 3985e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * (potentially) handled in a different thread. 3986e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 3987e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean private class NativeEventHandlerDelegate { 3988e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean private final Handler mHandler; 3989e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 3990033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean NativeEventHandlerDelegate(final AudioDeviceCallback callback, 3991e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean Handler handler) { 3992e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean // find the looper for our new event handler 3993e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean Looper looper; 3994e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean if (handler != null) { 3995e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean looper = handler.getLooper(); 3996e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } else { 3997e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean // no given handler, use the looper the addListener call was called in 3998e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean looper = Looper.getMainLooper(); 3999e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 4000e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 4001e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean // construct the event handler with this looper 4002e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean if (looper != null) { 4003e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean // implement the event handler delegate 4004e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean mHandler = new Handler(looper) { 4005e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean @Override 4006e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void handleMessage(Message msg) { 4007e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean switch(msg.what) { 4008cbeb8a2a3ebf2eef6877e6f78ec16797125c20baPaul McLean case MSG_DEVICES_CALLBACK_REGISTERED: 4009033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean case MSG_DEVICES_DEVICES_ADDED: 4010033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean if (callback != null) { 4011033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean callback.onAudioDevicesAdded((AudioDeviceInfo[])msg.obj); 4012e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 4013e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean break; 4014033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 4015033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean case MSG_DEVICES_DEVICES_REMOVED: 4016033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean if (callback != null) { 4017033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean callback.onAudioDevicesRemoved((AudioDeviceInfo[])msg.obj); 4018033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean } 4019033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean break; 4020033468868dfa89e6c8dae2f8ad7365538329da42Paul McLean 4021e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean default: 4022e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean Log.e(TAG, "Unknown native event type: " + msg.what); 4023e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean break; 4024e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 4025e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 4026e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean }; 4027e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } else { 4028e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean mHandler = null; 4029e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 4030e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 4031e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 4032e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean Handler getHandler() { 4033e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean return mHandler; 4034e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 4035e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 40369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 4037