AudioManager.java revision 8ab8c2d06185dfefb5c69e614271f684e77eef63
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; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 28c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurentimport android.os.Build; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 31d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Looper; 32d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Message; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 3486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.os.SystemClock; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.ServiceManager; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.provider.Settings; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 38d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.view.KeyEvent; 3986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.view.VolumePanel; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 41d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport java.util.HashMap; 42d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioManager provides access to volume and ringer mode control. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use <code>Context.getSystemService(Context.AUDIO_SERVICE)</code> to get 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an instance of this class. 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioManager { 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Context mContext; 5286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato private long mVolumeKeyUpTime; 53cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood private final boolean mUseMasterVolume; 54b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate private final boolean mUseVolumeKeySounds; 5579f7ec70ebd5758ce54fd5b6fcd60fd27457cba6Dianne Hackborn private final Binder mToken = new Binder(); 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String TAG = "AudioManager"; 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent, a hint for applications that audio is about to become 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'noisy' due to a change in audio outputs. For example, this intent may 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent when a wired headset is unplugged, or when an A2DP audio 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sink is disconnected, and the audio system is about to automatically 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch audio route to the speaker. Applications that are controlling 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * audio streams may consider pausing, reducing volume or some other action 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on receipt of this intent so as not to surprise the user with audio 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the speaker. 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sticky broadcast intent action indicating that the ringer mode has 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the new ringer mode. 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_RINGER_MODE 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new ringer mode. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_CHANGED_ACTION 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_NORMAL 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_SILENT 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_VIBRATE 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the vibrate setting has 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the vibrate type and its new setting. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_SETTING 96cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 97cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1000dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String VIBRATE_SETTING_CHANGED_ACTION = 1010dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.VIBRATE_SETTING_CHANGED"; 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Broadcast intent when the volume for a particular stream type changes. 1053114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Includes the stream, the new volume and previous volumes. 1063114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Notes: 1073114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - for internal platform use only, do not make public, 1083114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - never used for "remote" volume changes 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_TYPE 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_VALUE 1129ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @see #EXTRA_PREV_VOLUME_STREAM_VALUE 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1180dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master volume changes. 1190dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the new volume 1200dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1210dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_VALUE 1220dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_PREV_MASTER_VOLUME_VALUE 1230dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1240dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1250dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_VOLUME_CHANGED_ACTION = 1260dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_VOLUME_CHANGED_ACTION"; 1270dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1280dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1290dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master mute state changes. 1300dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the the new volume 1310dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1320dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_MUTED 1330dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1340dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1350dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_MUTE_CHANGED_ACTION = 1360dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_MUTE_CHANGED_ACTION"; 1370dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1380dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new vibrate setting for a particular type. 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ON 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_OFF 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ONLY_SILENT 146cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 147cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The vibrate type whose setting has changed. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_NOTIFICATION 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_RINGER 157cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 158cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The stream type for the volume changed intent. 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The volume associated with the stream for the volume changed intent. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_VALUE = 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.media.EXTRA_VOLUME_STREAM_VALUE"; 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1739ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent /** 1749ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @hide The previous volume associated with the stream for the volume changed intent. 1759ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent */ 1769ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = 1779ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; 1780dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1790dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1800dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume value for the master volume changed intent. 1810dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is integer between 0 and 100 inclusive. 1820dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1830dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_VALUE = 1840dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_VALUE"; 1850dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1860dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1870dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The previous master volume value for the master volume changed intent. 1880dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is integer between 0 and 100 inclusive. 1890dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1900dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_PREV_MASTER_VOLUME_VALUE = 1910dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_PREV_MASTER_VOLUME_VALUE"; 1920dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1930dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1940dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume mute state for the master mute changed intent. 1950dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is boolean 1960dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1970dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_MUTED = 1980dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_MUTED"; 1999ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for phone calls */ 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for system sounds */ 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for the phone ring */ 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = AudioSystem.STREAM_RING; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for music playback */ 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for alarms */ 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for notifications */ 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide The audio stream for phone calls when connected to bluetooth */ 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; 214a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 215a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; 216a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** The audio stream for DTMF Tones */ 217a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; 218a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for text to speech (TTS) */ 219a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = AudioSystem.STREAM_TTS; 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Number of audio streams */ 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use AudioSystem.getNumStreamTypes() instead 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 224a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide Default volume index values for audio streams */ 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int[] DEFAULT_STREAM_VOLUME = new int[] { 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4, // STREAM_VOICE_CALL 2309d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_RING 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11, // STREAM_MUSIC 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6, // STREAM_ALARM 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_NOTIFICATION 235a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 7, // STREAM_BLUETOOTH_SCO 2369d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM_ENFORCED 237a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11, // STREAM_DTMF 238a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11 // STREAM_TTS 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Increase the ringer volume. 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_RAISE = 1; 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decrease the ringer volume. 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_LOWER = -1; 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maintain the previous ringer volume. This may be useful when needing to 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * show the volume toast without actually modifying the 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_SAME = 0; 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Flags should be powers of 2! 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Show a toast containing the current volume. 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_SHOW_UI = 1 << 0; 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to include ringer modes as possible options when changing volume. 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if true and volume level is 0 and the volume is adjusted 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate mode. 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * By default this is on for the ring stream. If this flag is included, 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this behavior will be present regardless of the stream type being 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affected by the ringer mode. 287105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to play a sound when changing the volume. 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is given to {@link #adjustVolume(int, int)} or 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in some cases (for example, the decided stream type is not 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_RING}, or the volume is being adjusted 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * downward). 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_PLAY_SOUND = 1 << 2; 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any sounds/vibrate that may be in the queue, or are playing (related to 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changing volume). 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to vibrate if going into the vibrate ringer mode. 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_VIBRATE = 1 << 4; 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3204bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * Indicates to VolumePanel that the volume slider should be disabled as user 3214bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * cannot change the stream volume 3224bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * @hide 3234bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent */ 3244bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent public static final int FLAG_FIXED_VOLUME = 1 << 5; 3254bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent 3264bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent /** 327c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * Indicates the volume set/adjust call is for Bluetooth absolute volume 328c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie * @hide 329c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie */ 330c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie public static final int FLAG_BLUETOOTH_ABS_VOLUME = 1 << 6; 331c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie 332c9d1d5f35091226e96fcfa91817480f589eb36e2Matthew Xie /** 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will not vibrate. (This overrides the 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate setting.) 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_SILENT = 0; 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will vibrate. (This will cause the 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone ringer to always vibrate, but the notification vibrate to only 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate if set.) 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_VIBRATE = 1; 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that may be audible and may vibrate. It will be audible if 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the volume before changing out of this mode was audible. It will vibrate 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the vibrate setting is on. 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_NORMAL = 2; 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 36172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent // maximum valid ringer mode value. Values must start from 0 and be contiguous. 36272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent private static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; 36372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to the ringer. 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 370cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 371cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_RINGER = 0; 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to notifications. 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 381cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 382cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_NOTIFICATION = 1; 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to never vibrate. 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 391cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 392cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_OFF = 0; 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to vibrate when possible. 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 401cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 402cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ON = 1; 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to only vibrate when in the vibrate ringer 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 412cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 413cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ONLY_SILENT = 2; 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Suggests using the default stream type. This may not be used in all 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * places a stream type is needed. 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService sService; 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioManager(Context context) { 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContext = context; 430cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood mUseMasterVolume = mContext.getResources().getBoolean( 431cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood com.android.internal.R.bool.config_useMasterVolume); 432b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate mUseVolumeKeySounds = mContext.getResources().getBoolean( 433b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate com.android.internal.R.bool.config_useVolumeKeySounds); 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService getService() 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sService != null) { 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sService = IAudioService.Stub.asInterface(b); 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 447a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Sends a simulated key event for a media button. 448a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * To simulate a key press, you must first send a KeyEvent built with a 449a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#ACTION_DOWN} action, then another event with the {@link KeyEvent#ACTION_UP} 450a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * action. 451a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * <p>The key event will be sent to the current media key event consumer which registered with 452a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link AudioManager#registerMediaButtonEventReceiver(PendingIntent)}. 453a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param keyEvent a {@link KeyEvent} instance whose key code is one of 454a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MUTE}, 455a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_HEADSETHOOK}, 456a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY}, 457a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PAUSE}, 458a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PLAY_PAUSE}, 459a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_STOP}, 460a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_NEXT}, 461a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_PREVIOUS}, 462a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_REWIND}, 463a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_RECORD}, 464a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_FAST_FORWARD}, 465a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_CLOSE}, 466a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * {@link KeyEvent#KEYCODE_MEDIA_EJECT}, 467a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * or {@link KeyEvent#KEYCODE_MEDIA_AUDIO_TRACK}. 468a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi */ 469a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi public void dispatchMediaKeyEvent(KeyEvent keyEvent) { 4707ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi IAudioService service = getService(); 4717ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi try { 4727ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi service.dispatchMediaKeyEvent(keyEvent); 4737ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } catch (RemoteException e) { 4747ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi Log.e(TAG, "dispatchMediaKeyEvent threw exception ", e); 4757ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 4767ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 4777ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 4787ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 4797ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 48086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 481ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void preDispatchKeyEvent(KeyEvent event, int stream) { 48286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 48386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * If the user hits another key within the play sound delay, then 48486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * cancel the sound 48586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 486ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 48786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP 48886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE 48986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && mVolumeKeyUpTime + VolumePanel.PLAY_SOUND_DELAY 49086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato > SystemClock.uptimeMillis()) { 49186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 49286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * The user has hit another key during the delay (e.g., 300ms) 49386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * since the last volume key up, so cancel any sounds. 49486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 495cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 4968dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood adjustMasterVolume(ADJUST_SAME, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 497cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 498cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume(ADJUST_SAME, 49986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 500cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 50186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 50286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 50386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 50486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 50586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 50686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 507ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyDown(KeyEvent event, int stream) { 508ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 50986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 51086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 51186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 51286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 51386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Adjust the volume in on key down since it is more 51486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * responsive to the user. 51586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 516402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent int flags = FLAG_SHOW_UI | FLAG_VIBRATE; 517b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate 518cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 519cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustMasterVolume( 520cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 521cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 5228dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood : ADJUST_LOWER, 5238dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood flags); 524cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 525cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume( 526cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 527cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 528cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood : ADJUST_LOWER, 529cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood stream, 530cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood flags); 531402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 53286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 53386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 534ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (event.getRepeatCount() == 0) { 535ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (mUseMasterVolume) { 536ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood setMasterMute(!isMasterMute()); 537ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } else { 538ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood // TODO: Actually handle MUTE. 539ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 540ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 54186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 54286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 54386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 54486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 54586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 54686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 54786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 548ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyUp(KeyEvent event, int stream) { 549ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 55086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 55186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 55286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 55386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 55486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Play a sound. This is done on key up since we don't want the 55586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * sound to play when a user holds down volume down to mute. 55686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 557b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseVolumeKeySounds) { 558b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseMasterVolume) { 559c4b78d206ffcdccac01e3436a4a3462bef9672edChristopher Tate adjustMasterVolume(ADJUST_SAME, FLAG_PLAY_SOUND); 560b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate } else { 561b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate int flags = FLAG_PLAY_SOUND; 562b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate adjustSuggestedStreamVolume( 563b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate ADJUST_SAME, 564b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate stream, 565b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate flags); 566cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 567402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 56886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato mVolumeKeyUpTime = SystemClock.uptimeMillis(); 56986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 57086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 57186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 57286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 57386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of a particular stream by one step in a direction. 575fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 576fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 577fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_ALARM} 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustStreamVolume(int streamType, int direction, int flags) { 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5924767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 59395d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(direction, flags, mContext.getOpPackageName()); 5944767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 595ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn service.adjustStreamVolume(streamType, direction, flags, 59695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName()); 5974767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustStreamVolume", e); 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream. For example, if a call is 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active, it will have the highest priority regardless of if the in-call 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen is showing. Another example, if music is playing in the background 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and a call is not active, the music stream will be adjusted. 608fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 609fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 610fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustSuggestedStreamVolume(int, int, int) 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustVolume(int direction, int flags) { 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6234767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 62495d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(direction, flags, mContext.getOpPackageName()); 6254767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 62695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustVolume(direction, flags, mContext.getOpPackageName()); 6274767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustVolume", e); 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream, or the given fallback 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stream. 636fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 637fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 638fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param suggestedStreamType The stream type that will be used if there 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is valid here. 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6534767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 65495d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(direction, flags, mContext.getOpPackageName()); 6554767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 656ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn service.adjustSuggestedStreamVolume(direction, suggestedStreamType, flags, 65795d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName()); 6584767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 660cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustSuggestedStreamVolume", e); 661cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 662cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 663cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood 664cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood /** 665cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * Adjusts the master volume for the device's audio amplifier. 666cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * <p> 667cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * 6686c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang * @param steps The number of volume steps to adjust. A positive 6696c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang * value will raise the volume. 6708dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood * @param flags One or more flags. 671e3f5979307fa52898459d9d09ee11bc1d65a4f7fJason Simmons * @hide 672cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood */ 6736c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang public void adjustMasterVolume(int steps, int flags) { 674cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood IAudioService service = getService(); 675cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood try { 67695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.adjustMasterVolume(steps, flags, mContext.getOpPackageName()); 677cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } catch (RemoteException e) { 678cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustMasterVolume", e); 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current ringtone mode. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRingerMode() { 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getRingerMode(); 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getRingerMode", e); 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return RINGER_MODE_NORMAL; 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 70072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * Checks valid ringer mode values. 70172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 70272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @return true if the ringer mode indicated is valid, false otherwise. 70372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 70472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @see #setRingerMode(int) 70572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @hide 70672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent */ 70772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent public static boolean isValidRingerMode(int ringerMode) { 70872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { 70972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return false; 71072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 71172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return true; 71272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 71372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 71472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent /** 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum volume index for a particular stream. 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose maximum volume index is returned. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The maximum valid volume index for the stream. 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamMaxVolume(int streamType) { 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7244767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 7254767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getMasterMaxVolume(); 7264767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 7274767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getStreamMaxVolume(streamType); 7284767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamMaxVolume", e); 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current volume index for a particular stream. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose volume index is returned. 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current volume index for the stream. 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamVolume(int streamType) { 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7464767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 7474767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getMasterVolume(); 7484767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 7494767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getStreamVolume(streamType); 7504767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamVolume", e); 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 75825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * Get last audible volume before stream was muted. 75925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 76025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 76125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 76225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public int getLastAudibleStreamVolume(int streamType) { 76325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 76425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 7654767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 766ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.getLastAudibleMasterVolume(); 7674767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 7684767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getLastAudibleStreamVolume(streamType); 7694767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 77025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 77125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); 77225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return 0; 77325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 77425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 77525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 77625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 7776d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * Get the stream type whose volume is driving the UI sounds volume. 7786d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * UI sounds are screen lock/unlock, camera shutter, key clicks... 7796d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * @hide 7806d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent */ 7816d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent public int getMasterStreamType() { 7826d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent IAudioService service = getService(); 7836d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent try { 7846d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return service.getMasterStreamType(); 7856d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } catch (RemoteException e) { 7866d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent Log.e(TAG, "Dead object in getMasterStreamType", e); 7876d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return STREAM_RING; 7886d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 7896d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 7906d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent 7916d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent /** 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the ringer mode. 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Silent mode will mute the volume and will not vibrate. Vibrate mode will 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mute the volume and vibrate. Normal mode will be audible and may vibrate 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * according to user settings. 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRingerMode(int ringerMode) { 80372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (!isValidRingerMode(ringerMode)) { 80472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return; 80572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setRingerMode(ringerMode); 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setRingerMode", e); 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the volume index for a particular stream. 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream whose volume index should be set. 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The volume index to set. See 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getStreamMaxVolume(int)} for the largest valid value. 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamVolume(int streamType, int index, int flags) { 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8274767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 82895d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.setMasterVolume(index, flags, mContext.getOpPackageName()); 8294767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 83095d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.setStreamVolume(streamType, index, flags, mContext.getOpPackageName()); 8314767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamVolume", e); 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 838fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Returns the maximum volume index for master volume. 839fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 840fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 841fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 842fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getMasterMaxVolume() { 843fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 844fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 845fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getMasterMaxVolume(); 846fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 847fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getMasterMaxVolume", e); 848fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 849fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 850fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 851fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 852fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 853fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Returns the current volume index for master volume. 854fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 855fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @return The current volume index for master volume. 856fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 857fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 858fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getMasterVolume() { 859fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 860fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 861fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getMasterVolume(); 862fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 863fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getMasterVolume", e); 864fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 865fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 866fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 867fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 868fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 869fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Get last audible volume before master volume was muted. 870fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 871fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 872fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 873fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getLastAudibleMasterVolume() { 874fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 875fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 876fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getLastAudibleMasterVolume(); 877fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 878fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getLastAudibleMasterVolume", e); 879fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 880fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 881fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 882fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 883fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 884fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Sets the volume index for master volume. 885fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 886fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @param index The volume index to set. See 887ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * {@link #getMasterMaxVolume()} for the largest valid value. 888fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @param flags One or more flags. 889ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @see #getMasterMaxVolume() 890ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @see #getMasterVolume() 891fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 892fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 893fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public void setMasterVolume(int index, int flags) { 894fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 895fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 89695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn service.setMasterVolume(index, flags, mContext.getOpPackageName()); 897fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 898fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in setMasterVolume", e); 899fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 900fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 901fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 902fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Solo or unsolo a particular stream. All other streams are muted. 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo command is protected against client process death: if a process 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active solo request on a stream dies, all streams that were muted 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because of this request will be unmuted automatically. 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo requests for a given stream are cumulative: the AudioManager 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several solo requests from one or more clients and the stream 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unsoloed only when the same number of unsolo requests are received. 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unsolo a soloed stream 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and solo is again in onResume() if appropriate. 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be soloed/unsoloed. 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required solo state: true for solo ON, false for solo OFF 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamSolo(int streamType, boolean state) { 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamSolo(streamType, state, mICallBack); 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamSolo", e); 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mute or unmute an audio stream. 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute command is protected against client process death: if a process 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active mute request on a stream dies, this stream will be unmuted 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * automatically. 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute requests for a given stream are cumulative: the AudioManager 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several mute requests from one or more clients and the stream 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unmuted only when the same number of unmute requests are received. 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unmute a muted stream 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and mute is again in onResume() if appropriate. 941fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 942fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 943fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be muted/unmuted. 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required mute state: true for mute ON, false for mute OFF 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamMute(int streamType, boolean state) { 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamMute(streamType, state, mICallBack); 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamMute", e); 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 95825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * get stream mute state. 95925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 96025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 96125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 96225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public boolean isStreamMute(int streamType) { 96325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 96425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 96525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return service.isStreamMute(streamType); 96625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 96725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in isStreamMute", e); 96825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return false; 96925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 97025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 97125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 97225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 973ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * set master mute state. 974ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 975ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 976ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 977ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void setMasterMute(boolean state) { 9780273af55cf68d54d26d154b44d105d40fed79701Justin Koh setMasterMute(state, FLAG_SHOW_UI); 9790273af55cf68d54d26d154b44d105d40fed79701Justin Koh } 9800273af55cf68d54d26d154b44d105d40fed79701Justin Koh 9810273af55cf68d54d26d154b44d105d40fed79701Justin Koh /** 9820273af55cf68d54d26d154b44d105d40fed79701Justin Koh * set master mute state with optional flags. 9830273af55cf68d54d26d154b44d105d40fed79701Justin Koh * 9840273af55cf68d54d26d154b44d105d40fed79701Justin Koh * @hide 9850273af55cf68d54d26d154b44d105d40fed79701Justin Koh */ 9860273af55cf68d54d26d154b44d105d40fed79701Justin Koh public void setMasterMute(boolean state, int flags) { 987ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 988ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 9890273af55cf68d54d26d154b44d105d40fed79701Justin Koh service.setMasterMute(state, flags, mICallBack); 990ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 991ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in setMasterMute", e); 992ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 993ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 994ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 995ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 996ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * get master mute state. 997ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 998ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 999ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 1000ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public boolean isMasterMute() { 1001ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 1002ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 1003ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.isMasterMute(); 1004ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 1005ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in isMasterMute", e); 1006ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return false; 1007ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1008ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 1009ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 1010ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 1011402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces the stream controlled by hard volume keys 1012402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * specifying streamType == -1 releases control to the 1013402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * logic. 1014402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * 1015402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 1016402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 1017402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public void forceVolumeControlStream(int streamType) { 101845c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent IAudioService service = getService(); 101945c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent try { 102045c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent service.forceVolumeControlStream(streamType, mICallBack); 102145c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } catch (RemoteException e) { 102245c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent Log.e(TAG, "Dead object in forceVolumeControlStream", e); 102345c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } 1024402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 1025402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 1026402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether a particular type should vibrate according to user 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings and the current ringer mode. 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that use notifications to 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate. The notification manager will not vibrate if the policy doesn't 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it, so the client should always set a vibrate pattern and let the 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * notification manager control whether or not to actually vibrate. 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether the type should vibrate at the instant this method is 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 1042cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1043cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldVibrate(int vibrateType) { 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.shouldVibrate(vibrateType); 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in shouldVibrate", e); 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether the user's vibrate setting for a vibrate type. 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that want to vibrate, instead 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link #shouldVibrate(int)}. 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1069cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1070cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getVibrateSetting(int vibrateType) { 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getVibrateSetting(vibrateType); 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getVibrateSetting", e); 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return VIBRATE_SETTING_OFF; 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the setting for when the vibrate type should vibrate. 1084fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1085fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1086fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateSetting The vibrate setting, one of 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ON}, 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1097cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1098cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setVibrateSetting(int vibrateType, int vibrateSetting) { 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setVibrateSetting(vibrateType, vibrateSetting); 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setVibrateSetting", e); 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the speakerphone on or off. 1111fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1112fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1113fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to turn on speakerphone; 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn it off 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpeakerphoneOn(boolean on){ 1119c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1120c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1121c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setSpeakerphoneOn(on); 1122c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1123c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setSpeakerphoneOn", e); 1124a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the speakerphone is on or off. 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if speakerphone is on, false if it's off 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSpeakerphoneOn() { 1133c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1134c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1135c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isSpeakerphoneOn(); 1136c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1137c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isSpeakerphoneOn", e); 1138a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1139a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11423def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent //==================================================================== 11433def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent // Bluetooth SCO control 11443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 11453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 114695b88fbe744d8ce53b5f54f6fcd90c55094a8d14Eric Laurent * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} 11473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} 11483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * or {@link #SCO_AUDIO_STATE_CONNECTED} 11493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * 11503def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 1151dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead 11523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 1153dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @Deprecated 11543def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 11553def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_CHANGED = 11563def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.SCO_AUDIO_STATE_CHANGED"; 1157dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1158dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1159dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 1160dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * connection state has been updated. 1161dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>This intent has two extras: 1162dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1163dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_STATE} - The new SCO audio state. </li> 1164dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE}- The previous SCO audio state. </li> 1165dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1166dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p> EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: 1167dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1168dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_DISCONNECTED}, </li> 1169dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTING} or </li> 1170dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTED}, </li> 1171dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1172dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #startBluetoothSco() 1173dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1174dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1175dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_UPDATED = 1176dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; 1177dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 11783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1179dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or 1180dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. 11813def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 11823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String EXTRA_SCO_AUDIO_STATE = 11833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.extra.SCO_AUDIO_STATE"; 11843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 11853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1186dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous 1187dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * bluetooth SCO connection state. 1188dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1189dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = 1190dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; 1191dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1192dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1193dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1194dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is not established 11953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 11963def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; 11973def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1198dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} 1199dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is established 12003def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12013def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTED = 1; 12023def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1203dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1204dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is being established 1205dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1206dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTING = 2; 1207dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1208dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE indicating that 12093def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * there was an error trying to obtain the state 12103def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12113def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_ERROR = -1; 12123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12143def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12153def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Indicates if current platform supports use of SCO for off call use cases. 12163def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Application wanted to use bluetooth SCO audio when the phone is not in call 12172ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi * must first call this method to make sure that the platform supports this 12183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * feature. 12193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @return true if bluetooth SCO can be used for audio when not in call 12203def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * false otherwise 12213def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 12223def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12233def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public boolean isBluetoothScoAvailableOffCall() { 12243def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent return mContext.getResources().getBoolean( 12253def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent com.android.internal.R.bool.config_bluetooth_sco_off_call); 12263def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12273def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12283def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12293def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Start bluetooth SCO audio connection. 12303def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 12313def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 12323def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method can be used by applications wanting to send and received audio 12333def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * to/from a bluetooth SCO headset while the phone is not in call. 12343def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>As the SCO connection establishment can take several seconds, 12353def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * applications should not rely on the connection to be available when the method 1236dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} 12373def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. 1238dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO 1239dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * audio state before calling startBluetoothSco() by reading the intent returned by the receiver 1240dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * registration. If the state is already CONNECTED, no state change will be received via the 1241dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() 1242dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * so that the connection stays active in case the current initiator stops the connection. 1243dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>Unless the connection is already active as described above, the state will always 1244dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection 1245dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). 1246dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>When finished with the SCO connection or if the establishment fails, the application must 1247dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. 12483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Even if a SCO connection is established, the following restrictions apply on audio 12493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * output streams so that they can be routed to SCO headset: 1250c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurent * <p>NOTE: up to and including API version 1251c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurent * {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1}, this method initiates a virtual 1252c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurent * voice call to the bluetooth headset. 1253c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurent * After API version {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR2} only a raw SCO audio 1254c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurent * connection is established. 1255dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1256dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the stream type must be {@link #STREAM_VOICE_CALL} </li> 1257dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1258dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 16kHz or 8kHz </li> 1259dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 12603def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>The following restrictions apply on input streams: 1261dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1262dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1263dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 8kHz </li> 1264dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 12653def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Note that the phone application always has the priority on the usage of the SCO 12663def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * connection for telephony. If this method is called while the phone is in call 12673def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * it will be ignored. Similarly, if a call is received or sent while an application 12683def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * is using the SCO connection, the connection will be lost for the application and NOT 12693def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * returned automatically when the call ends. 12703def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #stopBluetoothSco() 1271dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 12723def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12733def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void startBluetoothSco(){ 12743def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 12753def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 1276c18c9138cee0f0859bcab636a004ce92ca4a9ab5Eric Laurent service.startBluetoothSco(mICallBack, mContext.getApplicationInfo().targetSdkVersion); 12773def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 12783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in startBluetoothSco", e); 12793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12813def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Stop bluetooth SCO audio connection. 12843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 12853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 12863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method must be called by applications having requested the use of 12873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * bluetooth SCO audio with {@link #startBluetoothSco()} 1288dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * when finished with the SCO connection or if connection fails. 12893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 12903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12913def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void stopBluetoothSco(){ 12923def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 12933def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 12943def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.stopBluetoothSco(mICallBack); 12953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 12963def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in stopBluetoothSco", e); 12973def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12983def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12993def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1301a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Request use of Bluetooth SCO headset for communications. 1302fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1303fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1304fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1306a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param on set <var>true</var> to use bluetooth SCO for communications; 1307a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * <var>false</var> to not use bluetooth SCO for communications 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBluetoothScoOn(boolean on){ 1310c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1311c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1312c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setBluetoothScoOn(on); 1313c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1314c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setBluetoothScoOn", e); 1315a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1319a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Checks whether communications use Bluetooth SCO. 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1321a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return true if SCO is used for communications; 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothScoOn() { 1325c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1326c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1327c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isBluetoothScoOn(); 1328c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1329c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isBluetoothScoOn", e); 1330a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1331a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1335242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @param on set <var>true</var> to route A2DP audio to/from Bluetooth 1336242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * headset; <var>false</var> disable A2DP audio 1337a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1339a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setBluetoothA2dpOn(boolean on){ 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1343242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * Checks whether A2DP audio routing to the Bluetooth headset is on or off. 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1345242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @return true if A2DP audio is being routed to/from Bluetooth headset; 1346242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * false if otherwise 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothA2dpOn() { 1349242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") 1350242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1351a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1352242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent } else { 1353242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent return true; 1354a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets audio routing to the wired headset on or off. 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route audio to/from wired 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable wired headset audio 1362a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1364a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setWiredHeadsetOn(boolean on){ 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1368497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * Checks whether a wired headset is connected or not. 1369497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * <p>This is not a valid indication that audio playback is 1370497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * actually over the wired headset as audio routing depends on other conditions. 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1372497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @return true if a wired headset is connected. 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 1374497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @deprecated Use only to check is a headset is connected or not. 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWiredHeadsetOn() { 13778b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") 13786015a9715421a339c2b7bb63f9166504e3488179Eric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE && 13798b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") 1380a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1381a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1382a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1383a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1384a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 1389fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1390fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1391fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to mute the microphone; 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMicrophoneMute(boolean on){ 1397a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.muteMicrophone(on); 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if microphone is muted, false if it's not 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMicrophoneMute() { 1406a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.isMicrophoneMuted(); 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio mode. 1411fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1412fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * The audio mode encompasses audio routing AND the behavior of 1413fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * the telephony layer. Therefore this method should only be used by applications that 1414fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * replace the platform-wide management of audio settings or the main telephony application. 1415fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony 1416fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * application when it places a phone call, as it will cause signals from the radio layer 1417fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * to feed the platform mixer. 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14198aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 14208aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Informs the HAL about the current audio state so that 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it can route the audio appropriately. 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMode(int mode) { 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14279272b4b4a44fe1f33e3030810618194f817caaecEric Laurent service.setMode(mode, mICallBack); 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setMode", e); 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio mode. 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14368aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 14378aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current current audio state from the HAL. 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMode() { 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getMode(); 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getMode", e); 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return MODE_INVALID; 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* modes for setMode/getMode/setRoute/getRoute */ 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Audio harware modes. 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalid audio mode. 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = AudioSystem.MODE_INVALID; 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Current audio mode. Used to apply audio routing to current mode. 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normal audio mode: not ringing and no call established. 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringing audio mode. An incoming is being signaled. 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14718f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In call audio mode. A telephony call is established. 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; 14748f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi /** 14758f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In communication audio mode. An audio/video chat or VoIP call is established. 14768f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi */ 14778f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Routing bits for setRouting/getRouting API */ 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to earpiece 14824a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14834a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1485a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14874a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * Routing audio output to speaker 14884a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14894a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1491a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} 14944a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14954a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth SCO 15004a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15014a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1503a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to headset 15064a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15074a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1509a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth A2DP 15124a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15134a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1515a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used for mask parameter of {@link #setRouting(int,int,int)}. 15184a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 15194a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1521a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio routing for a specified mode 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to change route. E.g., MODE_RINGTONE. 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param routes bit vector of routes requested, created from one or 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more of ROUTE_xxx types. Set bits indicate that route should be on 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mask bit vector of routes to change, created from one or more of 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ROUTE_xxx types. Unset bits indicate the route should be left unchanged 1531b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * 1532b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 1533a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * setBluetoothScoOn() methods instead. 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1535a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRouting(int mode, int routes, int mask) { 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio routing bit vector for a specified mode. 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to get route (e.g., MODE_RINGTONE) 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an audio route bit vector that can be compared with ROUTE_xxx 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bits 1545b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), 1546b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1548b9c9d260f21b321527c4622a123af9767630d94dEric Laurent @Deprecated 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRouting(int mode) { 1550a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return -1; 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether any music is active. 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if any music tracks are active. 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMusicActive() { 155925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return AudioSystem.isStreamActive(STREAM_MUSIC, 0); 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15623114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi /** 15633114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * @hide 1564679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * Checks whether any music or media is actively playing on a remote device (e.g. wireless 1565679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * display). Note that BT audio sinks are not considered remote devices. 1566679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @return true if {@link AudioManager#STREAM_MUSIC} is active on a remote device 1567679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi */ 1568679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi public boolean isMusicActiveRemotely() { 1569679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi return AudioSystem.isStreamActiveRemotely(STREAM_MUSIC, 0); 1570679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi } 1571679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi 1572679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi /** 1573679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @hide 15742380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Checks whether the current audio focus is exclusive. 15752380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @return true if the top of the audio focus stack requested focus 15762380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * with {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} 15772380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 15782380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public boolean isAudioFocusExclusive() { 15792380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi IAudioService service = getService(); 15802380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi try { 15812380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return service.getCurrentAudioFocus() == AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE; 15822380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } catch (RemoteException e) { 15832380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi Log.e(TAG, "Dead object in isAudioFocusExclusive()", e); 15842380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi return false; 15852380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 15862380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi } 15872380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 15882380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 15892380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @hide 15903114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * If the stream is active locally or remotely, adjust its volume according to the enforced 15913114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * priority rules. 15923114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Note: only AudioManager.STREAM_MUSIC is supported at the moment 15933114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi */ 15943114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi public void adjustLocalOrRemoteStreamVolume(int streamType, int direction) { 15953114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi if (streamType != STREAM_MUSIC) { 15963114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi Log.w(TAG, "adjustLocalOrRemoteStreamVolume() doesn't support stream " + streamType); 15973114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } 15983114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi IAudioService service = getService(); 15993114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi try { 1600ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn service.adjustLocalOrRemoteStreamVolume(streamType, direction, 160195d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName()); 16023114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } catch (RemoteException e) { 16033114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi Log.e(TAG, "Dead object in adjustLocalOrRemoteStreamVolume", e); 16043114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } 16053114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } 16063114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a generic audio configuration parameter. The use of these parameters 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are platform dependant, see libaudio 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Temporary interface - DO NOT USE 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * TODO: Replace with a more generic key:value get/set mechanism 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param key name of parameter to set. Must not be null. 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param value value of parameter. Must not be null. 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1620ba50b97cff80e73620a0e3d13cae169e095974a7Dianne Hackborn * @deprecated Use {@link #setParameters(String)} instead 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1622a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setParameter(String key, String value) { 1623a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent setParameters(key+"="+value); 1624a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1625a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1626a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1627a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a variable number of parameter values to audio hardware. 1628a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1629a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keyValuePairs list of parameters key value pairs in the form: 1630a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1631a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1632a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1633a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public void setParameters(String keyValuePairs) { 1634a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.setParameters(keyValuePairs); 1635a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1636a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1637a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1638aac753dcf8862b416773eabaabb9d938a30f5896John Spurlock * Gets a variable number of parameter values from audio hardware. 1639a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1640a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keys list of parameters 1641a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return list of parameters key value pairs in the form: 1642a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1643a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1644a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public String getParameters(String keys) { 1645a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.getParameters(keys); 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Sound effect identifiers */ 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Keyboard and direction pad click sound 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEY_CLICK = 0; 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved up 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_UP = 1; 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved down 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_DOWN = 2; 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved left 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_LEFT = 3; 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved right 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME standard keypress sound 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_STANDARD = 5; 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME spacebar keypress sound 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_SPACEBAR = 6; 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME delete keypress sound 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_DELETE = 7; 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME return_keypress sound 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_RETURN = 8; 1694cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh 1695cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh /** 1696cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * Invalid keypress sound 1697cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * @see #playSoundEffect(int) 1698cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh */ 1699cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int FX_KEYPRESS_INVALID = 9; 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Number of sound effects 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1703cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh public static final int NUM_SOUND_EFFECTS = 10; 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1713105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1714105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1715105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1716105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1717cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version uses the UI settings to determine 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whether sounds are heard or not. 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType) { 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!querySoundEffectsEnabled()) { 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 17319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffect(effectType); 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1746105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1747105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1748105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1749105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1750cacfe69b6845dd1c1c8682f67c3c52ef35214b2cJustin Koh * {@link #FX_KEYPRESS_INVALID}, 1751a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * @param volume Sound effect volume. 1752a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * The volume value is a raw scalar so UI controls should be scaled logarithmically. 1753a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version is for applications that have their own 17559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings panel for enabling and controlling volume. 17569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType, float volume) { 17589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 17609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffectVolume(effectType, volume); 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 17669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 17679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings has an in memory cache, so this is fast. 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean querySoundEffectsEnabled() { 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Settings.System.getInt(mContext.getContentResolver(), Settings.System.SOUND_EFFECTS_ENABLED, 0) != 0; 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Load Sound effects. 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method must be called when sound effects are enabled. 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void loadSoundEffects() { 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.loadSoundEffects(); 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in loadSoundEffects"+e); 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unload Sound effects. 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method can be called to free some memory when 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sound effects are disabled. 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unloadSoundEffects() { 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.unloadSoundEffects(); 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in unloadSoundEffects"+e); 18029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18054050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent /** 18062380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @hide 18072380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate no audio focus has been gained or lost. 18082380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 18092380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_NONE = 0; 18102380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi 18112380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 1812d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. 18137f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1814d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1815d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1816d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN = 1; 1817d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1818d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a temporary gain or request of audio focus, anticipated to last a short 1819d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * amount of time. Examples of temporary changes are the playback of driving directions, or an 1820d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * event notification. 18217f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1822d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1823d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1824d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; 1825078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1826078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 1827983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * amount of time, and where it is acceptable for other audio applications to keep playing 1828983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * after having lowered their output level (also referred to as "ducking"). 1829078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Examples of temporary changes are the playback of driving directions where playback of music 1830078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * in the background is acceptable. 18317f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1832078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1833078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1834078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; 1835078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 18362380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 18372380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * amount of time, during which no other applications, or system components, should play 18382380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * anything. Examples of exclusive and transient audio focus requests are voice 18392380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * memo recording and speech recognition, during which the system shouldn't play any 18402380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * notifications, and media playback should have paused. 18412380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 18422380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi */ 18432380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE = 4; 18442380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi /** 1845078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a loss of audio focus of unknown duration. 18467f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1847078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1848078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; 1849078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1850078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus. 18517f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1852078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1853078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; 1854078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1855078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus where the loser of the audio focus can 1856983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * lower its output volume if it wants to continue playing (also referred to as "ducking"), as 1857983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the new focus owner doesn't require others to be silent. 18587f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1859078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1860078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = 1861078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; 1862d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1863d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1864d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Interface definition for a callback to be invoked when the audio focus of the system is 1865d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * updated. 1866d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1867d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public interface OnAudioFocusChangeListener { 1868d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1869d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Called on the listener to notify it the audio focus for this listener has been changed. 1870d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * The focusChange value indicates whether the focus was gained, 1871d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * whether the focus was lost, and whether that loss is transient, or whether the new focus 1872d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * holder will hold it for an unknown amount of time. 1873983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * When losing focus, listeners can use the focus change information to decide what 1874983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * behavior to adopt when losing focus. A music player could for instance elect to lower 1875983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the volume of its music stream (duck) for transient focus losses, and pause otherwise. 1876983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, 1877078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} 1878983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. 1879d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 18807f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi public void onAudioFocusChange(int focusChange); 1881d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1882d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1883d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1884d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, 1885d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * to actual listener objects. 1886d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 188730c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final HashMap<String, OnAudioFocusChangeListener> mAudioFocusIdListenerMap = 1888d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi new HashMap<String, OnAudioFocusChangeListener>(); 1889d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1890d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager 1891d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * instance. 1892d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1893d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Object mFocusListenerLock = new Object(); 1894d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1895d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private OnAudioFocusChangeListener findFocusListener(String id) { 1896d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi return mAudioFocusIdListenerMap.get(id); 1897d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1898d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1899d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1900d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Handler for audio focus events coming from the audio service. 1901d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 190230c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = 1903d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi new FocusEventHandlerDelegate(); 1904078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi 1905d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1906d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Helper class to handle the forwarding of audio focus events to the appropriate listener 1907d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1908d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private class FocusEventHandlerDelegate { 1909d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Handler mHandler; 1910d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1911d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi FocusEventHandlerDelegate() { 1912d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Looper looper; 1913d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if ((looper = Looper.myLooper()) == null) { 1914d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi looper = Looper.getMainLooper(); 1915d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1916d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1917d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (looper != null) { 1918d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // implement the event handler delegate to receive audio focus events 1919d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = new Handler(looper) { 1920d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi @Override 1921d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void handleMessage(Message msg) { 1922d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi OnAudioFocusChangeListener listener = null; 1923d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1924d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi listener = findFocusListener((String)msg.obj); 1925d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1926d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (listener != null) { 19277f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi listener.onAudioFocusChange(msg.what); 1928d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1929d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1930d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1931d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1932d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = null; 1933d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1934d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1935d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1936d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Handler getHandler() { 1937d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return mHandler; 1938d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1939d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1940d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 194130c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { 1942d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1943d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void dispatchAudioFocusChange(int focusChange, String id) { 1944d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); 1945d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); 1946d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1947d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1948d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1949d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1950d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { 1951d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (l == null) { 1952308e9a5d0975489982f93fd1f3728e6ed7a778d0Jean-Michel Trivi return new String(this.toString()); 1953d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1954d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return new String(this.toString() + l.toString()); 1955d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1956d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1957d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1958d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 19595f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 196046b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Registers a listener to be called when audio focus changes. Calling this method is optional 196146b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it 196246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * will register the listener as well if it wasn't registered already. 196346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to be notified of audio focus changes. 1964d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1965d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void registerAudioFocusListener(OnAudioFocusChangeListener l) { 1966d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1967d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { 1968d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return; 1969d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1970d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); 1971d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1972d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1973d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1974d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 19755f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 197646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Causes the specified listener to not be called anymore when focus is gained or lost. 197746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to unregister. 1978d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1979d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { 1980392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi 1981d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // remove locally 1982d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1983d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); 1984d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1985d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1986d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1987d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1988d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 198946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A failed focus change request. 1990d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1991d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_FAILED = 0; 1992d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 199346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A successful focus change request. 1994d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1995d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; 1996d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1997d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1998d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1999d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Request audio focus. 200046b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Send a request to obtain the audio focus 2001d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param l the listener to be notified of audio focus changes 2002d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param streamType the main audio stream type affected by the focus request 2003d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 2004d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 2005078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * for the playback of driving directions, or notifications sounds. 2006983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 2007983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 20089171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * Alternatively use {@link #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} for a temporary request 20099171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * that benefits from the system not playing disruptive sounds like notifications, for 20109171db279826ee91d64eb9538a504ffed5e53b38Jean-Michel Trivi * usecases such as voice memo recording, or speech recognition. 2011078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 2012d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * as the playback of a song or a video. 2013d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2014d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2015d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { 2016d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 20172380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi if ((durationHint < AUDIOFOCUS_GAIN) || 20182380566debfc57eb1cc07db1306ccee23b84ddd4Jean-Michel Trivi (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE)) { 201955d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi Log.e(TAG, "Invalid duration hint, audio focus request denied"); 202055d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi return status; 202155d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi } 2022d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi registerAudioFocusListener(l); 2023d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi //TODO protect request by permission check? 2024d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2025d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2026d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi status = service.requestAudioFocus(streamType, durationHint, mICallBack, 20278f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mAudioFocusDispatcher, getIdForAudioFocusListener(l), 202895d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName() /* package name */); 2029d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 20304dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocus() on AudioService due to "+e); 2031d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2032d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2033d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2034d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 20354dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 20364dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 20374dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to request audio focus. Will cause the focus request 20384dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to be associated with the "voice communication" identifier only used in AudioService 20394dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to identify this use case. 20404dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param streamType use STREAM_RING for focus requests when ringing, VOICE_CALL for 20414dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * the establishment of the call 20424dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param durationHint the type of focus request. AUDIOFOCUS_GAIN_TRANSIENT is recommended so 20434dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * media applications resume after a call 20444dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 20454dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void requestAudioFocusForCall(int streamType, int durationHint) { 20464dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 20474dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 20484dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi service.requestAudioFocus(streamType, durationHint, mICallBack, null, 2049fa9a69805b001034aa04c3b33989a7ac21522371Jean-Michel Trivi MediaFocusControl.IN_VOICE_COMM_FOCUS_ID, 205095d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn mContext.getOpPackageName()); 20514dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 20524dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocusForCall() on AudioService due to "+e); 20534dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 20544dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 20554dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi 20564dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 20574dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 20584dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to abandon audio focus, typically after a call or 20594dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * when ringing ends and the call is rejected or not answered. 20604dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Should match one or more calls to {@link #requestAudioFocusForCall(int, int)}. 20614dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 20624dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void abandonAudioFocusForCall() { 20634dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 20644dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 2065fa9a69805b001034aa04c3b33989a7ac21522371Jean-Michel Trivi service.abandonAudioFocus(null, MediaFocusControl.IN_VOICE_COMM_FOCUS_ID); 20664dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 20674dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocusForCall() on AudioService due to "+e); 20684dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 20694dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 2070d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2071d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 207246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 207346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener with which focus was requested. 2074d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2075d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2076d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l) { 2077d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2078392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi unregisterAudioFocusListener(l); 2079d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2080d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2081d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi status = service.abandonAudioFocus(mAudioFocusDispatcher, 2082d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi getIdForAudioFocusListener(l)); 2083d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 20844dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocus() on AudioService due to "+e); 2085d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2086d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2087d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2088d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2089d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2090d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi //==================================================================== 2091d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi // Remote Control 2092d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 209346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Register a component to be the sole receiver of MEDIA_BUTTON intents. 2094d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 2095d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * that will receive the media button intent. This broadcast receiver must be declared 2096f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * in the application manifest. The package of the component must match that of 2097f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * the context you're registering from. 2098d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2099d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { 21008f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 21018f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 21028f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2103f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if (!eventReceiver.getPackageName().equals(mContext.getPackageName())) { 2104f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "registerMediaButtonEventReceiver() error: " + 2105f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi "receiver and context package names don't match"); 2106f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2107f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2108f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and register it 2109f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2110f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2111f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2112f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 2113f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2114f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi registerMediaButtonIntent(pi, eventReceiver); 2115f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2116f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2117f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2118961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Register a component to be the sole receiver of MEDIA_BUTTON intents. This is like 2119961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(android.content.ComponentName)}, but allows 2120961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * the buttons to go to any PendingIntent. Note that you should only use this form if 2121961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * you know you will continue running for the full time until unregistering the 2122961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * PendingIntent. 2123961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver target that will receive media button intents. The PendingIntent 2124961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * will be sent as-is when a media button action occurs, with {@link Intent#EXTRA_KEY_EVENT} 2125961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * added and holding the key code of the media button that was pressed. 2126961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2127961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void registerMediaButtonEventReceiver(PendingIntent eventReceiver) { 2128961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2129961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2130961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2131961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn registerMediaButtonIntent(eventReceiver, null); 2132961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2133961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2134961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2135f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2136f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * no-op if (pi == null) or (eventReceiver == null) 2137f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2138f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi public void registerMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { 2139961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (pi == null) { 2140f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Cannot call registerMediaButtonIntent() with a null parameter"); 2141f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2142f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2143d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 2144d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 2145f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // pi != null 214679f7ec70ebd5758ce54fd5b6fcd60fd27457cba6Dianne Hackborn service.registerMediaButtonIntent(pi, eventReceiver, 214779f7ec70ebd5758ce54fd5b6fcd60fd27457cba6Dianne Hackborn eventReceiver == null ? mToken : null); 2148d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 2149f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Dead object in registerMediaButtonIntent"+e); 2150d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2151d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2152d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 2153d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 2154722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * @hide 2155722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * Used internally by telephony package to register an intent receiver for ACTION_MEDIA_BUTTON. 2156722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * @param eventReceiver the component that will receive the media button key events, 2157722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * no-op if eventReceiver is null 2158722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi */ 2159722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi public void registerMediaButtonEventReceiverForCalls(ComponentName eventReceiver) { 2160722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi if (eventReceiver == null) { 2161722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi return; 2162722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2163722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi IAudioService service = getService(); 2164722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi try { 2165722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi // eventReceiver != null 2166722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi service.registerMediaButtonEventReceiverForCalls(eventReceiver); 2167722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } catch (RemoteException e) { 2168722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi Log.e(TAG, "Dead object in registerMediaButtonEventReceiverForCalls", e); 2169722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2170722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2171722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi 2172722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi /** 2173722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * @hide 2174722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi */ 2175722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi public void unregisterMediaButtonEventReceiverForCalls() { 2176722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi IAudioService service = getService(); 2177722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi try { 2178722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi service.unregisterMediaButtonEventReceiverForCalls(); 2179722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } catch (RemoteException e) { 2180722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterMediaButtonEventReceiverForCalls", e); 2181722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2182722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2183722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi 2184722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi /** 218546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Unregister the receiver of MEDIA_BUTTON intents. 218646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 218746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. 2188d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2189d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { 21908f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 21918f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 21928f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2193f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and unregister it 2194f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2195f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2196f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2197f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 2198f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2199b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(pi); 2200f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2201f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2202f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2203961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Unregister the receiver of MEDIA_BUTTON intents. 2204961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver same PendingIntent that was registed with 2205961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(PendingIntent)}. 2206961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2207961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void unregisterMediaButtonEventReceiver(PendingIntent eventReceiver) { 2208961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2209961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2210961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2211b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(eventReceiver); 2212961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2213961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2214961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2215f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2216f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2217b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi public void unregisterMediaButtonIntent(PendingIntent pi) { 2218d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 2219d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 2220b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi service.unregisterMediaButtonIntent(pi); 2221d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 2222f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterMediaButtonIntent"+e); 2223d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2224d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2225d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 2226178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 2227178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Registers the remote control client for providing information to display on the remote 2228178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * controls. 2229466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client from which remote controls will receive 2230466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * information to display. 2231466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @see RemoteControlClient 22328f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 22334426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void registerRemoteControlClient(RemoteControlClient rcClient) { 2234f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 22358f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 22368f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22378f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 22388f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 22393114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi int rcseId = service.registerRemoteControlClient( 22403114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi rcClient.getRcMediaIntent(), /* mediaIntent */ 22413114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi rcClient.getIRemoteControlClient(),/* rcClient */ 22428f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi // used to match media button event receiver and audio focus 22433114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi mContext.getPackageName()); /* packageName */ 22443114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi rcClient.setRcseId(rcseId); 22458f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 22468f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlClient"+e); 22478f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22488f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22498f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 22508f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 2251fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * Unregisters the remote control client that was providing information to display on the 2252466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * remote controls. 2253466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client to unregister. 22544426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi * @see #registerRemoteControlClient(RemoteControlClient) 22558f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 22564426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void unregisterRemoteControlClient(RemoteControlClient rcClient) { 2257f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 22588f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 22598f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22608f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 22618f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 2262f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi service.unregisterRemoteControlClient(rcClient.getRcMediaIntent(), /* mediaIntent */ 2263f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi rcClient.getIRemoteControlClient()); /* rcClient */ 22648f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 22658f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlClient"+e); 22668f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22678f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22688f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 226944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 2270a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Registers a {@link RemoteController} instance for it to receive media metadata updates 2271a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * and playback state information from applications using {@link RemoteControlClient}, and 2272a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * control their playback. 2273a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * <p>Registration requires the {@link Manifest.permission#MEDIA_CONTENT_CONTROL} permission. 2274a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to register. 22757ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @return true if the {@link RemoteController} was successfully registered, false if an 22767ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * error occurred, due to an internal system error, or insufficient permissions. 22777ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 22787ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public boolean registerRemoteController(RemoteController rctlr) { 22797ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 22807ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return false; 22817ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 22827ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi IAudioService service = getService(); 22837ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi try { 22848ab8c2d06185dfefb5c69e614271f684e77eef63Jean-Michel Trivi int[] artworkDimensions = rctlr.getArtworkSize(); 22857ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi boolean reg = service.registerRemoteControlDisplay(rctlr.getRcDisplay(), 22868ab8c2d06185dfefb5c69e614271f684e77eef63Jean-Michel Trivi artworkDimensions[0]/*w*/, artworkDimensions[1]/*h*/); 22877ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi rctlr.setIsRegistered(reg); 22887ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return reg; 22897ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } catch (RemoteException e) { 22907ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); 22917ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return false; 22927ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 22937ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 22947ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 22957ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 2296a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * Unregisters a {@link RemoteController}, causing it to no longer receive media metadata and 2297a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * playback state information, and no longer be capable of controlling playback. 2298a83487e8c618f3c267c3fe3a72d4eb9f1388d07eJean-Michel Trivi * @param rctlr the object to unregister. 22997ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi */ 23007ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public void unregisterRemoteController(RemoteController rctlr) { 23017ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi if (rctlr == null) { 23027ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi return; 23037ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 23047ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi IAudioService service = getService(); 23057ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi try { 23067ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi service.unregisterRemoteControlDisplay(rctlr.getRcDisplay()); 23077ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi rctlr.setIsRegistered(false); 23087ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } catch (RemoteException e) { 23097ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); 23107ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 23117ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi } 23127ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi 23137ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi /** 23147ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * @hide 231544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 23164a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Use this method if your IRemoteControlDisplay is not going to display artwork, otherwise 23174a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * use {@link #registerRemoteControlDisplay(IRemoteControlDisplay, int, int)} to pass the 23184a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * artwork size directly, or 23194a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * {@link #remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay, int, int)} later if artwork 23204a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * is not yet needed. 23214a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd the IRemoteControlDisplay 232244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 232344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd) { 23244a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi // passing a negative value for art work width and height as they are unknown at this stage 23254a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi registerRemoteControlDisplay(rcd, /*w*/-1, /*h*/ -1); 23264a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi } 23274a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi 23284a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi /** 23294a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @hide 23304a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 23314a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd 23324a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 23334a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 23344a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 23354a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 23364a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi */ 23374a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd, int w, int h) { 233844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 233944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 234044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 234144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 234244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 23434a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi service.registerRemoteControlDisplay(rcd, w, h); 234444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 234544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); 234644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 234744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 234844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 234944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 235044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 235144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Unregisters a remote control display that was sent information by remote control clients. 235244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 235344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 235444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void unregisterRemoteControlDisplay(IRemoteControlDisplay rcd) { 235544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 235644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 235744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 235844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 235944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 236044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.unregisterRemoteControlDisplay(rcd); 236144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 236244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); 236344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 236444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 236544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 236644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 236744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 236844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Sets the artwork size a remote control display expects when receiving bitmaps. 236944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 237044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 237144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 237244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 237344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 237444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 237544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay rcd, int w, int h) { 237644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 237744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 237844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 237944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 238044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 238144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.remoteControlDisplayUsesBitmapSize(rcd, w, h); 238244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 238344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayUsesBitmapSize " + e); 238444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 238544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 2386ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh 2387b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi /** 23883261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @hide 2389c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * Controls whether a remote control display needs periodic checks of the RemoteControlClient 2390c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * playback position to verify that the estimated position has not drifted from the actual 2391c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position. By default the check is not performed. 2392c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * The IRemoteControlDisplay must have been previously registered for this to have any effect. 2393c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param rcd the IRemoteControlDisplay for which the anti-drift mechanism will be enabled 2394c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * or disabled. No effect is null. 2395c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @param wantsSync if true, RemoteControlClient instances which expose their playback position 2396c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * to the framework will regularly compare the estimated playback position with the actual 2397c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * position, and will update the IRemoteControlDisplay implementation whenever a drift is 2398c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * detected. 2399c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi */ 2400c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi public void remoteControlDisplayWantsPlaybackPositionSync(IRemoteControlDisplay rcd, 2401c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi boolean wantsSync) { 2402c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi if (rcd == null) { 2403c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi return; 2404c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2405c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi IAudioService service = getService(); 2406c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi try { 2407c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi service.remoteControlDisplayWantsPlaybackPositionSync(rcd, wantsSync); 2408c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } catch (RemoteException e) { 2409c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayWantsPlaybackPositionSync " + e); 2410c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2411c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi } 2412c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi 2413c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi /** 2414c3c4babf8424f65b3d3d2700f60fae6e94e9cd00Jean-Michel Trivi * @hide 24153261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * Request the user of a RemoteControlClient to seek to the given playback position. 24163261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @param generationId the RemoteControlClient generation counter for which this request is 24173261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * issued. Requests for an older generation than current one will be ignored. 24183261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @param timeMs the time in ms to seek to, must be positive. 24193261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi */ 24203261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi public void setRemoteControlClientPlaybackPosition(int generationId, long timeMs) { 24213261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi if (timeMs < 0) { 24223261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi return; 24233261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } 24243261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi IAudioService service = getService(); 24253261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi try { 24263261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi service.setRemoteControlClientPlaybackPosition(generationId, timeMs); 24273261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } catch (RemoteException e) { 24283261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi Log.e(TAG, "Dead object in setRccPlaybackPosition("+ generationId + ", " 24293261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi + timeMs + ")", e); 24303261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } 24313261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } 24323261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi 24333261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi /** 2434f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi * @hide 24357ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * Notify the user of a RemoteControlClient that it should update its metadata with the 24367ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi * new value for the given key. 2437f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi * @param generationId the RemoteControlClient generation counter for which this request is 2438f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi * issued. Requests for an older generation than current one will be ignored. 2439f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi * @param key the metadata key for which a new value exists 2440f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi * @param value the new metadata value 2441f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi */ 24427ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi public void updateRemoteControlClientMetadata(int generationId, int key, 24437ddd226e7c6e759feaf2747a90be1cc06acf37a3Jean-Michel Trivi Rating value) { 2444f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi IAudioService service = getService(); 2445f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi try { 2446f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi service.updateRemoteControlClientMetadata(generationId, key, value); 2447f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi } catch (RemoteException e) { 2448f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi Log.e(TAG, "Dead object in updateRemoteControlClientMetadata("+ generationId + ", " 2449f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi + key +", " + value + ")", e); 2450f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi } 2451f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi } 2452f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi 2453f823fc4dba2df5cf5f00e13361f2db93c81f6961Jean-Michel Trivi /** 24544050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * @hide 24554050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * Reload audio settings. This method is called by Settings backup 24564050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * agent when audio settings are restored and causes the AudioService 24574050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * to read and apply restored settings. 24584050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent */ 24594050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent public void reloadAudioSettings() { 24604050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent IAudioService service = getService(); 24614050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent try { 24624050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent service.reloadAudioSettings(); 24634050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } catch (RemoteException e) { 24644050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent Log.e(TAG, "Dead object in reloadAudioSettings"+e); 24654050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 24664050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 24674050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent 24685a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du /** 24695a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * @hide 24705a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * Notifies AudioService that it is connected to an A2DP device that supports absolute volume, 24715a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * so that AudioService can send volume change events to the A2DP device, rather than handling 24725a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du * them. 24735a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du */ 24745a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du public void avrcpSupportsAbsoluteVolume(String address, boolean support) { 24755a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du IAudioService service = getService(); 24765a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du try { 24775a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du service.avrcpSupportsAbsoluteVolume(address, support); 24785a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } catch (RemoteException e) { 24795a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du Log.e(TAG, "Dead object in avrcpSupportsAbsoluteVolume", e); 24805a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 24815a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du } 24825a0cf7a27f3953a1266af48543ccd9024f4cd89fJohn Du 24839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 24849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 24859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 248630c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IBinder mICallBack = new Binder(); 24877f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 24887f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten /** 24897f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * Checks whether the phone is in silent mode, with or without vibrate. 24907f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 24917f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @return true if phone is in silent mode, with or without vibrate. 24927f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 24937f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @see #getRingerMode() 24947f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 24957f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @hide pending API Council approval 24967f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten */ 24977f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten public boolean isSilentMode() { 24987f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten int ringerMode = getRingerMode(); 24997f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten boolean silentMode = 25007f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_SILENT) || 25017f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_VIBRATE); 25027f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten return silentMode; 25037f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten } 25047f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 25058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // This section re-defines new output device constants from AudioSystem, because the AudioSystem 25068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // class is not used by other parts of the framework, which instead use definitions and methods 25078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. 25088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 25098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the small speaker at the front of the device used 25108b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * when placing calls. Does not refer to an in-ear headphone without attached microphone, 25118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a 25128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}. 25138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 25148b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; 25158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the built-in speaker */ 25168b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; 25178b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headset with attached microphone */ 25188b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; 25198b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headphone without attached microphone */ 25208b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; 25218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth SCO, for voice */ 25228b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; 25238b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO Headset Profile (HSP) and 25248b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Hands-Free Profile (HFP), for voice 25258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 25268b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 25278b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; 25288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO car audio, for voice */ 25298b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 25308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; 25318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth A2DP, for music */ 25328b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; 25338b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP headphones, for music */ 25348b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 25358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; 25368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP external speaker, for music */ 25378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 25388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; 25398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for S/PDIF or HDMI */ 25408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; 25418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for an analog wired headset attached via a 25428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 25438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 25448b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; 25458b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a digital wired headset attached via a 25468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 25478b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 25488b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; 254959f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent /** {@hide} The audio output device code for a USB audio accessory. The accessory is in USB host 255059f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB device mode 255159f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 255259f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_ACCESSORY = AudioSystem.DEVICE_OUT_USB_ACCESSORY; 255359f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent /** {@hide} The audio output device code for a USB audio device. The device is in USB device 255459f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB host mode 255559f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 255659f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_DEVICE = AudioSystem.DEVICE_OUT_USB_DEVICE; 25578b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} This is not used as a returned value from {@link #getDevicesForStream}, but could be 25588b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * used in the future in a set method to select whatever default device is chosen by the 25598b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * platform-specific implementation. 25608b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 25618b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; 25628b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 25638b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** 25648b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Return the enabled devices for the specified output stream type. 25658b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 25668b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @param streamType The stream type to query. One of 25678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_VOICE_CALL}, 25688b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_SYSTEM}, 25698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_RING}, 25708b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_MUSIC}, 25718b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_ALARM}, 25728b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_NOTIFICATION}, 25738b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_DTMF}. 25748b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 25758b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @return The bit-mask "or" of audio output device codes for all enabled devices on this 25768b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * stream. Zero or more of 25778b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_EARPIECE}, 25788b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_SPEAKER}, 25798b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADSET}, 25808b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}, 25818b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO}, 25828b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, 25838b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, 25848b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, 25858b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, 25868b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, 25878b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_AUX_DIGITAL}, 25888b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, 25898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. 25908b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DEFAULT} is not used here. 25918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 25928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * The implementation may support additional device codes beyond those listed, so 25938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * the application should ignore any bits which it does not recognize. 25948b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Note that the information may be imprecise when the implementation 25958b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * cannot distinguish whether a particular device is enabled. 25968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 25978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@hide} 25988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 25998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public int getDevicesForStream(int streamType) { 26008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten switch (streamType) { 26018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_VOICE_CALL: 26028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_SYSTEM: 26038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_RING: 26048b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_MUSIC: 26058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_ALARM: 26068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_NOTIFICATION: 26078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_DTMF: 26088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return AudioSystem.getDevicesForStream(streamType); 26098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten default: 26108b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return 0; 26118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 26128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 26138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2614b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 2615b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * Indicate wired accessory connection state change. 2616b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device type of device connected/disconnected (AudioManager.DEVICE_OUT_xxx) 2617b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state: 1 connected, 0 disconnected 2618b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param name device name 2619b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 2620b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 2621b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent public void setWiredDeviceConnectionState(int device, int state, String name) { 2622b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 2623b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 2624b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent service.setWiredDeviceConnectionState(device, state, name); 2625b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 2626b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setWiredDeviceConnectionState "+e); 2627b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2628b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2629b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 2630b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 2631b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * Indicate A2DP sink connection state change. 2632b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device Bluetooth device connected/disconnected 2633b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state (BluetoothProfile.STATE_xxx) 2634b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @return a delay in ms that the caller should wait before broadcasting 2635b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED intent. 2636b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 2637b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 2638b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent public int setBluetoothA2dpDeviceConnectionState(BluetoothDevice device, int state) { 2639b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 2640b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent int delay = 0; 2641b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 2642b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent delay = service.setBluetoothA2dpDeviceConnectionState(device, state); 2643b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 2644b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setBluetoothA2dpDeviceConnectionState "+e); 2645b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } finally { 2646b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent return delay; 2647b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2648b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2649b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 2650098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey /** {@hide} */ 2651098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey public IRingtonePlayer getRingtonePlayer() { 2652098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey try { 2653098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return getService().getRingtonePlayer(); 2654098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } catch (RemoteException e) { 2655098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return null; 2656098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 2657098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 2658228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2659228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 266062796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output sample rate 266162796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal Hz. 2662228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2663228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_SAMPLE_RATE = 2664228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_SAMPLE_RATE"; 2665228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2666228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 266762796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output buffer size 266862796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal PCM frames. 2669228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2670228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_FRAMES_PER_BUFFER = 2671228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_FRAMES_PER_BUFFER"; 2672228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2673228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 267462796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Returns the value of the property with the specified key. 2675228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @param key One of the strings corresponding to a property key: either 267662796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_SAMPLE_RATE} or 267762796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_FRAMES_PER_BUFFER} 2678228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @return A string representing the associated value for that property key, 2679228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * or null if there is no value for that key. 2680228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2681228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public String getProperty(String key) { 2682c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten if (PROPERTY_OUTPUT_SAMPLE_RATE.equals(key)) { 2683c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputSampleRate = AudioSystem.getPrimaryOutputSamplingRate(); 2684c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputSampleRate > 0 ? Integer.toString(outputSampleRate) : null; 2685c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else if (PROPERTY_OUTPUT_FRAMES_PER_BUFFER.equals(key)) { 2686c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputFramesPerBuffer = AudioSystem.getPrimaryOutputFrameCount(); 2687c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputFramesPerBuffer > 0 ? Integer.toString(outputFramesPerBuffer) : null; 2688c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else { 2689c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten // null or unknown key 2690c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return null; 2691c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } 2692228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten } 2693228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 269461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 269561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns the estimated latency for the given stream type in milliseconds. 269661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 269761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 269861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 269961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 270061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 270161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getOutputLatency(int streamType) { 270261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return AudioSystem.getOutputLatency(streamType); 270361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 270461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 27059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2706