AudioManager.java revision b214efbb9170a9f6a4991684a63ca59680074cc7
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; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant.SdkConstantType; 22f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Triviimport android.app.PendingIntent; 23b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurentimport android.bluetooth.BluetoothDevice; 24d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.content.ComponentName; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 26f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Triviimport android.content.Intent; 27f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Triviimport android.media.RemoteController.OnClientUpdateListener; 28a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Triviimport android.media.audiopolicy.AudioPolicy; 29a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Triviimport android.media.audiopolicy.AudioPolicyConfig; 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; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 4086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.os.SystemClock; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.ServiceManager; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.provider.Settings; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 44d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.view.KeyEvent; 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 46d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport java.util.HashMap; 47a198a29250acb7c3e918f1566727190966bb336fEric Laurentimport java.util.ArrayList; 48d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 49700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioManager provides access to volume and ringer mode control. 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use <code>Context.getSystemService(Context.AUDIO_SERVICE)</code> to get 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an instance of this class. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioManager { 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Context mContext; 5986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato private long mVolumeKeyUpTime; 60cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood private final boolean mUseMasterVolume; 61b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate private final boolean mUseVolumeKeySounds; 62ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent private final boolean mUseFixedVolume; 6379f7ec70ebd5758ce54fd5b6fcd60fd27457cba6Dianne Hackborn private final Binder mToken = new Binder(); 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String TAG = "AudioManager"; 65700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent AudioPortEventHandler mAudioPortEventHandler; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent, a hint for applications that audio is about to become 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'noisy' due to a change in audio outputs. For example, this intent may 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent when a wired headset is unplugged, or when an A2DP audio 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sink is disconnected, and the audio system is about to automatically 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch audio route to the speaker. Applications that are controlling 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * audio streams may consider pausing, reducing volume or some other action 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on receipt of this intent so as not to surprise the user with audio 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the speaker. 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sticky broadcast intent action indicating that the ringer mode has 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the new ringer mode. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_RINGER_MODE 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new ringer mode. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_CHANGED_ACTION 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_NORMAL 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_SILENT 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_VIBRATE 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the vibrate setting has 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the vibrate type and its new setting. 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_SETTING 105cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 106cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1090dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String VIBRATE_SETTING_CHANGED_ACTION = 1100dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.VIBRATE_SETTING_CHANGED"; 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Broadcast intent when the volume for a particular stream type changes. 1143114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Includes the stream, the new volume and previous volumes. 1153114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Notes: 1163114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - for internal platform use only, do not make public, 1173114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - never used for "remote" volume changes 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_TYPE 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_VALUE 1219ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @see #EXTRA_PREV_VOLUME_STREAM_VALUE 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1270dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master volume changes. 1280dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the new volume 1290dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1300dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_VALUE 1310dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_PREV_MASTER_VOLUME_VALUE 1320dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1330dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1340dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_VOLUME_CHANGED_ACTION = 1350dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_VOLUME_CHANGED_ACTION"; 1360dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1370dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1380dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master mute state changes. 1390dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the the new volume 1400dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1410dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_MUTED 1420dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1430dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1440dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_MUTE_CHANGED_ACTION = 1450dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_MUTE_CHANGED_ACTION"; 1460dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1470dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new vibrate setting for a particular type. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ON 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_OFF 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ONLY_SILENT 155cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 156cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The vibrate type whose setting has changed. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_NOTIFICATION 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_RINGER 166cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 167cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The stream type for the volume changed intent. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The volume associated with the stream for the volume changed intent. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_VALUE = 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.media.EXTRA_VOLUME_STREAM_VALUE"; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1829ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent /** 1839ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @hide The previous volume associated with the stream for the volume changed intent. 1849ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent */ 1859ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = 1869ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; 1870dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1880dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1890dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume value for the master volume changed intent. 1900dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is integer between 0 and 100 inclusive. 1910dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1920dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_VALUE = 1930dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_VALUE"; 1940dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1950dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1960dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The previous master volume value for the master volume changed intent. 1970dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is integer between 0 and 100 inclusive. 1980dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1990dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_PREV_MASTER_VOLUME_VALUE = 2000dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_PREV_MASTER_VOLUME_VALUE"; 2010dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 2020dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 2030dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume mute state for the master mute changed intent. 2040dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is boolean 2050dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 2060dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_MUTED = 2070dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_MUTED"; 2089ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for phone calls */ 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for system sounds */ 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for the phone ring */ 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = AudioSystem.STREAM_RING; 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for music playback */ 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for alarms */ 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for notifications */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide The audio stream for phone calls when connected to bluetooth */ 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; 223a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 224a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; 225a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** The audio stream for DTMF Tones */ 226a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; 227a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for text to speech (TTS) */ 228a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = AudioSystem.STREAM_TTS; 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Number of audio streams */ 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use AudioSystem.getNumStreamTypes() instead 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 233a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide Default volume index values for audio streams */ 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int[] DEFAULT_STREAM_VOLUME = new int[] { 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4, // STREAM_VOICE_CALL 2399d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_RING 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11, // STREAM_MUSIC 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6, // STREAM_ALARM 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_NOTIFICATION 244a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 7, // STREAM_BLUETOOTH_SCO 2459d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM_ENFORCED 246a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11, // STREAM_DTMF 247a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11 // STREAM_TTS 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Increase the ringer volume. 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_RAISE = 1; 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decrease the ringer volume. 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_LOWER = -1; 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maintain the previous ringer volume. This may be useful when needing to 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * show the volume toast without actually modifying the volume. 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_SAME = 0; 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Flags should be powers of 2! 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Show a toast containing the current volume. 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_SHOW_UI = 1 << 0; 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to include ringer modes as possible options when changing volume. 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if true and volume level is 0 and the volume is adjusted 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate mode. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * By default this is on for the ring stream. If this flag is included, 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this behavior will be present regardless of the stream type being 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affected by the ringer mode. 296105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to play a sound when changing the volume. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is given to {@link #adjustVolume(int, int)} or 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in some cases (for example, the decided stream type is not 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_RING}, or the volume is being adjusted 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * downward). 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_PLAY_SOUND = 1 << 2; 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any sounds/vibrate that may be in the queue, or are playing (related to 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changing volume). 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to vibrate if going into the vibrate ringer mode. 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_VIBRATE = 1 << 4; 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3294bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * Indicates to VolumePanel that the volume slider should be disabled as user 3304bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * cannot change the stream volume 3314bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * @hide 3324bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent */ 3334bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent public static final int FLAG_FIXED_VOLUME = 1 << 5; 3344bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent 3354bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent /** 336c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * Indicates the volume set/adjust call is for Bluetooth absolute volume 337c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * @hide 338c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie */ 339c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie public static final int FLAG_BLUETOOTH_ABS_VOLUME = 1 << 6; 340c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie 341c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie /** 342a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock * Adjusting the volume was prevented due to silent mode, display a hint in the UI. 343a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock * @hide 344a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock */ 345a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock public static final int FLAG_SHOW_SILENT_HINT = 1 << 7; 346a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock 347a11b4affcad3d255aa723a89b768ea222506f2e8John Spurlock /** 34841d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * Indicates the volume call is for Hdmi Cec system audio volume 34941d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @hide 35041d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang */ 35141d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang public static final int FLAG_HDMI_SYSTEM_AUDIO_VOLUME = 1 << 8; 35241d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang 35341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang /** 3543c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik * Indicates that this should only be handled if media is actively playing. 3553c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik * @hide 3563c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik */ 3573c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik public static final int FLAG_ACTIVE_MEDIA_ONLY = 1 << 9; 3583c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik 3593c45c29109d23981d8b707c809b3b43ce2e20fc3RoboErik /** 360351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock * Like FLAG_SHOW_UI, but only dialog warnings and confirmations, no sliders. 361351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock * @hide 362351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock */ 363351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock public static final int FLAG_SHOW_UI_WARNINGS = 1 << 10; 364351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock 365351346092acdfbfcc1d9ebf98d539d2a1196c5e8John Spurlock /** 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will not vibrate. (This overrides the 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate setting.) 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_SILENT = 0; 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will vibrate. (This will cause the 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone ringer to always vibrate, but the notification vibrate to only 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate if set.) 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_VIBRATE = 1; 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that may be audible and may vibrate. It will be audible if 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the volume before changing out of this mode was audible. It will vibrate 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the vibrate setting is on. 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_NORMAL = 2; 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 39472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent // maximum valid ringer mode value. Values must start from 0 and be contiguous. 39572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent private static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; 39672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to the ringer. 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 403cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 404cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_RINGER = 0; 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to notifications. 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 414cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 415cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_NOTIFICATION = 1; 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to never vibrate. 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 424cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 425cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_OFF = 0; 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to vibrate when possible. 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 434cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 435cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ON = 1; 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to only vibrate when in the vibrate ringer 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 445cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 446cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ONLY_SILENT = 2; 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Suggests using the default stream type. This may not be used in all 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * places a stream type is needed. 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService sService; 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioManager(Context context) { 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContext = context; 463cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood mUseMasterVolume = mContext.getResources().getBoolean( 464cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood com.android.internal.R.bool.config_useMasterVolume); 465b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate mUseVolumeKeySounds = mContext.getResources().getBoolean( 466b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate com.android.internal.R.bool.config_useVolumeKeySounds); 467700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent mAudioPortEventHandler = new AudioPortEventHandler(this); 468ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent mUseFixedVolume = mContext.getResources().getBoolean( 469ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent com.android.internal.R.bool.config_useFixedVolume); 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService getService() 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sService != null) { 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sService = IAudioService.Stub.asInterface(b); 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 483a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Sends a simulated key event for a media button. 484a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * To simulate a key press, you must first send a KeyEvent built with a 485a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#ACTION_DOWN} action, then another event with the {@link KeyEvent#ACTION_UP} 486a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * action. 487a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * <p>The key event will be sent to the current media key event consumer which registered with 488a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link AudioManager#registerMediaButtonEventReceiver(PendingIntent)}. 489a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param keyEvent a {@link KeyEvent} instance whose key code is one of 490a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MUTE}, 491a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_HEADSETHOOK}, 492a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY}, 493a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PAUSE}, 494a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY_PAUSE}, 495a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_STOP}, 496a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_NEXT}, 497a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PREVIOUS}, 498a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_REWIND}, 499a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_RECORD}, 500a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_FAST_FORWARD}, 501a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_CLOSE}, 502a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_EJECT}, 503a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * or {@link KeyEvent#KEYCODE_MEDIA_AUDIO_TRACK}. 504a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi */ 505a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi public void dispatchMediaKeyEvent(KeyEvent keyEvent) { 506430fc48865e5a371b08f180390946b96d73848feRoboErik MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mContext); 507430fc48865e5a371b08f180390946b96d73848feRoboErik helper.sendMediaButtonEvent(keyEvent, false); 5087ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 5097ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 5107ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 5117ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 51286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 513ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void preDispatchKeyEvent(KeyEvent event, int stream) { 51486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 51586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * If the user hits another key within the play sound delay, then 51686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * cancel the sound 51786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 518ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 51986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP 52086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE 5213346a802087f621c6441bc512dfcc17b07143fc6John Spurlock && mVolumeKeyUpTime + AudioService.PLAY_SOUND_DELAY 52286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato > SystemClock.uptimeMillis()) { 52386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 52486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * The user has hit another key during the delay (e.g., 300ms) 52586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * since the last volume key up, so cancel any sounds. 52686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 527cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 5288dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood adjustMasterVolume(ADJUST_SAME, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 529cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 530cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume(ADJUST_SAME, 53186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 532cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 53386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 53486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 53586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 53686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 53786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 53886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 539ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyDown(KeyEvent event, int stream) { 540ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 54186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 54286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 54386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 54486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 54586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Adjust the volume in on key down since it is more 54686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * responsive to the user. 54786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 548402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent int flags = FLAG_SHOW_UI | FLAG_VIBRATE; 549b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate 550cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 551cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustMasterVolume( 552cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 553cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 5548dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood : ADJUST_LOWER, 5558dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood flags); 556cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 557cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume( 558cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 559cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 560cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood : ADJUST_LOWER, 561cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood stream, 562cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood flags); 563402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 56486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 56586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 566ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (event.getRepeatCount() == 0) { 567ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (mUseMasterVolume) { 568ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood setMasterMute(!isMasterMute()); 569ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } else { 570ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood // TODO: Actually handle MUTE. 571ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 572ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 57386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 57486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 57586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 57686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 57786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 57886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 57986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 580ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyUp(KeyEvent event, int stream) { 581ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 58286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 58386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 58486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 58586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 58686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Play a sound. This is done on key up since we don't want the 58786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * sound to play when a user holds down volume down to mute. 58886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 589b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseVolumeKeySounds) { 590b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseMasterVolume) { 591c4b78d206ffcdccac01e3436a4a3462bef9672edChristopher Tate adjustMasterVolume(ADJUST_SAME, FLAG_PLAY_SOUND); 592b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate } else { 593b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate int flags = FLAG_PLAY_SOUND; 594b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate adjustSuggestedStreamVolume( 595b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate ADJUST_SAME, 596b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate stream, 597b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate flags); 598cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 599402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 60086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato mVolumeKeyUpTime = SystemClock.uptimeMillis(); 60186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 60286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 60386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 60486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 60586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 606ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * Indicates if the device implements a fixed volume policy. 607ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>Some devices may not have volume control and may operate at a fixed volume, 608ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * and may not enable muting or changing the volume of audio streams. 609ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * This method will return true on such devices. 610ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>The following APIs have no effect when volume is fixed: 611ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <ul> 612ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustVolume(int, int)} 613ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustSuggestedStreamVolume(int, int, int)} 614ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #adjustStreamVolume(int, int, int)} 615ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamVolume(int, int, int)} 616ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setRingerMode(int)} 617ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamSolo(int, boolean)} 618ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <li> {@link #setStreamMute(int, boolean)} 619ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * </ul> 620ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent */ 621ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent public boolean isVolumeFixed() { 622ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent return mUseFixedVolume; 623ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent } 624ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent 625ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent /** 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of a particular stream by one step in a direction. 627fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 628fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 629fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_ALARM} 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustStreamVolume(int streamType, int direction, int flags) { 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6444767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 64595d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(direction, flags, mContext.getOpPackageName()); 6464767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 647ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn service.adjustStreamVolume(streamType, direction, flags, 64895d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName()); 6494767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustStreamVolume", e); 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream. For example, if a call is 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active, it will have the highest priority regardless of if the in-call 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen is showing. Another example, if music is playing in the background 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and a call is not active, the music stream will be adjusted. 660fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 661fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 662fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 663ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 664ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustSuggestedStreamVolume(int, int, int) 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 672ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustVolume(int direction, int flags) { 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6774767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 67895d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(direction, flags, mContext.getOpPackageName()); 6794767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 680430fc48865e5a371b08f180390946b96d73848feRoboErik MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mContext); 681430fc48865e5a371b08f180390946b96d73848feRoboErik helper.sendAdjustVolumeBy(USE_DEFAULT_STREAM_TYPE, direction, flags); 6824767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustVolume", e); 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream, or the given fallback 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stream. 691fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 692fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 693fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 695ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 696ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param suggestedStreamType The stream type that will be used if there 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is valid here. 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 706ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7114767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 71295d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(direction, flags, mContext.getOpPackageName()); 7134767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 714430fc48865e5a371b08f180390946b96d73848feRoboErik MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mContext); 715430fc48865e5a371b08f180390946b96d73848feRoboErik helper.sendAdjustVolumeBy(suggestedStreamType, direction, flags); 7164767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 718cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustSuggestedStreamVolume", e); 719cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 720cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 721cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood 722cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood /** 723cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * Adjusts the master volume for the device's audio amplifier. 724cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * <p> 725cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * 7266c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang * @param steps The number of volume steps to adjust. A positive 7276c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang * value will raise the volume. 7288dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood * @param flags One or more flags. 729e3f5979307fa52898459d9d09ee11bc1d65a4f7fJason Simmons * @hide 730cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood */ 7316c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang public void adjustMasterVolume(int steps, int flags) { 732cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood IAudioService service = getService(); 733cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood try { 73495d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(steps, flags, mContext.getOpPackageName()); 735cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } catch (RemoteException e) { 736cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustMasterVolume", e); 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current ringtone mode. 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRingerMode() { 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getRingerMode(); 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getRingerMode", e); 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return RINGER_MODE_NORMAL; 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 75872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * Checks valid ringer mode values. 75972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 76072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @return true if the ringer mode indicated is valid, false otherwise. 76172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 76272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @see #setRingerMode(int) 76372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @hide 76472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent */ 76572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent public static boolean isValidRingerMode(int ringerMode) { 76672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { 76772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return false; 76872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 76972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return true; 77072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 77172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 77272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent /** 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum volume index for a particular stream. 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose maximum volume index is returned. 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The maximum valid volume index for the stream. 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamMaxVolume(int streamType) { 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7824767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 7834767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getMasterMaxVolume(); 7844767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 7854767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getStreamMaxVolume(streamType); 7864767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamMaxVolume", e); 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current volume index for a particular stream. 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose volume index is returned. 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current volume index for the stream. 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamVolume(int streamType) { 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8044767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 8054767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getMasterVolume(); 8064767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 8074767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getStreamVolume(streamType); 8084767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamVolume", e); 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 81625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * Get last audible volume before stream was muted. 81725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 81825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 81925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 82025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public int getLastAudibleStreamVolume(int streamType) { 82125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 82225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 8234767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 824ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.getLastAudibleMasterVolume(); 8254767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 8264767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getLastAudibleStreamVolume(streamType); 8274767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 82825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 82925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); 83025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return 0; 83125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 83225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 83325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 83425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 8356d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * Get the stream type whose volume is driving the UI sounds volume. 8366d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * UI sounds are screen lock/unlock, camera shutter, key clicks... 8376d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * @hide 8386d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent */ 8396d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent public int getMasterStreamType() { 8406d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent IAudioService service = getService(); 8416d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent try { 8426d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return service.getMasterStreamType(); 8436d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } catch (RemoteException e) { 8446d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent Log.e(TAG, "Dead object in getMasterStreamType", e); 8456d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return STREAM_RING; 8466d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 8476d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 8486d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent 8496d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent /** 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the ringer mode. 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Silent mode will mute the volume and will not vibrate. Vibrate mode will 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mute the volume and vibrate. Normal mode will be audible and may vibrate 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * according to user settings. 855ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 856ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 860ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRingerMode(int ringerMode) { 86372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (!isValidRingerMode(ringerMode)) { 86472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return; 86572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setRingerMode(ringerMode); 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setRingerMode", e); 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the volume index for a particular stream. 876ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 877ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream whose volume index should be set. 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The volume index to set. See 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getStreamMaxVolume(int)} for the largest valid value. 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 884ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamVolume(int streamType, int index, int flags) { 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8894767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 89095d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.setMasterVolume(index, flags, mContext.getOpPackageName()); 8914767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 89295d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.setStreamVolume(streamType, index, flags, mContext.getOpPackageName()); 8934767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamVolume", e); 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 900fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Returns the maximum volume index for master volume. 901fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 902fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 903fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 904fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getMasterMaxVolume() { 905fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 906fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 907fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getMasterMaxVolume(); 908fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 909fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getMasterMaxVolume", e); 910fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 911fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 912fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 913fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 914fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 915fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Returns the current volume index for master volume. 916fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 917fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @return The current volume index for master volume. 918fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 919fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 920fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getMasterVolume() { 921fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 922fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 923fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getMasterVolume(); 924fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 925fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getMasterVolume", e); 926fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 927fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 928fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 929fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 930fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 931fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Get last audible volume before master volume was muted. 932fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 933fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 934fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 935fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getLastAudibleMasterVolume() { 936fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 937fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 938fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getLastAudibleMasterVolume(); 939fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 940fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getLastAudibleMasterVolume", e); 941fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 942fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 943fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 944fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 945fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 946fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Sets the volume index for master volume. 947fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 948fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @param index The volume index to set. See 949ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * {@link #getMasterMaxVolume()} for the largest valid value. 950fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @param flags One or more flags. 951ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @see #getMasterMaxVolume() 952ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @see #getMasterVolume() 953fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 954fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 955fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public void setMasterVolume(int index, int flags) { 956fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 957fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 95895d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.setMasterVolume(index, flags, mContext.getOpPackageName()); 959fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 960fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in setMasterVolume", e); 961fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 962fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 963fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 964fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Solo or unsolo a particular stream. All other streams are muted. 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo command is protected against client process death: if a process 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active solo request on a stream dies, all streams that were muted 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because of this request will be unmuted automatically. 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo requests for a given stream are cumulative: the AudioManager 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several solo requests from one or more clients and the stream 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unsoloed only when the same number of unsolo requests are received. 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unsolo a soloed stream 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and solo is again in onResume() if appropriate. 977ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 978ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be soloed/unsoloed. 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required solo state: true for solo ON, false for solo OFF 982ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * 983ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamSolo(int streamType, boolean state) { 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamSolo(streamType, state, mICallBack); 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamSolo", e); 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mute or unmute an audio stream. 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute command is protected against client process death: if a process 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active mute request on a stream dies, this stream will be unmuted 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * automatically. 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute requests for a given stream are cumulative: the AudioManager 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several mute requests from one or more clients and the stream 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unmuted only when the same number of unmute requests are received. 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unmute a muted stream 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and mute is again in onResume() if appropriate. 1007fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1008fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1009fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 1010ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * <p>This method has no effect if the device implements a fixed volume policy 1011ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * as indicated by {@link #isVolumeFixed()}. 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be muted/unmuted. 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required mute state: true for mute ON, false for mute OFF 1015ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * 1016ba207e76b2c5ebc01ececff351107d19a3134f3aEric Laurent * @see #isVolumeFixed() 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamMute(int streamType, boolean state) { 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamMute(streamType, state, mICallBack); 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamMute", e); 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 102825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * get stream mute state. 102925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 103025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 103125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 103225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public boolean isStreamMute(int streamType) { 103325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 103425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 103525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return service.isStreamMute(streamType); 103625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 103725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in isStreamMute", e); 103825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return false; 103925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 104025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 104125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 104225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 1043ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * set master mute state. 1044ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 1045ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 1046ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 1047ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void setMasterMute(boolean state) { 10480273af55cf68d54d26d154b44d105d40fed79701Justin Koh setMasterMute(state, FLAG_SHOW_UI); 10490273af55cf68d54d26d154b44d105d40fed79701Justin Koh } 10500273af55cf68d54d26d154b44d105d40fed79701Justin Koh 10510273af55cf68d54d26d154b44d105d40fed79701Justin Koh /** 10520273af55cf68d54d26d154b44d105d40fed79701Justin Koh * set master mute state with optional flags. 10530273af55cf68d54d26d154b44d105d40fed79701Justin Koh * 10540273af55cf68d54d26d154b44d105d40fed79701Justin Koh * @hide 10550273af55cf68d54d26d154b44d105d40fed79701Justin Koh */ 10560273af55cf68d54d26d154b44d105d40fed79701Justin Koh public void setMasterMute(boolean state, int flags) { 1057ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 1058ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 10594a21b25fad62e4f19d13ba814263841c931f56efJulia Reynolds service.setMasterMute(state, flags, mContext.getOpPackageName(), mICallBack); 1060ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 1061ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in setMasterMute", e); 1062ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1063ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1064ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 1065ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 1066ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * get master mute state. 1067ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 1068ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 1069ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 1070ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public boolean isMasterMute() { 1071ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 1072ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 1073ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.isMasterMute(); 1074ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 1075ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in isMasterMute", e); 1076ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return false; 1077ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1078ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1079ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 1080ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 1081402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces the stream controlled by hard volume keys 1082402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * specifying streamType == -1 releases control to the 1083402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * logic. 1084402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * 1085402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 1086402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 1087402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public void forceVolumeControlStream(int streamType) { 108845c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent IAudioService service = getService(); 108945c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent try { 109045c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent service.forceVolumeControlStream(streamType, mICallBack); 109145c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } catch (RemoteException e) { 109245c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent Log.e(TAG, "Dead object in forceVolumeControlStream", e); 109345c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } 1094402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 1095402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 1096402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether a particular type should vibrate according to user 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings and the current ringer mode. 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that use notifications to 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate. The notification manager will not vibrate if the policy doesn't 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it, so the client should always set a vibrate pattern and let the 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * notification manager control whether or not to actually vibrate. 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether the type should vibrate at the instant this method is 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 1112cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1113cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldVibrate(int vibrateType) { 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.shouldVibrate(vibrateType); 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in shouldVibrate", e); 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether the user's vibrate setting for a vibrate type. 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that want to vibrate, instead 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link #shouldVibrate(int)}. 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1139cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1140cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getVibrateSetting(int vibrateType) { 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getVibrateSetting(vibrateType); 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getVibrateSetting", e); 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return VIBRATE_SETTING_OFF; 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the setting for when the vibrate type should vibrate. 1154fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1155fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1156fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateSetting The vibrate setting, one of 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ON}, 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1167cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1168cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setVibrateSetting(int vibrateType, int vibrateSetting) { 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setVibrateSetting(vibrateType, vibrateSetting); 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setVibrateSetting", e); 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the speakerphone on or off. 1181fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1182fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1183fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to turn on speakerphone; 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn it off 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpeakerphoneOn(boolean on){ 1189c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1190c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1191c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setSpeakerphoneOn(on); 1192c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1193c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setSpeakerphoneOn", e); 1194a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the speakerphone is on or off. 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if speakerphone is on, false if it's off 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSpeakerphoneOn() { 1203c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1204c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1205c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isSpeakerphoneOn(); 1206c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1207c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isSpeakerphoneOn", e); 1208a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1209a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent //==================================================================== 12133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent // Bluetooth SCO control 12143def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12153def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 121695b88fbe744d8ce53b5f54f6fcd90c55094a8d14Eric Laurent * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} 12173def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} 12183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * or {@link #SCO_AUDIO_STATE_CONNECTED} 12193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * 12203def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 1221dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead 12223def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 1223dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @Deprecated 12243def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 12253def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_CHANGED = 12263def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.SCO_AUDIO_STATE_CHANGED"; 1227dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1228dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1229dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 1230dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * connection state has been updated. 1231dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>This intent has two extras: 1232dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1233dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_STATE} - The new SCO audio state. </li> 1234dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE}- The previous SCO audio state. </li> 1235dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1236dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p> EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: 1237dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1238dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_DISCONNECTED}, </li> 1239dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTING} or </li> 1240dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTED}, </li> 1241dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1242dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #startBluetoothSco() 1243dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1244dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1245dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_UPDATED = 1246dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; 1247dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 12483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1249dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or 1250dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. 12513def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String EXTRA_SCO_AUDIO_STATE = 12533def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.extra.SCO_AUDIO_STATE"; 12543def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12553def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1256dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous 1257dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * bluetooth SCO connection state. 1258dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1259dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = 1260dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; 1261dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1262dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1263dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1264dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is not established 12653def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12663def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; 12673def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1268dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} 1269dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is established 12703def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12713def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTED = 1; 12723def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1273dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1274dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is being established 1275dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1276dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTING = 2; 1277dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1278dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE indicating that 12793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * there was an error trying to obtain the state 12803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12813def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_ERROR = -1; 12823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Indicates if current platform supports use of SCO for off call use cases. 12863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Application wanted to use bluetooth SCO audio when the phone is not in call 12872ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi * must first call this method to make sure that the platform supports this 12883def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * feature. 12893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @return true if bluetooth SCO can be used for audio when not in call 12903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * false otherwise 12913def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 12923def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12933def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public boolean isBluetoothScoAvailableOffCall() { 12943def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent return mContext.getResources().getBoolean( 12953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent com.android.internal.R.bool.config_bluetooth_sco_off_call); 12963def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12973def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12983def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12993def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Start bluetooth SCO audio connection. 13003def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 13013def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 13023def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method can be used by applications wanting to send and received audio 13033def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * to/from a bluetooth SCO headset while the phone is not in call. 13043def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>As the SCO connection establishment can take several seconds, 13053def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * applications should not rely on the connection to be available when the method 1306dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} 13073def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. 1308dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO 1309dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * audio state before calling startBluetoothSco() by reading the intent returned by the receiver 1310dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * registration. If the state is already CONNECTED, no state change will be received via the 1311dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() 1312dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * so that the connection stays active in case the current initiator stops the connection. 1313dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>Unless the connection is already active as described above, the state will always 1314dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection 1315dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). 1316dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>When finished with the SCO connection or if the establishment fails, the application must 1317dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. 13183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Even if a SCO connection is established, the following restrictions apply on audio 13193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * output streams so that they can be routed to SCO headset: 1320dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1321dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the stream type must be {@link #STREAM_VOICE_CALL} </li> 1322dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1323dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 16kHz or 8kHz </li> 1324dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 13253def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>The following restrictions apply on input streams: 1326dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1327dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1328dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 8kHz </li> 1329dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 13303def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Note that the phone application always has the priority on the usage of the SCO 13313def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * connection for telephony. If this method is called while the phone is in call 13323def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * it will be ignored. Similarly, if a call is received or sent while an application 13333def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * is using the SCO connection, the connection will be lost for the application and NOT 13343def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * returned automatically when the call ends. 133583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>NOTE: up to and including API version 133683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1}, this method initiates a virtual 133783900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * voice call to the bluetooth headset. 133883900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * After API version {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR2} only a raw SCO audio 133983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * connection is established. 13403def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #stopBluetoothSco() 1341dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 13423def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13433def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void startBluetoothSco(){ 13443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 13453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 1346c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurent service.startBluetoothSco(mICallBack, mContext.getApplicationInfo().targetSdkVersion); 13473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 13483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in startBluetoothSco", e); 13493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13503def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13513def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 13530daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * @hide 135483900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Start bluetooth SCO audio connection in virtual call mode. 135583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>Requires Permission: 135683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 135783900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * <p>Similar to {@link #startBluetoothSco()} with explicit selection of virtual call mode. 135883900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Telephony and communication applications (VoIP, Video Chat) should preferably select 135983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * virtual call mode. 136083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * Applications using voice input for search or commands should first try raw audio connection 136183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * with {@link #startBluetoothSco()} and fall back to startBluetoothScoVirtualCall() in case of 136283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * failure. 136383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #startBluetoothSco() 136483900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #stopBluetoothSco() 136583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 136683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent */ 136783900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent public void startBluetoothScoVirtualCall() { 136883900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent IAudioService service = getService(); 136983900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent try { 137083900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent service.startBluetoothScoVirtualCall(mICallBack); 137183900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } catch (RemoteException e) { 137283900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent Log.e(TAG, "Dead object in startBluetoothScoVirtualCall", e); 137383900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } 137483900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent } 137583900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent 137683900754f357616b9e56eaf7fc85f49b8906e987Eric Laurent /** 13773def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Stop bluetooth SCO audio connection. 13783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 13793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 13803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method must be called by applications having requested the use of 13810daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * bluetooth SCO audio with {@link #startBluetoothSco()} when finished with the SCO 13820daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi * connection or if connection fails. 13833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 13843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 13850daab220b2379aad33321364e8a39d2e3d4c3551Jean-Michel Trivi // Also used for connections started with {@link #startBluetoothScoVirtualCall()} 13863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void stopBluetoothSco(){ 13873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 13883def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 13893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.stopBluetoothSco(mICallBack); 13903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 13913def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in stopBluetoothSco", e); 13923def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13933def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 13943def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1396a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Request use of Bluetooth SCO headset for communications. 1397fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1398fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1399fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1401a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param on set <var>true</var> to use bluetooth SCO for communications; 1402a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * <var>false</var> to not use bluetooth SCO for communications 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBluetoothScoOn(boolean on){ 1405c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1406c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1407c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setBluetoothScoOn(on); 1408c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1409c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setBluetoothScoOn", e); 1410a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1414a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Checks whether communications use Bluetooth SCO. 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1416a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return true if SCO is used for communications; 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothScoOn() { 1420c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1421c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1422c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isBluetoothScoOn(); 1423c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1424c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isBluetoothScoOn", e); 1425a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1426a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1430242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @param on set <var>true</var> to route A2DP audio to/from Bluetooth 1431242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * headset; <var>false</var> disable A2DP audio 1432a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1434a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setBluetoothA2dpOn(boolean on){ 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1438242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * Checks whether A2DP audio routing to the Bluetooth headset is on or off. 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1440242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @return true if A2DP audio is being routed to/from Bluetooth headset; 1441242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * false if otherwise 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothA2dpOn() { 1444242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") 1445242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1446a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1447242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent } else { 1448242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent return true; 1449a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets audio routing to the wired headset on or off. 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route audio to/from wired 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable wired headset audio 1457a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1459a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setWiredHeadsetOn(boolean on){ 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1463497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * Checks whether a wired headset is connected or not. 1464497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * <p>This is not a valid indication that audio playback is 1465497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * actually over the wired headset as audio routing depends on other conditions. 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1467497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @return true if a wired headset is connected. 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 1469497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @deprecated Use only to check is a headset is connected or not. 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWiredHeadsetOn() { 14728b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") 14736015a9715421a339c2b7bb63f9166504e3488179Eric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE && 14748b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") 1475a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1476a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1477a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1478a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1479a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 1484fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1485fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1486fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to mute the microphone; 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMicrophoneMute(boolean on){ 149222c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier IAudioService service = getService(); 149322c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier try { 149422c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier service.setMicrophoneMute(on, mContext.getOpPackageName()); 149522c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier } catch (RemoteException e) { 149622c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier Log.e(TAG, "Dead object in setMicrophoneMute", e); 149722c921a910d236abf3a1705a02541a49fdaf3a14Emily Bernier } 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if microphone is muted, false if it's not 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMicrophoneMute() { 1506a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.isMicrophoneMuted(); 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio mode. 1511fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1512fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * The audio mode encompasses audio routing AND the behavior of 1513fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * the telephony layer. Therefore this method should only be used by applications that 1514fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * replace the platform-wide management of audio settings or the main telephony application. 1515fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony 1516fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * application when it places a phone call, as it will cause signals from the radio layer 1517fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * to feed the platform mixer. 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15198aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 15208aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Informs the HAL about the current audio state so that 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it can route the audio appropriately. 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMode(int mode) { 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15279272b4b4a44fe1f33e3030810618194f817caaecEric Laurent service.setMode(mode, mICallBack); 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setMode", e); 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio mode. 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15368aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 15378aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current current audio state from the HAL. 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMode() { 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getMode(); 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getMode", e); 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return MODE_INVALID; 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* modes for setMode/getMode/setRoute/getRoute */ 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Audio harware modes. 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalid audio mode. 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = AudioSystem.MODE_INVALID; 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Current audio mode. Used to apply audio routing to current mode. 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normal audio mode: not ringing and no call established. 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringing audio mode. An incoming is being signaled. 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15718f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In call audio mode. A telephony call is established. 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; 15748f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi /** 15758f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In communication audio mode. An audio/video chat or VoIP call is established. 15768f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi */ 15778f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Routing bits for setRouting/getRouting API */ 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to earpiece 15824a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15834a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1585a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15874a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * Routing audio output to speaker 15884a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15894a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1591a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} 15944a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15954a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth SCO 16004a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16014a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1603a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to headset 16064a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16074a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1609a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth A2DP 16124a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16134a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1615a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used for mask parameter of {@link #setRouting(int,int,int)}. 16184a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 16194a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1621a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio routing for a specified mode 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to change route. E.g., MODE_RINGTONE. 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param routes bit vector of routes requested, created from one or 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more of ROUTE_xxx types. Set bits indicate that route should be on 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mask bit vector of routes to change, created from one or more of 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ROUTE_xxx types. Unset bits indicate the route should be left unchanged 1631b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * 1632b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 1633a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * setBluetoothScoOn() methods instead. 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1635a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRouting(int mode, int routes, int mask) { 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio routing bit vector for a specified mode. 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to get route (e.g., MODE_RINGTONE) 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an audio route bit vector that can be compared with ROUTE_xxx 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bits 1645b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), 1646b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1648b9c9d260f21b321527c4622a123af9767630d94dEric Laurent @Deprecated 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRouting(int mode) { 1650a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return -1; 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether any music is active. 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if any music tracks are active. 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMusicActive() { 165925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return AudioSystem.isStreamActive(STREAM_MUSIC, 0); 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16623114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi /** 16633114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * @hide 1664679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * Checks whether any music or media is actively playing on a remote device (e.g. wireless 1665679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * display). Note that BT audio sinks are not considered remote devices. 1666679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @return true if {@link AudioManager#STREAM_MUSIC} is active on a remote device 1667679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi */ 1668679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi public boolean isMusicActiveRemotely() { 1669679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi return AudioSystem.isStreamActiveRemotely(STREAM_MUSIC, 0); 1670679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi } 1671679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi 1672679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi /** 1673679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @hide 1674fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi * Checks whether any local or remote media playback is active. 1675fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi * Local playback refers to playback for instance on the device's speakers or wired headphones. 1676fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi * Remote playback refers to playback for instance on a wireless display mirroring the 1677fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi * devices's, or on a device using a Cast-like protocol. 1678fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi * @return true if media playback, from which the device is aware, is active. 1679fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi */ 1680fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi public boolean isLocalOrRemoteMusicActive() { 1681fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi IAudioService service = getService(); 1682fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi try { 1683fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi return service.isLocalOrRemoteMusicActive(); 1684fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi } catch (RemoteException e) { 1685fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi Log.e(TAG, "Dead object in isLocalOrRemoteMusicActive()", e); 1686fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi return false; 1687fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi } 1688fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi } 1689fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi 1690fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi /** 1691fca1e603236b8d1681f784e77e3719d1d59c1428Jean-Michel Trivi * @hide 16922380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Checks whether the current audio focus is exclusive. 16932380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @return true if the top of the audio focus stack requested focus 16942380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * with {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} 16952380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 16962380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public boolean isAudioFocusExclusive() { 16972380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi IAudioService service = getService(); 16982380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi try { 16992380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return service.getCurrentAudioFocus() == AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE; 17002380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } catch (RemoteException e) { 17012380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi Log.e(TAG, "Dead object in isAudioFocusExclusive()", e); 17022380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return false; 17032380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 17042380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 17052380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 17062380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 17078a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * Return a new audio session identifier not associated with any player or effect. 17088a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * It can for instance be used to create one of the {@link android.media.audiofx.AudioEffect} 1709289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * objects or specify a session for speech synthesis in 1710289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link android.speech.tts.TextToSpeech.Engine}. 17118a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * @return a new unclaimed and unused audio session identifier, or {@link #ERROR} when the 1712289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * system failed to generate a new session. 17138a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi */ 1714289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi public int generateAudioSessionId() { 17158a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi int session = AudioSystem.newAudioSessionId(); 17168a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi if (session > 0) { 17178a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi return session; 17188a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } else { 1719289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi Log.e(TAG, "Failure to generate a new audio session ID"); 17208a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi return ERROR; 17218a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } 17228a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi } 17238a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi 1724289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi /** 1725289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * A special audio session ID to indicate that the audio session ID isn't known and the 1726289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * framework should generate a new value. This can be used when building a new 1727289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioTrack} instance with 1728289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioTrack#AudioTrack(AudioAttributes, AudioFormat, int, int, int)}. 1729289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi */ 1730289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi public static final int AUDIO_SESSION_ID_GENERATE = AudioSystem.AUDIO_SESSION_ALLOCATE; 1731289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi 17328a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a generic audio configuration parameter. The use of these parameters 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are platform dependant, see libaudio 17369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Temporary interface - DO NOT USE 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * TODO: Replace with a more generic key:value get/set mechanism 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param key name of parameter to set. Must not be null. 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param value value of parameter. Must not be null. 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1746ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @deprecated Use {@link #setParameters(String)} instead 17479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1748a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setParameter(String key, String value) { 1749a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent setParameters(key+"="+value); 1750a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1751a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1752a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1753a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a variable number of parameter values to audio hardware. 1754a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1755a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keyValuePairs list of parameters key value pairs in the form: 1756a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1757a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1758a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1759a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public void setParameters(String keyValuePairs) { 1760a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.setParameters(keyValuePairs); 1761a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1762a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1763a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1764aac753dcf8862b416773eabaabb9d938a30f5896John Spurlock * Gets a variable number of parameter values from audio hardware. 1765a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1766a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keys list of parameters 1767a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return list of parameters key value pairs in the form: 1768a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1769a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1770a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public String getParameters(String keys) { 1771a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.getParameters(keys); 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Sound effect identifiers */ 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Keyboard and direction pad click sound 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEY_CLICK = 0; 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved up 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_UP = 1; 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved down 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_DOWN = 2; 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved left 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_LEFT = 3; 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved right 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME standard 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_STANDARD = 5; 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME spacebar keypress sound 18079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_SPACEBAR = 6; 18109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME delete keypress sound 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_DELETE = 7; 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME return_keypress sound 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_RETURN = 8; 1820cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh 1821cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh /** 1822cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * Invalid keypress sound 1823cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * @see #playSoundEffect(int) 1824cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh */ 1825cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int FX_KEYPRESS_INVALID = 9; 18269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Number of sound effects 18289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1829cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int NUM_SOUND_EFFECTS = 10; 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 18389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1839105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1840105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1841105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1842105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1843cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version uses the UI settings to determine 18459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whether sounds are heard or not. 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType) { 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 18509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!querySoundEffectsEnabled()) { 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffect(effectType); 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 18679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 18689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1872105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1873105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1874105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1875105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1876cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 1877a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * @param volume Sound effect volume. 1878a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * The volume value is a raw scalar so UI controls should be scaled logarithmically. 1879a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version is for applications that have their own 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings panel for enabling and controlling volume. 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType, float volume) { 18849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 18859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 18869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 18899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffectVolume(effectType, volume); 18919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 18929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 18939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings has an in memory cache, so this is fast. 18989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean querySoundEffectsEnabled() { 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Settings.System.getInt(mContext.getContentResolver(), Settings.System.SOUND_EFFECTS_ENABLED, 0) != 0; 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Load Sound effects. 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method must be called when sound effects are enabled. 19079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void loadSoundEffects() { 19099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 19109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.loadSoundEffects(); 19129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 19139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in loadSoundEffects"+e); 19149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unload Sound effects. 19199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method can be called to free some memory when 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sound effects are disabled. 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unloadSoundEffects() { 19239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 19249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.unloadSoundEffects(); 19269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in unloadSoundEffects"+e); 19289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19314050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent /** 19322380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @hide 19332380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate no audio focus has been gained or lost. 19342380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 19352380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_NONE = 0; 19362380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 19372380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 1938d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. 19397f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1940d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1941d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1942d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN = 1; 1943d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1944d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a temporary gain or request of audio focus, anticipated to last a short 1945d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * amount of time. Examples of temporary changes are the playback of driving directions, or an 1946d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * event notification. 19477f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1948d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1949d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1950d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; 1951078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1952078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 1953983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * amount of time, and where it is acceptable for other audio applications to keep playing 1954983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * after having lowered their output level (also referred to as "ducking"). 1955078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Examples of temporary changes are the playback of driving directions where playback of music 1956078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * in the background is acceptable. 19577f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1958078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1959078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1960078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; 1961078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 19622380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 19632380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * amount of time, during which no other applications, or system components, should play 19642380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * anything. Examples of exclusive and transient audio focus requests are voice 19652380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * memo recording and speech recognition, during which the system shouldn't play any 19662380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * notifications, and media playback should have paused. 19672380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 19682380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 19692380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE = 4; 19702380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 1971078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a loss of audio focus of unknown duration. 19727f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1973078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1974078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; 1975078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1976078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus. 19777f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1978078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1979078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; 1980078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1981078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus where the loser of the audio focus can 1982983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * lower its output volume if it wants to continue playing (also referred to as "ducking"), as 1983983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the new focus owner doesn't require others to be silent. 19847f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1985078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1986078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = 1987078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; 1988d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1989d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1990d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Interface definition for a callback to be invoked when the audio focus of the system is 1991d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * updated. 1992d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1993d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public interface OnAudioFocusChangeListener { 1994d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1995d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Called on the listener to notify it the audio focus for this listener has been changed. 1996d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * The focusChange value indicates whether the focus was gained, 1997d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * whether the focus was lost, and whether that loss is transient, or whether the new focus 1998d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * holder will hold it for an unknown amount of time. 1999983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * When losing focus, listeners can use the focus change information to decide what 2000983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * behavior to adopt when losing focus. A music player could for instance elect to lower 2001983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the volume of its music stream (duck) for transient focus losses, and pause otherwise. 2002983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, 2003078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} 2004983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. 2005d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 20067f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi public void onAudioFocusChange(int focusChange); 2007d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2008d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2009d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2010d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, 2011d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * to actual listener objects. 2012d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 201330c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final HashMap<String, OnAudioFocusChangeListener> mAudioFocusIdListenerMap = 2014d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi new HashMap<String, OnAudioFocusChangeListener>(); 2015d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2016d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager 2017d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * instance. 2018d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2019d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Object mFocusListenerLock = new Object(); 2020d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2021d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private OnAudioFocusChangeListener findFocusListener(String id) { 2022d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi return mAudioFocusIdListenerMap.get(id); 2023d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2024d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2025d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2026d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Handler for audio focus events coming from the audio service. 2027d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 202830c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = 2029d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi new FocusEventHandlerDelegate(); 2030078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi 2031d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2032d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Helper class to handle the forwarding of audio focus events to the appropriate listener 2033d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2034d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private class FocusEventHandlerDelegate { 2035d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Handler mHandler; 2036d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2037d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi FocusEventHandlerDelegate() { 2038d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Looper looper; 2039d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if ((looper = Looper.myLooper()) == null) { 2040d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi looper = Looper.getMainLooper(); 2041d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2042d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2043d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (looper != null) { 2044d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // implement the event handler delegate to receive audio focus events 2045d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = new Handler(looper) { 2046d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi @Override 2047d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void handleMessage(Message msg) { 2048d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi OnAudioFocusChangeListener listener = null; 2049d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2050d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi listener = findFocusListener((String)msg.obj); 2051d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2052d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (listener != null) { 20537f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi listener.onAudioFocusChange(msg.what); 2054d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2055d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2056d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 2057d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 2058d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = null; 2059d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2060d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2061d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2062d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Handler getHandler() { 2063d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return mHandler; 2064d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2065d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2066d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 206730c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { 2068d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2069d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void dispatchAudioFocusChange(int focusChange, String id) { 2070d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); 2071d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); 2072d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2073d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2074d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 2075d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2076d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { 2077d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (l == null) { 2078308e9a5d0975489982f93fd1f3728e6ed7a778d0Jean-Michel Trivi return new String(this.toString()); 2079d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 2080d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return new String(this.toString() + l.toString()); 2081d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2082d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2083d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2084d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 20855f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 208646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Registers a listener to be called when audio focus changes. Calling this method is optional 208746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it 208846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * will register the listener as well if it wasn't registered already. 208946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to be notified of audio focus changes. 2090d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2091d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void registerAudioFocusListener(OnAudioFocusChangeListener l) { 2092d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2093d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { 2094d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return; 2095d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2096d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); 2097d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2098d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2099d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2100d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 21015f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 210246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Causes the specified listener to not be called anymore when focus is gained or lost. 210346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to unregister. 2104d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2105d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { 2106392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi 2107d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // remove locally 2108d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 2109d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); 2110d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2111d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2112d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2113d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2114d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 211546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A failed focus change request. 2116d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2117d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_FAILED = 0; 2118d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 211946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A successful focus change request. 2120d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2121d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; 2122d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2123d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2124d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 2125d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Request audio focus. 212646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Send a request to obtain the audio focus 2127d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param l the listener to be notified of audio focus changes 2128d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param streamType the main audio stream type affected by the focus request 2129d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 2130d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 2131078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * for the playback of driving directions, or notifications sounds. 2132983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 2133983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 21349171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * Alternatively use {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} for a temporary request 21359171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * that benefits from the system not playing disruptive sounds like notifications, for 21369171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * usecases such as voice memo recording, or speech recognition. 2137078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 2138d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * as the playback of a song or a video. 2139d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2140d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2141d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { 2142d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 21432380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi if ((durationHint < AUDIOFOCUS_GAIN) || 21442380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE)) { 214555d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi Log.e(TAG, "Invalid duration hint, audio focus request denied"); 214655d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi return status; 214755d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi } 2148d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi registerAudioFocusListener(l); 2149d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi //TODO protect request by permission check? 2150d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2151d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2152d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi status = service.requestAudioFocus(streamType, durationHint, mICallBack, 21538f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mAudioFocusDispatcher, getIdForAudioFocusListener(l), 215495d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName() /* package name */); 2155d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 21564dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocus() on AudioService due to "+e); 2157d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2158d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2159d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2160d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 21614dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 21624dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 21634dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to request audio focus. Will cause the focus request 21644dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to be associated with the "voice communication" identifier only used in AudioService 21654dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to identify this use case. 21664dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param streamType use STREAM_RING for focus requests when ringing, VOICE_CALL for 21674dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * the establishment of the call 21684dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param durationHint the type of focus request. AUDIOFOCUS_GAIN_TRANSIENT is recommended so 21694dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * media applications resume after a call 21704dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 21714dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void requestAudioFocusForCall(int streamType, int durationHint) { 21724dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 21734dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 21744dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi service.requestAudioFocus(streamType, durationHint, mICallBack, null, 2175fa9a69805b001034aa04c3b33989a7ac21522371Jean-Michel Trivi MediaFocusControl.IN_VOICE_COMM_FOCUS_ID, 217695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName()); 21774dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 21784dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocusForCall() on AudioService due to "+e); 21794dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 21804dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 21814dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi 21824dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 21834dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 21844dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to abandon audio focus, typically after a call or 21854dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * when ringing ends and the call is rejected or not answered. 21864dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Should match one or more calls to {@link #requestAudioFocusForCall(int, int)}. 21874dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 21884dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void abandonAudioFocusForCall() { 21894dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 21904dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 2191fa9a69805b001034aa04c3b33989a7ac21522371Jean-Michel Trivi service.abandonAudioFocus(null, MediaFocusControl.IN_VOICE_COMM_FOCUS_ID); 21924dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 21934dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocusForCall() on AudioService due to "+e); 21944dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 21954dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 2196d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2197d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 219846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 219946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener with which focus was requested. 2200d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2201d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2202d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l) { 2203d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2204392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi unregisterAudioFocusListener(l); 2205d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2206d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2207d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi status = service.abandonAudioFocus(mAudioFocusDispatcher, 2208d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi getIdForAudioFocusListener(l)); 2209d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 22104dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocus() on AudioService due to "+e); 2211d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2212d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2213d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2214d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2215d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2216d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi //==================================================================== 2217d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi // Remote Control 2218d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 221946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Register a component to be the sole receiver of MEDIA_BUTTON intents. 2220d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 2221d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * that will receive the media button intent. This broadcast receiver must be declared 2222f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * in the application manifest. The package of the component must match that of 2223f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * the context you're registering from. 2224b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession#setMediaButtonReceiver(PendingIntent)} instead. 2225d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2226b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2227d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { 22288f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 22298f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 22308f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2231f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if (!eventReceiver.getPackageName().equals(mContext.getPackageName())) { 2232f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "registerMediaButtonEventReceiver() error: " + 2233f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi "receiver and context package names don't match"); 2234f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2235f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2236f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and register it 2237f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2238f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2239f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2240f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 2241f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2242f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi registerMediaButtonIntent(pi, eventReceiver); 2243f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2244f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2245f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2246961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Register a component to be the sole receiver of MEDIA_BUTTON intents. This is like 2247961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(android.content.ComponentName)}, but allows 2248961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * the buttons to go to any PendingIntent. Note that you should only use this form if 2249961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * you know you will continue running for the full time until unregistering the 2250961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * PendingIntent. 2251961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver target that will receive media button intents. The PendingIntent 2252b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * will be sent an {@link Intent#ACTION_MEDIA_BUTTON} event when a media button action 2253b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * occurs, with {@link Intent#EXTRA_KEY_EVENT} added and holding the key code of the 2254b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * media button that was pressed. 2255b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession#setMediaButtonReceiver(PendingIntent)} instead. 2256961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2257b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2258961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void registerMediaButtonEventReceiver(PendingIntent eventReceiver) { 2259961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2260961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2261961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2262961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn registerMediaButtonIntent(eventReceiver, null); 2263961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2264961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2265961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2266f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2267f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * no-op if (pi == null) or (eventReceiver == null) 2268f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2269f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi public void registerMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { 2270961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (pi == null) { 2271f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Cannot call registerMediaButtonIntent() with a null parameter"); 2272f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2273f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2274430fc48865e5a371b08f180390946b96d73848feRoboErik MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mContext); 22756f0e4ddd66fcdcc13944d8970d0b560e2626508bRoboErik helper.addMediaButtonListener(pi, eventReceiver, mContext); 2276722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2277722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi 2278722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi /** 227946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Unregister the receiver of MEDIA_BUTTON intents. 228046b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 228146b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. 2282b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 2283d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2284b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2285d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { 22868f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 22878f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 22888f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2289f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and unregister it 2290f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2291f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2292f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2293f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 2294f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2295b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(pi); 2296f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2297f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2298f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2299961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Unregister the receiver of MEDIA_BUTTON intents. 2300961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver same PendingIntent that was registed with 2301961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(PendingIntent)}. 2302b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 2303961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2304b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 2305961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void unregisterMediaButtonEventReceiver(PendingIntent eventReceiver) { 2306961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2307961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2308961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2309b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(eventReceiver); 2310961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2311961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2312961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2313f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2314f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2315b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi public void unregisterMediaButtonIntent(PendingIntent pi) { 2316430fc48865e5a371b08f180390946b96d73848feRoboErik MediaSessionLegacyHelper helper = MediaSessionLegacyHelper.getHelper(mContext); 2317430fc48865e5a371b08f180390946b96d73848feRoboErik helper.removeMediaButtonListener(pi); 2318d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2319d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 2320178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 2321178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Registers the remote control client for providing information to display on the remote 2322178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * controls. 2323466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client from which remote controls will receive 2324466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * information to display. 2325466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @see RemoteControlClient 2326b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 23278f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 2328b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 23294426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void registerRemoteControlClient(RemoteControlClient rcClient) { 2330f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 23318f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 23328f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2333430fc48865e5a371b08f180390946b96d73848feRoboErik rcClient.registerWithSession(MediaSessionLegacyHelper.getHelper(mContext)); 23348f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 23358f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 23368f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 2337fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * Unregisters the remote control client that was providing information to display on the 2338466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * remote controls. 2339466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client to unregister. 23404426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi * @see #registerRemoteControlClient(RemoteControlClient) 2341b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use {@link MediaSession} instead. 23428f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 2343b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 23444426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void unregisterRemoteControlClient(RemoteControlClient rcClient) { 2345f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 23468f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 23478f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2348430fc48865e5a371b08f180390946b96d73848feRoboErik rcClient.unregisterWithSession(MediaSessionLegacyHelper.getHelper(mContext)); 23498f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 23508f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 235144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 2352a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Registers a {@link RemoteController} instance for it to receive media metadata updates 2353a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * and playback state information from applications using {@link RemoteControlClient}, and 2354a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * control their playback. 2355f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * <p>Registration requires the {@link OnClientUpdateListener} listener to be one of the 2356f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * enabled notification listeners (see 2357f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * {@link android.service.notification.NotificationListenerService}). 2358a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to register. 23597ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @return true if the {@link RemoteController} was successfully registered, false if an 23607ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * error occurred, due to an internal system error, or insufficient permissions. 2361b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use 2362b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * {@link MediaSessionManager#addActiveSessionsListener(android.media.session.MediaSessionManager.SessionListener, ComponentName)} 2363b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * and {@link MediaController} instead. 23647ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 2365b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 23667ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public boolean registerRemoteController(RemoteController rctlr) { 23677ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 23687ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return false; 23697ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 2370430fc48865e5a371b08f180390946b96d73848feRoboErik rctlr.startListeningToSessions(); 2371430fc48865e5a371b08f180390946b96d73848feRoboErik return true; 23727ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 23737ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 23747ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 2375a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Unregisters a {@link RemoteController}, causing it to no longer receive media metadata and 2376a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * playback state information, and no longer be capable of controlling playback. 2377a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to unregister. 2378b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * @deprecated Use 2379b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * {@link MediaSessionManager#removeActiveSessionsListener(android.media.session.MediaSessionManager.SessionListener)} 2380b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik * instead. 23817ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 2382b214efbb9170a9f6a4991684a63ca59680074cc7RoboErik @Deprecated 23837ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public void unregisterRemoteController(RemoteController rctlr) { 23847ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 23857ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return; 23867ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 2387430fc48865e5a371b08f180390946b96d73848feRoboErik rctlr.stopListeningToSessions(); 23887ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 23897ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 23907ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 23917ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 239244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 23934a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Use this method if your IRemoteControlDisplay is not going to display artwork, otherwise 23944a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * use {@link #registerRemoteControlDisplay(IRemoteControlDisplay, int, int)} to pass the 23954a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * artwork size directly, or 23964a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * {@link #remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay, int, int)} later if artwork 23974a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * is not yet needed. 2398f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * <p>Registration requires the {@link Manifest.permission#MEDIA_CONTENT_CONTROL} permission. 23994a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd the IRemoteControlDisplay 240044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 240144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd) { 24024a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi // passing a negative value for art work width and height as they are unknown at this stage 24034a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi registerRemoteControlDisplay(rcd, /*w*/-1, /*h*/ -1); 24044a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi } 24054a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi 24064a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi /** 24074a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @hide 24084a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 2409f108cdd9ee5efe354d87edd02a07b323298c116cJean-Michel Trivi * <p>Registration requires the {@link Manifest.permission#MEDIA_CONTENT_CONTROL} permission. 24104a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd 24114a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 24124a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 24134a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 24144a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 24154a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi */ 24164a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd, int w, int h) { 241744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 241844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 241944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 242044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 242144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 24224a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi service.registerRemoteControlDisplay(rcd, w, h); 242344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 242444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); 242544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 242644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 242744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 242844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 242944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 243044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Unregisters a remote control display that was sent information by remote control clients. 243144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 243244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 243344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void unregisterRemoteControlDisplay(IRemoteControlDisplay rcd) { 243444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 243544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 243644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 243744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 243844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 243944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.unregisterRemoteControlDisplay(rcd); 244044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 244144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); 244244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 244344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 244444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 244544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 244644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 244744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Sets the artwork size a remote control display expects when receiving bitmaps. 244844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 244944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 245044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 245144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 245244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 245344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 245444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay rcd, int w, int h) { 245544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 245644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 245744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 245844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 245944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 246044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.remoteControlDisplayUsesBitmapSize(rcd, w, h); 246144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 246244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayUsesBitmapSize " + e); 246344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 246444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 2465ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh 2466b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi /** 24673261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @hide 2468c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * Controls whether a remote control display needs periodic checks of the RemoteControlClient 2469c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * playback position to verify that the estimated position has not drifted from the actual 2470c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position. By default the check is not performed. 2471c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * The IRemoteControlDisplay must have been previously registered for this to have any effect. 2472c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param rcd the IRemoteControlDisplay for which the anti-drift mechanism will be enabled 2473c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * or disabled. No effect is null. 2474c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param wantsSync if true, RemoteControlClient instances which expose their playback position 2475c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * to the framework will regularly compare the estimated playback position with the actual 2476c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position, and will update the IRemoteControlDisplay implementation whenever a drift is 2477c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * detected. 2478c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi */ 2479c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi public void remoteControlDisplayWantsPlaybackPositionSync(IRemoteControlDisplay rcd, 2480c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi boolean wantsSync) { 2481c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi if (rcd == null) { 2482c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi return; 2483c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2484c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi IAudioService service = getService(); 2485c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi try { 2486c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi service.remoteControlDisplayWantsPlaybackPositionSync(rcd, wantsSync); 2487c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } catch (RemoteException e) { 2488c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayWantsPlaybackPositionSync " + e); 2489c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2490c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2491c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi 2492c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi /** 2493a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @hide 2494a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 2495a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * Register the given {@link AudioPolicy}. 2496a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * This call is synchronous and blocks until the registration process successfully completed 2497a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * or failed to complete. 2498a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @param policy the {@link AudioPolicy} to register. 2499a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @return {@link #ERROR} if there was an error communicating with the registration service 2500a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * or if the user doesn't have the required 2501a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * {@link android.Manifest.permission#MODIFY_AUDIO_ROUTING} permission, 2502a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * {@link #SUCCESS} otherwise. 2503a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi */ 2504a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi public int registerAudioPolicy(AudioPolicy policy) { 2505a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi if (policy == null) { 2506a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioPolicy argument"); 2507a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2508a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi IAudioService service = getService(); 2509a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi try { 2510a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi if (!service.registerAudioPolicy(policy.getConfig(), policy.token())) { 2511a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return ERROR; 2512a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2513a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } catch (RemoteException e) { 2514a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi Log.e(TAG, "Dead object in registerAudioPolicyAsync()", e); 2515a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return ERROR; 2516a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2517a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi return SUCCESS; 2518a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2519a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2520a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi /** 2521a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @hide 2522a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 2523a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * @param policy the {@link AudioPolicy} to unregister. 2524a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi */ 2525a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi public void unregisterAudioPolicyAsync(AudioPolicy policy) { 2526a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi if (policy == null) { 2527a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioPolicy argument"); 2528a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2529a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi IAudioService service = getService(); 2530a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi try { 2531a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi service.unregisterAudioPolicyAsync(policy.token()); 2532a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } catch (RemoteException e) { 2533a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterAudioPolicyAsync()", e); 2534a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2535a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi } 2536a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2537a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi 2538a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi /** 25394050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * @hide 25404050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * Reload audio settings. This method is called by Settings backup 25414050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * agent when audio settings are restored and causes the AudioService 25424050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * to read and apply restored settings. 25434050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent */ 25444050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent public void reloadAudioSettings() { 25454050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent IAudioService service = getService(); 25464050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent try { 25474050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent service.reloadAudioSettings(); 25484050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } catch (RemoteException e) { 25494050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent Log.e(TAG, "Dead object in reloadAudioSettings"+e); 25504050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 25514050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 25524050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent 25535a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du /** 25545a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * @hide 25555a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * Notifies AudioService that it is connected to an A2DP device that supports absolute volume, 25565a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * so that AudioService can send volume change events to the A2DP device, rather than handling 25575a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * them. 25585a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du */ 25595a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du public void avrcpSupportsAbsoluteVolume(String address, boolean support) { 25605a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du IAudioService service = getService(); 25615a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du try { 25625a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du service.avrcpSupportsAbsoluteVolume(address, support); 25635a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } catch (RemoteException e) { 25645a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du Log.e(TAG, "Dead object in avrcpSupportsAbsoluteVolume", e); 25655a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 25665a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 25675a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du 25689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 25709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 257130c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IBinder mICallBack = new Binder(); 25727f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 25737f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten /** 25747f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * Checks whether the phone is in silent mode, with or without vibrate. 25757f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 25767f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @return true if phone is in silent mode, with or without vibrate. 25777f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 25787f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @see #getRingerMode() 25797f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 25807f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @hide pending API Council approval 25817f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten */ 25827f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten public boolean isSilentMode() { 25837f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten int ringerMode = getRingerMode(); 25847f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten boolean silentMode = 25857f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_SILENT) || 25867f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_VIBRATE); 25877f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten return silentMode; 25887f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten } 25897f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 25908b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // This section re-defines new output device constants from AudioSystem, because the AudioSystem 25918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // class is not used by other parts of the framework, which instead use definitions and methods 25928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. 25938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2594948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2595d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim * The audio device code for representing "no device." */ 2596d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim public static final int DEVICE_NONE = AudioSystem.DEVICE_NONE; 2597d7c29189aa639bfac1e6efcd222e65c2c8ecf3f1Wonsik Kim /** @hide 2598948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for the small speaker at the front of the device used 25998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * when placing calls. Does not refer to an in-ear headphone without attached microphone, 26008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a 26018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}. 26028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 26038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; 2604948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2605948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for the built-in speaker */ 26068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; 2607948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2608948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a wired headset with attached microphone */ 26098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; 2610948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2611948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a wired headphone without attached microphone */ 26128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; 2613948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2614948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for generic Bluetooth SCO, for voice */ 26158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; 2616948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2617948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth SCO Headset Profile (HSP) and 2618948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Hands-Free Profile (HFP), for voice 26198b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 26208b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 26218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; 2622948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2623948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth SCO car audio, for voice */ 26248b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 26258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; 2626948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2627948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for generic Bluetooth A2DP, for music */ 26288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; 2629948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2630948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth A2DP headphones, for music */ 26318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 26328b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; 2633948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2634948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for Bluetooth A2DP external speaker, for music */ 26358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 26368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; 2637948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2638948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for S/PDIF (legacy) or HDMI 2639948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Deprecated: replaced by {@link #DEVICE_OUT_HDMI} */ 26408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; 2641948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2642948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for HDMI */ 2643948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_HDMI = AudioSystem.DEVICE_OUT_HDMI; 2644948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2645948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for an analog wired headset attached via a 26468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 26478b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 26488b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; 2649948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2650948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a digital wired headset attached via a 26518b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 26528b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 26538b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; 2654948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2655948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a USB audio accessory. The accessory is in USB host 265659f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB device mode 265759f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 265859f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_ACCESSORY = AudioSystem.DEVICE_OUT_USB_ACCESSORY; 2659948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2660948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for a USB audio device. The device is in USB device 266159f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB host mode 266259f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 266359f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_DEVICE = AudioSystem.DEVICE_OUT_USB_DEVICE; 2664948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2665948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for projection output. 2666948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2667948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_REMOTE_SUBMIX = AudioSystem.DEVICE_OUT_REMOTE_SUBMIX; 2668948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2669948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code the telephony voice TX path. 2670948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2671948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_TELEPHONY_TX = AudioSystem.DEVICE_OUT_TELEPHONY_TX; 2672948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2673948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for an analog jack with line impedance detected. 2674948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2675948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_LINE = AudioSystem.DEVICE_OUT_LINE; 2676948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2677948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for HDMI Audio Return Channel. 2678948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2679948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_HDMI_ARC = AudioSystem.DEVICE_OUT_HDMI_ARC; 2680948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2681948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for S/PDIF digital connection. 2682948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2683948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_SPDIF = AudioSystem.DEVICE_OUT_SPDIF; 2684948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2685948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio output device code for built-in FM transmitter. 2686948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2687948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_OUT_FM = AudioSystem.DEVICE_OUT_FM; 2688948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2689948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * This is not used as a returned value from {@link #getDevicesForStream}, but could be 26908b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * used in the future in a set method to select whatever default device is chosen by the 26918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * platform-specific implementation. 26928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 26938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; 26948b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2695948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2696948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for default built-in microphone 2697948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2698948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BUILTIN_MIC = AudioSystem.DEVICE_IN_BUILTIN_MIC; 2699948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2700948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a Bluetooth SCO headset 2701948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2702948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BLUETOOTH_SCO_HEADSET = 2703948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_BLUETOOTH_SCO_HEADSET; 2704948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2705948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for wired headset microphone 2706948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2707948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_WIRED_HEADSET = 2708948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_WIRED_HEADSET; 2709948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2710948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for HDMI 2711948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2712948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_HDMI = 2713948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_HDMI; 2714948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2715948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for telephony voice RX path 2716948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2717948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_TELEPHONY_RX = 2718948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_TELEPHONY_RX; 2719948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2720948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for built-in microphone pointing to the back 2721948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2722948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_BACK_MIC = 2723948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_BACK_MIC; 2724948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2725948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for analog from a docking station 2726948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2727948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_ANLG_DOCK_HEADSET = 2728948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_ANLG_DOCK_HEADSET; 2729948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2730948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for digital from a docking station 2731948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2732948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_DGTL_DOCK_HEADSET = 2733948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_DGTL_DOCK_HEADSET; 2734948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2735948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a USB audio accessory. The accessory is in USB host 2736948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * mode and the Android device in USB device mode 2737948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2738948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_USB_ACCESSORY = 2739948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_USB_ACCESSORY; 2740948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2741948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a USB audio device. The device is in USB device 2742948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * mode and the Android device in USB host mode 2743948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2744948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_USB_DEVICE = 2745948d32748caaac5be06c991ebf00f74265a7849fEric Laurent AudioSystem.DEVICE_IN_USB_DEVICE; 2746948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2747948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a FM radio tuner 2748948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2749948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_FM_TUNER = AudioSystem.DEVICE_IN_FM_TUNER; 2750948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2751948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a TV tuner 2752948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2753948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_TV_TUNER = AudioSystem.DEVICE_IN_TV_TUNER; 2754948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2755948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for an analog jack with line impedance detected 2756948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2757948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_LINE = AudioSystem.DEVICE_IN_LINE; 2758948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** @hide 2759948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * The audio input device code for a S/PDIF digital connection 2760948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2761948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static final int DEVICE_IN_SPDIF = AudioSystem.DEVICE_IN_SPDIF; 2762112c19ee8b459439c3462767199832e5394b37a8Terry Heo /** @hide 2763112c19ee8b459439c3462767199832e5394b37a8Terry Heo * The audio input device code for audio loopback 2764112c19ee8b459439c3462767199832e5394b37a8Terry Heo */ 2765112c19ee8b459439c3462767199832e5394b37a8Terry Heo public static final int DEVICE_IN_LOOPBACK = AudioSystem.DEVICE_IN_LOOPBACK; 2766948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 2767948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** 2768948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Return true if the device code corresponds to an output device. 2769948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * @hide 2770948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2771948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static boolean isOutputDevice(int device) 2772948d32748caaac5be06c991ebf00f74265a7849fEric Laurent { 2773948d32748caaac5be06c991ebf00f74265a7849fEric Laurent return (device & AudioSystem.DEVICE_BIT_IN) == 0; 2774948d32748caaac5be06c991ebf00f74265a7849fEric Laurent } 2775948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 2776948d32748caaac5be06c991ebf00f74265a7849fEric Laurent /** 2777948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * Return true if the device code corresponds to an input device. 2778948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * @hide 2779948d32748caaac5be06c991ebf00f74265a7849fEric Laurent */ 2780948d32748caaac5be06c991ebf00f74265a7849fEric Laurent public static boolean isInputDevice(int device) 2781948d32748caaac5be06c991ebf00f74265a7849fEric Laurent { 2782948d32748caaac5be06c991ebf00f74265a7849fEric Laurent return (device & AudioSystem.DEVICE_BIT_IN) == AudioSystem.DEVICE_BIT_IN; 2783948d32748caaac5be06c991ebf00f74265a7849fEric Laurent } 2784948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 2785948d32748caaac5be06c991ebf00f74265a7849fEric Laurent 27868b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** 27878b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Return the enabled devices for the specified output stream type. 27888b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 27898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @param streamType The stream type to query. One of 27908b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_VOICE_CALL}, 27918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_SYSTEM}, 27928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_RING}, 27938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_MUSIC}, 27948b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_ALARM}, 27958b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_NOTIFICATION}, 27968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_DTMF}. 27978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 27988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @return The bit-mask "or" of audio output device codes for all enabled devices on this 27998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * stream. Zero or more of 28008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_EARPIECE}, 28018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_SPEAKER}, 28028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADSET}, 28038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}, 28048b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO}, 28058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, 28068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, 28078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, 28088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, 28098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, 2810948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_HDMI}, 28118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, 28128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. 2813948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_USB_ACCESSORY}. 2814948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_USB_DEVICE}. 2815948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_REMOTE_SUBMIX}. 2816948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_TELEPHONY_TX}. 2817948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_LINE}. 2818948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_HDMI_ARC}. 2819948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_SPDIF}. 2820948d32748caaac5be06c991ebf00f74265a7849fEric Laurent * {@link #DEVICE_OUT_FM}. 28218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DEFAULT} is not used here. 28228b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 28238b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * The implementation may support additional device codes beyond those listed, so 28248b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * the application should ignore any bits which it does not recognize. 28258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Note that the information may be imprecise when the implementation 28268b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * cannot distinguish whether a particular device is enabled. 28278b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 28288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@hide} 28298b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 28308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public int getDevicesForStream(int streamType) { 28318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten switch (streamType) { 28328b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_VOICE_CALL: 28338b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_SYSTEM: 28348b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_RING: 28358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_MUSIC: 28368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_ALARM: 28378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_NOTIFICATION: 28388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_DTMF: 28398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return AudioSystem.getDevicesForStream(streamType); 28408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten default: 28418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return 0; 28428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 28438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 28448b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2845b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 2846b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * Indicate wired accessory connection state change. 2847b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device type of device connected/disconnected (AudioManager.DEVICE_OUT_xxx) 2848b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state: 1 connected, 0 disconnected 2849b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param name device name 2850b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 2851b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 2852b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent public void setWiredDeviceConnectionState(int device, int state, String name) { 2853b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 2854b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 2855b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent service.setWiredDeviceConnectionState(device, state, name); 2856b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 2857b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setWiredDeviceConnectionState "+e); 2858b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2859b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2860b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 2861b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 28620a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * Indicate A2DP source or sink connection state change. 2863b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device Bluetooth device connected/disconnected 2864b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state (BluetoothProfile.STATE_xxx) 28650a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * @param profile profile for the A2DP device 28660a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * (either {@link android.bluetooth.BluetoothProfile.A2DP} or 28670a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood * {@link android.bluetooth.BluetoothProfile.A2DP_SINK}) 2868b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @return a delay in ms that the caller should wait before broadcasting 2869b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED intent. 2870b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 2871b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 28720a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood public int setBluetoothA2dpDeviceConnectionState(BluetoothDevice device, int state, 28730a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood int profile) { 2874b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 2875b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent int delay = 0; 2876b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 28770a40ec2192e4836b2fcb6ba51a7688aa6bd4ee98Mike Lockwood delay = service.setBluetoothA2dpDeviceConnectionState(device, state, profile); 2878b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 2879b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setBluetoothA2dpDeviceConnectionState "+e); 2880b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } finally { 2881b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent return delay; 2882b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2883b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2884b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 2885098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey /** {@hide} */ 2886098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey public IRingtonePlayer getRingtonePlayer() { 2887098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey try { 2888098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return getService().getRingtonePlayer(); 2889098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } catch (RemoteException e) { 2890098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return null; 2891098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 2892098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 2893228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2894228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 289562796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output sample rate 289662796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal Hz. 2897228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2898228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_SAMPLE_RATE = 2899228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_SAMPLE_RATE"; 2900228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2901228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 290262796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output buffer size 290362796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal PCM frames. 2904228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2905228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_FRAMES_PER_BUFFER = 2906228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_FRAMES_PER_BUFFER"; 2907228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2908228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 290962796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Returns the value of the property with the specified key. 2910228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @param key One of the strings corresponding to a property key: either 291162796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_SAMPLE_RATE} or 291262796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_FRAMES_PER_BUFFER} 2913228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @return A string representing the associated value for that property key, 2914228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * or null if there is no value for that key. 2915228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2916228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public String getProperty(String key) { 2917c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten if (PROPERTY_OUTPUT_SAMPLE_RATE.equals(key)) { 2918c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputSampleRate = AudioSystem.getPrimaryOutputSamplingRate(); 2919c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputSampleRate > 0 ? Integer.toString(outputSampleRate) : null; 2920c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else if (PROPERTY_OUTPUT_FRAMES_PER_BUFFER.equals(key)) { 2921c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputFramesPerBuffer = AudioSystem.getPrimaryOutputFrameCount(); 2922c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputFramesPerBuffer > 0 ? Integer.toString(outputFramesPerBuffer) : null; 2923c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else { 2924c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten // null or unknown key 2925c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return null; 2926c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } 2927228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten } 2928228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 292961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 293061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns the estimated latency for the given stream type in milliseconds. 293161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 293261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 293361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 293461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 293561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 293661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getOutputLatency(int streamType) { 293761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return AudioSystem.getOutputLatency(streamType); 293861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 293961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 29403346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 29413346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Registers a global volume controller interface. Currently limited to SystemUI. 29423346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * 29433346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 29443346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 29453346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public void setVolumeController(IVolumeController controller) { 29463346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 29473346a802087f621c6441bc512dfcc17b07143fc6John Spurlock getService().setVolumeController(controller); 29483346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 29493346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error setting volume controller", e); 29503346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 29513346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 29523346a802087f621c6441bc512dfcc17b07143fc6John Spurlock 29533346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 295433f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * Notify audio manager about volume controller visibility changes. 295533f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * Currently limited to SystemUI. 295633f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * 295733f4e04e32fac42f158733d6a731e50490fa9951John Spurlock * @hide 295833f4e04e32fac42f158733d6a731e50490fa9951John Spurlock */ 295933f4e04e32fac42f158733d6a731e50490fa9951John Spurlock public void notifyVolumeControllerVisible(IVolumeController controller, boolean visible) { 296033f4e04e32fac42f158733d6a731e50490fa9951John Spurlock try { 296133f4e04e32fac42f158733d6a731e50490fa9951John Spurlock getService().notifyVolumeControllerVisible(controller, visible); 296233f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } catch (RemoteException e) { 296333f4e04e32fac42f158733d6a731e50490fa9951John Spurlock Log.w(TAG, "Error notifying about volume controller visibility", e); 296433f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } 296533f4e04e32fac42f158733d6a731e50490fa9951John Spurlock } 296633f4e04e32fac42f158733d6a731e50490fa9951John Spurlock 296733f4e04e32fac42f158733d6a731e50490fa9951John Spurlock /** 29683346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Only useful for volume controllers. 29693346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 29703346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 29713346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public boolean isStreamAffectedByRingerMode(int streamType) { 29723346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 29733346a802087f621c6441bc512dfcc17b07143fc6John Spurlock return getService().isStreamAffectedByRingerMode(streamType); 29743346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 29753346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error calling isStreamAffectedByRingerMode", e); 29763346a802087f621c6441bc512dfcc17b07143fc6John Spurlock return false; 29773346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 29783346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 29793346a802087f621c6441bc512dfcc17b07143fc6John Spurlock 29803346a802087f621c6441bc512dfcc17b07143fc6John Spurlock /** 29813346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * Only useful for volume controllers. 29823346a802087f621c6441bc512dfcc17b07143fc6John Spurlock * @hide 29833346a802087f621c6441bc512dfcc17b07143fc6John Spurlock */ 29843346a802087f621c6441bc512dfcc17b07143fc6John Spurlock public void disableSafeMediaVolume() { 29853346a802087f621c6441bc512dfcc17b07143fc6John Spurlock try { 29863346a802087f621c6441bc512dfcc17b07143fc6John Spurlock getService().disableSafeMediaVolume(); 29873346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } catch (RemoteException e) { 29883346a802087f621c6441bc512dfcc17b07143fc6John Spurlock Log.w(TAG, "Error disabling safe media volume", e); 29893346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 29903346a802087f621c6441bc512dfcc17b07143fc6John Spurlock } 2991a198a29250acb7c3e918f1566727190966bb336fEric Laurent 2992a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 299341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * Set Hdmi Cec system audio mode. 299441d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * 299541d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @param on whether to be on system audio mode 29966f34f5ab8ab1b1db7887e5405d8b0031e105ab05Jungshik Jang * @return output device type. 0 (DEVICE_NONE) if failed to set device. 299741d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang * @hide 299841d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang */ 299912307ca810e8100981b2b60e3f2c6a7e451b9774Jungshik Jang public int setHdmiSystemAudioSupported(boolean on) { 300041d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang try { 300112307ca810e8100981b2b60e3f2c6a7e451b9774Jungshik Jang return getService().setHdmiSystemAudioSupported(on); 300241d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } catch (RemoteException e) { 300341d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang Log.w(TAG, "Error setting system audio mode", e); 30046f34f5ab8ab1b1db7887e5405d8b0031e105ab05Jungshik Jang return AudioSystem.DEVICE_NONE; 300541d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } 300641d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang } 300741d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang 300841d974631c5f525da49c88d34cecedd5a4cfeda8Jungshik Jang /** 3009a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Return codes for listAudioPorts(), createAudioPatch() ... 3010a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3011a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3012a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3013a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 3014a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3015a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int SUCCESS = AudioSystem.SUCCESS; 30168a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi /** 30178a21f5dd79e93aa4e4b08ab4f33b9255d7c06961Jean-Michel Trivi * A default error code. 3018a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3019a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR = AudioSystem.ERROR; 3020a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3021a8b6bd88cfb010c9e9aa1339e504fd593919e1e0Jean-Michel Trivi * CANDIDATE FOR PUBLIC API 3022a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3023a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_BAD_VALUE = AudioSystem.BAD_VALUE; 3024a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3025a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3026a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_INVALID_OPERATION = AudioSystem.INVALID_OPERATION; 3027a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3028a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3029a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_PERMISSION_DENIED = AudioSystem.PERMISSION_DENIED; 3030a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** @hide 3031a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3032a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_NO_INIT = AudioSystem.NO_INIT; 3033ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent /** 3034ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * An error code indicating that the object reporting it is no longer valid and needs to 3035ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * be recreated. 3036a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3037a198a29250acb7c3e918f1566727190966bb336fEric Laurent public static final int ERROR_DEAD_OBJECT = AudioSystem.DEAD_OBJECT; 3038a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3039a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3040a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Returns a list of descriptors for all audio ports managed by the audio framework. 3041a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Audio ports are nodes in the audio framework or audio hardware that can be configured 3042a198a29250acb7c3e918f1566727190966bb336fEric Laurent * or connected and disconnected with createAudioPatch() or releaseAudioPatch(). 3043a198a29250acb7c3e918f1566727190966bb336fEric Laurent * See AudioPort for a list of attributes of each audio port. 3044a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param ports An AudioPort ArrayList where the list will be returned. 3045a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3046a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3047a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int listAudioPorts(ArrayList<AudioPort> ports) { 3048b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return updateAudioPortCache(ports, null); 3049a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3050a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3051a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3052a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Specialized version of listAudioPorts() listing only audio devices (AudioDevicePort) 3053a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @see listAudioPorts(ArrayList<AudioPort>) 3054a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3055a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3056a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int listAudioDevicePorts(ArrayList<AudioPort> devices) { 3057b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPort> ports = new ArrayList<AudioPort>(); 3058b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int status = updateAudioPortCache(ports, null); 3059b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status == SUCCESS) { 3060b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent devices.clear(); 3061b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int i = 0; i < ports.size(); i++) { 3062b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports.get(i) instanceof AudioDevicePort) { 3063b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent devices.add(ports.get(i)); 3064b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3065b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3066b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3067b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3068a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3069a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3070a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3071a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Create a connection between two or more devices. The framework will reject the request if 3072a198a29250acb7c3e918f1566727190966bb336fEric Laurent * device types are not compatible or the implementation does not support the requested 3073a198a29250acb7c3e918f1566727190966bb336fEric Laurent * configuration. 3074a198a29250acb7c3e918f1566727190966bb336fEric Laurent * NOTE: current implementation is limited to one source and one sink per patch. 3075a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patch AudioPatch array where the newly created patch will be returned. 3076a198a29250acb7c3e918f1566727190966bb336fEric Laurent * As input, if patch[0] is not null, the specified patch will be replaced by the 3077a198a29250acb7c3e918f1566727190966bb336fEric Laurent * new patch created. This avoids calling releaseAudioPatch() when modifying a 3078a198a29250acb7c3e918f1566727190966bb336fEric Laurent * patch and allows the implementation to optimize transitions. 3079a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param sources List of source audio ports. All must be AudioPort.ROLE_SOURCE. 3080a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param sinks List of sink audio ports. All must be AudioPort.ROLE_SINK. 3081a198a29250acb7c3e918f1566727190966bb336fEric Laurent * 3082a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @return - {@link #SUCCESS} if connection is successful. 3083a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_BAD_VALUE} if incompatible device types are passed. 3084a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_INVALID_OPERATION} if the requested connection is not supported. 3085a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_PERMISSION_DENIED} if the client does not have permission to create 3086a198a29250acb7c3e918f1566727190966bb336fEric Laurent * a patch. 3087a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_DEAD_OBJECT} if the server process is dead 3088a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR} if patch cannot be connected for any other reason. 3089a198a29250acb7c3e918f1566727190966bb336fEric Laurent * 3090a198a29250acb7c3e918f1566727190966bb336fEric Laurent * patch[0] contains the newly created patch 3091a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3092a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3093a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int createAudioPatch(AudioPatch[] patch, 3094a198a29250acb7c3e918f1566727190966bb336fEric Laurent AudioPortConfig[] sources, 3095a198a29250acb7c3e918f1566727190966bb336fEric Laurent AudioPortConfig[] sinks) { 3096b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return AudioSystem.createAudioPatch(patch, sources, sinks); 3097a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3098a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3099a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3100a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Releases an existing audio patch connection. 3101a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patch The audio patch to disconnect. 3102a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @return - {@link #SUCCESS} if disconnection is successful. 3103a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_BAD_VALUE} if the specified patch does not exist. 3104a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_PERMISSION_DENIED} if the client does not have permission to release 3105a198a29250acb7c3e918f1566727190966bb336fEric Laurent * a patch. 3106a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR_DEAD_OBJECT} if the server process is dead 3107a198a29250acb7c3e918f1566727190966bb336fEric Laurent * - {@link #ERROR} if patch cannot be released for any other reason. 3108a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3109a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3110a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int releaseAudioPatch(AudioPatch patch) { 3111b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return AudioSystem.releaseAudioPatch(patch); 3112a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3113a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3114a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3115a198a29250acb7c3e918f1566727190966bb336fEric Laurent * List all existing connections between audio ports. 3116a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patches An AudioPatch array where the list will be returned. 3117a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3118a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3119a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int listAudioPatches(ArrayList<AudioPatch> patches) { 3120b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return updateAudioPortCache(null, patches); 3121a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3122a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3123a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3124a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Set the gain on the specified AudioPort. The AudioGainConfig config is build by 3125a198a29250acb7c3e918f1566727190966bb336fEric Laurent * AudioGain.buildConfig() 3126a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3127a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3128a198a29250acb7c3e918f1566727190966bb336fEric Laurent public int setAudioPortGain(AudioPort port, AudioGainConfig gain) { 31293a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent if (port == null || gain == null) { 31303a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent return ERROR_BAD_VALUE; 31313a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent } 31323a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent AudioPortConfig activeConfig = port.activeConfig(); 31333a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent AudioPortConfig config = new AudioPortConfig(port, activeConfig.samplingRate(), 31343a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent activeConfig.channelMask(), activeConfig.format(), gain); 31353a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent config.mConfigMask = AudioPortConfig.GAIN; 31363a24199a0fe9479802ff6096d82cb3745efa1f1fEric Laurent return AudioSystem.setAudioPortConfig(config); 3137a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3138a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3139a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3140a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Listener registered by client to be notified upon new audio port connections, 3141a198a29250acb7c3e918f1566727190966bb336fEric Laurent * disconnections or attributes update. 3142a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3143a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3144a198a29250acb7c3e918f1566727190966bb336fEric Laurent public interface OnAudioPortUpdateListener { 3145a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3146a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called upon audio port list update. 3147a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param portList the updated list of audio ports 3148a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3149a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void OnAudioPortListUpdate(AudioPort[] portList); 3150a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3151a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3152a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called upon audio patch list update. 3153a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @param patchList the updated list of audio patches 3154a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3155a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void OnAudioPatchListUpdate(AudioPatch[] patchList); 3156a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3157a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3158a198a29250acb7c3e918f1566727190966bb336fEric Laurent * Callback method called when the mediaserver dies 3159a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3160a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void OnServiceDied(); 3161a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3162a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3163a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3164700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent * Register an audio port list update listener. 3165a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3166a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3167a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void registerAudioPortUpdateListener(OnAudioPortUpdateListener l) { 3168700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent mAudioPortEventHandler.registerListener(l); 3169a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3170a198a29250acb7c3e918f1566727190966bb336fEric Laurent 3171a198a29250acb7c3e918f1566727190966bb336fEric Laurent /** 3172700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent * Unregister an audio port list update listener. 3173a198a29250acb7c3e918f1566727190966bb336fEric Laurent * @hide 3174a198a29250acb7c3e918f1566727190966bb336fEric Laurent */ 3175a198a29250acb7c3e918f1566727190966bb336fEric Laurent public void unregisterAudioPortUpdateListener(OnAudioPortUpdateListener l) { 3176700e73471d85348b52ecf213c36bb24b93997ec7Eric Laurent mAudioPortEventHandler.unregisterListener(l); 3177a198a29250acb7c3e918f1566727190966bb336fEric Laurent } 3178b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3179b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // 3180b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // AudioPort implementation 3181b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // 3182b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3183b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent static final int AUDIOPORT_GENERATION_INIT = 0; 3184b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent Integer mAudioPortGeneration = new Integer(AUDIOPORT_GENERATION_INIT); 3185b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPort> mAudioPortsCached = new ArrayList<AudioPort>(); 3186b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPatch> mAudioPatchesCached = new ArrayList<AudioPatch>(); 3187b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3188b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int resetAudioPortGeneration() { 3189b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int generation; 3190b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent synchronized (mAudioPortGeneration) { 3191b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent generation = mAudioPortGeneration; 3192b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent mAudioPortGeneration = AUDIOPORT_GENERATION_INIT; 3193b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3194b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return generation; 3195b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3196b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3197b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int updateAudioPortCache(ArrayList<AudioPort> ports, ArrayList<AudioPatch> patches) { 3198b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent synchronized (mAudioPortGeneration) { 3199b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3200b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (mAudioPortGeneration == AUDIOPORT_GENERATION_INIT) { 3201b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int[] patchGeneration = new int[1]; 3202b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int[] portGeneration = new int[1]; 3203b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int status; 3204b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPort> newPorts = new ArrayList<AudioPort>(); 3205b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ArrayList<AudioPatch> newPatches = new ArrayList<AudioPatch>(); 3206b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3207b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent do { 3208b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPorts.clear(); 3209b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent status = AudioSystem.listAudioPorts(newPorts, portGeneration); 3210b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status != SUCCESS) { 3211b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3212b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3213b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPatches.clear(); 3214b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent status = AudioSystem.listAudioPatches(newPatches, patchGeneration); 3215b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (status != SUCCESS) { 3216b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return status; 3217b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3218b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } while (patchGeneration[0] != portGeneration[0]); 3219b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3220b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int i = 0; i < newPatches.size(); i++) { 3221b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int j = 0; j < newPatches.get(i).sources().length; j++) { 3222b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent AudioPortConfig portCfg = updatePortConfig(newPatches.get(i).sources()[j], 3223b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent newPorts); 3224b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (portCfg == null) { 3225b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return ERROR; 3226b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3227b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPatches.get(i).sources()[j] = portCfg; 3228b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3229b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (int j = 0; j < newPatches.get(i).sinks().length; j++) { 3230b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent AudioPortConfig portCfg = updatePortConfig(newPatches.get(i).sinks()[j], 3231b4e0909fc4fb08f513cb2b39a919b189621be87cEric Laurent newPorts); 3232b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (portCfg == null) { 3233b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return ERROR; 3234b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3235b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent newPatches.get(i).sinks()[j] = portCfg; 3236b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3237b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3238b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3239b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent mAudioPortsCached = newPorts; 3240b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent mAudioPatchesCached = newPatches; 3241b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent mAudioPortGeneration = portGeneration[0]; 3242b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3243b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports != null) { 3244b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ports.clear(); 3245b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent ports.addAll(mAudioPortsCached); 3246b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3247b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (patches != null) { 3248b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent patches.clear(); 3249b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent patches.addAll(mAudioPatchesCached); 3250b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3251b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3252b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return SUCCESS; 3253b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3254b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent 3255b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioPortConfig updatePortConfig(AudioPortConfig portCfg, ArrayList<AudioPort> ports) { 3256b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioPort port = portCfg.port(); 3257b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent int k; 3258b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent for (k = 0; k < ports.size(); k++) { 3259b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // compare handles because the port returned by JNI is not of the correct 3260b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // subclass 3261b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (ports.get(k).handle().equals(port.handle())) { 3262b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent port = ports.get(k); 3263b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent break; 3264b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3265b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3266b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (k == ports.size()) { 3267b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent // this hould never happen 3268b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent Log.e(TAG, "updatePortConfig port not found for handle: "+port.handle().id()); 3269b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return null; 3270b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3271b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioGainConfig gainCfg = portCfg.gain(); 3272b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent if (gainCfg != null) { 3273b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent AudioGain gain = port.gain(gainCfg.index()); 3274b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg = gain.buildConfig(gainCfg.mode(), 3275b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.channelMask(), 3276b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.values(), 3277b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg.rampDurationMs()); 3278b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 3279b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent return port.buildConfig(portCfg.samplingRate(), 3280b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent portCfg.channelMask(), 3281b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent portCfg.format(), 3282b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent gainCfg); 3283b69681c894c663e84f2826d9b0c832ceb9b45047Eric Laurent } 32849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 3285