AudioManager.java revision b304ba5bc8fbc6034cf232cbbeeb3a34a5ce5b9f
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; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.provider.Settings; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 45d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.view.KeyEvent; 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 47a198a29250acb7c3e918f1566727190966bb336fEric Laurentimport java.util.ArrayList; 48b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kimimport java.util.HashMap; 49b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kimimport java.util.Iterator; 50700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioManager provides access to volume and ringer mode control. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use <code>Context.getSystemService(Context.AUDIO_SERVICE)</code> to get 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an instance of this class. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioManager { 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 59926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen private final Context mApplicationContext; 6086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato private long mVolumeKeyUpTime; 61b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate private final boolean mUseVolumeKeySounds; 62ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent private final boolean mUseFixedVolume; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String TAG = "AudioManager"; 64f076db407029e734703d8676f806bea94393e824Eric Laurent private static final AudioPortEventHandler sAudioPortEventHandler = new AudioPortEventHandler(); 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent, a hint for applications that audio is about to become 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'noisy' due to a change in audio outputs. For example, this intent may 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent when a wired headset is unplugged, or when an A2DP audio 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sink is disconnected, and the audio system is about to automatically 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch audio route to the speaker. Applications that are controlling 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * audio streams may consider pausing, reducing volume or some other action 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on receipt of this intent so as not to surprise the user with audio 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the speaker. 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sticky broadcast intent action indicating that the ringer mode has 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the new ringer mode. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_RINGER_MODE 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 89bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * @hide 90bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * Sticky broadcast intent action indicating that the internal ringer mode has 91bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * changed. Includes the new ringer mode. 92bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * 93bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock * @see #EXTRA_RINGER_MODE 94bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock */ 95bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 96bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock public static final String INTERNAL_RINGER_MODE_CHANGED_ACTION = 97bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock "android.media.INTERNAL_RINGER_MODE_CHANGED_ACTION"; 98bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock 99bcc1087af40a0e1bb35dbe8a39c830ecdea8280bJohn Spurlock /** 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new ringer mode. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_CHANGED_ACTION 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_NORMAL 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_SILENT 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_VIBRATE 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the vibrate setting has 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the vibrate type and its new setting. 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_SETTING 115cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 116cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1190dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String VIBRATE_SETTING_CHANGED_ACTION = 1200dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.VIBRATE_SETTING_CHANGED"; 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Broadcast intent when the volume for a particular stream type changes. 1243114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Includes the stream, the new volume and previous volumes. 1253114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Notes: 1263114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - for internal platform use only, do not make public, 1273114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - never used for "remote" volume changes 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_TYPE 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_VALUE 1319ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @see #EXTRA_PREV_VOLUME_STREAM_VALUE 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1377c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @hide Broadcast intent when a stream mute state changes. 1387c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * Includes the stream that changed and the new mute state 1397c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * 1407c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @see #EXTRA_VOLUME_STREAM_TYPE 1417c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @see #EXTRA_STREAM_VOLUME_MUTED 1427c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik */ 1437c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1447c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik public static final String STREAM_MUTE_CHANGED_ACTION = 1457c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik "android.media.STREAM_MUTE_CHANGED_ACTION"; 1467c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik 1477c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik /** 1480dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master mute state changes. 1490dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the the new volume 1500dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1510dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_MUTED 1520dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1530dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1540dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_MUTE_CHANGED_ACTION = 1550dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_MUTE_CHANGED_ACTION"; 1560dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1570dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new vibrate setting for a particular type. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ON 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_OFF 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ONLY_SILENT 165cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 166cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The vibrate type whose setting has changed. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_NOTIFICATION 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_RINGER 176cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 177cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The stream type for the volume changed intent. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The volume associated with the stream for the volume changed intent. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_VALUE = 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.media.EXTRA_VOLUME_STREAM_VALUE"; 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1929ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent /** 1939ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @hide The previous volume associated with the stream for the volume changed intent. 1949ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent */ 1959ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = 1969ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; 1970dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1980dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1990dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume mute state for the master mute changed intent. 2000dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is boolean 2010dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 2020dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_MUTED = 2030dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_MUTED"; 2049ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent 205c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 2067c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * @hide The new stream volume mute state for the stream mute changed intent. 2077c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik * Value is boolean 2087c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik */ 2097c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik public static final String EXTRA_STREAM_VOLUME_MUTED = 2107c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik "android.media.EXTRA_STREAM_VOLUME_MUTED"; 2117c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik 2127c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik /** 213c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Broadcast Action: Wired Headset plugged in or unplugged. 214c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * 215c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * You <em>cannot</em> receive this through components declared 216c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * in manifests, only by explicitly registering for it with 217c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter) 218c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Context.registerReceiver()}. 219c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * 220c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <p>The intent will have the following extra values: 221c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <ul> 222c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <li><em>state</em> - 0 for unplugged, 1 for plugged. </li> 223c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <li><em>name</em> - Headset type, human readable string </li> 224c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <li><em>microphone</em> - 1 if headset has a microphone, 0 otherwise </li> 225c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * </ul> 226c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * </ul> 227c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 228c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 229c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi public static final String ACTION_HEADSET_PLUG = 230c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi "android.intent.action.HEADSET_PLUG"; 231c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 232c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 233bc68256fea95c25258d8faad6bb697c364ad5a90Eemi Haukkala * Broadcast Action: A sticky broadcast indicating an HDMI cable was plugged or unplugged. 234c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * 235c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * The intent will have the following extra values: {@link #EXTRA_AUDIO_PLUG_STATE}, 236c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link #EXTRA_MAX_CHANNEL_COUNT}, {@link #EXTRA_ENCODINGS}. 237c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * <p>It can only be received by explicitly registering for it with 238c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)}. 239c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 240c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 241c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi public static final String ACTION_HDMI_AUDIO_PLUG = 242c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi "android.media.action.HDMI_AUDIO_PLUG"; 243c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 244c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 245c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Extra used in {@link #ACTION_HDMI_AUDIO_PLUG} to communicate whether HDMI is plugged in 246c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * or unplugged. 247c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * An integer value of 1 indicates a plugged-in state, 0 is unplugged. 248c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 249deddda5d62498bbaa9789c622be7a08be83f2f51Jean-Michel Trivi public static final String EXTRA_AUDIO_PLUG_STATE = "android.media.extra.AUDIO_PLUG_STATE"; 250c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 251c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 252c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Extra used in {@link #ACTION_HDMI_AUDIO_PLUG} to define the maximum number of channels 253c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * supported by the HDMI device. 254c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * The corresponding integer value is only available when the device is plugged in (as expressed 255c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * by {@link #EXTRA_AUDIO_PLUG_STATE}). 256c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 257deddda5d62498bbaa9789c622be7a08be83f2f51Jean-Michel Trivi public static final String EXTRA_MAX_CHANNEL_COUNT = "android.media.extra.MAX_CHANNEL_COUNT"; 258c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 259c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi /** 260c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * Extra used in {@link #ACTION_HDMI_AUDIO_PLUG} to define the audio encodings supported by 261c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * the connected HDMI device. 262c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * The corresponding array of encoding values is only available when the device is plugged in 263c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * (as expressed by {@link #EXTRA_AUDIO_PLUG_STATE}). Encoding values are defined in 264c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link AudioFormat} (for instance see {@link AudioFormat#ENCODING_PCM_16BIT}). Use 265c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi * {@link android.content.Intent#getIntArrayExtra(String)} to retrieve the encoding values. 266c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi */ 267deddda5d62498bbaa9789c622be7a08be83f2f51Jean-Michel Trivi public static final String EXTRA_ENCODINGS = "android.media.extra.ENCODINGS"; 268c5258433dd353769ccfa2e5e769a7379378a3a0bJean-Michel Trivi 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for phone calls */ 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for system sounds */ 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for the phone ring */ 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = AudioSystem.STREAM_RING; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for music playback */ 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for alarms */ 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for notifications */ 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide The audio stream for phone calls when connected to bluetooth */ 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; 283a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 284a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; 285a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** The audio stream for DTMF Tones */ 286a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; 287a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for text to speech (TTS) */ 288a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = AudioSystem.STREAM_TTS; 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Number of audio streams */ 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use AudioSystem.getNumStreamTypes() instead 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 293a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Increase the ringer volume. 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_RAISE = 1; 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decrease the ringer volume. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_LOWER = -1; 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maintain the previous ringer volume. This may be useful when needing to 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * show the volume toast without actually modifying the volume. 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_SAME = 0; 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3204197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik /** 3214197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Mute the volume. Has no effect if the stream is already muted. 3224197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 3234197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustVolume(int, int) 3244197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 3254197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik */ 3264197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik public static final int ADJUST_MUTE = -100; 3274197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik 3284197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik /** 3294197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Unmute the volume. Has no effect if the stream is not muted. 3304197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 3314197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustVolume(int, int) 3324197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 3334197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik */ 3344197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik public static final int ADJUST_UNMUTE = 100; 3354197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik 3364197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik /** 3374197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Toggle the mute state. If muted the stream will be unmuted. If not muted 3384197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * the stream will be muted. 3394197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 3404197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustVolume(int, int) 3414197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 3424197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik */ 3434197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik public static final int ADJUST_TOGGLE_MUTE = 101; 3444197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Flags should be powers of 2! 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Show a toast containing the current volume. 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_SHOW_UI = 1 << 0; 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to include ringer modes as possible options when changing volume. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if true and volume level is 0 and the volume is adjusted 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate mode. 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * By default this is on for the ring stream. If this flag is included, 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this behavior will be present regardless of the stream type being 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affected by the ringer mode. 366105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to play a sound when changing the volume. 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is given to {@link #adjustVolume(int, int)} or 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in some cases (for example, the decided stream type is not 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_RING}, or the volume is being adjusted 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * downward). 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_PLAY_SOUND = 1 << 2; 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any sounds/vibrate that may be in the queue, or are playing (related to 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changing volume). 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to vibrate if going into the vibrate ringer mode. 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_VIBRATE = 1 << 4; 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3994bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * Indicates to VolumePanel that the volume slider should be disabled as user 4004bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * cannot change the stream volume 4014bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * @hide 4024bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent */ 4034bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent public static final int FLAG_FIXED_VOLUME = 1 << 5; 4044bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent 4054bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent /** 406c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * Indicates the volume set/adjust call is for Bluetooth absolute volume 407c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * @hide 408c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie */ 409c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie public static final int FLAG_BLUETOOTH_ABS_VOLUME = 1 << 6; 410c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie 411c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie /** 412a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock * Adjusting the volume was prevented due to silent mode, display a hint in the UI. 413a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock * @hide 414a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock */ 415a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock public static final int FLAG_SHOW_SILENT_HINT = 1 << 7; 416a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock 417a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock /** 41841d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * Indicates the volume call is for Hdmi Cec system audio volume 41941d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @hide 42041d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang */ 42141d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang public static final int FLAG_HDMI_SYSTEM_AUDIO_VOLUME = 1 << 8; 42241d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang 42341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang /** 4243c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik * Indicates that this should only be handled if media is actively playing. 4253c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik * @hide 4263c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik */ 4273c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik public static final int FLAG_ACTIVE_MEDIA_ONLY = 1 << 9; 4283c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik 4293c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik /** 430351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock * Like FLAG_SHOW_UI, but only dialog warnings and confirmations, no sliders. 431351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock * @hide 432351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock */ 433351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock public static final int FLAG_SHOW_UI_WARNINGS = 1 << 10; 434351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock 435351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock /** 436661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * Adjusting the volume down from vibrated was prevented, display a hint in the UI. 437661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * @hide 438661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock */ 439661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public static final int FLAG_SHOW_VIBRATE_HINT = 1 << 11; 440661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 441661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock private static final String[] FLAG_NAMES = { 442661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_UI", 443661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_ALLOW_RINGER_MODES", 444661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_PLAY_SOUND", 445661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_REMOVE_SOUND_AND_VIBRATE", 446661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_VIBRATE", 447661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_FIXED_VOLUME", 448661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_BLUETOOTH_ABS_VOLUME", 449661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_SILENT_HINT", 450661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_HDMI_SYSTEM_AUDIO_VOLUME", 451661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_ACTIVE_MEDIA_ONLY", 452661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_UI_WARNINGS", 453661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock "FLAG_SHOW_VIBRATE_HINT", 454661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock }; 455661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 456661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** @hide */ 457661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public static String flagsToString(int flags) { 458661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock final StringBuilder sb = new StringBuilder(); 459661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock for (int i = 0; i < FLAG_NAMES.length; i++) { 460661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock final int flag = 1 << i; 461661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if ((flags & flag) != 0) { 462661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if (sb.length() > 0) { 463661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(','); 464661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 465661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(FLAG_NAMES[i]); 466661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock flags &= ~flag; 467661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 468661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 469661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if (flags != 0) { 470661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock if (sb.length() > 0) { 471661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(','); 472661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 473661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock sb.append(flags); 474661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 475661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return sb.toString(); 476661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 477661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 478661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will not vibrate. (This overrides the 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate setting.) 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_SILENT = 0; 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will vibrate. (This will cause the 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone ringer to always vibrate, but the notification vibrate to only 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate if set.) 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_VIBRATE = 1; 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that may be audible and may vibrate. It will be audible if 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the volume before changing out of this mode was audible. It will vibrate 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the vibrate setting is on. 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_NORMAL = 2; 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5079755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock /** 5089755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock * Maximum valid ringer mode value. Values must start from 0 and be contiguous. 5099755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock * @hide 5109755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock */ 5119755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock public static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; 51272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to the ringer. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 519cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 520cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_RINGER = 0; 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to notifications. 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 530cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 531cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_NOTIFICATION = 1; 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to never vibrate. 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 540cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 541cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_OFF = 0; 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to vibrate when possible. 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 550cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 551cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ON = 1; 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to only vibrate when in the vibrate ringer 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 561cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 562cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ONLY_SILENT = 2; 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Suggests using the default stream type. This may not be used in all 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * places a stream type is needed. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService sService; 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioManager(Context context) { 578a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen mApplicationContext = context; 579926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen mUseVolumeKeySounds = mApplicationContext.getResources().getBoolean( 580b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate com.android.internal.R.bool.config_useVolumeKeySounds); 581926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen mUseFixedVolume = mApplicationContext.getResources().getBoolean( 582ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent com.android.internal.R.bool.config_useFixedVolume); 583f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortEventHandler.init(); 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService getService() 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sService != null) { 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sService = IAudioService.Stub.asInterface(b); 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 597a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Sends a simulated key event for a media button. 598a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * To simulate a key press, you must first send a KeyEvent built with a 599a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#ACTION_DOWN} action, then another event with the {@link KeyEvent#ACTION_UP} 600a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * action. 601a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * <p>The key event will be sent to the current media key event consumer which registered with 602a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link AudioManager#registerMediaButtonEventReceiver(PendingIntent)}. 603a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param keyEvent a {@link KeyEvent} instance whose key code is one of 604a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MUTE}, 605a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_HEADSETHOOK}, 606a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY}, 607a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PAUSE}, 608a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY_PAUSE}, 609a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_STOP}, 610a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_NEXT}, 611a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PREVIOUS}, 612a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_REWIND}, 613a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_RECORD}, 614a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_FAST_FORWARD}, 615a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_CLOSE}, 616a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_EJECT}, 617a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * or {@link KeyEvent#KEYCODE_MEDIA_AUDIO_TRACK}. 618a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi */ 619a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi public void dispatchMediaKeyEvent(KeyEvent keyEvent) { 620926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mApplicationContext); 621430fc48865e5a371b08f180390946b96d73848feRoboErik helper.sendMediaButtonEvent(keyEvent, false); 6227ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 6237ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 6247ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 6257ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 62686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 627ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void preDispatchKeyEvent(KeyEvent event, int stream) { 62886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 62986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * If the user hits another key within the play sound delay, then 63086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * cancel the sound 63186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 632ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 63386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP 63486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE 6356156017c2217d0fbbbb03434986250ec6bbd69d8John Spurlock && mVolumeKeyUpTime + AudioSystem.PLAY_SOUND_DELAY > SystemClock.uptimeMillis()) { 63686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 63786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * The user has hit another key during the delay (e.g., 300ms) 63886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * since the last volume key up, so cancel any sounds. 63986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 640ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock adjustSuggestedStreamVolume(ADJUST_SAME, 641ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 64286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 64386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 64486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 64586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 64686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 64786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 648ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyDown(KeyEvent event, int stream) { 649ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 65086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 65186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 65286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 65386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 65486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Adjust the volume in on key down since it is more 65586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * responsive to the user. 65686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 657ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock adjustSuggestedStreamVolume( 658ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock keyCode == KeyEvent.KEYCODE_VOLUME_UP 659ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock ? ADJUST_RAISE 660ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock : ADJUST_LOWER, 661ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock stream, 662ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock FLAG_SHOW_UI | FLAG_VIBRATE); 66386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 66486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 665ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (event.getRepeatCount() == 0) { 666926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen MediaSessionLegacyHelper.getHelper(mApplicationContext) 667926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen .sendVolumeKeyEvent(event, false); 668ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 66986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 67086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 67186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 67286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 67386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 67486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 67586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 676ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyUp(KeyEvent event, int stream) { 677ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 67886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 67986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 68086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 68186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 68286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Play a sound. This is done on key up since we don't want the 68386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * sound to play when a user holds down volume down to mute. 68486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 685b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseVolumeKeySounds) { 686ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock adjustSuggestedStreamVolume( 687ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock ADJUST_SAME, 688ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock stream, 689ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock FLAG_PLAY_SOUND); 690402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 69186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato mVolumeKeyUpTime = SystemClock.uptimeMillis(); 69286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 6937c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik case KeyEvent.KEYCODE_VOLUME_MUTE: 694926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen MediaSessionLegacyHelper.getHelper(mApplicationContext) 695926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen .sendVolumeKeyEvent(event, false); 6967c82ced4fc5b66c09a19eed9a5499039530142fbRoboErik break; 69786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 69886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 69986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 70086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 701ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * Indicates if the device implements a fixed volume policy. 702ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>Some devices may not have volume control and may operate at a fixed volume, 703ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * and may not enable muting or changing the volume of audio streams. 704ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * This method will return true on such devices. 705ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>The following APIs have no effect when volume is fixed: 706ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <ul> 707ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustVolume(int, int)} 708ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustSuggestedStreamVolume(int, int, int)} 709ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustStreamVolume(int, int, int)} 710ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamVolume(int, int, int)} 711ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setRingerMode(int)} 712ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamSolo(int, boolean)} 713ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamMute(int, boolean)} 714ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * </ul> 715ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent */ 716ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent public boolean isVolumeFixed() { 717ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent return mUseFixedVolume; 718ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent } 719ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent 720ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent /** 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of a particular stream by one step in a direction. 722fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 723fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 724fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_ALARM} 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustStreamVolume(int streamType, int direction, int flags) { 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 739ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock service.adjustStreamVolume(streamType, direction, flags, 740a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen mApplicationContext.getOpPackageName()); 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustStreamVolume", e); 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream. For example, if a call is 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active, it will have the highest priority regardless of if the in-call 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen is showing. Another example, if music is playing in the background 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and a call is not active, the music stream will be adjusted. 751fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 7524197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method should only be used by applications that replace the 7534197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * platform-wide management of audio settings or the main telephony 7544197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * application. 7554197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <p> 7564197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method has no effect if the device implements a fixed volume policy 757ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 7584197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 7604197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, 7614197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_SAME}, {@link #ADJUST_MUTE}, 7624197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_UNMUTE}, or {@link #ADJUST_TOGGLE_MUTE}. 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustSuggestedStreamVolume(int, int, int) 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 767ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustVolume(int direction, int flags) { 770a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mApplicationContext); 771ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock helper.sendAdjustVolumeBy(USE_DEFAULT_STREAM_TYPE, direction, flags); 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream, or the given fallback 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stream. 777fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 7784197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method should only be used by applications that replace the 7794197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * platform-wide management of audio settings or the main telephony 7804197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * application. 7814197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <p> 7824197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method has no effect if the device implements a fixed volume policy 783ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 7844197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 7864197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, 7874197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_SAME}, {@link #ADJUST_MUTE}, 7884197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_UNMUTE}, or {@link #ADJUST_TOGGLE_MUTE}. 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param suggestedStreamType The stream type that will be used if there 7904197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is 7914197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * valid here. 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 796ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { 799a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mApplicationContext); 800ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock helper.sendAdjustVolumeBy(suggestedStreamType, direction, flags); 801cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 802cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood 803ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock /** @hide */ 804ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock public void setMasterMute(boolean mute, int flags) { 805cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood IAudioService service = getService(); 806cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood try { 807a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen service.setMasterMute(mute, flags, mApplicationContext.getOpPackageName()); 808cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } catch (RemoteException e) { 809ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock Log.e(TAG, "Dead object in setMasterMute", e); 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current ringtone mode. 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRingerMode() { 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 823661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return service.getRingerModeExternal(); 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getRingerMode", e); 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return RINGER_MODE_NORMAL; 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 83172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * Checks valid ringer mode values. 83272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 83372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @return true if the ringer mode indicated is valid, false otherwise. 83472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 83572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @see #setRingerMode(int) 83672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @hide 83772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent */ 83872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent public static boolean isValidRingerMode(int ringerMode) { 83972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { 84072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return false; 84172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 8429755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock IAudioService service = getService(); 8439755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock try { 8449755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock return service.isValidRingerMode(ringerMode); 8459755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock } catch (RemoteException e) { 8469755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock Log.e(TAG, "Dead object in isValidRingerMode", e); 8479755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock return false; 8489755937ed90f06db45ff5fe4510950ae1516f8f9John Spurlock } 84972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 85072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 85172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent /** 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum volume index for a particular stream. 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose maximum volume index is returned. 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The maximum valid volume index for the stream. 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamMaxVolume(int streamType) { 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 861ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getStreamMaxVolume(streamType); 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamMaxVolume", e); 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 869b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * Returns the minimum volume index for a particular stream. 870b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * 871b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @param streamType The stream type whose minimum volume index is returned. 872b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @return The minimum valid volume index for the stream. 873b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @see #getStreamVolume(int) 874b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock * @hide 875b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock */ 876b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock public int getStreamMinVolume(int streamType) { 877b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock IAudioService service = getService(); 878b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock try { 879b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock return service.getStreamMinVolume(streamType); 880b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock } catch (RemoteException e) { 881b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock Log.e(TAG, "Dead object in getStreamMinVolume", e); 882b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock return 0; 883b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock } 884b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock } 885b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock 886b6e19e3e0f0170d058636101e23f964196f6f4b2John Spurlock /** 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current volume index for a particular stream. 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose volume index is returned. 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current volume index for the stream. 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamVolume(int streamType) { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 897ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getStreamVolume(streamType); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamVolume", e); 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 90525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * Get last audible volume before stream was muted. 90625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 90725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 90825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 90925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public int getLastAudibleStreamVolume(int streamType) { 91025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 91125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 912ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getLastAudibleStreamVolume(streamType); 91325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 91425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); 91525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return 0; 91625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 91725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 91825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 91925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 9206d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * Get the stream type whose volume is driving the UI sounds volume. 9216d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * UI sounds are screen lock/unlock, camera shutter, key clicks... 9224f0f120316cfcee5880191264885772677fff921John Spurlock * It is assumed that this stream type is also tied to ringer mode changes. 9236d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * @hide 9246d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent */ 925ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock public int getUiSoundsStreamType() { 9266d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent IAudioService service = getService(); 9276d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent try { 928ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.getUiSoundsStreamType(); 9296d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } catch (RemoteException e) { 930ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock Log.e(TAG, "Dead object in getUiSoundsStreamType", e); 9316d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return STREAM_RING; 9326d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 9336d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 9346d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent 9356d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent /** 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the ringer mode. 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Silent mode will mute the volume and will not vibrate. Vibrate mode will 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mute the volume and vibrate. Normal mode will be audible and may vibrate 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * according to user settings. 941ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 942ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 946ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRingerMode(int ringerMode) { 94972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (!isValidRingerMode(ringerMode)) { 95072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return; 95172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 954926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen service.setRingerModeExternal(ringerMode, mApplicationContext.getOpPackageName()); 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setRingerMode", e); 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the volume index for a particular stream. 962ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 963ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream whose volume index should be set. 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The volume index to set. See 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getStreamMaxVolume(int)} for the largest valid value. 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 970ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamVolume(int streamType, int index, int flags) { 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 975a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen service.setStreamVolume(streamType, index, flags, mApplicationContext.getOpPackageName()); 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamVolume", e); 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9824197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Solo or unsolo a particular stream. 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9844197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Do not use. This method has been deprecated and is now a no-op. 9854197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #requestAudioFocus} should be used for exclusive audio playback. 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be soloed/unsoloed. 9884197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @param state The required solo state: true for solo ON, false for solo 9894197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * OFF 990ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 9914197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @deprecated Do not use. If you need exclusive audio playback use 9924197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #requestAudioFocus}. 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9944197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik @Deprecated 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamSolo(int streamType, boolean state) { 9964197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik Log.w(TAG, "setStreamSolo has been deprecated. Do not use."); 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mute or unmute an audio stream. 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10024197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method should only be used by applications that replace the 10034197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * platform-wide management of audio settings or the main telephony 10044197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * application. 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10064197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method has no effect if the device implements a fixed volume policy 1007ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 10084197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <p> 10094197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * This method was deprecated in API level 22. Prior to API level 22 this 10104197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * method had significantly different behavior and should be used carefully. 10114197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * The following applies only to pre-22 platforms: 10124197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <ul> 10134197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <li>The mute command is protected against client process death: if a 10144197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * process with an active mute request on a stream dies, this stream will be 10154197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * unmuted automatically.</li> 10164197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <li>The mute requests for a given stream are cumulative: the AudioManager 10174197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * can receive several mute requests from one or more clients and the stream 10184197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * will be unmuted only when the same number of unmute requests are 10194197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * received.</li> 10204197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * <li>For a better user experience, applications MUST unmute a muted stream 10214197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * in onPause() and mute is again in onResume() if appropriate.</li> 10224197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * </ul> 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be muted/unmuted. 10254197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @param state The required mute state: true for mute ON, false for mute 10264197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * OFF 1027ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 10284197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @deprecated Use {@link #adjustStreamVolume(int, int, int)} with 10294197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * {@link #ADJUST_MUTE} or {@link #ADJUST_UNMUTE} instead. 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10314197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik @Deprecated 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamMute(int streamType, boolean state) { 10334197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik Log.w(TAG, "setStreamMute is deprecated. adjustStreamVolume should be used instead."); 10344197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik int direction = state ? ADJUST_MUTE : ADJUST_UNMUTE; 10354197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik if (streamType == AudioManager.USE_DEFAULT_STREAM_TYPE) { 10364197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik adjustSuggestedStreamVolume(direction, streamType, 0); 10374197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik } else { 10384197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik adjustStreamVolume(streamType, direction, 0); 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10434197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * Returns the current mute state for a particular stream. 104425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 10454197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @param streamType The stream to get mute state for. 10464197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @return The mute state for the given stream. 10474197cb60bc74629fe4c04ab10cb3b1c9a7427d24RoboErik * @see #adjustStreamVolume(int, int, int) 104825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 104925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public boolean isStreamMute(int streamType) { 105025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 105125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 1052ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock return service.isStreamMute(streamType); 105325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 105425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in isStreamMute", e); 105525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return false; 105625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 105725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 105825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 105925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 1060ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * get master mute state. 1061ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 1062ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 1063ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 1064ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public boolean isMasterMute() { 1065ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 1066ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 1067ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.isMasterMute(); 1068ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 1069ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in isMasterMute", e); 1070ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return false; 1071ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1072ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1073ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 1074ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 1075402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces the stream controlled by hard volume keys 1076402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * specifying streamType == -1 releases control to the 1077402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * logic. 1078402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * 1079402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 1080402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 1081402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public void forceVolumeControlStream(int streamType) { 108245c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent IAudioService service = getService(); 108345c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent try { 108445c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent service.forceVolumeControlStream(streamType, mICallBack); 108545c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } catch (RemoteException e) { 108645c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent Log.e(TAG, "Dead object in forceVolumeControlStream", e); 108745c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } 1088402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 1089402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 1090402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether a particular type should vibrate according to user 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings and the current ringer mode. 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that use notifications to 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate. The notification manager will not vibrate if the policy doesn't 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it, so the client should always set a vibrate pattern and let the 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * notification manager control whether or not to actually vibrate. 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether the type should vibrate at the instant this method is 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 1106cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1107cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldVibrate(int vibrateType) { 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.shouldVibrate(vibrateType); 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in shouldVibrate", e); 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether the user's vibrate setting for a vibrate type. 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that want to vibrate, instead 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link #shouldVibrate(int)}. 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1133cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1134cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getVibrateSetting(int vibrateType) { 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getVibrateSetting(vibrateType); 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getVibrateSetting", e); 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return VIBRATE_SETTING_OFF; 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the setting for when the vibrate type should vibrate. 1148fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1149fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1150fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateSetting The vibrate setting, one of 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ON}, 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1161cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1162cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setVibrateSetting(int vibrateType, int vibrateSetting) { 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setVibrateSetting(vibrateType, vibrateSetting); 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setVibrateSetting", e); 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the speakerphone on or off. 1175fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1176fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1177fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to turn on speakerphone; 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn it off 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpeakerphoneOn(boolean on){ 1183c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1184c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1185c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setSpeakerphoneOn(on); 1186c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1187c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setSpeakerphoneOn", e); 1188a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the speakerphone is on or off. 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if speakerphone is on, false if it's off 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSpeakerphoneOn() { 1197c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1198c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1199c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isSpeakerphoneOn(); 1200c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1201c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isSpeakerphoneOn", e); 1202a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1203a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12063def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent //==================================================================== 12073def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent // Bluetooth SCO control 12083def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12093def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 121095b88fbe744d8ce53b5f54f6fcd90c55094a8d14Eric Laurent * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} 12113def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} 12123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * or {@link #SCO_AUDIO_STATE_CONNECTED} 12133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * 12143def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 1215dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead 12163def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 1217dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @Deprecated 12183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 12193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_CHANGED = 12203def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.SCO_AUDIO_STATE_CHANGED"; 1221dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1222dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1223dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 1224dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * connection state has been updated. 1225dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>This intent has two extras: 1226dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1227dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_STATE} - The new SCO audio state. </li> 1228dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE}- The previous SCO audio state. </li> 1229dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1230dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p> EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: 1231dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1232dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_DISCONNECTED}, </li> 1233dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTING} or </li> 1234dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTED}, </li> 1235dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1236dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #startBluetoothSco() 1237dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1238dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1239dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_UPDATED = 1240dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; 1241dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 12423def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1243dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or 1244dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. 12453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12463def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String EXTRA_SCO_AUDIO_STATE = 12473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.extra.SCO_AUDIO_STATE"; 12483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1250dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous 1251dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * bluetooth SCO connection state. 1252dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1253dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = 1254dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; 1255dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1256dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1257dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1258dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is not established 12593def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12603def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; 12613def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1262dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} 1263dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is established 12643def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12653def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTED = 1; 12663def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1267dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1268dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is being established 1269dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1270dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTING = 2; 1271dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1272dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE indicating that 12733def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * there was an error trying to obtain the state 12743def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12753def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_ERROR = -1; 12763def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12773def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Indicates if current platform supports use of SCO for off call use cases. 12803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Application wanted to use bluetooth SCO audio when the phone is not in call 12812ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi * must first call this method to make sure that the platform supports this 12823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * feature. 12833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @return true if bluetooth SCO can be used for audio when not in call 12843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * false otherwise 12853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 12863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public boolean isBluetoothScoAvailableOffCall() { 1288926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen return mApplicationContext.getResources().getBoolean( 12893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent com.android.internal.R.bool.config_bluetooth_sco_off_call); 12903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12913def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12923def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12933def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Start bluetooth SCO audio connection. 12943def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 12953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 12963def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method can be used by applications wanting to send and received audio 12973def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * to/from a bluetooth SCO headset while the phone is not in call. 12983def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>As the SCO connection establishment can take several seconds, 12993def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * applications should not rely on the connection to be available when the method 1300dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} 13013def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. 1302dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO 1303dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * audio state before calling startBluetoothSco() by reading the intent returned by the receiver 1304dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * registration. If the state is already CONNECTED, no state change will be received via the 1305dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() 1306dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * so that the connection stays active in case the current initiator stops the connection. 1307dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>Unless the connection is already active as described above, the state will always 1308dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection 1309dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). 1310dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>When finished with the SCO connection or if the establishment fails, the application must 1311dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. 13123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Even if a SCO connection is established, the following restrictions apply on audio 13133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * output streams so that they can be routed to SCO headset: 1314dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1315dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the stream type must be {@link #STREAM_VOICE_CALL} </li> 1316dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1317dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 16kHz or 8kHz </li> 1318dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 13193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>The following restrictions apply on input streams: 1320dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1321dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1322dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 8kHz </li> 1323dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 13243def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Note that the phone application always has the priority on the usage of the SCO 13253def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * connection for telephony. If this method is called while the phone is in call 13263def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * it will be ignored. Similarly, if a call is received or sent while an application 13273def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * is using the SCO connection, the connection will be lost for the application and NOT 13283def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * returned automatically when the call ends. 132983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>NOTE: up to and including API version 133083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1}, this method initiates a virtual 133183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * voice call to the bluetooth headset. 133283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * After API version {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR2} only a raw SCO audio 133383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * connection is established. 13343def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #stopBluetoothSco() 1335dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 13363def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13373def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void startBluetoothSco(){ 13383def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 13393def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 1340926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen service.startBluetoothSco(mICallBack, 1341926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen mApplicationContext.getApplicationInfo().targetSdkVersion); 13423def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 13433def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in startBluetoothSco", e); 13443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13463def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 13480daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * @hide 134983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Start bluetooth SCO audio connection in virtual call mode. 135083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>Requires Permission: 135183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 135283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>Similar to {@link #startBluetoothSco()} with explicit selection of virtual call mode. 135383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Telephony and communication applications (VoIP, Video Chat) should preferably select 135483900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * virtual call mode. 135583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Applications using voice input for search or commands should first try raw audio connection 135683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * with {@link #startBluetoothSco()} and fall back to startBluetoothScoVirtualCall() in case of 135783900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * failure. 135883900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #startBluetoothSco() 135983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #stopBluetoothSco() 136083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 136183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent */ 136283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent public void startBluetoothScoVirtualCall() { 136383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent IAudioService service = getService(); 136483900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent try { 136583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent service.startBluetoothScoVirtualCall(mICallBack); 136683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } catch (RemoteException e) { 136783900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent Log.e(TAG, "Dead object in startBluetoothScoVirtualCall", e); 136883900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } 136983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } 137083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent 137183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent /** 13723def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Stop bluetooth SCO audio connection. 13733def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 13743def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 13753def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method must be called by applications having requested the use of 13760daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * bluetooth SCO audio with {@link #startBluetoothSco()} when finished with the SCO 13770daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * connection or if connection fails. 13783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 13793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13800daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi // Also used for connections started with {@link #startBluetoothScoVirtualCall()} 13813def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void stopBluetoothSco(){ 13823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 13833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 13843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.stopBluetoothSco(mICallBack); 13853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 13863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in stopBluetoothSco", e); 13873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13883def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1391a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Request use of Bluetooth SCO headset for communications. 1392fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1393fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1394fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1396a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param on set <var>true</var> to use bluetooth SCO for communications; 1397a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * <var>false</var> to not use bluetooth SCO for communications 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBluetoothScoOn(boolean on){ 1400c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1401c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1402c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setBluetoothScoOn(on); 1403c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1404c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setBluetoothScoOn", e); 1405a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1409a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Checks whether communications use Bluetooth SCO. 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1411a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return true if SCO is used for communications; 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothScoOn() { 1415c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1416c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1417c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isBluetoothScoOn(); 1418c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1419c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isBluetoothScoOn", e); 1420a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1421a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1425242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @param on set <var>true</var> to route A2DP audio to/from Bluetooth 1426242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * headset; <var>false</var> disable A2DP audio 1427a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1429a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setBluetoothA2dpOn(boolean on){ 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1433242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * Checks whether A2DP audio routing to the Bluetooth headset is on or off. 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1435242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @return true if A2DP audio is being routed to/from Bluetooth headset; 1436242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * false if otherwise 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothA2dpOn() { 1439242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") 1440242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1441a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1442242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent } else { 1443242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent return true; 1444a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets audio routing to the wired headset on or off. 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route audio to/from wired 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable wired headset audio 1452a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1454a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setWiredHeadsetOn(boolean on){ 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1458497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * Checks whether a wired headset is connected or not. 1459497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * <p>This is not a valid indication that audio playback is 1460497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * actually over the wired headset as audio routing depends on other conditions. 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1462497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @return true if a wired headset is connected. 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 1464497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @deprecated Use only to check is a headset is connected or not. 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWiredHeadsetOn() { 14678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") 14686015a9715421a339c2b7bb63f9166504e3488179Eric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE && 14698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") 1470a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1471a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1472a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1473a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1474a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 1479fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1480fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1481fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to mute the microphone; 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMicrophoneMute(boolean on){ 148722c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier IAudioService service = getService(); 148822c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier try { 1489926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen service.setMicrophoneMute(on, mApplicationContext.getOpPackageName()); 149022c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier } catch (RemoteException e) { 149122c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier Log.e(TAG, "Dead object in setMicrophoneMute", e); 149222c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if microphone is muted, false if it's not 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMicrophoneMute() { 1501a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.isMicrophoneMuted(); 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio mode. 1506fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1507fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * The audio mode encompasses audio routing AND the behavior of 1508fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * the telephony layer. Therefore this method should only be used by applications that 1509fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * replace the platform-wide management of audio settings or the main telephony application. 1510fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony 1511fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * application when it places a phone call, as it will cause signals from the radio layer 1512fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * to feed the platform mixer. 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15148aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 15158aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Informs the HAL about the current audio state so that 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it can route the audio appropriately. 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMode(int mode) { 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1522a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen service.setMode(mode, mICallBack, mApplicationContext.getOpPackageName()); 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setMode", e); 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio mode. 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15318aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 15328aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current current audio state from the HAL. 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMode() { 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getMode(); 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getMode", e); 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return MODE_INVALID; 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* modes for setMode/getMode/setRoute/getRoute */ 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Audio harware modes. 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalid audio mode. 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = AudioSystem.MODE_INVALID; 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Current audio mode. Used to apply audio routing to current mode. 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normal audio mode: not ringing and no call established. 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringing audio mode. An incoming is being signaled. 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15668f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In call audio mode. A telephony call is established. 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; 15698f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi /** 15708f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In communication audio mode. An audio/video chat or VoIP call is established. 15718f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi */ 15728f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Routing bits for setRouting/getRouting API */ 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to earpiece 15774a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15784a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1580a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15824a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * Routing audio output to speaker 15834a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15844a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1586a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} 15894a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15904a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth SCO 15954a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15964a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1598a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to headset 16014a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16024a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1604a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth A2DP 16074a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16084a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1610a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used for mask parameter of {@link #setRouting(int,int,int)}. 16134a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16144a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1616a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio routing for a specified mode 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to change route. E.g., MODE_RINGTONE. 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param routes bit vector of routes requested, created from one or 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more of ROUTE_xxx types. Set bits indicate that route should be on 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mask bit vector of routes to change, created from one or more of 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ROUTE_xxx types. Unset bits indicate the route should be left unchanged 1626b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * 1627b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 1628a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * setBluetoothScoOn() methods instead. 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1630a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRouting(int mode, int routes, int mask) { 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio routing bit vector for a specified mode. 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to get route (e.g., MODE_RINGTONE) 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an audio route bit vector that can be compared with ROUTE_xxx 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bits 1640b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), 1641b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1643b9c9d260f21b321527c4622a123af9767630d94dEric Laurent @Deprecated 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRouting(int mode) { 1645a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return -1; 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether any music is active. 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if any music tracks are active. 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMusicActive() { 165425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return AudioSystem.isStreamActive(STREAM_MUSIC, 0); 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16573114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi /** 16583114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * @hide 1659679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * Checks whether any music or media is actively playing on a remote device (e.g. wireless 1660679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * display). Note that BT audio sinks are not considered remote devices. 1661679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @return true if {@link AudioManager#STREAM_MUSIC} is active on a remote device 1662679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi */ 1663679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi public boolean isMusicActiveRemotely() { 1664679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi return AudioSystem.isStreamActiveRemotely(STREAM_MUSIC, 0); 1665679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi } 1666679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi 1667679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi /** 1668679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @hide 16692380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Checks whether the current audio focus is exclusive. 16702380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @return true if the top of the audio focus stack requested focus 16712380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * with {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} 16722380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 16732380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public boolean isAudioFocusExclusive() { 16742380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi IAudioService service = getService(); 16752380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi try { 16762380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return service.getCurrentAudioFocus() == AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE; 16772380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } catch (RemoteException e) { 16782380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi Log.e(TAG, "Dead object in isAudioFocusExclusive()", e); 16792380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return false; 16802380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 16812380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 16822380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 16832380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 16848a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * Return a new audio session identifier not associated with any player or effect. 16859e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * An audio session identifier is a system wide unique identifier for a set of audio streams 16869e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * (one or more mixed together). 16879e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * <p>The primary use of the audio session ID is to associate audio effects to audio players, 16889e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * such as {@link MediaPlayer} or {@link AudioTrack}: all audio effects sharing the same audio 16899e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * session ID will be applied to the mixed audio content of the players that share the same 16909e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * audio session. 16919e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * <p>This method can for instance be used when creating one of the 16929e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * {@link android.media.audiofx.AudioEffect} objects to define the audio session of the effect, 16939e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * or to specify a session for a speech synthesis utterance 16949e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * in {@link android.speech.tts.TextToSpeech.Engine}. 16958a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * @return a new unclaimed and unused audio session identifier, or {@link #ERROR} when the 16969e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * system failed to generate a new session, a condition in which audio playback or recording 16979e477e408433fe1bd0c695b1e7a0738a76009cfdJean-Michel Trivi * will subsequently fail as well. 16988a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi */ 1699289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi public int generateAudioSessionId() { 17008a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi int session = AudioSystem.newAudioSessionId(); 17018a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi if (session > 0) { 17028a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi return session; 17038a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } else { 1704289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi Log.e(TAG, "Failure to generate a new audio session ID"); 17058a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi return ERROR; 17068a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } 17078a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } 17088a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi 1709289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi /** 1710289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * A special audio session ID to indicate that the audio session ID isn't known and the 1711289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * framework should generate a new value. This can be used when building a new 1712289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioTrack} instance with 1713289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioTrack#AudioTrack(AudioAttributes, AudioFormat, int, int, int)}. 1714289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi */ 1715289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi public static final int AUDIO_SESSION_ID_GENERATE = AudioSystem.AUDIO_SESSION_ALLOCATE; 1716289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi 17178a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a generic audio configuration parameter. The use of these parameters 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are platform dependant, see libaudio 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Temporary interface - DO NOT USE 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * TODO: Replace with a more generic key:value get/set mechanism 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param key name of parameter to set. Must not be null. 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param value value of parameter. Must not be null. 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1731ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @deprecated Use {@link #setParameters(String)} instead 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1733a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setParameter(String key, String value) { 1734a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent setParameters(key+"="+value); 1735a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1736a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1737a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1738a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a variable number of parameter values to audio hardware. 1739a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1740a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keyValuePairs list of parameters key value pairs in the form: 1741a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1742a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1743a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1744a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public void setParameters(String keyValuePairs) { 1745a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.setParameters(keyValuePairs); 1746a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1747a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1748a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1749aac753dcf8862b416773eabaabb9d938a30f5896John Spurlock * Gets a variable number of parameter values from audio hardware. 1750a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1751a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keys list of parameters 1752a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return list of parameters key value pairs in the form: 1753a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1754a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1755a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public String getParameters(String keys) { 1756a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.getParameters(keys); 17579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Sound effect identifiers */ 17609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Keyboard and direction pad click sound 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEY_CLICK = 0; 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved up 17679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_UP = 1; 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved down 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_DOWN = 2; 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved left 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_LEFT = 3; 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved right 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME standard keypress sound 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_STANDARD = 5; 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME spacebar keypress sound 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_SPACEBAR = 6; 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME delete keypress sound 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_DELETE = 7; 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME return_keypress sound 18029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_RETURN = 8; 1805cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh 1806cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh /** 1807cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * Invalid keypress sound 1808cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * @see #playSoundEffect(int) 1809cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh */ 1810cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int FX_KEYPRESS_INVALID = 9; 18119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Number of sound effects 18139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1814cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int NUM_SOUND_EFFECTS = 10; 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 18219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 18229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 18239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1824105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1825105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1826105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1827105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1828cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version uses the UI settings to determine 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whether sounds are heard or not. 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType) { 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18370c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk if (!querySoundEffectsEnabled(Process.myUserHandle().getIdentifier())) { 18380c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk return; 18390c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 18400c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk 18410c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk IAudioService service = getService(); 18420c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk try { 18430c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk service.playSoundEffect(effectType); 18440c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } catch (RemoteException e) { 18450c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk Log.e(TAG, "Dead object in playSoundEffect"+e); 18460c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 18470c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 18480c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk 18490c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk /** 18500c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * Plays a sound effect (Key clicks, lid open/close...) 18510c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * @param effectType The type of sound effect. One of 18520c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEY_CLICK}, 18530c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_UP}, 18540c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_DOWN}, 18550c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_LEFT}, 18560c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 18570c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_STANDARD}, 18580c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_SPACEBAR}, 18590c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_DELETE}, 18600c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_RETURN}, 18610c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * {@link #FX_KEYPRESS_INVALID}, 18620c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * @param userId The current user to pull sound settings from 18630c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * NOTE: This version uses the UI settings to determine 18640c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * whether sounds are heard or not. 18650c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk * @hide 18660c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk */ 18670c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk public void playSoundEffect(int effectType, int userId) { 18680c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 18690c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk return; 18700c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk } 18710c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk 18720c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk if (!querySoundEffectsEnabled(userId)) { 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 18779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffect(effectType); 18799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 18869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 18879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 18889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 18899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 18919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1892105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1893105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1894105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1895105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1896cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 1897a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * @param volume Sound effect volume. 1898a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * The volume value is a raw scalar so UI controls should be scaled logarithmically. 1899a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version is for applications that have their own 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings panel for enabling and controlling volume. 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType, float volume) { 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 19089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 19099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffectVolume(effectType, volume); 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 19129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 19139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings has an in memory cache, so this is fast. 19189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19190c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk private boolean querySoundEffectsEnabled(int user) { 1920926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen return Settings.System.getIntForUser(mApplicationContext.getContentResolver(), 19210c37ba318847a44cb9256e55eca1160dc1fffd4dJason Monk Settings.System.SOUND_EFFECTS_ENABLED, 0, user) != 0; 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Load Sound effects. 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method must be called when sound effects are enabled. 19289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void loadSoundEffects() { 19309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 19319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.loadSoundEffects(); 19339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 19349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in loadSoundEffects"+e); 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unload Sound effects. 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method can be called to free some memory when 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sound effects are disabled. 19429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unloadSoundEffects() { 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 19459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.unloadSoundEffects(); 19479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in unloadSoundEffects"+e); 19499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19524050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent /** 19532380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @hide 19542380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate no audio focus has been gained or lost. 19552380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 19562380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_NONE = 0; 19572380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 19582380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 1959d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. 19607f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1961d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1962d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1963d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN = 1; 1964d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1965d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a temporary gain or request of audio focus, anticipated to last a short 1966d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * amount of time. Examples of temporary changes are the playback of driving directions, or an 1967d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * event notification. 19687f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1969d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1970d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1971d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; 1972078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1973078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 1974983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * amount of time, and where it is acceptable for other audio applications to keep playing 1975983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * after having lowered their output level (also referred to as "ducking"). 1976078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Examples of temporary changes are the playback of driving directions where playback of music 1977078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * in the background is acceptable. 19787f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1979078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1980078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1981078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; 1982078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 19832380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 19842380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * amount of time, during which no other applications, or system components, should play 19852380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * anything. Examples of exclusive and transient audio focus requests are voice 19862380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * memo recording and speech recognition, during which the system shouldn't play any 19872380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * notifications, and media playback should have paused. 19882380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 19892380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 19902380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE = 4; 19912380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 1992078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a loss of audio focus of unknown duration. 19937f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1994078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1995078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; 1996078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1997078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus. 19987f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1999078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 2000078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; 2001078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 2002078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus where the loser of the audio focus can 2003983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * lower its output volume if it wants to continue playing (also referred to as "ducking"), as 2004983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the new focus owner doesn't require others to be silent. 20057f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 2006078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 2007078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = 2008078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; 2009d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2010d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2011d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Interface definition for a callback to be invoked when the audio focus of the system is 2012d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * updated. 2013d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2014d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public interface OnAudioFocusChangeListener { 2015d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2016d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Called on the listener to notify it the audio focus for this listener has been changed. 2017d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * The focusChange value indicates whether the focus was gained, 2018d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * whether the focus was lost, and whether that loss is transient, or whether the new focus 2019d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * holder will hold it for an unknown amount of time. 2020983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * When losing focus, listeners can use the focus change information to decide what 2021983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * behavior to adopt when losing focus. A music player could for instance elect to lower 2022983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the volume of its music stream (duck) for transient focus losses, and pause otherwise. 2023983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, 2024078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} 2025983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. 2026d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 20277f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi public void onAudioFocusChange(int focusChange); 2028d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2029d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2030d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2031d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, 2032d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * to actual listener objects. 2033d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 203430c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final HashMap<String, OnAudioFocusChangeListener> mAudioFocusIdListenerMap = 2035d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi new HashMap<String, OnAudioFocusChangeListener>(); 2036d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2037d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager 2038d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * instance. 2039d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2040d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Object mFocusListenerLock = new Object(); 2041d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2042d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private OnAudioFocusChangeListener findFocusListener(String id) { 2043d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi return mAudioFocusIdListenerMap.get(id); 2044d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2045d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2046d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2047d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Handler for audio focus events coming from the audio service. 2048d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 204930c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = 2050d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi new FocusEventHandlerDelegate(); 2051078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi 2052d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2053d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Helper class to handle the forwarding of audio focus events to the appropriate listener 2054d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2055d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private class FocusEventHandlerDelegate { 2056d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Handler mHandler; 2057d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2058d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi FocusEventHandlerDelegate() { 2059d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Looper looper; 2060d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if ((looper = Looper.myLooper()) == null) { 2061d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi looper = Looper.getMainLooper(); 2062d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2063d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2064d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (looper != null) { 2065d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // implement the event handler delegate to receive audio focus events 2066d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = new Handler(looper) { 2067d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi @Override 2068d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void handleMessage(Message msg) { 2069d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi OnAudioFocusChangeListener listener = null; 2070d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2071d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi listener = findFocusListener((String)msg.obj); 2072d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2073d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (listener != null) { 2074fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi Log.d(TAG, "AudioManager dispatching onAudioFocusChange(" 2075fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi + msg.what + ") for " + msg.obj); 20767f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi listener.onAudioFocusChange(msg.what); 2077d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2078d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2079d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 2080d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 2081d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = null; 2082d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2083d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2084d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2085d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Handler getHandler() { 2086d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return mHandler; 2087d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2088d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2089d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 209030c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { 2091d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2092d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void dispatchAudioFocusChange(int focusChange, String id) { 2093d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); 2094d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); 2095d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2096d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2097d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 2098d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2099d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { 2100d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (l == null) { 2101308e9a5d0975489982f93fd1f3728e6ed7a778d0Jean-Michel Trivi return new String(this.toString()); 2102d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 2103d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return new String(this.toString() + l.toString()); 2104d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2105d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2106d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2107d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 21085f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 210946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Registers a listener to be called when audio focus changes. Calling this method is optional 211046b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it 211146b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * will register the listener as well if it wasn't registered already. 211246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to be notified of audio focus changes. 2113d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2114d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void registerAudioFocusListener(OnAudioFocusChangeListener l) { 2115d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2116d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { 2117d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return; 2118d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2119d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); 2120d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2121d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2122d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2123d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 21245f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 212546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Causes the specified listener to not be called anymore when focus is gained or lost. 212646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to unregister. 2127d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2128d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { 2129392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi 2130d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // remove locally 2131d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2132d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); 2133d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2134d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2135d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2136d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2137d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 213846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A failed focus change request. 2139d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2140d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_FAILED = 0; 2141d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 214246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A successful focus change request. 2143d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2144d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; 2145fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi /** 2146fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @hide 2147fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * A focus change request whose granting is delayed: the request was successful, but the 2148fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * requester will only be granted audio focus once the condition that prevented immediate 2149fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * granting has ended. 2150fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * See {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2151fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi */ 2152fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_DELAYED = 2; 2153d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2154d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2155d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2156d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Request audio focus. 215746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Send a request to obtain the audio focus 2158d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param l the listener to be notified of audio focus changes 2159d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param streamType the main audio stream type affected by the focus request 2160d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 2161d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 2162078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * for the playback of driving directions, or notifications sounds. 2163983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 2164983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 21659171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * Alternatively use {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} for a temporary request 21669171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * that benefits from the system not playing disruptive sounds like notifications, for 21679171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * usecases such as voice memo recording, or speech recognition. 2168078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 2169d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * as the playback of a song or a video. 2170d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2171d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2172d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { 2173d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2174fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2175fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi try { 2176fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // status is guaranteed to be either AUDIOFOCUS_REQUEST_FAILED or 2177fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // AUDIOFOCUS_REQUEST_GRANTED as focus is requested without the 2178fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // AUDIOFOCUS_FLAG_DELAY_OK flag 2179fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi status = requestAudioFocus(l, 2180fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi new AudioAttributes.Builder() 2181fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi .setInternalLegacyStreamType(streamType).build(), 2182fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi durationHint, 2183fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 0 /* flags, legacy behavior */); 2184fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } catch (IllegalArgumentException e) { 2185fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi Log.e(TAG, "Audio focus request denied due to ", e); 2186fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2187fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2188fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi return status; 2189fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2190fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2191958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi // when adding new flags, add them to the relevant AUDIOFOCUS_FLAGS_APPS or SYSTEM masks 21920212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi /** 21930212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @hide 21940212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * Use this flag when requesting audio focus to indicate it is ok for the requester to not be 21950212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * granted audio focus immediately (as indicated by {@link #AUDIOFOCUS_REQUEST_DELAYED}) when 21960212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * the system is in a state where focus cannot change, but be granted focus later when 21970212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * this condition ends. 21980212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi */ 2199958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 2200fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi public static final int AUDIOFOCUS_FLAG_DELAY_OK = 0x1 << 0; 22010212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi /** 22020212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @hide 22030212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * Use this flag when requesting audio focus to indicate that the requester 22040212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * will pause its media playback (if applicable) when losing audio focus with 22050212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link #AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}, rather than ducking. 22060212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * <br>On some platforms, the ducking may be handled without the application being aware of it 22070212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * (i.e. it will not transiently lose focus). For applications that for instance play spoken 22080212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * content, such as audio book or podcast players, ducking may never be acceptable, and will 22090212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * thus always pause. This flag enables them to be declared as such whenever they request focus. 22100212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi */ 22110212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi @SystemApi 22120212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi public static final int AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS = 0x1 << 1; 22130212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi /** 22140212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @hide 22150212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * Use this flag to lock audio focus so granting is temporarily disabled. 22160212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * <br>This flag can only be used by owners of a registered 22170212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link android.media.audiopolicy.AudioPolicy} in 22180212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int, AudioPolicy)} 22190212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi */ 2220958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 22210212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi public static final int AUDIOFOCUS_FLAG_LOCK = 0x1 << 2; 2222958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** @hide */ 22230212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi public static final int AUDIOFOCUS_FLAGS_APPS = AUDIOFOCUS_FLAG_DELAY_OK 22240212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi | AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS; 2225958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** @hide */ 2226958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi public static final int AUDIOFOCUS_FLAGS_SYSTEM = AUDIOFOCUS_FLAG_DELAY_OK 22270212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi | AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS | AUDIOFOCUS_FLAG_LOCK; 2228fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2229fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi /** 2230fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @hide 2231958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Request audio focus. 2232958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Send a request to obtain the audio focus. This method differs from 2233958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)} in that it can express 2234958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * that the requester accepts delayed grants of audio focus. 2235fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @param l the listener to be notified of audio focus changes. It is not allowed to be null 2236fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * when the request is flagged with {@link #AUDIOFOCUS_FLAG_DELAY_OK}. 2237fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @param requestAttributes non null {@link AudioAttributes} describing the main reason for 2238fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * requesting audio focus. 2239fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 2240fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 2241fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * for the playback of driving directions, or notifications sounds. 2242fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 2243fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 2244fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * Alternatively use {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} for a temporary request 2245fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * that benefits from the system not playing disruptive sounds like notifications, for 2246fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * usecases such as voice memo recording, or speech recognition. 2247fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 2248fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * as the playback of a song or a video. 22490212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * @param flags 0 or a combination of {link #AUDIOFOCUS_FLAG_DELAY_OK} 22500212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * and {@link #AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS}. 2251958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * <br>Use 0 when not using any flags for the request, which behaves like 2252958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, where either audio 2253958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * focus is granted immediately, or the grant request fails because the system is in a 2254958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * state where focus cannot change (e.g. a phone call). 2255fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED}, {@link #AUDIOFOCUS_REQUEST_GRANTED} 2256fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * or {@link #AUDIOFOCUS_REQUEST_DELAYED}. 2257fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * The return value is never {@link #AUDIOFOCUS_REQUEST_DELAYED} when focus is requested 2258fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * without the {@link #AUDIOFOCUS_FLAG_DELAY_OK} flag. 2259fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi * @throws IllegalArgumentException 2260fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi */ 2261958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 2262fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, 2263958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @NonNull AudioAttributes requestAttributes, 2264fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi int durationHint, 2265fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi int flags) throws IllegalArgumentException { 2266958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi if (flags != (flags & AUDIOFOCUS_FLAGS_APPS)) { 2267958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi throw new IllegalArgumentException("Invalid flags 0x" 2268958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi + Integer.toHexString(flags).toUpperCase()); 2269958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2270958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi return requestAudioFocus(l, requestAttributes, durationHint, 2271958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi flags & AUDIOFOCUS_FLAGS_APPS, 2272958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi null /* no AudioPolicy*/); 2273958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2274958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi 2275958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** 2276958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @hide 2277958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Request or lock audio focus. 2278958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * This method is to be used by system components that have registered an 2279958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link android.media.audiopolicy.AudioPolicy} to request audio focus, but also to "lock" it 2280958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * so focus granting is temporarily disabled. 2281958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param l see the description of the same parameter in 2282958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2283958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param requestAttributes non null {@link AudioAttributes} describing the main reason for 2284958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * requesting audio focus. 2285958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param durationHint see the description of the same parameter in 2286958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2287958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param flags 0 or a combination of {link #AUDIOFOCUS_FLAG_DELAY_OK}, 22880212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi * {@link #AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS}, and {@link #AUDIOFOCUS_FLAG_LOCK}. 2289958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * <br>Use 0 when not using any flags for the request, which behaves like 2290958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, where either audio 2291958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * focus is granted immediately, or the grant request fails because the system is in a 2292958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * state where focus cannot change (e.g. a phone call). 2293958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param ap a registered {@link android.media.audiopolicy.AudioPolicy} instance when locking 2294958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * focus, or null. 2295958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @return see the description of the same return value in 2296958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * {@link #requestAudioFocus(OnAudioFocusChangeListener, AudioAttributes, int, int)} 2297958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @throws IllegalArgumentException 2298958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi */ 22991b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi @SystemApi 2300958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, 2301958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @NonNull AudioAttributes requestAttributes, 2302958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi int durationHint, 2303958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi int flags, 2304958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi AudioPolicy ap) throws IllegalArgumentException { 2305fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi // parameter checking 2306fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi if (requestAttributes == null) { 2307fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes argument"); 2308fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 23092380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi if ((durationHint < AUDIOFOCUS_GAIN) || 23102380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE)) { 2311fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException("Invalid duration hint"); 2312fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2313958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi if (flags != (flags & AUDIOFOCUS_FLAGS_SYSTEM)) { 2314fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException("Illegal flags 0x" 2315fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi + Integer.toHexString(flags).toUpperCase()); 231655d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi } 2317fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi if (((flags & AUDIOFOCUS_FLAG_DELAY_OK) == AUDIOFOCUS_FLAG_DELAY_OK) && (l == null)) { 2318fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi throw new IllegalArgumentException( 2319fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi "Illegal null focus listener when flagged as accepting delayed focus grant"); 2320fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi } 2321958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi if (((flags & AUDIOFOCUS_FLAG_LOCK) == AUDIOFOCUS_FLAG_LOCK) && (ap == null)) { 2322958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi throw new IllegalArgumentException( 2323958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi "Illegal null audio policy when locking audio focus"); 2324958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2325fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi 2326fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2327d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi registerAudioFocusListener(l); 2328d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2329d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2330fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi status = service.requestAudioFocus(requestAttributes, durationHint, mICallBack, 23318f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mAudioFocusDispatcher, getIdForAudioFocusListener(l), 2332926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen mApplicationContext.getOpPackageName() /* package name */, flags, 23330212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi ap != null ? ap.cb() : null); 2334d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 2335958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocus() on AudioService:", e); 2336d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2337d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2338d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2339d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 23404dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 23414dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 23424dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to request audio focus. Will cause the focus request 23434dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to be associated with the "voice communication" identifier only used in AudioService 23444dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to identify this use case. 23454dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param streamType use STREAM_RING for focus requests when ringing, VOICE_CALL for 23464dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * the establishment of the call 23474dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param durationHint the type of focus request. AUDIOFOCUS_GAIN_TRANSIENT is recommended so 23484dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * media applications resume after a call 23494dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 23504dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void requestAudioFocusForCall(int streamType, int durationHint) { 23514dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 23524dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 2353fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi service.requestAudioFocus(new AudioAttributes.Builder() 2354fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi .setInternalLegacyStreamType(streamType).build(), 2355fd6ad747e6c268753d0edf7a5a59b6815b190854Jean-Michel Trivi durationHint, mICallBack, null, 23566156017c2217d0fbbbb03434986250ec6bbd69d8John Spurlock AudioSystem.IN_VOICE_COMM_FOCUS_ID, 2357926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen mApplicationContext.getOpPackageName(), 2358958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi AUDIOFOCUS_FLAG_LOCK, 2359958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi null /* policy token */); 23604dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 2361958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocusForCall() on AudioService:", e); 23624dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 23634dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 23644dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi 23654dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 23664dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 23674dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to abandon audio focus, typically after a call or 23684dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * when ringing ends and the call is rejected or not answered. 23694dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Should match one or more calls to {@link #requestAudioFocusForCall(int, int)}. 23704dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 23714dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void abandonAudioFocusForCall() { 23724dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 23734dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 23746156017c2217d0fbbbb03434986250ec6bbd69d8John Spurlock service.abandonAudioFocus(null, AudioSystem.IN_VOICE_COMM_FOCUS_ID, 2375958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi null /*AudioAttributes, legacy behavior*/); 23764dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 2377958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocusForCall() on AudioService:", e); 23784dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 23794dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 2380d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2381d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 238246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 238346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener with which focus was requested. 2384d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2385d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2386d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l) { 2387958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi return abandonAudioFocus(l, null /*AudioAttributes, legacy behavior*/); 2388958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi } 2389958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi 2390958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi /** 2391958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @hide 2392958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 2393958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param l the listener with which focus was requested. 2394958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @param aa the {@link AudioAttributes} with which audio focus was requested 2395958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2396958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi */ 2397958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi @SystemApi 2398958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l, AudioAttributes aa) { 2399d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2400392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi unregisterAudioFocusListener(l); 2401d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2402d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2403d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi status = service.abandonAudioFocus(mAudioFocusDispatcher, 2404958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi getIdForAudioFocusListener(l), aa); 2405d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 2406958876fe55ea0fdeb73c72240a2f2bab32833443Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocus() on AudioService:", e); 2407d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2408d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2409d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2410d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2411d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi //==================================================================== 2412d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi // Remote Control 2413d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 241446b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Register a component to be the sole receiver of MEDIA_BUTTON intents. 2415d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 2416d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * that will receive the media button intent. This broadcast receiver must be declared 2417f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * in the application manifest. The package of the component must match that of 2418f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * the context you're registering from. 2419b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession#setMediaButtonReceiver(PendingIntent)} instead. 2420d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2421b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2422d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { 24238f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 24248f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 24258f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2426926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen if (!eventReceiver.getPackageName().equals(mApplicationContext.getPackageName())) { 2427f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "registerMediaButtonEventReceiver() error: " + 2428f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi "receiver and context package names don't match"); 2429f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2430f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2431f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and register it 2432f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2433f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2434f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2435926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen PendingIntent pi = PendingIntent.getBroadcast(mApplicationContext, 2436f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2437f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi registerMediaButtonIntent(pi, eventReceiver); 2438f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2439f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2440f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2441961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Register a component to be the sole receiver of MEDIA_BUTTON intents. This is like 2442961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(android.content.ComponentName)}, but allows 2443961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * the buttons to go to any PendingIntent. Note that you should only use this form if 2444961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * you know you will continue running for the full time until unregistering the 2445961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * PendingIntent. 2446961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver target that will receive media button intents. The PendingIntent 2447b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * will be sent an {@link Intent#ACTION_MEDIA_BUTTON} event when a media button action 2448b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * occurs, with {@link Intent#EXTRA_KEY_EVENT} added and holding the key code of the 2449b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * media button that was pressed. 2450b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession#setMediaButtonReceiver(PendingIntent)} instead. 2451961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2452b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2453961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void registerMediaButtonEventReceiver(PendingIntent eventReceiver) { 2454961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2455961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2456961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2457961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn registerMediaButtonIntent(eventReceiver, null); 2458961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2459961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2460961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2461f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2462f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * no-op if (pi == null) or (eventReceiver == null) 2463f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2464f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi public void registerMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { 2465961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (pi == null) { 2466f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Cannot call registerMediaButtonIntent() with a null parameter"); 2467f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2468f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2469926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mApplicationContext); 2470926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen helper.addMediaButtonListener(pi, eventReceiver, mApplicationContext); 2471722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2472722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi 2473722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi /** 247446b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Unregister the receiver of MEDIA_BUTTON intents. 247546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 247646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. 2477b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 2478d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2479b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2480d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { 24818f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 24828f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 24838f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2484f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and unregister it 2485f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2486f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2487f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2488926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen PendingIntent pi = PendingIntent.getBroadcast(mApplicationContext, 2489f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2490b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(pi); 2491f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2492f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2493f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2494961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Unregister the receiver of MEDIA_BUTTON intents. 2495961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver same PendingIntent that was registed with 2496961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(PendingIntent)}. 2497b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 2498961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2499b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2500961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void unregisterMediaButtonEventReceiver(PendingIntent eventReceiver) { 2501961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2502961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2503961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2504b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(eventReceiver); 2505961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2506961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2507961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2508f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2509f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2510b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi public void unregisterMediaButtonIntent(PendingIntent pi) { 2511926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mApplicationContext); 2512430fc48865e5a371b08f180390946b96d73848feRoboErik helper.removeMediaButtonListener(pi); 2513d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2514d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 2515178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 2516178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Registers the remote control client for providing information to display on the remote 2517178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * controls. 2518466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client from which remote controls will receive 2519466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * information to display. 2520466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @see RemoteControlClient 2521b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 25228f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 2523b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 25244426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void registerRemoteControlClient(RemoteControlClient rcClient) { 2525f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 25268f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 25278f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2528926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen rcClient.registerWithSession(MediaSessionLegacyHelper.getHelper(mApplicationContext)); 25298f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 25308f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 25318f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 2532fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * Unregisters the remote control client that was providing information to display on the 2533466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * remote controls. 2534466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client to unregister. 25354426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi * @see #registerRemoteControlClient(RemoteControlClient) 2536b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 25378f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 2538b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 25394426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void unregisterRemoteControlClient(RemoteControlClient rcClient) { 2540f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 25418f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 25428f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2543926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen rcClient.unregisterWithSession(MediaSessionLegacyHelper.getHelper(mApplicationContext)); 25448f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 25458f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 254644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 2547a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * Registers a {@link RemoteController} instance for it to receive media 2548a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * metadata updates and playback state information from applications using 2549a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * {@link RemoteControlClient}, and control their playback. 2550a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * <p> 2551ee5ad729b90deff435f9875337cbc434be4f8fe7John Spurlock * Registration requires the {@link RemoteController.OnClientUpdateListener} listener to be 2552a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * one of the enabled notification listeners (see 2553f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * {@link android.service.notification.NotificationListenerService}). 2554a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * 2555a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to register. 2556a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * @return true if the {@link RemoteController} was successfully registered, 2557a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * false if an error occurred, due to an internal system error, or 2558a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * insufficient permissions. 2559b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use 2560a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * {@link MediaSessionManager#addOnActiveSessionsChangedListener(android.media.session.MediaSessionManager.OnActiveSessionsChangedListener, ComponentName)} 2561a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * and {@link MediaController} instead. 25627ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 2563b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 25647ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public boolean registerRemoteController(RemoteController rctlr) { 25657ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 25667ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return false; 25677ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 2568430fc48865e5a371b08f180390946b96d73848feRoboErik rctlr.startListeningToSessions(); 2569430fc48865e5a371b08f180390946b96d73848feRoboErik return true; 25707ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 25717ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 25727ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 2573a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * Unregisters a {@link RemoteController}, causing it to no longer receive 2574a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * media metadata and playback state information, and no longer be capable 2575a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * of controlling playback. 2576a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * 2577a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to unregister. 2578b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use 2579a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * {@link MediaSessionManager#removeOnActiveSessionsChangedListener(android.media.session.MediaSessionManager.OnActiveSessionsChangedListener)} 2580a66c40bf6e0fb79ead6d8a9fc29c5671fa7b1206RoboErik * instead. 25817ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 2582b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 25837ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public void unregisterRemoteController(RemoteController rctlr) { 25847ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 25857ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return; 25867ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 2587430fc48865e5a371b08f180390946b96d73848feRoboErik rctlr.stopListeningToSessions(); 25887ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 25897ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 25907ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 25917ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 259244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 25934a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Use this method if your IRemoteControlDisplay is not going to display artwork, otherwise 25944a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * use {@link #registerRemoteControlDisplay(IRemoteControlDisplay, int, int)} to pass the 25954a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * artwork size directly, or 25964a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * {@link #remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay, int, int)} later if artwork 25974a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * is not yet needed. 2598f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * <p>Registration requires the {@link Manifest.permission#MEDIA_CONTENT_CONTROL} permission. 25994a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd the IRemoteControlDisplay 260044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 260144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd) { 26024a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi // passing a negative value for art work width and height as they are unknown at this stage 26034a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi registerRemoteControlDisplay(rcd, /*w*/-1, /*h*/ -1); 26044a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi } 26054a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi 26064a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi /** 26074a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @hide 26084a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 2609f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * <p>Registration requires the {@link Manifest.permission#MEDIA_CONTENT_CONTROL} permission. 26104a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd 26114a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 26124a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 26134a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 26144a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 26154a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi */ 26164a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd, int w, int h) { 261744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 261844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 261944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 262044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 262144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 26224a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi service.registerRemoteControlDisplay(rcd, w, h); 262344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 262444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); 262544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 262644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 262744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 262844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 262944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 263044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Unregisters a remote control display that was sent information by remote control clients. 263144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 263244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 263344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void unregisterRemoteControlDisplay(IRemoteControlDisplay rcd) { 263444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 263544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 263644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 263744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 263844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 263944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.unregisterRemoteControlDisplay(rcd); 264044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 264144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); 264244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 264344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 264444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 264544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 264644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 264744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Sets the artwork size a remote control display expects when receiving bitmaps. 264844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 264944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 265044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 265144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 265244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 265344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 265444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay rcd, int w, int h) { 265544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 265644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 265744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 265844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 265944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 266044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.remoteControlDisplayUsesBitmapSize(rcd, w, h); 266144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 266244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayUsesBitmapSize " + e); 266344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 266444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 2665ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh 2666b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi /** 26673261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @hide 2668c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * Controls whether a remote control display needs periodic checks of the RemoteControlClient 2669c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * playback position to verify that the estimated position has not drifted from the actual 2670c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position. By default the check is not performed. 2671c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * The IRemoteControlDisplay must have been previously registered for this to have any effect. 2672c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param rcd the IRemoteControlDisplay for which the anti-drift mechanism will be enabled 2673c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * or disabled. No effect is null. 2674c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param wantsSync if true, RemoteControlClient instances which expose their playback position 2675c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * to the framework will regularly compare the estimated playback position with the actual 2676c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position, and will update the IRemoteControlDisplay implementation whenever a drift is 2677c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * detected. 2678c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi */ 2679c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi public void remoteControlDisplayWantsPlaybackPositionSync(IRemoteControlDisplay rcd, 2680c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi boolean wantsSync) { 2681c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi if (rcd == null) { 2682c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi return; 2683c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2684c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi IAudioService service = getService(); 2685c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi try { 2686c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi service.remoteControlDisplayWantsPlaybackPositionSync(rcd, wantsSync); 2687c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } catch (RemoteException e) { 2688c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayWantsPlaybackPositionSync " + e); 2689c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2690c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2691c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi 2692c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi /** 2693a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @hide 2694a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * Register the given {@link AudioPolicy}. 2695a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * This call is synchronous and blocks until the registration process successfully completed 2696a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * or failed to complete. 26971b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi * @param policy the non-null {@link AudioPolicy} to register. 2698a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @return {@link #ERROR} if there was an error communicating with the registration service 2699a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * or if the user doesn't have the required 2700a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * {@link android.Manifest.permission#MODIFY_AUDIO_ROUTING} permission, 2701a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * {@link #SUCCESS} otherwise. 2702a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi */ 27031b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi @SystemApi 27041b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi public int registerAudioPolicy(@NonNull AudioPolicy policy) { 2705a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi if (policy == null) { 2706a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioPolicy argument"); 2707a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2708a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi IAudioService service = getService(); 2709a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi try { 27100212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi String regId = service.registerAudioPolicy(policy.getConfig(), policy.cb(), 27110212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi policy.hasFocusListener()); 27128fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi if (regId == null) { 2713a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return ERROR; 27148fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi } else { 27158fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi policy.setRegistration(regId); 2716a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 27178fdb0d4defb6ee2ca8057d3442ead36b408b6c17Jean-Michel Trivi // successful registration 2718a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } catch (RemoteException e) { 2719a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi Log.e(TAG, "Dead object in registerAudioPolicyAsync()", e); 2720a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return ERROR; 2721a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2722a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return SUCCESS; 2723a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2724a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2725a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi /** 2726a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @hide 27271b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi * @param policy the non-null {@link AudioPolicy} to unregister. 2728a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi */ 27291b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi @SystemApi 27301b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi public void unregisterAudioPolicyAsync(@NonNull AudioPolicy policy) { 2731a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi if (policy == null) { 2732a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioPolicy argument"); 2733a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2734a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi IAudioService service = getService(); 2735a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi try { 27360212be5150fb9fb3c340f3c7e51f6126372cc6f9Jean-Michel Trivi service.unregisterAudioPolicyAsync(policy.cb()); 27371b3541d5eedb332ea01066b4a78a2d06d5304044Jean-Michel Trivi policy.setRegistration(null); 2738a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } catch (RemoteException e) { 2739a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterAudioPolicyAsync()", e); 2740a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2741a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2742a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2743a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2744a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi /** 27454050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * @hide 27464050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * Reload audio settings. This method is called by Settings backup 27474050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * agent when audio settings are restored and causes the AudioService 27484050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * to read and apply restored settings. 27494050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent */ 27504050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent public void reloadAudioSettings() { 27514050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent IAudioService service = getService(); 27524050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent try { 27534050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent service.reloadAudioSettings(); 27544050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } catch (RemoteException e) { 27554050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent Log.e(TAG, "Dead object in reloadAudioSettings"+e); 27564050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 27574050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 27584050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent 27595a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du /** 27605a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * @hide 27615a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * Notifies AudioService that it is connected to an A2DP device that supports absolute volume, 27625a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * so that AudioService can send volume change events to the A2DP device, rather than handling 27635a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * them. 27645a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du */ 27655a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du public void avrcpSupportsAbsoluteVolume(String address, boolean support) { 27665a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du IAudioService service = getService(); 27675a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du try { 27685a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du service.avrcpSupportsAbsoluteVolume(address, support); 27695a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } catch (RemoteException e) { 27705a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du Log.e(TAG, "Dead object in avrcpSupportsAbsoluteVolume", e); 27715a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 27725a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 27735a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du 27749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 27759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 27769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 277730c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IBinder mICallBack = new Binder(); 27787f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 27797f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten /** 27807f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * Checks whether the phone is in silent mode, with or without vibrate. 27817f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 27827f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @return true if phone is in silent mode, with or without vibrate. 27837f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 27847f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @see #getRingerMode() 27857f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 27867f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @hide pending API Council approval 27877f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten */ 27887f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten public boolean isSilentMode() { 27897f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten int ringerMode = getRingerMode(); 27907f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten boolean silentMode = 27917f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_SILENT) || 27927f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_VIBRATE); 27937f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten return silentMode; 27947f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten } 27957f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 27968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // This section re-defines new output device constants from AudioSystem, because the AudioSystem 27978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // class is not used by other parts of the framework, which instead use definitions and methods 27988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. 27998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2800948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2801d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim * The audio device code for representing "no device." */ 2802d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim public static final int DEVICE_NONE = AudioSystem.DEVICE_NONE; 2803d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim /** @hide 2804948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for the small speaker at the front of the device used 28058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * when placing calls. Does not refer to an in-ear headphone without attached microphone, 28068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a 28078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}. 28088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; 2810948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2811948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for the built-in speaker */ 28128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; 2813948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2814948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a wired headset with attached microphone */ 28158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; 2816948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2817948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a wired headphone without attached microphone */ 28188b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; 2819948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2820948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for generic Bluetooth SCO, for voice */ 28218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; 2822948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2823948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth SCO Headset Profile (HSP) and 2824948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Hands-Free Profile (HFP), for voice 28258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28268b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 28278b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; 2828948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2829948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth SCO car audio, for voice */ 28308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 28318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; 2832948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2833948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for generic Bluetooth A2DP, for music */ 28348b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; 2835948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2836948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth A2DP headphones, for music */ 28378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 28388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; 2839948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2840948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth A2DP external speaker, for music */ 28418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 28428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; 2843948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2844948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for S/PDIF (legacy) or HDMI 2845948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Deprecated: replaced by {@link #DEVICE_OUT_HDMI} */ 28468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; 2847948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2848948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for HDMI */ 2849948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_HDMI = AudioSystem.DEVICE_OUT_HDMI; 2850948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2851948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for an analog wired headset attached via a 28528b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 28538b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28548b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; 2855948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2856948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a digital wired headset attached via a 28578b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 28588b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28598b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; 2860948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2861948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a USB audio accessory. The accessory is in USB host 286259f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB device mode 286359f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 286459f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_ACCESSORY = AudioSystem.DEVICE_OUT_USB_ACCESSORY; 2865948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2866948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a USB audio device. The device is in USB device 286759f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB host mode 286859f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 286959f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_DEVICE = AudioSystem.DEVICE_OUT_USB_DEVICE; 2870948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2871948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for projection output. 2872948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2873948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_REMOTE_SUBMIX = AudioSystem.DEVICE_OUT_REMOTE_SUBMIX; 2874948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2875948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code the telephony voice TX path. 2876948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2877948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_TELEPHONY_TX = AudioSystem.DEVICE_OUT_TELEPHONY_TX; 2878948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2879948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for an analog jack with line impedance detected. 2880948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2881948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_LINE = AudioSystem.DEVICE_OUT_LINE; 2882948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2883948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for HDMI Audio Return Channel. 2884948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2885948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_HDMI_ARC = AudioSystem.DEVICE_OUT_HDMI_ARC; 2886948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2887948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for S/PDIF digital connection. 2888948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2889948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_SPDIF = AudioSystem.DEVICE_OUT_SPDIF; 2890948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2891948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for built-in FM transmitter. 2892948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2893948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_FM = AudioSystem.DEVICE_OUT_FM; 2894948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2895948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * This is not used as a returned value from {@link #getDevicesForStream}, but could be 28968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * used in the future in a set method to select whatever default device is chosen by the 28978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * platform-specific implementation. 28988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; 29008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2901948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2902948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for default built-in microphone 2903948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2904948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BUILTIN_MIC = AudioSystem.DEVICE_IN_BUILTIN_MIC; 2905948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2906948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a Bluetooth SCO headset 2907948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2908948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BLUETOOTH_SCO_HEADSET = 2909948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_BLUETOOTH_SCO_HEADSET; 2910948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2911948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for wired headset microphone 2912948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2913948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_WIRED_HEADSET = 2914948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_WIRED_HEADSET; 2915948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2916948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for HDMI 2917948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2918948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_HDMI = 2919948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_HDMI; 2920948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2921948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for telephony voice RX path 2922948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2923948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_TELEPHONY_RX = 2924948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_TELEPHONY_RX; 2925948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2926948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for built-in microphone pointing to the back 2927948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2928948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BACK_MIC = 2929948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_BACK_MIC; 2930948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2931948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for analog from a docking station 2932948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2933948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_ANLG_DOCK_HEADSET = 2934948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_ANLG_DOCK_HEADSET; 2935948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2936948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for digital from a docking station 2937948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2938948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_DGTL_DOCK_HEADSET = 2939948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_DGTL_DOCK_HEADSET; 2940948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2941948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a USB audio accessory. The accessory is in USB host 2942948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * mode and the Android device in USB device mode 2943948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2944948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_USB_ACCESSORY = 2945948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_USB_ACCESSORY; 2946948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2947948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a USB audio device. The device is in USB device 2948948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * mode and the Android device in USB host mode 2949948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2950948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_USB_DEVICE = 2951948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_USB_DEVICE; 2952948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2953948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a FM radio tuner 2954948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2955948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_FM_TUNER = AudioSystem.DEVICE_IN_FM_TUNER; 2956948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2957948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a TV tuner 2958948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2959948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_TV_TUNER = AudioSystem.DEVICE_IN_TV_TUNER; 2960948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2961948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for an analog jack with line impedance detected 2962948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2963948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_LINE = AudioSystem.DEVICE_IN_LINE; 2964948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2965948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a S/PDIF digital connection 2966948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2967948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_SPDIF = AudioSystem.DEVICE_IN_SPDIF; 2968112c19ee8b459439c3462767199832e5394b37a8Terry Heo /** @hide 2969112c19ee8b459439c3462767199832e5394b37a8Terry Heo * The audio input device code for audio loopback 2970112c19ee8b459439c3462767199832e5394b37a8Terry Heo */ 2971112c19ee8b459439c3462767199832e5394b37a8Terry Heo public static final int DEVICE_IN_LOOPBACK = AudioSystem.DEVICE_IN_LOOPBACK; 2972948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 2973948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** 2974948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Return true if the device code corresponds to an output device. 2975948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * @hide 2976948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2977948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static boolean isOutputDevice(int device) 2978948d32748caaac5be06c991ebf00f74265a7849fEric Laurent { 2979948d32748caaac5be06c991ebf00f74265a7849fEric Laurent return (device & AudioSystem.DEVICE_BIT_IN) == 0; 2980948d32748caaac5be06c991ebf00f74265a7849fEric Laurent } 2981948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 2982948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** 2983948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Return true if the device code corresponds to an input device. 2984948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * @hide 2985948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2986948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static boolean isInputDevice(int device) 2987948d32748caaac5be06c991ebf00f74265a7849fEric Laurent { 2988948d32748caaac5be06c991ebf00f74265a7849fEric Laurent return (device & AudioSystem.DEVICE_BIT_IN) == AudioSystem.DEVICE_BIT_IN; 2989948d32748caaac5be06c991ebf00f74265a7849fEric Laurent } 2990948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 2991948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 29928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** 29938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Return the enabled devices for the specified output stream type. 29948b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 29958b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @param streamType The stream type to query. One of 29968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_VOICE_CALL}, 29978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_SYSTEM}, 29988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_RING}, 29998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_MUSIC}, 30008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_ALARM}, 30018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_NOTIFICATION}, 30028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_DTMF}. 30038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 30048b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @return The bit-mask "or" of audio output device codes for all enabled devices on this 30058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * stream. Zero or more of 30068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_EARPIECE}, 30078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_SPEAKER}, 30088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADSET}, 30098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}, 30108b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO}, 30118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, 30128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, 30138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, 30148b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, 30158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, 3016948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_HDMI}, 30178b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, 30188b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. 3019948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_USB_ACCESSORY}. 3020948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_USB_DEVICE}. 3021948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_REMOTE_SUBMIX}. 3022948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_TELEPHONY_TX}. 3023948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_LINE}. 3024948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_HDMI_ARC}. 3025948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_SPDIF}. 3026948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_FM}. 30278b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DEFAULT} is not used here. 30288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 30298b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * The implementation may support additional device codes beyond those listed, so 30308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * the application should ignore any bits which it does not recognize. 30318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Note that the information may be imprecise when the implementation 30328b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * cannot distinguish whether a particular device is enabled. 30338b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 30348b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@hide} 30358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 30368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public int getDevicesForStream(int streamType) { 30378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten switch (streamType) { 30388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_VOICE_CALL: 30398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_SYSTEM: 30408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_RING: 30418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_MUSIC: 30428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_ALARM: 30438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_NOTIFICATION: 30448b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_DTMF: 30458b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return AudioSystem.getDevicesForStream(streamType); 30468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten default: 30478b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return 0; 30488b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 30498b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 30508b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 3051b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 3052b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * Indicate wired accessory connection state change. 3053b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device type of device connected/disconnected (AudioManager.DEVICE_OUT_xxx) 3054b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state: 1 connected, 0 disconnected 3055b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param name device name 3056b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 3057b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 305810804eb2818ab59b763a37b4f6151693c2ebba7bPaul McLean public void setWiredDeviceConnectionState(int type, int state, String address, String name) { 3059b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 3060b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 30619087433753a5068819dcd3e86bdc2cce82bb8040John Spurlock service.setWiredDeviceConnectionState(type, state, address, name, 3062a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen mApplicationContext.getOpPackageName()); 3063b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 3064b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setWiredDeviceConnectionState "+e); 3065b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3066b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3067b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 3068b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 30690a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * Indicate A2DP source or sink connection state change. 3070b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device Bluetooth device connected/disconnected 3071b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state (BluetoothProfile.STATE_xxx) 30720a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * @param profile profile for the A2DP device 30730a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * (either {@link android.bluetooth.BluetoothProfile.A2DP} or 30740a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * {@link android.bluetooth.BluetoothProfile.A2DP_SINK}) 3075b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @return a delay in ms that the caller should wait before broadcasting 3076b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED intent. 3077b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 3078b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 30790a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood public int setBluetoothA2dpDeviceConnectionState(BluetoothDevice device, int state, 30800a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood int profile) { 3081b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 3082b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent int delay = 0; 3083b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 30840a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood delay = service.setBluetoothA2dpDeviceConnectionState(device, state, profile); 3085b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 3086b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setBluetoothA2dpDeviceConnectionState "+e); 3087b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3088b304ba5bc8fbc6034cf232cbbeeb3a34a5ce5b9fEric Laurent return delay; 3089b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 3090b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 3091098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey /** {@hide} */ 3092098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey public IRingtonePlayer getRingtonePlayer() { 3093098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey try { 3094098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return getService().getRingtonePlayer(); 3095098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } catch (RemoteException e) { 3096098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return null; 3097098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 3098098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 3099228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 3100228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 310162796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output sample rate 310262796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal Hz. 3103228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 3104228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_SAMPLE_RATE = 3105228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_SAMPLE_RATE"; 3106228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 3107228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 310862796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output buffer size 310962796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal PCM frames. 3110228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 3111228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_FRAMES_PER_BUFFER = 3112228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_FRAMES_PER_BUFFER"; 3113228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 3114228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 311562796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Returns the value of the property with the specified key. 3116228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @param key One of the strings corresponding to a property key: either 311762796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_SAMPLE_RATE} or 311862796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_FRAMES_PER_BUFFER} 3119228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @return A string representing the associated value for that property key, 3120228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * or null if there is no value for that key. 3121228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 3122228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public String getProperty(String key) { 3123c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten if (PROPERTY_OUTPUT_SAMPLE_RATE.equals(key)) { 3124c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputSampleRate = AudioSystem.getPrimaryOutputSamplingRate(); 3125c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputSampleRate > 0 ? Integer.toString(outputSampleRate) : null; 3126c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else if (PROPERTY_OUTPUT_FRAMES_PER_BUFFER.equals(key)) { 3127c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputFramesPerBuffer = AudioSystem.getPrimaryOutputFrameCount(); 3128c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputFramesPerBuffer > 0 ? Integer.toString(outputFramesPerBuffer) : null; 3129c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else { 3130c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten // null or unknown key 3131c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return null; 3132c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } 3133228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten } 3134228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 313561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 313661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns the estimated latency for the given stream type in milliseconds. 313761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 313861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 313961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 314061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 314161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 314261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getOutputLatency(int streamType) { 314361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return AudioSystem.getOutputLatency(streamType); 314461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 314561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 31463346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 31473346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Registers a global volume controller interface. Currently limited to SystemUI. 31483346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * 31493346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 31503346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 31513346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public void setVolumeController(IVolumeController controller) { 31523346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 31533346a802087f621c6441bc512dfcc17b07143fc6John Spurlock getService().setVolumeController(controller); 31543346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 31553346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error setting volume controller", e); 31563346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 31573346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 31583346a802087f621c6441bc512dfcc17b07143fc6John Spurlock 31593346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 316033f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * Notify audio manager about volume controller visibility changes. 316133f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * Currently limited to SystemUI. 316233f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * 316333f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * @hide 316433f4e04e32fac42f158733d6a731e50490fa9951John Spurlock */ 316533f4e04e32fac42f158733d6a731e50490fa9951John Spurlock public void notifyVolumeControllerVisible(IVolumeController controller, boolean visible) { 316633f4e04e32fac42f158733d6a731e50490fa9951John Spurlock try { 316733f4e04e32fac42f158733d6a731e50490fa9951John Spurlock getService().notifyVolumeControllerVisible(controller, visible); 316833f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } catch (RemoteException e) { 316933f4e04e32fac42f158733d6a731e50490fa9951John Spurlock Log.w(TAG, "Error notifying about volume controller visibility", e); 317033f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } 317133f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } 317233f4e04e32fac42f158733d6a731e50490fa9951John Spurlock 317333f4e04e32fac42f158733d6a731e50490fa9951John Spurlock /** 31743346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Only useful for volume controllers. 31753346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 31763346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 31773346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public boolean isStreamAffectedByRingerMode(int streamType) { 31783346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 31793346a802087f621c6441bc512dfcc17b07143fc6John Spurlock return getService().isStreamAffectedByRingerMode(streamType); 31803346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 31813346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error calling isStreamAffectedByRingerMode", e); 31823346a802087f621c6441bc512dfcc17b07143fc6John Spurlock return false; 31833346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 31843346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 31853346a802087f621c6441bc512dfcc17b07143fc6John Spurlock 31863346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 31873346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Only useful for volume controllers. 31883346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 31893346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 3190a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock public boolean isStreamAffectedByMute(int streamType) { 3191a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock try { 3192a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock return getService().isStreamAffectedByMute(streamType); 3193a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock } catch (RemoteException e) { 3194a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock Log.w(TAG, "Error calling isStreamAffectedByMute", e); 3195a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock return false; 3196a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock } 3197a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock } 3198a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock 3199a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock /** 3200a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock * Only useful for volume controllers. 3201a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock * @hide 3202a9dfbe8b122d746cf8841fe1b13d31e7e0fc9c52John Spurlock */ 32033346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public void disableSafeMediaVolume() { 32043346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 3205a80ac05f85962949d5072831200d86a7023575fbMarco Nelissen getService().disableSafeMediaVolume(mApplicationContext.getOpPackageName()); 32063346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 32073346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error disabling safe media volume", e); 32083346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 32093346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 3210a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3211a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3212661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * Only useful for volume controllers. 3213661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * @hide 3214661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock */ 3215661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public void setRingerModeInternal(int ringerMode) { 3216661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock try { 3217926ebb860a8b5cbdec17f07404272be7c484fd79Marco Nelissen getService().setRingerModeInternal(ringerMode, mApplicationContext.getOpPackageName()); 3218661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } catch (RemoteException e) { 3219661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock Log.w(TAG, "Error calling setRingerModeInternal", e); 3220661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3221661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3222661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 3223661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** 3224661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * Only useful for volume controllers. 3225661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock * @hide 3226661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock */ 3227661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock public int getRingerModeInternal() { 3228661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock try { 3229661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return getService().getRingerModeInternal(); 3230661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } catch (RemoteException e) { 3231661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock Log.w(TAG, "Error calling getRingerModeInternal", e); 3232661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock return RINGER_MODE_NORMAL; 3233661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3234661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock } 3235661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock 3236661f2cf45860d2e10924e6b69966a9afe255f28bJohn Spurlock /** 3237a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock * Only useful for volume controllers. 3238a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock * @hide 3239a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock */ 3240a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock public void setVolumePolicy(VolumePolicy policy) { 3241a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock try { 3242a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock getService().setVolumePolicy(policy); 3243a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock } catch (RemoteException e) { 3244a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock Log.w(TAG, "Error calling setVolumePolicy", e); 3245a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock } 3246a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock } 3247a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock 3248a48d779dad4c48aa2f97ad021ae3a5649c058312John Spurlock /** 324941d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * Set Hdmi Cec system audio mode. 325041d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * 325141d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @param on whether to be on system audio mode 32526f34f5ab8ab1b1db7887e5405d8b0031e105ab05Jungshik Jang * @return output device type. 0 (DEVICE_NONE) if failed to set device. 325341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @hide 325441d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang */ 325512307ca810e8100981b2b60e3f2c6a7e451b9774Jungshik Jang public int setHdmiSystemAudioSupported(boolean on) { 325641d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang try { 325712307ca810e8100981b2b60e3f2c6a7e451b9774Jungshik Jang return getService().setHdmiSystemAudioSupported(on); 325841d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } catch (RemoteException e) { 325941d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang Log.w(TAG, "Error setting system audio mode", e); 32606f34f5ab8ab1b1db7887e5405d8b0031e105ab05Jungshik Jang return AudioSystem.DEVICE_NONE; 326141d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } 326241d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } 326341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang 326441d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang /** 3265e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo * Returns true if Hdmi Cec system audio mode is supported. 3266e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo * 3267e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo * @hide 3268e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo */ 3269e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo @SystemApi 3270e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo public boolean isHdmiSystemAudioSupported() { 3271e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo try { 3272e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo return getService().isHdmiSystemAudioSupported(); 3273e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo } catch (RemoteException e) { 3274e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo Log.w(TAG, "Error querying system audio mode", e); 3275e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo return false; 3276e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo } 3277e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo } 3278e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo 3279e7d6d97f0d95b9e8982b0d4d9f5e8ce688291940Terry Heo /** 3280a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Return codes for listAudioPorts(), createAudioPatch() ... 3281a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3282a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3283a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3284a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 3285a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3286a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int SUCCESS = AudioSystem.SUCCESS; 32878a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi /** 32888a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * A default error code. 3289a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3290a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR = AudioSystem.ERROR; 3291a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3292a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 3293a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3294a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_BAD_VALUE = AudioSystem.BAD_VALUE; 3295a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3296a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3297a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_INVALID_OPERATION = AudioSystem.INVALID_OPERATION; 3298a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3299a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3300a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_PERMISSION_DENIED = AudioSystem.PERMISSION_DENIED; 3301a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3302a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3303a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_NO_INIT = AudioSystem.NO_INIT; 3304ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent /** 3305ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * An error code indicating that the object reporting it is no longer valid and needs to 3306ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * be recreated. 3307a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3308a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_DEAD_OBJECT = AudioSystem.DEAD_OBJECT; 3309a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3310a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3311a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Returns a list of descriptors for all audio ports managed by the audio framework. 3312a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Audio ports are nodes in the audio framework or audio hardware that can be configured 3313a198a29250acb7c3e918f1566727190966bb336fEric Laurent * or connected and disconnected with createAudioPatch() or releaseAudioPatch(). 3314a198a29250acb7c3e918f1566727190966bb336fEric Laurent * See AudioPort for a list of attributes of each audio port. 3315a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param ports An AudioPort ArrayList where the list will be returned. 3316a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3317a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3318a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int listAudioPorts(ArrayList<AudioPort> ports) { 3319b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return updateAudioPortCache(ports, null); 3320a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3321a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3322a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3323a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Specialized version of listAudioPorts() listing only audio devices (AudioDevicePort) 3324a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @see listAudioPorts(ArrayList<AudioPort>) 3325a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3326a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3327ceb47aae5a045856ad13a5534a4d96f9b36c9a65Paul McLean public int listAudioDevicePorts(ArrayList<AudioDevicePort> devices) { 3328b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPort> ports = new ArrayList<AudioPort>(); 3329b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int status = updateAudioPortCache(ports, null); 3330b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status == SUCCESS) { 3331b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent devices.clear(); 3332b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int i = 0; i < ports.size(); i++) { 3333b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports.get(i) instanceof AudioDevicePort) { 3334ceb47aae5a045856ad13a5534a4d96f9b36c9a65Paul McLean devices.add((AudioDevicePort)ports.get(i)); 3335b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3336b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3337b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3338b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3339a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3340a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3341a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3342a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Create a connection between two or more devices. The framework will reject the request if 3343a198a29250acb7c3e918f1566727190966bb336fEric Laurent * device types are not compatible or the implementation does not support the requested 3344a198a29250acb7c3e918f1566727190966bb336fEric Laurent * configuration. 3345a198a29250acb7c3e918f1566727190966bb336fEric Laurent * NOTE: current implementation is limited to one source and one sink per patch. 3346a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patch AudioPatch array where the newly created patch will be returned. 3347a198a29250acb7c3e918f1566727190966bb336fEric Laurent * As input, if patch[0] is not null, the specified patch will be replaced by the 3348a198a29250acb7c3e918f1566727190966bb336fEric Laurent * new patch created. This avoids calling releaseAudioPatch() when modifying a 3349a198a29250acb7c3e918f1566727190966bb336fEric Laurent * patch and allows the implementation to optimize transitions. 3350a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param sources List of source audio ports. All must be AudioPort.ROLE_SOURCE. 3351a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param sinks List of sink audio ports. All must be AudioPort.ROLE_SINK. 3352a198a29250acb7c3e918f1566727190966bb336fEric Laurent * 3353a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @return - {@link #SUCCESS} if connection is successful. 3354a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_BAD_VALUE} if incompatible device types are passed. 3355a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_INVALID_OPERATION} if the requested connection is not supported. 3356a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_PERMISSION_DENIED} if the client does not have permission to create 3357a198a29250acb7c3e918f1566727190966bb336fEric Laurent * a patch. 3358a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_DEAD_OBJECT} if the server process is dead 3359a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR} if patch cannot be connected for any other reason. 3360a198a29250acb7c3e918f1566727190966bb336fEric Laurent * 3361a198a29250acb7c3e918f1566727190966bb336fEric Laurent * patch[0] contains the newly created patch 3362a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3363a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3364a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int createAudioPatch(AudioPatch[] patch, 3365a198a29250acb7c3e918f1566727190966bb336fEric Laurent AudioPortConfig[] sources, 3366a198a29250acb7c3e918f1566727190966bb336fEric Laurent AudioPortConfig[] sinks) { 3367b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return AudioSystem.createAudioPatch(patch, sources, sinks); 3368a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3369a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3370a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3371a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Releases an existing audio patch connection. 3372a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patch The audio patch to disconnect. 3373a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @return - {@link #SUCCESS} if disconnection is successful. 3374a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_BAD_VALUE} if the specified patch does not exist. 3375a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_PERMISSION_DENIED} if the client does not have permission to release 3376a198a29250acb7c3e918f1566727190966bb336fEric Laurent * a patch. 3377a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_DEAD_OBJECT} if the server process is dead 3378a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR} if patch cannot be released for any other reason. 3379a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3380a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3381a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int releaseAudioPatch(AudioPatch patch) { 3382b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return AudioSystem.releaseAudioPatch(patch); 3383a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3384a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3385a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3386a198a29250acb7c3e918f1566727190966bb336fEric Laurent * List all existing connections between audio ports. 3387a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patches An AudioPatch array where the list will be returned. 3388a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3389a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3390a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int listAudioPatches(ArrayList<AudioPatch> patches) { 3391b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return updateAudioPortCache(null, patches); 3392a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3393a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3394a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3395a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Set the gain on the specified AudioPort. The AudioGainConfig config is build by 3396a198a29250acb7c3e918f1566727190966bb336fEric Laurent * AudioGain.buildConfig() 3397a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3398a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3399a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int setAudioPortGain(AudioPort port, AudioGainConfig gain) { 34003a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent if (port == null || gain == null) { 34013a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent return ERROR_BAD_VALUE; 34023a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent } 34033a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent AudioPortConfig activeConfig = port.activeConfig(); 34043a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent AudioPortConfig config = new AudioPortConfig(port, activeConfig.samplingRate(), 34053a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent activeConfig.channelMask(), activeConfig.format(), gain); 34063a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent config.mConfigMask = AudioPortConfig.GAIN; 34073a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent return AudioSystem.setAudioPortConfig(config); 3408a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3409a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3410a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3411a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Listener registered by client to be notified upon new audio port connections, 3412a198a29250acb7c3e918f1566727190966bb336fEric Laurent * disconnections or attributes update. 3413a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3414a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3415a198a29250acb7c3e918f1566727190966bb336fEric Laurent public interface OnAudioPortUpdateListener { 3416a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3417a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called upon audio port list update. 3418a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param portList the updated list of audio ports 3419a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3420fdaed9dcb63171379fd7c5a6208014bac505dbc6Eric Laurent public void onAudioPortListUpdate(AudioPort[] portList); 3421a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3422a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3423a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called upon audio patch list update. 3424a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patchList the updated list of audio patches 3425a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3426fdaed9dcb63171379fd7c5a6208014bac505dbc6Eric Laurent public void onAudioPatchListUpdate(AudioPatch[] patchList); 3427a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3428a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3429a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called when the mediaserver dies 3430a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3431fdaed9dcb63171379fd7c5a6208014bac505dbc6Eric Laurent public void onServiceDied(); 3432a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3433a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3434a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3435700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent * Register an audio port list update listener. 3436a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3437a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3438a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void registerAudioPortUpdateListener(OnAudioPortUpdateListener l) { 3439f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortEventHandler.registerListener(l); 3440a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3441a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3442a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3443700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent * Unregister an audio port list update listener. 3444a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3445a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3446a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void unregisterAudioPortUpdateListener(OnAudioPortUpdateListener l) { 3447f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortEventHandler.unregisterListener(l); 3448a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3449b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3450b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // 3451b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // AudioPort implementation 3452b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // 3453b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3454b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent static final int AUDIOPORT_GENERATION_INIT = 0; 3455f076db407029e734703d8676f806bea94393e824Eric Laurent static Integer sAudioPortGeneration = new Integer(AUDIOPORT_GENERATION_INIT); 3456f076db407029e734703d8676f806bea94393e824Eric Laurent static ArrayList<AudioPort> sAudioPortsCached = new ArrayList<AudioPort>(); 3457f076db407029e734703d8676f806bea94393e824Eric Laurent static ArrayList<AudioPatch> sAudioPatchesCached = new ArrayList<AudioPatch>(); 3458b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3459f076db407029e734703d8676f806bea94393e824Eric Laurent static int resetAudioPortGeneration() { 3460b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int generation; 3461f076db407029e734703d8676f806bea94393e824Eric Laurent synchronized (sAudioPortGeneration) { 3462f076db407029e734703d8676f806bea94393e824Eric Laurent generation = sAudioPortGeneration; 3463f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortGeneration = AUDIOPORT_GENERATION_INIT; 3464b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3465b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return generation; 3466b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3467b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3468f076db407029e734703d8676f806bea94393e824Eric Laurent static int updateAudioPortCache(ArrayList<AudioPort> ports, ArrayList<AudioPatch> patches) { 3469f076db407029e734703d8676f806bea94393e824Eric Laurent synchronized (sAudioPortGeneration) { 3470b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3471f076db407029e734703d8676f806bea94393e824Eric Laurent if (sAudioPortGeneration == AUDIOPORT_GENERATION_INIT) { 3472b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int[] patchGeneration = new int[1]; 3473b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int[] portGeneration = new int[1]; 3474b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int status; 3475b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPort> newPorts = new ArrayList<AudioPort>(); 3476b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPatch> newPatches = new ArrayList<AudioPatch>(); 3477b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3478b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent do { 3479b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPorts.clear(); 3480b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent status = AudioSystem.listAudioPorts(newPorts, portGeneration); 3481b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status != SUCCESS) { 3482b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim Log.w(TAG, "updateAudioPortCache: listAudioPorts failed"); 3483b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3484b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3485b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPatches.clear(); 3486b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent status = AudioSystem.listAudioPatches(newPatches, patchGeneration); 3487b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status != SUCCESS) { 3488b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim Log.w(TAG, "updateAudioPortCache: listAudioPatches failed"); 3489b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3490b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3491b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } while (patchGeneration[0] != portGeneration[0]); 3492b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3493b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int i = 0; i < newPatches.size(); i++) { 3494b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int j = 0; j < newPatches.get(i).sources().length; j++) { 3495b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent AudioPortConfig portCfg = updatePortConfig(newPatches.get(i).sources()[j], 3496b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent newPorts); 3497b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPatches.get(i).sources()[j] = portCfg; 3498b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3499b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int j = 0; j < newPatches.get(i).sinks().length; j++) { 3500b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent AudioPortConfig portCfg = updatePortConfig(newPatches.get(i).sinks()[j], 3501b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent newPorts); 3502b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim newPatches.get(i).sinks()[j] = portCfg; 3503b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3504b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3505b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim for (Iterator<AudioPatch> i = newPatches.iterator(); i.hasNext(); ) { 3506b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim AudioPatch newPatch = i.next(); 3507b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim boolean hasInvalidPort = false; 3508b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim for (AudioPortConfig portCfg : newPatch.sources()) { 3509b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (portCfg == null) { 3510b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim hasInvalidPort = true; 3511b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim break; 3512b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3513b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3514b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim for (AudioPortConfig portCfg : newPatch.sinks()) { 3515b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim if (portCfg == null) { 3516b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim hasInvalidPort = true; 3517b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim break; 3518b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3519b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim } 3520b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim if (hasInvalidPort) { 3521b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim // Temporarily remove patches with invalid ports. One who created the patch 3522b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim // is responsible for dealing with the port change. 3523b561ccedd89f92b249c06522e960b135a02107d8Wonsik Kim i.remove(); 3524b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3525b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3526b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3527f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortsCached = newPorts; 3528f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPatchesCached = newPatches; 3529f076db407029e734703d8676f806bea94393e824Eric Laurent sAudioPortGeneration = portGeneration[0]; 3530b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3531b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports != null) { 3532b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ports.clear(); 3533f076db407029e734703d8676f806bea94393e824Eric Laurent ports.addAll(sAudioPortsCached); 3534b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3535b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (patches != null) { 3536b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent patches.clear(); 3537f076db407029e734703d8676f806bea94393e824Eric Laurent patches.addAll(sAudioPatchesCached); 3538b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3539b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3540b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return SUCCESS; 3541b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3542b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3543f076db407029e734703d8676f806bea94393e824Eric Laurent static AudioPortConfig updatePortConfig(AudioPortConfig portCfg, ArrayList<AudioPort> ports) { 3544b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioPort port = portCfg.port(); 3545b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int k; 3546b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (k = 0; k < ports.size(); k++) { 3547b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // compare handles because the port returned by JNI is not of the correct 3548b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // subclass 3549b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports.get(k).handle().equals(port.handle())) { 3550b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent port = ports.get(k); 3551b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent break; 3552b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3553b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3554b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (k == ports.size()) { 3555b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // this hould never happen 3556b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent Log.e(TAG, "updatePortConfig port not found for handle: "+port.handle().id()); 3557b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return null; 3558b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3559b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioGainConfig gainCfg = portCfg.gain(); 3560b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (gainCfg != null) { 3561b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioGain gain = port.gain(gainCfg.index()); 3562b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg = gain.buildConfig(gainCfg.mode(), 3563b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.channelMask(), 3564b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.values(), 3565b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.rampDurationMs()); 3566b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3567b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return port.buildConfig(portCfg.samplingRate(), 3568b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent portCfg.channelMask(), 3569b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent portCfg.format(), 3570b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg); 3571b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 35729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 3573