AudioManager.java revision 79f7ec70ebd5758ce54fd5b6fcd60fd27457cba6
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.media; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant.SdkConstantType; 21f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Triviimport android.app.PendingIntent; 22b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurentimport android.bluetooth.BluetoothDevice; 23d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.content.ComponentName; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 25f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Triviimport android.content.Intent; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 29d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Looper; 30d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Message; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 3286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.os.SystemClock; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.ServiceManager; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.provider.Settings; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 36d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.view.KeyEvent; 3786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.view.VolumePanel; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 39d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport java.util.HashMap; 40d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioManager provides access to volume and ringer mode control. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use <code>Context.getSystemService(Context.AUDIO_SERVICE)</code> to get 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an instance of this class. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioManager { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Context mContext; 5086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato private long mVolumeKeyUpTime; 51cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood private final boolean mUseMasterVolume; 52b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate private final boolean mUseVolumeKeySounds; 5379f7ec70ebd5758ce54fd5b6fcd60fd27457cba6Dianne Hackborn private final Binder mToken = new Binder(); 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String TAG = "AudioManager"; 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent, a hint for applications that audio is about to become 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'noisy' due to a change in audio outputs. For example, this intent may 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent when a wired headset is unplugged, or when an A2DP audio 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sink is disconnected, and the audio system is about to automatically 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch audio route to the speaker. Applications that are controlling 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * audio streams may consider pausing, reducing volume or some other action 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on receipt of this intent so as not to surprise the user with audio 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the speaker. 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sticky broadcast intent action indicating that the ringer mode has 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the new ringer mode. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_RINGER_MODE 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new ringer mode. 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_CHANGED_ACTION 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_NORMAL 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_SILENT 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_VIBRATE 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the vibrate setting has 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the vibrate type and its new setting. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_SETTING 94cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 95cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 980dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String VIBRATE_SETTING_CHANGED_ACTION = 990dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.VIBRATE_SETTING_CHANGED"; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Broadcast intent when the volume for a particular stream type changes. 1033114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Includes the stream, the new volume and previous volumes. 1043114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Notes: 1053114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - for internal platform use only, do not make public, 1063114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * - never used for "remote" volume changes 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_TYPE 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_VALUE 1109ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @see #EXTRA_PREV_VOLUME_STREAM_VALUE 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1160dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master volume changes. 1170dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the new volume 1180dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1190dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_VALUE 1200dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_PREV_MASTER_VOLUME_VALUE 1210dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1220dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1230dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_VOLUME_CHANGED_ACTION = 1240dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_VOLUME_CHANGED_ACTION"; 1250dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1260dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1270dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide Broadcast intent when the master mute state changes. 1280dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Includes the the new volume 1290dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * 1300dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @see #EXTRA_MASTER_VOLUME_MUTED 1310dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1320dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1330dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String MASTER_MUTE_CHANGED_ACTION = 1340dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.MASTER_MUTE_CHANGED_ACTION"; 1350dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1360dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new vibrate setting for a particular type. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ON 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_OFF 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ONLY_SILENT 144cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 145cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The vibrate type whose setting has changed. 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_NOTIFICATION 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_RINGER 155cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 156cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode and listen to {@link #RINGER_MODE_CHANGED_ACTION} instead. 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The stream type for the volume changed intent. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The volume associated with the stream for the volume changed intent. 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_VALUE = 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.media.EXTRA_VOLUME_STREAM_VALUE"; 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent /** 1729ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @hide The previous volume associated with the stream for the volume changed intent. 1739ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent */ 1749ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = 1759ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; 1760dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1770dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1780dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume value for the master volume changed intent. 1790dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is integer between 0 and 100 inclusive. 1800dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1810dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_VALUE = 1820dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_VALUE"; 1830dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1840dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1850dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The previous master volume value for the master volume changed intent. 1860dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is integer between 0 and 100 inclusive. 1870dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1880dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_PREV_MASTER_VOLUME_VALUE = 1890dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_PREV_MASTER_VOLUME_VALUE"; 1900dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood 1910dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood /** 1920dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * @hide The new master volume mute state for the master mute changed intent. 1930dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood * Value is boolean 1940dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood */ 1950dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood public static final String EXTRA_MASTER_VOLUME_MUTED = 1960dc37cce9d564ae43883c8dc8672b9266b881e63Mike Lockwood "android.media.EXTRA_MASTER_VOLUME_MUTED"; 1979ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for phone calls */ 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for system sounds */ 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for the phone ring */ 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = AudioSystem.STREAM_RING; 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for music playback */ 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for alarms */ 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for notifications */ 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide The audio stream for phone calls when connected to bluetooth */ 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; 212a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 213a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; 214a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** The audio stream for DTMF Tones */ 215a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; 216a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for text to speech (TTS) */ 217a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = AudioSystem.STREAM_TTS; 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Number of audio streams */ 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use AudioSystem.getNumStreamTypes() instead 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 222a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide Default volume index values for audio streams */ 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int[] DEFAULT_STREAM_VOLUME = new int[] { 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4, // STREAM_VOICE_CALL 2289d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_RING 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11, // STREAM_MUSIC 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6, // STREAM_ALARM 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_NOTIFICATION 233a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 7, // STREAM_BLUETOOTH_SCO 2349d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM_ENFORCED 235a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11, // STREAM_DTMF 236a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11 // STREAM_TTS 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Increase the ringer volume. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_RAISE = 1; 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decrease the ringer volume. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_LOWER = -1; 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maintain the previous ringer volume. This may be useful when needing to 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * show the volume toast without actually modifying the volume. 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_SAME = 0; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Flags should be powers of 2! 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Show a toast containing the current volume. 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_SHOW_UI = 1 << 0; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to include ringer modes as possible options when changing volume. 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if true and volume level is 0 and the volume is adjusted 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate mode. 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * By default this is on for the ring stream. If this flag is included, 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this behavior will be present regardless of the stream type being 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affected by the ringer mode. 285105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to play a sound when changing the volume. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is given to {@link #adjustVolume(int, int)} or 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in some cases (for example, the decided stream type is not 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_RING}, or the volume is being adjusted 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * downward). 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_PLAY_SOUND = 1 << 2; 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any sounds/vibrate that may be in the queue, or are playing (related to 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changing volume). 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to vibrate if going into the vibrate ringer mode. 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_VIBRATE = 1 << 4; 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3184bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * Indicates to VolumePanel that the volume slider should be disabled as user 3194bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * cannot change the stream volume 3204bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent * @hide 3214bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent */ 3224bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent public static final int FLAG_FIXED_VOLUME = 1 << 5; 3234bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent 3244bbcc6549738f3d69831b2bd9eb4accec3e9920eEric Laurent /** 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will not vibrate. (This overrides the 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate setting.) 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_SILENT = 0; 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will vibrate. (This will cause the 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone ringer to always vibrate, but the notification vibrate to only 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate if set.) 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_VIBRATE = 1; 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that may be audible and may vibrate. It will be audible if 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the volume before changing out of this mode was audible. It will vibrate 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the vibrate setting is on. 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_NORMAL = 2; 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 35372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent // maximum valid ringer mode value. Values must start from 0 and be contiguous. 35472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent private static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; 35572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to the ringer. 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 362cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 363cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_RINGER = 0; 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to notifications. 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 373cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 374cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_NOTIFICATION = 1; 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to never vibrate. 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 383cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 384cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_OFF = 0; 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to vibrate when possible. 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 393cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 394cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ON = 1; 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to only vibrate when in the vibrate ringer 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 404cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 405cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ONLY_SILENT = 2; 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Suggests using the default stream type. This may not be used in all 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * places a stream type is needed. 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService sService; 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioManager(Context context) { 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContext = context; 422cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood mUseMasterVolume = mContext.getResources().getBoolean( 423cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood com.android.internal.R.bool.config_useMasterVolume); 424b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate mUseVolumeKeySounds = mContext.getResources().getBoolean( 425b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate com.android.internal.R.bool.config_useVolumeKeySounds); 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService getService() 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sService != null) { 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sService = IAudioService.Stub.asInterface(b); 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 43986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 44086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 441ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void preDispatchKeyEvent(KeyEvent event, int stream) { 44286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 44386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * If the user hits another key within the play sound delay, then 44486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * cancel the sound 44586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 446ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 44786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP 44886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE 44986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && mVolumeKeyUpTime + VolumePanel.PLAY_SOUND_DELAY 45086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato > SystemClock.uptimeMillis()) { 45186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 45286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * The user has hit another key during the delay (e.g., 300ms) 45386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * since the last volume key up, so cancel any sounds. 45486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 455cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 4568dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood adjustMasterVolume(ADJUST_SAME, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 457cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 458cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume(ADJUST_SAME, 45986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 460cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 46186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 46286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 46386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 46486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 46586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 46686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 467ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyDown(KeyEvent event, int stream) { 468ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 46986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 47086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 47186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 47286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 47386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Adjust the volume in on key down since it is more 47486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * responsive to the user. 47586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 476402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent int flags = FLAG_SHOW_UI | FLAG_VIBRATE; 477b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate 478cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 479cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustMasterVolume( 480cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 481cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 4828dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood : ADJUST_LOWER, 4838dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood flags); 484cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 485cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume( 486cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 487cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 488cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood : ADJUST_LOWER, 489cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood stream, 490cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood flags); 491402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 49286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 49386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 494ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (event.getRepeatCount() == 0) { 495ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood if (mUseMasterVolume) { 496ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood setMasterMute(!isMasterMute()); 497ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } else { 498ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood // TODO: Actually handle MUTE. 499ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 500ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 50186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 50286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 50386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 50486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 50586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 50686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 50786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 508ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void handleKeyUp(KeyEvent event, int stream) { 509ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood int keyCode = event.getKeyCode(); 51086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 51186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 51286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 51386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 51486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Play a sound. This is done on key up since we don't want the 51586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * sound to play when a user holds down volume down to mute. 51686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 517b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseVolumeKeySounds) { 518b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate if (mUseMasterVolume) { 519c4b78d206ffcdccac01e3436a4a3462bef9672edChristopher Tate adjustMasterVolume(ADJUST_SAME, FLAG_PLAY_SOUND); 520b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate } else { 521b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate int flags = FLAG_PLAY_SOUND; 522b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate adjustSuggestedStreamVolume( 523b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate ADJUST_SAME, 524b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate stream, 525b89ce434993cca883818ab38f98c0b29d77e7aa2Christopher Tate flags); 526cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 527402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 52886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato mVolumeKeyUpTime = SystemClock.uptimeMillis(); 52986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 53086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 53186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 53286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 53386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of a particular stream by one step in a direction. 535fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 536fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 537fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_ALARM} 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustStreamVolume(int streamType, int direction, int flags) { 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5524767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 5534767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.adjustMasterVolume(direction, flags); 5544767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 5554767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.adjustStreamVolume(streamType, direction, flags); 5564767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustStreamVolume", e); 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream. For example, if a call is 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active, it will have the highest priority regardless of if the in-call 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen is showing. Another example, if music is playing in the background 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and a call is not active, the music stream will be adjusted. 567fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 568fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 569fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustSuggestedStreamVolume(int, int, int) 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustVolume(int direction, int flags) { 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5824767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 5834767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.adjustMasterVolume(direction, flags); 5844767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 5854767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.adjustVolume(direction, flags); 5864767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustVolume", e); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream, or the given fallback 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stream. 595fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 596fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 597fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param suggestedStreamType The stream type that will be used if there 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is valid here. 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6124767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 6134767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.adjustMasterVolume(direction, flags); 6144767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 6154767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.adjustSuggestedStreamVolume(direction, suggestedStreamType, flags); 6164767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 618cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustSuggestedStreamVolume", e); 619cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 620cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 621cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood 622cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood /** 623cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * Adjusts the master volume for the device's audio amplifier. 624cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * <p> 625cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * 6266c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang * @param steps The number of volume steps to adjust. A positive 6276c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang * value will raise the volume. 6288dc1dabd254249b7ddb8743e88fdb96580ffc585Mike Lockwood * @param flags One or more flags. 629e3f5979307fa52898459d9d09ee11bc1d65a4f7fJason Simmons * @hide 630cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood */ 6316c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang public void adjustMasterVolume(int steps, int flags) { 632cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood IAudioService service = getService(); 633cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood try { 6346c798970ccb8759d1e613b57111daa8da0ab44c7Lei Zhang service.adjustMasterVolume(steps, flags); 635cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } catch (RemoteException e) { 636cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustMasterVolume", e); 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current ringtone mode. 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRingerMode() { 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getRingerMode(); 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getRingerMode", e); 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return RINGER_MODE_NORMAL; 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 65872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * Checks valid ringer mode values. 65972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 66072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @return true if the ringer mode indicated is valid, false otherwise. 66172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 66272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @see #setRingerMode(int) 66372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @hide 66472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent */ 66572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent public static boolean isValidRingerMode(int ringerMode) { 66672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { 66772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return false; 66872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 66972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return true; 67072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 67172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 67272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent /** 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum volume index for a particular stream. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose maximum volume index is returned. 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The maximum valid volume index for the stream. 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamMaxVolume(int streamType) { 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6824767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 6834767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getMasterMaxVolume(); 6844767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 6854767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getStreamMaxVolume(streamType); 6864767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamMaxVolume", e); 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current volume index for a particular stream. 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose volume index is returned. 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current volume index for the stream. 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamVolume(int streamType) { 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7044767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 7054767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getMasterVolume(); 7064767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 7074767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getStreamVolume(streamType); 7084767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamVolume", e); 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 71625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * Get last audible volume before stream was muted. 71725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 71825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 71925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 72025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public int getLastAudibleStreamVolume(int streamType) { 72125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 72225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 7234767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 724ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.getLastAudibleMasterVolume(); 7254767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 7264767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood return service.getLastAudibleStreamVolume(streamType); 7274767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 72825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 72925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); 73025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return 0; 73125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 73225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 73325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 73425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 7356d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * Get the stream type whose volume is driving the UI sounds volume. 7366d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * UI sounds are screen lock/unlock, camera shutter, key clicks... 7376d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent * @hide 7386d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent */ 7396d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent public int getMasterStreamType() { 7406d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent IAudioService service = getService(); 7416d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent try { 7426d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return service.getMasterStreamType(); 7436d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } catch (RemoteException e) { 7446d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent Log.e(TAG, "Dead object in getMasterStreamType", e); 7456d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent return STREAM_RING; 7466d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 7476d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent } 7486d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent 7496d5176638c2189595cede38fb92c3e7e8700e221Eric Laurent /** 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the ringer mode. 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Silent mode will mute the volume and will not vibrate. Vibrate mode will 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mute the volume and vibrate. Normal mode will be audible and may vibrate 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * according to user settings. 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRingerMode(int ringerMode) { 76172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (!isValidRingerMode(ringerMode)) { 76272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return; 76372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setRingerMode(ringerMode); 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setRingerMode", e); 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the volume index for a particular stream. 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream whose volume index should be set. 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The volume index to set. See 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getStreamMaxVolume(int)} for the largest valid value. 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamVolume(int streamType, int index, int flags) { 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7854767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood if (mUseMasterVolume) { 7864767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.setMasterVolume(index, flags); 7874767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } else { 7884767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood service.setStreamVolume(streamType, index, flags); 7894767690f09ea3447b8c5c32fb28d27650aa18e00Mike Lockwood } 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamVolume", e); 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 796fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Returns the maximum volume index for master volume. 797fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 798fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 799fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 800fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getMasterMaxVolume() { 801fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 802fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 803fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getMasterMaxVolume(); 804fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 805fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getMasterMaxVolume", e); 806fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 807fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 808fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 809fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 810fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 811fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Returns the current volume index for master volume. 812fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 813fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @return The current volume index for master volume. 814fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 815fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 816fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getMasterVolume() { 817fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 818fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 819fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getMasterVolume(); 820fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 821fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getMasterVolume", e); 822fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 823fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 824fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 825fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 826fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 827fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Get last audible volume before master volume was muted. 828fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 829fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 830fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 831fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public int getLastAudibleMasterVolume() { 832fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 833fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 834fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return service.getLastAudibleMasterVolume(); 835fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 836fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in getLastAudibleMasterVolume", e); 837fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood return 0; 838fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 839fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 840fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 841fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 842fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * Sets the volume index for master volume. 843fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * 844fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @param index The volume index to set. See 845fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * {@link #getMasterMaxVolume(int)} for the largest valid value. 846fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @param flags One or more flags. 847fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @see #getMasterMaxVolume(int) 848fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @see #getMasterVolume(int) 849fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood * @hide 850fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood */ 851fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood public void setMasterVolume(int index, int flags) { 852fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood IAudioService service = getService(); 853fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood try { 854fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood service.setMasterVolume(index, flags); 855fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } catch (RemoteException e) { 856fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood Log.e(TAG, "Dead object in setMasterVolume", e); 857fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 858fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood } 859fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood 860fa7b06147c2d0f0c64fa334ed5a971cbad7cdbe5Mike Lockwood /** 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Solo or unsolo a particular stream. All other streams are muted. 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo command is protected against client process death: if a process 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active solo request on a stream dies, all streams that were muted 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because of this request will be unmuted automatically. 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo requests for a given stream are cumulative: the AudioManager 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several solo requests from one or more clients and the stream 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unsoloed only when the same number of unsolo requests are received. 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unsolo a soloed stream 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and solo is again in onResume() if appropriate. 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be soloed/unsoloed. 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required solo state: true for solo ON, false for solo OFF 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamSolo(int streamType, boolean state) { 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamSolo(streamType, state, mICallBack); 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamSolo", e); 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mute or unmute an audio stream. 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute command is protected against client process death: if a process 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active mute request on a stream dies, this stream will be unmuted 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * automatically. 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute requests for a given stream are cumulative: the AudioManager 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several mute requests from one or more clients and the stream 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unmuted only when the same number of unmute requests are received. 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unmute a muted stream 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and mute is again in onResume() if appropriate. 899fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 900fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 901fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be muted/unmuted. 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required mute state: true for mute ON, false for mute OFF 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamMute(int streamType, boolean state) { 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamMute(streamType, state, mICallBack); 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamMute", e); 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 91625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * get stream mute state. 91725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 91825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 91925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 92025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public boolean isStreamMute(int streamType) { 92125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 92225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 92325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return service.isStreamMute(streamType); 92425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 92525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in isStreamMute", e); 92625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return false; 92725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 92825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 92925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 93025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 931ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * set master mute state. 932ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 933ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 934ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 935ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public void setMasterMute(boolean state) { 9360273af55cf68d54d26d154b44d105d40fed79701Justin Koh setMasterMute(state, FLAG_SHOW_UI); 9370273af55cf68d54d26d154b44d105d40fed79701Justin Koh } 9380273af55cf68d54d26d154b44d105d40fed79701Justin Koh 9390273af55cf68d54d26d154b44d105d40fed79701Justin Koh /** 9400273af55cf68d54d26d154b44d105d40fed79701Justin Koh * set master mute state with optional flags. 9410273af55cf68d54d26d154b44d105d40fed79701Justin Koh * 9420273af55cf68d54d26d154b44d105d40fed79701Justin Koh * @hide 9430273af55cf68d54d26d154b44d105d40fed79701Justin Koh */ 9440273af55cf68d54d26d154b44d105d40fed79701Justin Koh public void setMasterMute(boolean state, int flags) { 945ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 946ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 9470273af55cf68d54d26d154b44d105d40fed79701Justin Koh service.setMasterMute(state, flags, mICallBack); 948ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 949ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in setMasterMute", e); 950ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 951ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 952ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 953ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 954ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * get master mute state. 955ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * 956ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood * @hide 957ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood */ 958ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood public boolean isMasterMute() { 959ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood IAudioService service = getService(); 960ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood try { 961ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return service.isMasterMute(); 962ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } catch (RemoteException e) { 963ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood Log.e(TAG, "Dead object in isMasterMute", e); 964ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood return false; 965ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 966ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood } 967ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood 968ce952c8e13c535bedde77bcdb94dfcc7508475aaMike Lockwood /** 969402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces the stream controlled by hard volume keys 970402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * specifying streamType == -1 releases control to the 971402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * logic. 972402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * 973402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 974402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 975402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public void forceVolumeControlStream(int streamType) { 97645c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent IAudioService service = getService(); 97745c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent try { 97845c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent service.forceVolumeControlStream(streamType, mICallBack); 97945c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } catch (RemoteException e) { 98045c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent Log.e(TAG, "Dead object in forceVolumeControlStream", e); 98145c90cefd13a03b852bb4b8da4be218876cbbb32Eric Laurent } 982402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 983402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 984402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether a particular type should vibrate according to user 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings and the current ringer mode. 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that use notifications to 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate. The notification manager will not vibrate if the policy doesn't 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it, so the client should always set a vibrate pattern and let the 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * notification manager control whether or not to actually vibrate. 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether the type should vibrate at the instant this method is 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 1000cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1001cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldVibrate(int vibrateType) { 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.shouldVibrate(vibrateType); 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in shouldVibrate", e); 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether the user's vibrate setting for a vibrate type. 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that want to vibrate, instead 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link #shouldVibrate(int)}. 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1027cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1028cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getVibrateSetting(int vibrateType) { 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getVibrateSetting(vibrateType); 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getVibrateSetting", e); 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return VIBRATE_SETTING_OFF; 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the setting for when the vibrate type should vibrate. 1042fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1043fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1044fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateSetting The vibrate setting, one of 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ON}, 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 1055cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * @deprecated Applications should maintain their own vibrate policy based on 1056cd1cd73baec1f93d21f67fdded5466e507431ebaEric Laurent * current ringer mode that can be queried via {@link #getRingerMode()}. 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setVibrateSetting(int vibrateType, int vibrateSetting) { 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setVibrateSetting(vibrateType, vibrateSetting); 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setVibrateSetting", e); 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the speakerphone on or off. 1069fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1070fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1071fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to turn on speakerphone; 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn it off 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpeakerphoneOn(boolean on){ 1077c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1078c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1079c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setSpeakerphoneOn(on); 1080c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1081c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setSpeakerphoneOn", e); 1082a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the speakerphone is on or off. 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if speakerphone is on, false if it's off 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSpeakerphoneOn() { 1091c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1092c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1093c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isSpeakerphoneOn(); 1094c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1095c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isSpeakerphoneOn", e); 1096a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1097a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11003def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent //==================================================================== 11013def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent // Bluetooth SCO control 11023def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 11033def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 110495b88fbe744d8ce53b5f54f6fcd90c55094a8d14Eric Laurent * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} 11053def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} 11063def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * or {@link #SCO_AUDIO_STATE_CONNECTED} 11073def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * 11083def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 1109dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead 11103def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 1111dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @Deprecated 11123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 11133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_CHANGED = 11143def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.SCO_AUDIO_STATE_CHANGED"; 1115dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1116dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1117dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 1118dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * connection state has been updated. 1119dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>This intent has two extras: 1120dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1121dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_STATE} - The new SCO audio state. </li> 1122dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE}- The previous SCO audio state. </li> 1123dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1124dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p> EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: 1125dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1126dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_DISCONNECTED}, </li> 1127dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTING} or </li> 1128dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTED}, </li> 1129dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 1130dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #startBluetoothSco() 1131dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1132dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1133dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_UPDATED = 1134dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; 1135dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 11363def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1137dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or 1138dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. 11393def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 11403def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String EXTRA_SCO_AUDIO_STATE = 11413def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.extra.SCO_AUDIO_STATE"; 11423def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 11433def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1144dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous 1145dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * bluetooth SCO connection state. 1146dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1147dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = 1148dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; 1149dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 1150dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1151dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1152dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is not established 11533def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 11543def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; 11553def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1156dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} 1157dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is established 11583def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 11593def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTED = 1; 11603def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 1161dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 1162dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is being established 1163dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 1164dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTING = 2; 1165dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 1166dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE indicating that 11673def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * there was an error trying to obtain the state 11683def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 11693def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_ERROR = -1; 11703def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 11713def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 11723def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 11733def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Indicates if current platform supports use of SCO for off call use cases. 11743def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Application wanted to use bluetooth SCO audio when the phone is not in call 11752ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi * must first call this method to make sure that the platform supports this 11763def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * feature. 11773def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @return true if bluetooth SCO can be used for audio when not in call 11783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * false otherwise 11793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 11803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 11813def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public boolean isBluetoothScoAvailableOffCall() { 11823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent return mContext.getResources().getBoolean( 11833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent com.android.internal.R.bool.config_bluetooth_sco_off_call); 11843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 11853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 11863def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 11873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Start bluetooth SCO audio connection. 11883def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 11893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 11903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method can be used by applications wanting to send and received audio 11913def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * to/from a bluetooth SCO headset while the phone is not in call. 11923def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>As the SCO connection establishment can take several seconds, 11933def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * applications should not rely on the connection to be available when the method 1194dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} 11953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. 1196dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO 1197dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * audio state before calling startBluetoothSco() by reading the intent returned by the receiver 1198dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * registration. If the state is already CONNECTED, no state change will be received via the 1199dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() 1200dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * so that the connection stays active in case the current initiator stops the connection. 1201dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>Unless the connection is already active as described above, the state will always 1202dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection 1203dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). 1204dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>When finished with the SCO connection or if the establishment fails, the application must 1205dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. 12063def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Even if a SCO connection is established, the following restrictions apply on audio 12073def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * output streams so that they can be routed to SCO headset: 1208dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1209dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the stream type must be {@link #STREAM_VOICE_CALL} </li> 1210dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1211dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 16kHz or 8kHz </li> 1212dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 12133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>The following restrictions apply on input streams: 1214dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 1215dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 1216dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 8kHz </li> 1217dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 12183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Note that the phone application always has the priority on the usage of the SCO 12193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * connection for telephony. If this method is called while the phone is in call 12203def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * it will be ignored. Similarly, if a call is received or sent while an application 12213def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * is using the SCO connection, the connection will be lost for the application and NOT 12223def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * returned automatically when the call ends. 12233def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #stopBluetoothSco() 1224dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 12253def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12263def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void startBluetoothSco(){ 12273def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 12283def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 12293def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.startBluetoothSco(mICallBack); 12303def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 12313def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in startBluetoothSco", e); 12323def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12333def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12343def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12353def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 12363def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Stop bluetooth SCO audio connection. 12373def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 12383def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 12393def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method must be called by applications having requested the use of 12403def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * bluetooth SCO audio with {@link #startBluetoothSco()} 1241dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * when finished with the SCO connection or if connection fails. 12423def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 12433def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 12443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void stopBluetoothSco(){ 12453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 12463def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 12473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.stopBluetoothSco(mICallBack); 12483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 12493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in stopBluetoothSco", e); 12503def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12513def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 12523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1254a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Request use of Bluetooth SCO headset for communications. 1255fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1256fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1257fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1259a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param on set <var>true</var> to use bluetooth SCO for communications; 1260a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * <var>false</var> to not use bluetooth SCO for communications 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBluetoothScoOn(boolean on){ 1263c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1264c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1265c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setBluetoothScoOn(on); 1266c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1267c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setBluetoothScoOn", e); 1268a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1272a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Checks whether communications use Bluetooth SCO. 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1274a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return true if SCO is used for communications; 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothScoOn() { 1278c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1279c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1280c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isBluetoothScoOn(); 1281c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1282c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isBluetoothScoOn", e); 1283a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1284a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1288242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @param on set <var>true</var> to route A2DP audio to/from Bluetooth 1289242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * headset; <var>false</var> disable A2DP audio 1290a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1292a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setBluetoothA2dpOn(boolean on){ 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1296242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * Checks whether A2DP audio routing to the Bluetooth headset is on or off. 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1298242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * @return true if A2DP audio is being routed to/from Bluetooth headset; 1299242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent * false if otherwise 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothA2dpOn() { 1302242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") 1303242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1304a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1305242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent } else { 1306242b33870b51ea962a1d5c077d71c648eccc2b7aEric Laurent return true; 1307a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13112ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi * @hide 13122ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi * Signals whether remote submix audio rerouting is enabled. 13132ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi */ 13142ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi public void setRemoteSubmixOn(boolean on, int address) { 13152ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi IAudioService service = getService(); 13162ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi try { 13172ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi service.setRemoteSubmixOn(on, address); 13182ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi } catch (RemoteException e) { 13192ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi Log.e(TAG, "Dead object in setRemoteSubmixOn", e); 13202ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi } 13212ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi } 13222ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi 13232ac2afeac989ea1dc326b0db996d6c6c8e00cc29Jean-Michel Trivi /** 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets audio routing to the wired headset on or off. 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route audio to/from wired 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable wired headset audio 1328a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1330a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setWiredHeadsetOn(boolean on){ 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1334497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * Checks whether a wired headset is connected or not. 1335497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * <p>This is not a valid indication that audio playback is 1336497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * actually over the wired headset as audio routing depends on other conditions. 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1338497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @return true if a wired headset is connected. 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 1340497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @deprecated Use only to check is a headset is connected or not. 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWiredHeadsetOn() { 13438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") 13446015a9715421a339c2b7bb63f9166504e3488179Eric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE && 13458b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") 1346a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1347a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1348a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1349a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1350a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 1355fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1356fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1357fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to mute the microphone; 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMicrophoneMute(boolean on){ 1363a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.muteMicrophone(on); 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if microphone is muted, false if it's not 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMicrophoneMute() { 1372a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.isMicrophoneMuted(); 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio mode. 1377fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1378fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * The audio mode encompasses audio routing AND the behavior of 1379fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * the telephony layer. Therefore this method should only be used by applications that 1380fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * replace the platform-wide management of audio settings or the main telephony application. 1381fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony 1382fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * application when it places a phone call, as it will cause signals from the radio layer 1383fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * to feed the platform mixer. 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13858aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 13868aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Informs the HAL about the current audio state so that 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it can route the audio appropriately. 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMode(int mode) { 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13939272b4b4a44fe1f33e3030810618194f817caaecEric Laurent service.setMode(mode, mICallBack); 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setMode", e); 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio mode. 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14028aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 14038aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current current audio state from the HAL. 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMode() { 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getMode(); 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getMode", e); 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return MODE_INVALID; 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* modes for setMode/getMode/setRoute/getRoute */ 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Audio harware modes. 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalid audio mode. 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = AudioSystem.MODE_INVALID; 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Current audio mode. Used to apply audio routing to current mode. 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normal audio mode: not ringing and no call established. 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringing audio mode. An incoming is being signaled. 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14378f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In call audio mode. A telephony call is established. 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; 14408f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi /** 14418f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In communication audio mode. An audio/video chat or VoIP call is established. 14428f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi */ 14438f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Routing bits for setRouting/getRouting API */ 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to earpiece 14484a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14494a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1451a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14534a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * Routing audio output to speaker 14544a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14554a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1457a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} 14604a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14614a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth SCO 14664a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14674a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1469a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to headset 14724a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14734a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1475a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth A2DP 14784a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14794a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1481a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used for mask parameter of {@link #setRouting(int,int,int)}. 14844a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 14854a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1487a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio routing for a specified mode 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to change route. E.g., MODE_RINGTONE. 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param routes bit vector of routes requested, created from one or 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more of ROUTE_xxx types. Set bits indicate that route should be on 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mask bit vector of routes to change, created from one or more of 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ROUTE_xxx types. Unset bits indicate the route should be left unchanged 1497b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * 1498b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 1499a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * setBluetoothScoOn() methods instead. 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1501a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRouting(int mode, int routes, int mask) { 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio routing bit vector for a specified mode. 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to get route (e.g., MODE_RINGTONE) 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an audio route bit vector that can be compared with ROUTE_xxx 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bits 1511b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), 1512b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1514b9c9d260f21b321527c4622a123af9767630d94dEric Laurent @Deprecated 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRouting(int mode) { 1516a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return -1; 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether any music is active. 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if any music tracks are active. 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMusicActive() { 152525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return AudioSystem.isStreamActive(STREAM_MUSIC, 0); 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15283114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi /** 15293114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * @hide 1530679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * Checks whether any music or media is actively playing on a remote device (e.g. wireless 1531679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * display). Note that BT audio sinks are not considered remote devices. 1532679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @return true if {@link AudioManager#STREAM_MUSIC} is active on a remote device 1533679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi */ 1534679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi public boolean isMusicActiveRemotely() { 1535679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi return AudioSystem.isStreamActiveRemotely(STREAM_MUSIC, 0); 1536679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi } 1537679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi 1538679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi /** 1539679d5046f245ea8b39f9b5596195f3468808dd54Jean-Michel Trivi * @hide 1540d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi * Checks whether speech recognition is active 1541d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi * @return true if a recording with source {@link MediaRecorder.AudioSource#VOICE_RECOGNITION} 1542d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi * is underway. 1543d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi */ 1544d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi public boolean isSpeechRecognitionActive() { 1545d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi return AudioSystem.isSourceActive(MediaRecorder.AudioSource.VOICE_RECOGNITION); 1546d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi } 1547d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi 1548d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi /** 1549d677054ca63f55abaa1c478ea3c50f6be665a979Jean-Michel Trivi * @hide 15503114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * If the stream is active locally or remotely, adjust its volume according to the enforced 15513114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * priority rules. 15523114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi * Note: only AudioManager.STREAM_MUSIC is supported at the moment 15533114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi */ 15543114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi public void adjustLocalOrRemoteStreamVolume(int streamType, int direction) { 15553114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi if (streamType != STREAM_MUSIC) { 15563114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi Log.w(TAG, "adjustLocalOrRemoteStreamVolume() doesn't support stream " + streamType); 15573114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } 15583114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi IAudioService service = getService(); 15593114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi try { 15603114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi service.adjustLocalOrRemoteStreamVolume(streamType, direction); 15613114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } catch (RemoteException e) { 15623114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi Log.e(TAG, "Dead object in adjustLocalOrRemoteStreamVolume", e); 15633114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } 15643114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi } 15653114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a generic audio configuration parameter. The use of these parameters 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are platform dependant, see libaudio 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Temporary interface - DO NOT USE 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * TODO: Replace with a more generic key:value get/set mechanism 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param key name of parameter to set. Must not be null. 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param value value of parameter. Must not be null. 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1579a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Use {@link #setPrameters(String)} instead 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1581a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setParameter(String key, String value) { 1582a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent setParameters(key+"="+value); 1583a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1584a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1585a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1586a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a variable number of parameter values to audio hardware. 1587a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1588a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keyValuePairs list of parameters key value pairs in the form: 1589a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1590a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1591a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1592a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public void setParameters(String keyValuePairs) { 1593a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.setParameters(keyValuePairs); 1594a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1595a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1596a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1597aac753dcf8862b416773eabaabb9d938a30f5896John Spurlock * Gets a variable number of parameter values from audio hardware. 1598a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1599a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keys list of parameters 1600a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return list of parameters key value pairs in the form: 1601a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1602a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1603a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public String getParameters(String keys) { 1604a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.getParameters(keys); 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Sound effect identifiers */ 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Keyboard and direction pad click sound 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEY_CLICK = 0; 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved up 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_UP = 1; 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved down 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_DOWN = 2; 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved left 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_LEFT = 3; 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved right 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME standard keypress sound 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_STANDARD = 5; 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME spacebar keypress sound 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_SPACEBAR = 6; 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME delete keypress sound 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_DELETE = 7; 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME return_keypress sound 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_RETURN = 8; 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Number of sound effects 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int NUM_SOUND_EFFECTS = 9; 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1666105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1667105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1668105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1669105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version uses the UI settings to determine 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whether sounds are heard or not. 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType) { 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!querySoundEffectsEnabled()) { 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffect(effectType); 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1698105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1699105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1700105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1701105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1702a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * @param volume Sound effect volume. 1703a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * The volume value is a raw scalar so UI controls should be scaled logarithmically. 1704a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version is for applications that have their own 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings panel for enabling and controlling volume. 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType, float volume) { 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffectVolume(effectType, volume); 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings has an in memory cache, so this is fast. 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean querySoundEffectsEnabled() { 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Settings.System.getInt(mContext.getContentResolver(), Settings.System.SOUND_EFFECTS_ENABLED, 0) != 0; 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Load Sound effects. 17319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method must be called when sound effects are enabled. 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void loadSoundEffects() { 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.loadSoundEffects(); 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in loadSoundEffects"+e); 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unload Sound effects. 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method can be called to free some memory when 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sound effects are disabled. 17469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unloadSoundEffects() { 17489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.unloadSoundEffects(); 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 17529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in unloadSoundEffects"+e); 17539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17564050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent /** 1757d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. 17587f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1759d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1760d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1761d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN = 1; 1762d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1763d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a temporary gain or request of audio focus, anticipated to last a short 1764d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * amount of time. Examples of temporary changes are the playback of driving directions, or an 1765d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * event notification. 17667f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1767d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1768d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1769d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; 1770078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1771078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 1772983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * amount of time, and where it is acceptable for other audio applications to keep playing 1773983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * after having lowered their output level (also referred to as "ducking"). 1774078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Examples of temporary changes are the playback of driving directions where playback of music 1775078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * in the background is acceptable. 17767f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1777078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1778078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1779078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; 1780078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1781078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a loss of audio focus of unknown duration. 17827f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1783078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1784078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; 1785078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1786078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus. 17877f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1788078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1789078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; 1790078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1791078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus where the loser of the audio focus can 1792983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * lower its output volume if it wants to continue playing (also referred to as "ducking"), as 1793983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the new focus owner doesn't require others to be silent. 17947f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1795078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1796078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = 1797078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; 1798d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1799d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1800d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Interface definition for a callback to be invoked when the audio focus of the system is 1801d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * updated. 1802d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1803d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public interface OnAudioFocusChangeListener { 1804d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1805d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Called on the listener to notify it the audio focus for this listener has been changed. 1806d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * The focusChange value indicates whether the focus was gained, 1807d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * whether the focus was lost, and whether that loss is transient, or whether the new focus 1808d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * holder will hold it for an unknown amount of time. 1809983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * When losing focus, listeners can use the focus change information to decide what 1810983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * behavior to adopt when losing focus. A music player could for instance elect to lower 1811983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the volume of its music stream (duck) for transient focus losses, and pause otherwise. 1812983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, 1813078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} 1814983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. 1815d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 18167f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi public void onAudioFocusChange(int focusChange); 1817d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1818d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1819d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1820d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, 1821d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * to actual listener objects. 1822d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 182330c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final HashMap<String, OnAudioFocusChangeListener> mAudioFocusIdListenerMap = 1824d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi new HashMap<String, OnAudioFocusChangeListener>(); 1825d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1826d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager 1827d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * instance. 1828d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1829d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Object mFocusListenerLock = new Object(); 1830d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1831d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private OnAudioFocusChangeListener findFocusListener(String id) { 1832d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi return mAudioFocusIdListenerMap.get(id); 1833d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1834d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1835d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1836d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Handler for audio focus events coming from the audio service. 1837d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 183830c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = 1839d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi new FocusEventHandlerDelegate(); 1840078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi 1841d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1842d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Helper class to handle the forwarding of audio focus events to the appropriate listener 1843d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1844d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private class FocusEventHandlerDelegate { 1845d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Handler mHandler; 1846d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1847d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi FocusEventHandlerDelegate() { 1848d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Looper looper; 1849d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if ((looper = Looper.myLooper()) == null) { 1850d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi looper = Looper.getMainLooper(); 1851d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1852d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1853d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (looper != null) { 1854d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // implement the event handler delegate to receive audio focus events 1855d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = new Handler(looper) { 1856d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi @Override 1857d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void handleMessage(Message msg) { 1858d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi OnAudioFocusChangeListener listener = null; 1859d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1860d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi listener = findFocusListener((String)msg.obj); 1861d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1862d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (listener != null) { 18637f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi listener.onAudioFocusChange(msg.what); 1864d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1865d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1866d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1867d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1868d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = null; 1869d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1870d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1871d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1872d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Handler getHandler() { 1873d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return mHandler; 1874d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1875d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1876d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 187730c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { 1878d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1879d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void dispatchAudioFocusChange(int focusChange, String id) { 1880d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); 1881d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); 1882d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1883d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1884d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1885d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1886d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { 1887d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (l == null) { 1888308e9a5d0975489982f93fd1f3728e6ed7a778d0Jean-Michel Trivi return new String(this.toString()); 1889d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1890d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return new String(this.toString() + l.toString()); 1891d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1892d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1893d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1894d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 18955f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 189646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Registers a listener to be called when audio focus changes. Calling this method is optional 189746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it 189846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * will register the listener as well if it wasn't registered already. 189946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to be notified of audio focus changes. 1900d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1901d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void registerAudioFocusListener(OnAudioFocusChangeListener l) { 1902d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1903d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { 1904d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return; 1905d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1906d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); 1907d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1908d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1909d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1910d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 19115f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 191246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Causes the specified listener to not be called anymore when focus is gained or lost. 191346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to unregister. 1914d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1915d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { 1916392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi 1917d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // remove locally 1918d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1919d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); 1920d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1921d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1922d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1923d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1924d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 192546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A failed focus change request. 1926d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1927d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_FAILED = 0; 1928d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 192946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A successful focus change request. 1930d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1931d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; 1932d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1933d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1934d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1935d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Request audio focus. 193646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Send a request to obtain the audio focus 1937d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param l the listener to be notified of audio focus changes 1938d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param streamType the main audio stream type affected by the focus request 1939d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 1940d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 1941078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * for the playback of driving directions, or notifications sounds. 1942983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 1943983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 1944078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 1945d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * as the playback of a song or a video. 1946d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 1947d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1948d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { 1949d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 195055d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi if ((durationHint < AUDIOFOCUS_GAIN) || (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK)) 195155d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi { 195255d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi Log.e(TAG, "Invalid duration hint, audio focus request denied"); 195355d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi return status; 195455d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi } 1955d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi registerAudioFocusListener(l); 1956d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi //TODO protect request by permission check? 1957d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 1958d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 1959d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi status = service.requestAudioFocus(streamType, durationHint, mICallBack, 19608f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mAudioFocusDispatcher, getIdForAudioFocusListener(l), 19618f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mContext.getPackageName() /* package name */); 1962d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 19634dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocus() on AudioService due to "+e); 1964d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1965d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 1966d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1967d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 19684dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 19694dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 19704dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to request audio focus. Will cause the focus request 19714dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to be associated with the "voice communication" identifier only used in AudioService 19724dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to identify this use case. 19734dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param streamType use STREAM_RING for focus requests when ringing, VOICE_CALL for 19744dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * the establishment of the call 19754dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param durationHint the type of focus request. AUDIOFOCUS_GAIN_TRANSIENT is recommended so 19764dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * media applications resume after a call 19774dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 19784dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void requestAudioFocusForCall(int streamType, int durationHint) { 19794dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 19804dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 19814dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi service.requestAudioFocus(streamType, durationHint, mICallBack, null, 19824dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi AudioService.IN_VOICE_COMM_FOCUS_ID, 19834dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi "system" /* dump-friendly package name */); 19844dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 19854dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocusForCall() on AudioService due to "+e); 19864dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 19874dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 19884dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi 19894dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 19904dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 19914dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to abandon audio focus, typically after a call or 19924dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * when ringing ends and the call is rejected or not answered. 19934dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Should match one or more calls to {@link #requestAudioFocusForCall(int, int)}. 19944dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 19954dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void abandonAudioFocusForCall() { 19964dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 19974dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 19984dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi service.abandonAudioFocus(null, AudioService.IN_VOICE_COMM_FOCUS_ID); 19994dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 20004dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocusForCall() on AudioService due to "+e); 20014dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 20024dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 2003d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2004d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 200546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 200646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener with which focus was requested. 2007d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 2008d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 2009d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l) { 2010d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 2011392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi unregisterAudioFocusListener(l); 2012d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 2013d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 2014d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi status = service.abandonAudioFocus(mAudioFocusDispatcher, 2015d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi getIdForAudioFocusListener(l)); 2016d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 20174dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocus() on AudioService due to "+e); 2018d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2019d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 2020d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 2021d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2022d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 2023d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi //==================================================================== 2024d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi // Remote Control 2025d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 202646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Register a component to be the sole receiver of MEDIA_BUTTON intents. 2027d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 2028d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * that will receive the media button intent. This broadcast receiver must be declared 2029f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * in the application manifest. The package of the component must match that of 2030f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * the context you're registering from. 2031d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2032d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { 20338f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 20348f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 20358f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2036f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if (!eventReceiver.getPackageName().equals(mContext.getPackageName())) { 2037f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "registerMediaButtonEventReceiver() error: " + 2038f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi "receiver and context package names don't match"); 2039f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2040f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2041f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and register it 2042f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2043f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2044f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2045f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 2046f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2047f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi registerMediaButtonIntent(pi, eventReceiver); 2048f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2049f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2050f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2051961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Register a component to be the sole receiver of MEDIA_BUTTON intents. This is like 2052961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(android.content.ComponentName)}, but allows 2053961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * the buttons to go to any PendingIntent. Note that you should only use this form if 2054961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * you know you will continue running for the full time until unregistering the 2055961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * PendingIntent. 2056961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver target that will receive media button intents. The PendingIntent 2057961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * will be sent as-is when a media button action occurs, with {@link Intent#EXTRA_KEY_EVENT} 2058961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * added and holding the key code of the media button that was pressed. 2059961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2060961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void registerMediaButtonEventReceiver(PendingIntent eventReceiver) { 2061961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2062961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2063961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2064961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn registerMediaButtonIntent(eventReceiver, null); 2065961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2066961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2067961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2068f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2069f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * no-op if (pi == null) or (eventReceiver == null) 2070f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2071f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi public void registerMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { 2072961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (pi == null) { 2073f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Cannot call registerMediaButtonIntent() with a null parameter"); 2074f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 2075f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2076d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 2077d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 2078f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // pi != null 207979f7ec70ebd5758ce54fd5b6fcd60fd27457cba6Dianne Hackborn service.registerMediaButtonIntent(pi, eventReceiver, 208079f7ec70ebd5758ce54fd5b6fcd60fd27457cba6Dianne Hackborn eventReceiver == null ? mToken : null); 2081d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 2082f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Dead object in registerMediaButtonIntent"+e); 2083d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2084d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2085d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 2086d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 2087722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * @hide 2088722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * Used internally by telephony package to register an intent receiver for ACTION_MEDIA_BUTTON. 2089722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * @param eventReceiver the component that will receive the media button key events, 2090722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * no-op if eventReceiver is null 2091722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi */ 2092722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi public void registerMediaButtonEventReceiverForCalls(ComponentName eventReceiver) { 2093722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi if (eventReceiver == null) { 2094722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi return; 2095722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2096722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi IAudioService service = getService(); 2097722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi try { 2098722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi // eventReceiver != null 2099722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi service.registerMediaButtonEventReceiverForCalls(eventReceiver); 2100722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } catch (RemoteException e) { 2101722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi Log.e(TAG, "Dead object in registerMediaButtonEventReceiverForCalls", e); 2102722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2103722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2104722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi 2105722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi /** 2106722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi * @hide 2107722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi */ 2108722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi public void unregisterMediaButtonEventReceiverForCalls() { 2109722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi IAudioService service = getService(); 2110722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi try { 2111722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi service.unregisterMediaButtonEventReceiverForCalls(); 2112722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } catch (RemoteException e) { 2113722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterMediaButtonEventReceiverForCalls", e); 2114722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2115722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi } 2116722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi 2117722b808662eb20fa91151f1e3aa05fd911d1d226Jean-Michel Trivi /** 211846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Unregister the receiver of MEDIA_BUTTON intents. 211946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 212046b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. 2121d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 2122d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { 21238f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 21248f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 21258f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 2126f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and unregister it 2127f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 2128f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 2129f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 2130f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 2131f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 2132b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(pi); 2133f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 2134f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 2135f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 2136961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * Unregister the receiver of MEDIA_BUTTON intents. 2137961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * @param eventReceiver same PendingIntent that was registed with 2138961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn * {@link #registerMediaButtonEventReceiver(PendingIntent)}. 2139961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn */ 2140961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn public void unregisterMediaButtonEventReceiver(PendingIntent eventReceiver) { 2141961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn if (eventReceiver == null) { 2142961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn return; 2143961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2144b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi unregisterMediaButtonIntent(eventReceiver); 2145961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn } 2146961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn 2147961cae92540763226648813d111c5b5c3b0f1597Dianne Hackborn /** 2148f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 2149f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 2150b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi public void unregisterMediaButtonIntent(PendingIntent pi) { 2151d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 2152d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 2153b839b83c7349533b4cb7278fd3d792b47199ba36Jean-Michel Trivi service.unregisterMediaButtonIntent(pi); 2154d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 2155f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterMediaButtonIntent"+e); 2156d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2157d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 2158d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 2159178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 2160178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Registers the remote control client for providing information to display on the remote 2161178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * controls. 2162466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client from which remote controls will receive 2163466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * information to display. 2164466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @see RemoteControlClient 21658f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 21664426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void registerRemoteControlClient(RemoteControlClient rcClient) { 2167f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 21688f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 21698f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 21708f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 21718f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 21723114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi int rcseId = service.registerRemoteControlClient( 21733114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi rcClient.getRcMediaIntent(), /* mediaIntent */ 21743114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi rcClient.getIRemoteControlClient(),/* rcClient */ 21758f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi // used to match media button event receiver and audio focus 21763114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi mContext.getPackageName()); /* packageName */ 21773114ce3861f20f9a5c2c59dd2629197a1f4874a8Jean-Michel Trivi rcClient.setRcseId(rcseId); 21788f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 21798f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlClient"+e); 21808f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 21818f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 21828f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 21838f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 2184fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * Unregisters the remote control client that was providing information to display on the 2185466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * remote controls. 2186466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client to unregister. 21874426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi * @see #registerRemoteControlClient(RemoteControlClient) 21888f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 21894426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void unregisterRemoteControlClient(RemoteControlClient rcClient) { 2190f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 21918f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 21928f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 21938f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 21948f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 2195f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi service.unregisterRemoteControlClient(rcClient.getRcMediaIntent(), /* mediaIntent */ 2196f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi rcClient.getIRemoteControlClient()); /* rcClient */ 21978f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 21988f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlClient"+e); 21998f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22008f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 22018f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 220244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 220344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 220444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 22054a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Use this method if your IRemoteControlDisplay is not going to display artwork, otherwise 22064a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * use {@link #registerRemoteControlDisplay(IRemoteControlDisplay, int, int)} to pass the 22074a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * artwork size directly, or 22084a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * {@link #remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay, int, int)} later if artwork 22094a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * is not yet needed. 22104a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd the IRemoteControlDisplay 221144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 221244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd) { 22134a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi // passing a negative value for art work width and height as they are unknown at this stage 22144a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi registerRemoteControlDisplay(rcd, /*w*/-1, /*h*/ -1); 22154a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi } 22164a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi 22174a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi /** 22184a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @hide 22194a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 22204a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param rcd 22214a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 22224a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 22234a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 22244a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi * useless to send artwork. 22254a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi */ 22264a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd, int w, int h) { 222744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 222844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 222944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 223044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 223144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 22324a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi // passing a negative value for art work width and height as they are unknown at 22334a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi // this stage 22344a5700556191c835116ec2a6997a4f16f464ac9dJean-Michel Trivi service.registerRemoteControlDisplay(rcd, w, h); 223544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 223644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); 223744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 223844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 223944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 224044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 224144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 224244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Unregisters a remote control display that was sent information by remote control clients. 224344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 224444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 224544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void unregisterRemoteControlDisplay(IRemoteControlDisplay rcd) { 224644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 224744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 224844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 224944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 225044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 225144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.unregisterRemoteControlDisplay(rcd); 225244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 225344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); 225444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 225544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 225644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 225744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 225844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 225944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Sets the artwork size a remote control display expects when receiving bitmaps. 226044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 226144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 226244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 226344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 226444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 226544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 226644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay rcd, int w, int h) { 226744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 226844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 226944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 227044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 227144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 227244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.remoteControlDisplayUsesBitmapSize(rcd, w, h); 227344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 227444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayUsesBitmapSize " + e); 227544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 227644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 2277ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh 2278b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi /** 22793261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @hide 22803261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * Request the user of a RemoteControlClient to seek to the given playback position. 22813261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @param generationId the RemoteControlClient generation counter for which this request is 22823261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * issued. Requests for an older generation than current one will be ignored. 22833261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi * @param timeMs the time in ms to seek to, must be positive. 22843261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi */ 22853261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi public void setRemoteControlClientPlaybackPosition(int generationId, long timeMs) { 22863261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi if (timeMs < 0) { 22873261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi return; 22883261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } 22893261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi IAudioService service = getService(); 22903261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi try { 22913261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi service.setRemoteControlClientPlaybackPosition(generationId, timeMs); 22923261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } catch (RemoteException e) { 22933261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi Log.e(TAG, "Dead object in setRccPlaybackPosition("+ generationId + ", " 22943261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi + timeMs + ")", e); 22953261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } 22963261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi } 22973261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi 22983261b537c5fdec824575a1f6ad6d8942715e82e2Jean-Michel Trivi /** 22994050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * @hide 23004050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * Reload audio settings. This method is called by Settings backup 23014050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * agent when audio settings are restored and causes the AudioService 23024050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * to read and apply restored settings. 23034050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent */ 23044050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent public void reloadAudioSettings() { 23054050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent IAudioService service = getService(); 23064050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent try { 23074050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent service.reloadAudioSettings(); 23084050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } catch (RemoteException e) { 23094050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent Log.e(TAG, "Dead object in reloadAudioSettings"+e); 23104050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 23114050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 23124050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent 23139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 23159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 231630c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IBinder mICallBack = new Binder(); 23177f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 23187f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten /** 23197f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * Checks whether the phone is in silent mode, with or without vibrate. 23207f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 23217f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @return true if phone is in silent mode, with or without vibrate. 23227f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 23237f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @see #getRingerMode() 23247f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 23257f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @hide pending API Council approval 23267f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten */ 23277f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten public boolean isSilentMode() { 23287f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten int ringerMode = getRingerMode(); 23297f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten boolean silentMode = 23307f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_SILENT) || 23317f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_VIBRATE); 23327f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten return silentMode; 23337f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten } 23347f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 23358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // This section re-defines new output device constants from AudioSystem, because the AudioSystem 23368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // class is not used by other parts of the framework, which instead use definitions and methods 23378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. 23388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 23398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the small speaker at the front of the device used 23408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * when placing calls. Does not refer to an in-ear headphone without attached microphone, 23418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a 23428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}. 23438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 23448b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; 23458b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the built-in speaker */ 23468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; 23478b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headset with attached microphone */ 23488b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; 23498b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headphone without attached microphone */ 23508b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; 23518b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth SCO, for voice */ 23528b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; 23538b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO Headset Profile (HSP) and 23548b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Hands-Free Profile (HFP), for voice 23558b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 23568b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 23578b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; 23588b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO car audio, for voice */ 23598b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 23608b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; 23618b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth A2DP, for music */ 23628b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; 23638b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP headphones, for music */ 23648b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 23658b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; 23668b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP external speaker, for music */ 23678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 23688b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; 23698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for S/PDIF or HDMI */ 23708b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; 23718b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for an analog wired headset attached via a 23728b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 23738b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 23748b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; 23758b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a digital wired headset attached via a 23768b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 23778b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 23788b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; 237959f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent /** {@hide} The audio output device code for a USB audio accessory. The accessory is in USB host 238059f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB device mode 238159f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 238259f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_ACCESSORY = AudioSystem.DEVICE_OUT_USB_ACCESSORY; 238359f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent /** {@hide} The audio output device code for a USB audio device. The device is in USB device 238459f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent * mode and the Android device in USB host mode 238559f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent */ 238659f482764e346a5c5ac118ee1f7b24da645c2559Eric Laurent public static final int DEVICE_OUT_USB_DEVICE = AudioSystem.DEVICE_OUT_USB_DEVICE; 23878b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} This is not used as a returned value from {@link #getDevicesForStream}, but could be 23888b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * used in the future in a set method to select whatever default device is chosen by the 23898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * platform-specific implementation. 23908b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 23918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; 23928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 23938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** 23948b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Return the enabled devices for the specified output stream type. 23958b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 23968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @param streamType The stream type to query. One of 23978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_VOICE_CALL}, 23988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_SYSTEM}, 23998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_RING}, 24008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_MUSIC}, 24018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_ALARM}, 24028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_NOTIFICATION}, 24038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_DTMF}. 24048b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 24058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @return The bit-mask "or" of audio output device codes for all enabled devices on this 24068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * stream. Zero or more of 24078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_EARPIECE}, 24088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_SPEAKER}, 24098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADSET}, 24108b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}, 24118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO}, 24128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, 24138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, 24148b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, 24158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, 24168b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, 24178b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_AUX_DIGITAL}, 24188b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, 24198b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. 24208b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DEFAULT} is not used here. 24218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 24228b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * The implementation may support additional device codes beyond those listed, so 24238b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * the application should ignore any bits which it does not recognize. 24248b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Note that the information may be imprecise when the implementation 24258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * cannot distinguish whether a particular device is enabled. 24268b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 24278b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@hide} 24288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 24298b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public int getDevicesForStream(int streamType) { 24308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten switch (streamType) { 24318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_VOICE_CALL: 24328b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_SYSTEM: 24338b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_RING: 24348b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_MUSIC: 24358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_ALARM: 24368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_NOTIFICATION: 24378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_DTMF: 24388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return AudioSystem.getDevicesForStream(streamType); 24398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten default: 24408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return 0; 24418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 24428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 24438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 2444b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 2445b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * Indicate wired accessory connection state change. 2446b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device type of device connected/disconnected (AudioManager.DEVICE_OUT_xxx) 2447b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state: 1 connected, 0 disconnected 2448b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param name device name 2449b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 2450b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 2451b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent public void setWiredDeviceConnectionState(int device, int state, String name) { 2452b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 2453b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 2454b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent service.setWiredDeviceConnectionState(device, state, name); 2455b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 2456b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setWiredDeviceConnectionState "+e); 2457b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2458b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2459b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 2460b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent /** 2461b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * Indicate A2DP sink connection state change. 2462b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param device Bluetooth device connected/disconnected 2463b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @param state new connection state (BluetoothProfile.STATE_xxx) 2464b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * @return a delay in ms that the caller should wait before broadcasting 2465b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED intent. 2466b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent * {@hide} 2467b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent */ 2468b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent public int setBluetoothA2dpDeviceConnectionState(BluetoothDevice device, int state) { 2469b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent IAudioService service = getService(); 2470b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent int delay = 0; 2471b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent try { 2472b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent delay = service.setBluetoothA2dpDeviceConnectionState(device, state); 2473b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } catch (RemoteException e) { 2474b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent Log.e(TAG, "Dead object in setBluetoothA2dpDeviceConnectionState "+e); 2475b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } finally { 2476b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent return delay; 2477b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2478b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent } 2479b1fbaaccb656ef09a8770c28df15e3e91a452e64Eric Laurent 2480098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey /** {@hide} */ 2481098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey public IRingtonePlayer getRingtonePlayer() { 2482098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey try { 2483098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return getService().getRingtonePlayer(); 2484098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } catch (RemoteException e) { 2485098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey return null; 2486098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 2487098d580cc2bb6c0891c756a4e5230c6c6b0d2376Jeff Sharkey } 2488228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2489228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 249062796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output sample rate 249162796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal Hz. 2492228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2493228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_SAMPLE_RATE = 2494228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_SAMPLE_RATE"; 2495228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2496228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 249762796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Used as a key for {@link #getProperty} to request the native or optimal output buffer size 249862796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * for this device's primary output stream, in decimal PCM frames. 2499228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2500228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public static final String PROPERTY_OUTPUT_FRAMES_PER_BUFFER = 2501228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten "android.media.property.OUTPUT_FRAMES_PER_BUFFER"; 2502228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 2503228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten /** 250462796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * Returns the value of the property with the specified key. 2505228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @param key One of the strings corresponding to a property key: either 250662796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_SAMPLE_RATE} or 250762796aac596f556a1871358bb8ce93af9d55c5a5Glenn Kasten * {@link #PROPERTY_OUTPUT_FRAMES_PER_BUFFER} 2508228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * @return A string representing the associated value for that property key, 2509228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten * or null if there is no value for that key. 2510228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten */ 2511228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten public String getProperty(String key) { 2512c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten if (PROPERTY_OUTPUT_SAMPLE_RATE.equals(key)) { 2513c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputSampleRate = AudioSystem.getPrimaryOutputSamplingRate(); 2514c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputSampleRate > 0 ? Integer.toString(outputSampleRate) : null; 2515c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else if (PROPERTY_OUTPUT_FRAMES_PER_BUFFER.equals(key)) { 2516c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten int outputFramesPerBuffer = AudioSystem.getPrimaryOutputFrameCount(); 2517c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return outputFramesPerBuffer > 0 ? Integer.toString(outputFramesPerBuffer) : null; 2518c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } else { 2519c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten // null or unknown key 2520c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten return null; 2521c6c4365ddb0213c548b055f257dc8077389224fbGlenn Kasten } 2522228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten } 2523228c9847a31b79f8baa80302731cdbf6a2b3c0d4Glenn Kasten 25249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2525