AudioManager.java revision cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762
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; 22d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.content.ComponentName; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 24f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Triviimport android.content.Intent; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 28d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Looper; 29d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport android.os.Message; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 3186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.os.SystemClock; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.ServiceManager; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.provider.Settings; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 35d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Triviimport android.view.KeyEvent; 3686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onoratoimport android.view.VolumePanel; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 38d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Triviimport java.util.HashMap; 39d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioManager provides access to volume and ringer mode control. 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use <code>Context.getSystemService(Context.AUDIO_SERVICE)</code> to get 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an instance of this class. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioManager { 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Context mContext; 4986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato private long mVolumeKeyUpTime; 50402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent private int mVolumeControlStream = -1; 51cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood private final boolean mUseMasterVolume; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String TAG = "AudioManager"; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent, a hint for applications that audio is about to become 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'noisy' due to a change in audio outputs. For example, this intent may 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent when a wired headset is unplugged, or when an A2DP audio 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sink is disconnected, and the audio system is about to automatically 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * switch audio route to the speaker. Applications that are controlling 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * audio streams may consider pausing, reducing volume or some other action 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on receipt of this intent so as not to surprise the user with audio 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the speaker. 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sticky broadcast intent action indicating that the ringer mode has 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the new ringer mode. 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_RINGER_MODE 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new ringer mode. 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_CHANGED_ACTION 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_NORMAL 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_SILENT 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #RINGER_MODE_VIBRATE 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the vibrate setting has 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. Includes the vibrate type and its new setting. 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_SETTING 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VIBRATE_SETTING_CHANGED_ACTION = "android.media.VIBRATE_SETTING_CHANGED"; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Broadcast intent when the volume for a particular stream type changes. 989ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * Includes the stream, the new volume and previous volumes 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_TYPE 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VOLUME_STREAM_VALUE 1029ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @see #EXTRA_PREV_VOLUME_STREAM_VALUE 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new vibrate setting for a particular type. 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_VIBRATE_TYPE 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ON 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_OFF 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_ONLY_SILENT 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The vibrate type whose setting has changed. 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_SETTING_CHANGED_ACTION 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_NOTIFICATION 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #VIBRATE_TYPE_RINGER 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The stream type for the volume changed intent. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide The volume associated with the stream for the volume changed intent. 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_VOLUME_STREAM_VALUE = 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.media.EXTRA_VOLUME_STREAM_VALUE"; 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1389ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent /** 1399ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent * @hide The previous volume associated with the stream for the volume changed intent. 1409ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent */ 1419ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = 1429ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; 1439ce379aef155e0c21b5d82d8dc713c62792e4f30Eric Laurent 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for phone calls */ 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for system sounds */ 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for the phone ring */ 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_RING = AudioSystem.STREAM_RING; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for music playback */ 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for alarms */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The audio stream for notifications */ 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide The audio stream for phone calls when connected to bluetooth */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; 158a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ 159a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; 160a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** The audio stream for DTMF Tones */ 161a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; 162a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** @hide The audio stream for text to speech (TTS) */ 163a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public static final int STREAM_TTS = AudioSystem.STREAM_TTS; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Number of audio streams */ 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated Use AudioSystem.getNumStreamTypes() instead 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 168a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide Default volume index values for audio streams */ 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int[] DEFAULT_STREAM_VOLUME = new int[] { 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4, // STREAM_VOICE_CALL 1749d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_RING 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11, // STREAM_MUSIC 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6, // STREAM_ALARM 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5, // STREAM_NOTIFICATION 179a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 7, // STREAM_BLUETOOTH_SCO 1809d85d5adf90e7363304e2d4a22d60a2114bb7ab9Eric Laurent 7, // STREAM_SYSTEM_ENFORCED 181a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11, // STREAM_DTMF 182a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 11 // STREAM_TTS 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Increase the ringer volume. 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_RAISE = 1; 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decrease the ringer volume. 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_LOWER = -1; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maintain the previous ringer volume. This may be useful when needing to 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * show the volume toast without actually modifying the volume. 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ADJUST_SAME = 0; 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Flags should be powers of 2! 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Show a toast containing the current volume. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_SHOW_UI = 1 << 0; 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to include ringer modes as possible options when changing volume. 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For example, if true and volume level is 0 and the volume is adjusted 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate mode. 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * By default this is on for the ring stream. If this flag is included, 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this behavior will be present regardless of the stream type being 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affected by the ringer mode. 231105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to play a sound when changing the volume. 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is given to {@link #adjustVolume(int, int)} or 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in some cases (for example, the decided stream type is not 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_RING}, or the volume is being adjusted 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * downward). 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_PLAY_SOUND = 1 << 2; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any sounds/vibrate that may be in the queue, or are playing (related to 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changing volume). 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether to vibrate if going into the vibrate ringer mode. 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_VIBRATE = 1 << 4; 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 264402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces use of specified stream 265402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 266402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 267402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public static final int FLAG_FORCE_STREAM = 1 << 5; 268402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 269402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 270402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will not vibrate. (This overrides the 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate setting.) 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_SILENT = 0; 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that will be silent and will vibrate. (This will cause the 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone ringer to always vibrate, but the notification vibrate to only 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate if set.) 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_VIBRATE = 1; 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringer mode that may be audible and may vibrate. It will be audible if 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the volume before changing out of this mode was audible. It will vibrate 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the vibrate setting is on. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RINGER_MODE_NORMAL = 2; 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 29972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent // maximum valid ringer mode value. Values must start from 0 and be contiguous. 30072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent private static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; 30172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to the ringer. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_RINGER = 0; 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate type that corresponds to notifications. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_TYPE_NOTIFICATION = 1; 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to never vibrate. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_OFF = 0; 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to vibrate when possible. 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ON = 1; 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Vibrate setting that suggests to only vibrate when in the vibrate ringer 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mode. 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VIBRATE_SETTING_ONLY_SILENT = 2; 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Suggests using the default stream type. This may not be used in all 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * places a stream type is needed. 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService sService; 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioManager(Context context) { 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContext = context; 358cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood mUseMasterVolume = mContext.getResources().getBoolean( 359cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood com.android.internal.R.bool.config_useMasterVolume); 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static IAudioService getService() 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sService != null) { 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sService = IAudioService.Stub.asInterface(b); 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sService; 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 37386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 37486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 37586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato public void preDispatchKeyEvent(int keyCode, int stream) { 37686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 37786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * If the user hits another key within the play sound delay, then 37886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * cancel the sound 37986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 38086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP 38186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE 38286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato && mVolumeKeyUpTime + VolumePanel.PLAY_SOUND_DELAY 38386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato > SystemClock.uptimeMillis()) { 38486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 38586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * The user has hit another key during the delay (e.g., 300ms) 38686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * since the last volume key up, so cancel any sounds. 38786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 388cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 389cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustMasterVolume(ADJUST_SAME); 390cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 391cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume(ADJUST_SAME, 39286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); 393cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 39486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 39586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 39686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 39786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 39886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 39986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 40086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato public void handleKeyDown(int keyCode, int stream) { 40186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 40286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 40386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 40486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 40586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Adjust the volume in on key down since it is more 40686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * responsive to the user. 40786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 408402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent int flags = FLAG_SHOW_UI | FLAG_VIBRATE; 409cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 410cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustMasterVolume( 411cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 412cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 413cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood : ADJUST_LOWER); 414cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 415cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mVolumeControlStream != -1) { 416cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood stream = mVolumeControlStream; 417cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood flags |= FLAG_FORCE_STREAM; 418cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 419cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume( 420cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood keyCode == KeyEvent.KEYCODE_VOLUME_UP 421cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ? ADJUST_RAISE 422cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood : ADJUST_LOWER, 423cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood stream, 424cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood flags); 425402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 42686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 42786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 42886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato // TODO: Actually handle MUTE. 42986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 43086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 43186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 43286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 43386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 43486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * @hide 43586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 43686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato public void handleKeyUp(int keyCode, int stream) { 43786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato switch (keyCode) { 43886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_UP: 43986f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_DOWN: 44086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /* 44186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * Play a sound. This is done on key up since we don't want the 44286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato * sound to play when a user holds down volume down to mute. 44386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato */ 444cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mUseMasterVolume) { 445cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN) { 446cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustMasterVolume(ADJUST_SAME); 447cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 448cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } else { 449cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood int flags = FLAG_PLAY_SOUND; 450cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood if (mVolumeControlStream != -1) { 451cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood stream = mVolumeControlStream; 452cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood flags |= FLAG_FORCE_STREAM; 453cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 454cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood adjustSuggestedStreamVolume( 455cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood ADJUST_SAME, 456cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood stream, 457cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood flags); 458402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 45925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 46086f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato mVolumeKeyUpTime = SystemClock.uptimeMillis(); 46186f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 46286f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato case KeyEvent.KEYCODE_VOLUME_MUTE: 46386f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato // TODO: Actually handle MUTE. 46486f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato break; 46586f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 46686f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato } 46786f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato 46886f6786032b1a0380cf089aeeceef7e9d8982ef8Joe Onorato /** 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of a particular stream by one step in a direction. 470fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 471fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 472fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #STREAM_ALARM} 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustStreamVolume(int streamType, int direction, int flags) { 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.adjustStreamVolume(streamType, direction, flags); 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustStreamVolume", e); 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream. For example, if a call is 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active, it will have the highest priority regardless of if the in-call 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen is showing. Another example, if music is playing in the background 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and a call is not active, the music stream will be adjusted. 498fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 499fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 500fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustSuggestedStreamVolume(int, int, int) 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustVolume(int direction, int flags) { 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.adjustVolume(direction, flags); 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in adjustVolume", e); 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adjusts the volume of the most relevant stream, or the given fallback 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stream. 522fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 523fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 524fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param direction The direction to adjust the volume. One of 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ADJUST_SAME}. 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param suggestedStreamType The stream type that will be used if there 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is valid here. 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustVolume(int, int) 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #adjustStreamVolume(int, int, int) 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.adjustSuggestedStreamVolume(direction, suggestedStreamType, flags); 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 541cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustSuggestedStreamVolume", e); 542cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 543cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } 544cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood 545cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood /** 546cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * Adjusts the master volume for the device's audio amplifier. 547cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * <p> 548cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * 549cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * @param direction The direction to adjust the volume. One of 550cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or 551cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood * {@link #ADJUST_SAME}. 552cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood */ 553cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood private void adjustMasterVolume(int direction) { 554cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood IAudioService service = getService(); 555cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood try { 556cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood service.adjustMasterVolume(direction); 557cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood } catch (RemoteException e) { 558cbdb49dc5e1b993a0bc5c68dbfb9486bfa0cd762Mike Lockwood Log.e(TAG, "Dead object in adjustMasterVolume", 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 * Returns the current ringtone mode. 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setRingerMode(int) 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRingerMode() { 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getRingerMode(); 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getRingerMode", e); 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return RINGER_MODE_NORMAL; 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 58072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * Checks valid ringer mode values. 58172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 58272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @return true if the ringer mode indicated is valid, false otherwise. 58372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * 58472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @see #setRingerMode(int) 58572668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent * @hide 58672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent */ 58772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent public static boolean isValidRingerMode(int ringerMode) { 58872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { 58972668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return false; 59072668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 59172668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return true; 59272668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 59372668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent 59472668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent /** 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum volume index for a particular stream. 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose maximum volume index is returned. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The maximum valid volume index for the stream. 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamMaxVolume(int streamType) { 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getStreamMaxVolume(streamType); 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamMaxVolume", e); 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current volume index for a particular stream. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream type whose volume index is returned. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The current volume index for the stream. 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setStreamVolume(int, int, int) 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamVolume(int streamType) { 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getStreamVolume(streamType); 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getStreamVolume", e); 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 63025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * Get last audible volume before stream was muted. 63125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 63225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 63325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 63425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public int getLastAudibleStreamVolume(int streamType) { 63525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 63625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 63725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return service.getLastAudibleStreamVolume(streamType); 63825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 63925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); 64025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return 0; 64125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 64225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 64325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 64425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the ringer mode. 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Silent mode will mute the volume and will not vibrate. Vibrate mode will 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mute the volume and vibrate. Normal mode will be audible and may vibrate 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * according to user settings. 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getRingerMode() 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRingerMode(int ringerMode) { 65672668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent if (!isValidRingerMode(ringerMode)) { 65772668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent return; 65872668b2c040b581b298b069f3b5af5ed7f212d89Eric Laurent } 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setRingerMode(ringerMode); 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setRingerMode", e); 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the volume index for a particular stream. 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream whose volume index should be set. 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The volume index to set. See 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getStreamMaxVolume(int)} for the largest valid value. 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags One or more flags. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamMaxVolume(int) 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getStreamVolume(int) 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamVolume(int streamType, int index, int flags) { 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamVolume(streamType, index, flags); 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamVolume", e); 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Solo or unsolo a particular stream. All other streams are muted. 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo command is protected against client process death: if a process 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active solo request on a stream dies, all streams that were muted 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because of this request will be unmuted automatically. 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The solo requests for a given stream are cumulative: the AudioManager 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several solo requests from one or more clients and the stream 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unsoloed only when the same number of unsolo requests are received. 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unsolo a soloed stream 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and solo is again in onResume() if appropriate. 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be soloed/unsoloed. 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required solo state: true for solo ON, false for solo OFF 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamSolo(int streamType, boolean state) { 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamSolo(streamType, state, mICallBack); 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamSolo", e); 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mute or unmute an audio stream. 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute command is protected against client process death: if a process 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with an active mute request on a stream dies, this stream will be unmuted 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * automatically. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The mute requests for a given stream are cumulative: the AudioManager 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can receive several mute requests from one or more clients and the stream 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be unmuted only when the same number of unmute requests are received. 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a better user experience, applications MUST unmute a muted stream 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in onPause() and mute is again in onResume() if appropriate. 725fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 726fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 727fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType The stream to be muted/unmuted. 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state The required mute state: true for mute ON, false for mute OFF 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStreamMute(int streamType, boolean state) { 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setStreamMute(streamType, state, mICallBack); 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setStreamMute", e); 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 74225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * get stream mute state. 74325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * 74425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent * @hide 74525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent */ 74625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent public boolean isStreamMute(int streamType) { 74725101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent IAudioService service = getService(); 74825101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent try { 74925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return service.isStreamMute(streamType); 75025101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } catch (RemoteException e) { 75125101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent Log.e(TAG, "Dead object in isStreamMute", e); 75225101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return false; 75325101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 75425101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent } 75525101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent 75625101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent /** 757402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * forces the stream controlled by hard volume keys 758402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * specifying streamType == -1 releases control to the 759402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * logic. 760402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * 761402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent * @hide 762402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent */ 763402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent public void forceVolumeControlStream(int streamType) { 764402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent mVolumeControlStream = streamType; 765402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent } 766402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent 767402f7f29634a9f68e7929be828a927a3e2f5efe9Eric Laurent /** 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether a particular type should vibrate according to user 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings and the current ringer mode. 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that use notifications to 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vibrate. The notification manager will not vibrate if the policy doesn't 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it, so the client should always set a vibrate pattern and let the 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * notification manager control whether or not to actually vibrate. 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether the type should vibrate at the instant this method is 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called. 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldVibrate(int vibrateType) { 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.shouldVibrate(vibrateType); 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in shouldVibrate", e); 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns whether the user's vibrate setting for a vibrate type. 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This shouldn't be needed by most clients that want to vibrate, instead 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link #shouldVibrate(int)}. 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setVibrateSetting(int, int) 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getVibrateSetting(int vibrateType) { 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getVibrateSetting(vibrateType); 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getVibrateSetting", e); 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return VIBRATE_SETTING_OFF; 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the setting for when the vibrate type should vibrate. 821fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 822fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 823fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateType The type of vibrate. One of 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_NOTIFICATION} or 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_TYPE_RINGER}. 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vibrateSetting The vibrate setting, one of 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ON}, 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_OFF}, or 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #VIBRATE_SETTING_ONLY_SILENT}. 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getVibrateSetting(int) 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #shouldVibrate(int) 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setVibrateSetting(int vibrateType, int vibrateSetting) { 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.setVibrateSetting(vibrateType, vibrateSetting); 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setVibrateSetting", e); 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the speakerphone on or off. 846fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 847fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 848fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to turn on speakerphone; 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn it off 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpeakerphoneOn(boolean on){ 854c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 855c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 856c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setSpeakerphoneOn(on); 857c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 858c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setSpeakerphoneOn", e); 859a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the speakerphone is on or off. 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if speakerphone is on, false if it's off 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSpeakerphoneOn() { 868c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 869c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 870c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isSpeakerphoneOn(); 871c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 872c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isSpeakerphoneOn", e); 873a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 874a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8773def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent //==================================================================== 8783def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent // Bluetooth SCO control 8793def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 8803def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 88195b88fbe744d8ce53b5f54f6fcd90c55094a8d14Eric Laurent * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} 8823def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} 8833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * or {@link #SCO_AUDIO_STATE_CONNECTED} 8843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * 8853def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 886dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead 8873def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 888dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @Deprecated 8893def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 8903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_CHANGED = 8913def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.SCO_AUDIO_STATE_CHANGED"; 892dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 893dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 894dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Sticky broadcast intent action indicating that the bluetoooth SCO audio 895dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * connection state has been updated. 896dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>This intent has two extras: 897dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 898dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_STATE} - The new SCO audio state. </li> 899dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE}- The previous SCO audio state. </li> 900dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 901dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p> EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: 902dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 903dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_DISCONNECTED}, </li> 904dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTING} or </li> 905dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> {@link #SCO_AUDIO_STATE_CONNECTED}, </li> 906dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 907dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #startBluetoothSco() 908dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 909dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 910dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String ACTION_SCO_AUDIO_STATE_UPDATED = 911dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; 912dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 9133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 914dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or 915dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. 9163def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9173def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final String EXTRA_SCO_AUDIO_STATE = 9183def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent "android.media.extra.SCO_AUDIO_STATE"; 9193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9203def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 921dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous 922dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * bluetooth SCO connection state. 923dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 924dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = 925dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; 926dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent 927dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 928dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 929dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is not established 9303def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9313def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; 9323def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 933dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} 934dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is established 9353def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9363def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTED = 1; 9373def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 938dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE 939dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * indicating that the SCO audio channel is being established 940dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent */ 941dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent public static final int SCO_AUDIO_STATE_CONNECTING = 2; 942dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent /** 943dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * Value for extra EXTRA_SCO_AUDIO_STATE indicating that 9443def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * there was an error trying to obtain the state 9453def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9463def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public static final int SCO_AUDIO_STATE_ERROR = -1; 9473def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9483def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9493def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 9503def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Indicates if current platform supports use of SCO for off call use cases. 9513def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Application wanted to use bluetooth SCO audio when the phone is not in call 9523def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * must first call thsi method to make sure that the platform supports this 9533def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * feature. 9543def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @return true if bluetooth SCO can be used for audio when not in call 9553def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * false otherwise 9563def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 9573def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 9583def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public boolean isBluetoothScoAvailableOffCall() { 9593def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent return mContext.getResources().getBoolean( 9603def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent com.android.internal.R.bool.config_bluetooth_sco_off_call); 9613def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 9623def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 9633def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 9643def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Start bluetooth SCO audio connection. 9653def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 9663def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 9673def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method can be used by applications wanting to send and received audio 9683def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * to/from a bluetooth SCO headset while the phone is not in call. 9693def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>As the SCO connection establishment can take several seconds, 9703def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * applications should not rely on the connection to be available when the method 971dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} 9723def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. 973dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO 974dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * audio state before calling startBluetoothSco() by reading the intent returned by the receiver 975dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * registration. If the state is already CONNECTED, no state change will be received via the 976dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() 977dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * so that the connection stays active in case the current initiator stops the connection. 978dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>Unless the connection is already active as described above, the state will always 979dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection 980dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). 981dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <p>When finished with the SCO connection or if the establishment fails, the application must 982dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. 9833def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Even if a SCO connection is established, the following restrictions apply on audio 9843def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * output streams so that they can be routed to SCO headset: 985dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 986dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the stream type must be {@link #STREAM_VOICE_CALL} </li> 987dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 988dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 16kHz or 8kHz </li> 989dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 9903def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>The following restrictions apply on input streams: 991dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <ul> 992dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the format must be mono </li> 993dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * <li> the sampling must be 8kHz </li> 994dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * </ul> 9953def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Note that the phone application always has the priority on the usage of the SCO 9963def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * connection for telephony. If this method is called while the phone is in call 9973def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * it will be ignored. Similarly, if a call is received or sent while an application 9983def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * is using the SCO connection, the connection will be lost for the application and NOT 9993def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * returned automatically when the call ends. 10003def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #stopBluetoothSco() 1001dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * @see #ACTION_SCO_AUDIO_STATE_UPDATED 10023def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 10033def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void startBluetoothSco(){ 10043def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 10053def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 10063def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.startBluetoothSco(mICallBack); 10073def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 10083def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in startBluetoothSco", e); 10093def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 10103def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 10113def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 10123def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent /** 10133def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * Stop bluetooth SCO audio connection. 10143def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>Requires Permission: 10153def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. 10163def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * <p>This method must be called by applications having requested the use of 10173def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * bluetooth SCO audio with {@link #startBluetoothSco()} 1018dc03c61fe3cd8d0805480e48a974986439977a60Eric Laurent * when finished with the SCO connection or if connection fails. 10193def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent * @see #startBluetoothSco() 10203def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent */ 10213def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent public void stopBluetoothSco(){ 10223def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent IAudioService service = getService(); 10233def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent try { 10243def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent service.stopBluetoothSco(mICallBack); 10253def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } catch (RemoteException e) { 10263def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent Log.e(TAG, "Dead object in stopBluetoothSco", e); 10273def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 10283def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent } 10293def1eec2baed0b8845ec32c871e249dc533a9d9Eric Laurent 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1031a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Request use of Bluetooth SCO headset for communications. 1032fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1033fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1034fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1036a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param on set <var>true</var> to use bluetooth SCO for communications; 1037a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * <var>false</var> to not use bluetooth SCO for communications 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBluetoothScoOn(boolean on){ 1040c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1041c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1042c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent service.setBluetoothScoOn(on); 1043c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1044c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in setBluetoothScoOn", e); 1045a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1049a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Checks whether communications use Bluetooth SCO. 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1051a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return true if SCO is used for communications; 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothScoOn() { 1055c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent IAudioService service = getService(); 1056c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent try { 1057c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent return service.isBluetoothScoOn(); 1058c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent } catch (RemoteException e) { 1059c42ac9d4d03f62c3a1ba197a28a81fda44bd8b7fEric Laurent Log.e(TAG, "Dead object in isBluetoothScoOn", e); 1060a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1061a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route A2DP audio to/from Bluetooth 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable A2DP audio 1067a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1069a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setBluetoothA2dpOn(boolean on){ 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether A2DP audio routing to the Bluetooth headset is on or off. 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if A2DP audio is being routed to/from Bluetooth headset; 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isBluetoothA2dpOn() { 10798b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") 1080a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1081a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1082a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1083a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1084a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets audio routing to the wired headset on or off. 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to route audio to/from wired 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * headset; <var>false</var> disable wired headset audio 1092a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Do not use. 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1094a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setWiredHeadsetOn(boolean on){ 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1098497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * Checks whether a wired headset is connected or not. 1099497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * <p>This is not a valid indication that audio playback is 1100497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * actually over the wired headset as audio routing depends on other conditions. 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1102497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @return true if a wired headset is connected. 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if otherwise 1104497b3fe7257d5bbee7762455c6988915bde21601Eric Laurent * @deprecated Use only to check is a headset is connected or not. 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWiredHeadsetOn() { 11078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") 11086015a9715421a339c2b7bb63f9166504e3488179Eric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE && 11098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") 1110a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent == AudioSystem.DEVICE_STATE_UNAVAILABLE) { 1111a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return false; 1112a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } else { 1113a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return true; 1114a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the microphone mute on or off. 1119fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1120fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * This method should only be used by applications that replace the platform-wide 1121fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * management of audio settings or the main telephony application. 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param on set <var>true</var> to mute the microphone; 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>false</var> to turn mute off 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMicrophoneMute(boolean on){ 1127a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.muteMicrophone(on); 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether the microphone mute is on or off. 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if microphone is muted, false if it's not 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMicrophoneMute() { 1136a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.isMicrophoneMuted(); 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio mode. 1141fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * <p> 1142fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * The audio mode encompasses audio routing AND the behavior of 1143fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * the telephony layer. Therefore this method should only be used by applications that 1144fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * replace the platform-wide management of audio settings or the main telephony application. 1145fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony 1146fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * application when it places a phone call, as it will cause signals from the radio layer 1147fccb25d2074358c54d4c60eb321aeaa08a5de59aJean-Michel Trivi * to feed the platform mixer. 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11498aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 11508aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Informs the HAL about the current audio state so that 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it can route the audio appropriately. 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMode(int mode) { 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11579272b4b4a44fe1f33e3030810618194f817caaecEric Laurent service.setMode(mode, mICallBack); 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in setMode", e); 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio mode. 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11668aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, 11678aa798b244e32e227bad97d40ddfd7d3557030a3Jean-Michel Trivi * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current current audio state from the HAL. 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getMode() { 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return service.getMode(); 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in getMode", e); 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return MODE_INVALID; 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* modes for setMode/getMode/setRoute/getRoute */ 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Audio harware modes. 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalid audio mode. 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_INVALID = AudioSystem.MODE_INVALID; 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Current audio mode. Used to apply audio routing to current mode. 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normal audio mode: not ringing and no call established. 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Ringing audio mode. An incoming is being signaled. 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12018f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In call audio mode. A telephony call is established. 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; 12048f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi /** 12058f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi * In communication audio mode. An audio/video chat or VoIP call is established. 12068f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi */ 12078f677d66d9c3ba34c97e69b2bb9e161f129af0eeJean-Michel Trivi public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Routing bits for setRouting/getRouting API */ 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to earpiece 12124a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12134a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1215a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12174a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * Routing audio output to speaker 12184a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12194a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1221a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} 12244a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12254a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth SCO 12304a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12314a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1233a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to headset 12364a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12374a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Routing audio output to bluetooth A2DP 12424a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12434a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1245a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used for mask parameter of {@link #setRouting(int,int,int)}. 12484a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 12494a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * setBluetoothScoOn() methods instead. 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1251a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the audio routing for a specified mode 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to change route. E.g., MODE_RINGTONE. 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param routes bit vector of routes requested, created from one or 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more of ROUTE_xxx types. Set bits indicate that route should be on 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mask bit vector of routes to change, created from one or more of 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ROUTE_xxx types. Unset bits indicate the route should be left unchanged 1261b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * 1262b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), 1263a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * setBluetoothScoOn() methods instead. 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1265a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRouting(int mode, int routes, int mask) { 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current audio routing bit vector for a specified mode. 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode audio mode to get route (e.g., MODE_RINGTONE) 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an audio route bit vector that can be compared with ROUTE_xxx 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bits 1275b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), 1276b9c9d260f21b321527c4622a123af9767630d94dEric Laurent * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1278b9c9d260f21b321527c4622a123af9767630d94dEric Laurent @Deprecated 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRouting(int mode) { 1280a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return -1; 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether any music is active. 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if any music tracks are active. 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isMusicActive() { 128925101b0b9a84571ead15b26e9f4cd9c4298d7823Eric Laurent return AudioSystem.isStreamActive(STREAM_MUSIC, 0); 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a generic audio configuration parameter. The use of these parameters 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are platform dependant, see libaudio 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Temporary interface - DO NOT USE 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * TODO: Replace with a more generic key:value get/set mechanism 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param key name of parameter to set. Must not be null. 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * param value value of parameter. Must not be null. 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1305a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @deprecated Use {@link #setPrameters(String)} instead 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1307a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent @Deprecated public void setParameter(String key, String value) { 1308a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent setParameters(key+"="+value); 1309a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1310a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1311a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1312a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a variable number of parameter values to audio hardware. 1313a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1314a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keyValuePairs list of parameters key value pairs in the form: 1315a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1316a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1317a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1318a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public void setParameters(String keyValuePairs) { 1319a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent AudioSystem.setParameters(keyValuePairs); 1320a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent } 1321a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent 1322a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent /** 1323a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * Sets a varaible number of parameter values to audio hardware. 1324a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * 1325a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @param keys list of parameters 1326a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * @return list of parameters key value pairs in the form: 1327a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * key1=value1;key2=value2;... 1328a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent */ 1329a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent public String getParameters(String keys) { 1330a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent return AudioSystem.getParameters(keys); 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Sound effect identifiers */ 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Keyboard and direction pad click sound 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEY_CLICK = 0; 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved up 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_UP = 1; 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved down 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_DOWN = 2; 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved left 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_LEFT = 3; 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Focus has moved right 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME standard keypress sound 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_STANDARD = 5; 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME spacebar keypress sound 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_SPACEBAR = 6; 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME delete keypress sound 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_DELETE = 7; 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IME return_keypress sound 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #playSoundEffect(int) 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FX_KEYPRESS_RETURN = 8; 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide Number of sound effects 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int NUM_SOUND_EFFECTS = 9; 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1392105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1393105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1394105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1395105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version uses the UI settings to determine 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whether sounds are heard or not. 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType) { 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!querySoundEffectsEnabled()) { 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffect(effectType); 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Plays a sound effect (Key clicks, lid open/close...) 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param effectType The type of sound effect. One of 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_KEY_CLICK}, 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_UP}, 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_DOWN}, 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_LEFT}, 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FX_FOCUS_NAVIGATION_RIGHT}, 1424105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_STANDARD}, 1425105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_SPACEBAR}, 1426105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_DELETE}, 1427105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * {@link #FX_KEYPRESS_RETURN}, 1428a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * @param volume Sound effect volume. 1429a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * The volume value is a raw scalar so UI controls should be scaled logarithmically. 1430a2ef57dba9ac77d8eccacd646b2b8a8d99fe9d8bEric Laurent * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * NOTE: This version is for applications that have their own 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings panel for enabling and controlling volume. 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void playSoundEffect(int effectType, float volume) { 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.playSoundEffectVolume(effectType, volume); 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in playSoundEffect"+e); 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings has an in memory cache, so this is fast. 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean querySoundEffectsEnabled() { 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Settings.System.getInt(mContext.getContentResolver(), Settings.System.SOUND_EFFECTS_ENABLED, 0) != 0; 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Load Sound effects. 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method must be called when sound effects are enabled. 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void loadSoundEffects() { 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.loadSoundEffects(); 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in loadSoundEffects"+e); 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unload Sound effects. 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method can be called to free some memory when 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sound effects are disabled. 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unloadSoundEffects() { 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IAudioService service = getService(); 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project service.unloadSoundEffects(); 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Dead object in unloadSoundEffects"+e); 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14824050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent /** 1483d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. 14847f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1485d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1486d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1487d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN = 1; 1488d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1489d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Used to indicate a temporary gain or request of audio focus, anticipated to last a short 1490d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * amount of time. Examples of temporary changes are the playback of driving directions, or an 1491d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * event notification. 14927f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1493d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1494d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1495d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; 1496078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1497078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a temporary request of audio focus, anticipated to last a short 1498983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * amount of time, and where it is acceptable for other audio applications to keep playing 1499983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * after having lowered their output level (also referred to as "ducking"). 1500078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Examples of temporary changes are the playback of driving directions where playback of music 1501078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * in the background is acceptable. 15027f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1503078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) 1504078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1505078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; 1506078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1507078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a loss of audio focus of unknown duration. 15087f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1509078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1510078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; 1511078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1512078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus. 15137f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1514078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1515078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; 1516078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi /** 1517078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Used to indicate a transient loss of audio focus where the loser of the audio focus can 1518983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * lower its output volume if it wants to continue playing (also referred to as "ducking"), as 1519983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the new focus owner doesn't require others to be silent. 15207f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi * @see OnAudioFocusChangeListener#onAudioFocusChange(int) 1521078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi */ 1522078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = 1523078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; 1524d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1525d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1526d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Interface definition for a callback to be invoked when the audio focus of the system is 1527d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * updated. 1528d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1529d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public interface OnAudioFocusChangeListener { 1530d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1531d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Called on the listener to notify it the audio focus for this listener has been changed. 1532d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * The focusChange value indicates whether the focus was gained, 1533d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * whether the focus was lost, and whether that loss is transient, or whether the new focus 1534d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * holder will hold it for an unknown amount of time. 1535983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * When losing focus, listeners can use the focus change information to decide what 1536983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * behavior to adopt when losing focus. A music player could for instance elect to lower 1537983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the volume of its music stream (duck) for transient focus losses, and pause otherwise. 1538983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, 1539078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} 1540983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. 1541d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 15427f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi public void onAudioFocusChange(int focusChange); 1543d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1544d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1545d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1546d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, 1547d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * to actual listener objects. 1548d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 154930c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final HashMap<String, OnAudioFocusChangeListener> mAudioFocusIdListenerMap = 1550d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi new HashMap<String, OnAudioFocusChangeListener>(); 1551d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1552d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager 1553d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * instance. 1554d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1555d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Object mFocusListenerLock = new Object(); 1556d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1557d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private OnAudioFocusChangeListener findFocusListener(String id) { 1558d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi return mAudioFocusIdListenerMap.get(id); 1559d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1560d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1561d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1562d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Handler for audio focus events coming from the audio service. 1563d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 156430c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = 1565d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi new FocusEventHandlerDelegate(); 1566078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi 1567d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1568d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Helper class to handle the forwarding of audio focus events to the appropriate listener 1569d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1570d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private class FocusEventHandlerDelegate { 1571d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi private final Handler mHandler; 1572d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1573d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi FocusEventHandlerDelegate() { 1574d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Looper looper; 1575d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if ((looper = Looper.myLooper()) == null) { 1576d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi looper = Looper.getMainLooper(); 1577d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1578d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1579d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (looper != null) { 1580d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // implement the event handler delegate to receive audio focus events 1581d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = new Handler(looper) { 1582d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi @Override 1583d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void handleMessage(Message msg) { 1584d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi OnAudioFocusChangeListener listener = null; 1585d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1586d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi listener = findFocusListener((String)msg.obj); 1587d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1588d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (listener != null) { 15897f7e67f1b60b7840011236097baad9df6dd74c20Jean-Michel Trivi listener.onAudioFocusChange(msg.what); 1590d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1591d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1592d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1593d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1594d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi mHandler = null; 1595d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1596d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1597d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1598d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi Handler getHandler() { 1599d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return mHandler; 1600d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1601d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1602d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 160330c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { 1604d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1605d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void dispatchAudioFocusChange(int focusChange, String id) { 1606d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); 1607d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); 1608d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1609d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1610d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi }; 1611d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1612d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { 1613d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi if (l == null) { 1614308e9a5d0975489982f93fd1f3728e6ed7a778d0Jean-Michel Trivi return new String(this.toString()); 1615d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } else { 1616d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return new String(this.toString() + l.toString()); 1617d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1618d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1619d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1620d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 16215f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 162246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Registers a listener to be called when audio focus changes. Calling this method is optional 162346b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it 162446b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * will register the listener as well if it wasn't registered already. 162546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to be notified of audio focus changes. 1626d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1627d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void registerAudioFocusListener(OnAudioFocusChangeListener l) { 1628d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1629d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { 1630d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return; 1631d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1632d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); 1633d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1634d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1635d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1636d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 16375f53f0883a507b9d4b9b9891af560a64f746d149Xavier Ducrohet * @hide 163846b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Causes the specified listener to not be called anymore when focus is gained or lost. 163946b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener to unregister. 1640d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1641d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { 1642392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi 1643d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi // remove locally 1644d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi synchronized(mFocusListenerLock) { 1645d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); 1646d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1647d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1648d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1649d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1650d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 165146b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A failed focus change request. 1652d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1653d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_FAILED = 0; 1654d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 165546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * A successful focus change request. 1656d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1657d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; 1658d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1659d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1660d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 1661d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * Request audio focus. 166246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Send a request to obtain the audio focus 1663d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param l the listener to be notified of audio focus changes 1664d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param streamType the main audio stream type affected by the focus request 1665d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request 1666d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * is temporary, and focus will be abandonned shortly. Examples of transient requests are 1667078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * for the playback of driving directions, or notifications sounds. 1668983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for 1669983ac2b8cff85dda1f55b0d7779a33248b3fa7cfJean-Michel Trivi * the previous focus owner to keep playing if it ducks its audio output. 1670078fd47e91d495175927d1a4a8b9aad039a7ba4eJean-Michel Trivi * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such 1671d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * as the playback of a song or a video. 1672d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 1673d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1674d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { 1675d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 167655d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi if ((durationHint < AUDIOFOCUS_GAIN) || (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK)) 167755d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi { 167855d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi Log.e(TAG, "Invalid duration hint, audio focus request denied"); 167955d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi return status; 168055d1bb3483e17a11d122e68044e552d96ab55ff4Jean-Michel Trivi } 1681d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi registerAudioFocusListener(l); 1682d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi //TODO protect request by permission check? 1683d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 1684d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 1685d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi status = service.requestAudioFocus(streamType, durationHint, mICallBack, 16868f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mAudioFocusDispatcher, getIdForAudioFocusListener(l), 16878f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi mContext.getPackageName() /* package name */); 1688d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 16894dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocus() on AudioService due to "+e); 1690d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1691d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 1692d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1693d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 16944dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 16954dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 16964dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to request audio focus. Will cause the focus request 16974dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to be associated with the "voice communication" identifier only used in AudioService 16984dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * to identify this use case. 16994dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param streamType use STREAM_RING for focus requests when ringing, VOICE_CALL for 17004dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * the establishment of the call 17014dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @param durationHint the type of focus request. AUDIOFOCUS_GAIN_TRANSIENT is recommended so 17024dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * media applications resume after a call 17034dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 17044dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void requestAudioFocusForCall(int streamType, int durationHint) { 17054dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 17064dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 17074dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi service.requestAudioFocus(streamType, durationHint, mICallBack, null, 17084dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi AudioService.IN_VOICE_COMM_FOCUS_ID, 17094dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi "system" /* dump-friendly package name */); 17104dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 17114dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call requestAudioFocusForCall() on AudioService due to "+e); 17124dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 17134dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 17144dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi 17154dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi /** 17164dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * @hide 17174dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Used internally by telephony package to abandon audio focus, typically after a call or 17184dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * when ringing ends and the call is rejected or not answered. 17194dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi * Should match one or more calls to {@link #requestAudioFocusForCall(int, int)}. 17204dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi */ 17214dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi public void abandonAudioFocusForCall() { 17224dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi IAudioService service = getService(); 17234dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi try { 17244dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi service.abandonAudioFocus(null, AudioService.IN_VOICE_COMM_FOCUS_ID); 17254dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } catch (RemoteException e) { 17264dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocusForCall() on AudioService due to "+e); 17274dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 17284dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi } 1729d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1730d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi /** 173146b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. 173246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param l the listener with which focus was requested. 1733d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} 1734d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi */ 1735d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi public int abandonAudioFocus(OnAudioFocusChangeListener l) { 1736d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi int status = AUDIOFOCUS_REQUEST_FAILED; 1737392a2bbb52688ebd25768a7784d9edca7f498110Jean-Michel Trivi unregisterAudioFocusListener(l); 1738d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi IAudioService service = getService(); 1739d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi try { 1740d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi status = service.abandonAudioFocus(mAudioFocusDispatcher, 1741d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi getIdForAudioFocusListener(l)); 1742d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } catch (RemoteException e) { 17434dd3674e517051f130fef36d2eb201c68ff61094Jean-Michel Trivi Log.e(TAG, "Can't call abandonAudioFocus() on AudioService due to "+e); 1744d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1745d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi return status; 1746d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi } 1747d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1748d5176cfe6eae954e9cef1e2ec17859a5089e1330Jean-Michel Trivi 1749d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi //==================================================================== 1750d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi // Remote Control 1751d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 175246b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Register a component to be the sole receiver of MEDIA_BUTTON intents. 1753d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 1754d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi * that will receive the media button intent. This broadcast receiver must be declared 1755f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * in the application manifest. The package of the component must match that of 1756f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * the context you're registering from. 1757d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 1758d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { 17598f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 17608f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 17618f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 1762f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if (!eventReceiver.getPackageName().equals(mContext.getPackageName())) { 1763f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "registerMediaButtonEventReceiver() error: " + 1764f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi "receiver and context package names don't match"); 1765f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 1766f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 1767f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and register it 1768f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 1769f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 1770f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 1771f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 1772f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 1773f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi registerMediaButtonIntent(pi, eventReceiver); 1774f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 1775f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 1776f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 1777f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 1778f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * no-op if (pi == null) or (eventReceiver == null) 1779f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 1780f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi public void registerMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { 1781f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((pi == null) || (eventReceiver == null)) { 1782f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Cannot call registerMediaButtonIntent() with a null parameter"); 1783f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi return; 1784f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 1785d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 1786d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 1787f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // pi != null 1788f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi service.registerMediaButtonIntent(pi, eventReceiver); 1789d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 1790f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Dead object in registerMediaButtonIntent"+e); 1791d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1792d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1793d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 1794d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi /** 179546b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * Unregister the receiver of MEDIA_BUTTON intents. 179646b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} 179746b3a1808a8e6fc60079af3c2292fd784a7bb0fcJean-Michel Trivi * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. 1798d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi */ 1799d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { 18008f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi if (eventReceiver == null) { 18018f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 18028f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 1803f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // construct a PendingIntent for the media button and unregister it 1804f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); 1805f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi // the associated intent will be handled by the component being registered 1806f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi mediaButtonIntent.setComponent(eventReceiver); 1807f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi PendingIntent pi = PendingIntent.getBroadcast(mContext, 1808f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); 1809f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi unregisterMediaButtonIntent(pi, eventReceiver); 1810f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi } 1811f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi 1812f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi /** 1813f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi * @hide 1814f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi */ 1815f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi public void unregisterMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { 1816d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi IAudioService service = getService(); 1817d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi try { 1818f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi service.unregisterMediaButtonIntent(pi, eventReceiver); 1819d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } catch (RemoteException e) { 1820f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterMediaButtonIntent"+e); 1821d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1822d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi } 1823d327f21626217aa3c9c0cdb7a84a742c531e59a3Jean-Michel Trivi 1824178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 1825178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * Registers the remote control client for providing information to display on the remote 1826178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * controls. 1827466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client from which remote controls will receive 1828466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * information to display. 1829466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @see RemoteControlClient 18308f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 18314426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void registerRemoteControlClient(RemoteControlClient rcClient) { 1832f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 18338f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 18348f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18358f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 18368f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 1837f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi service.registerRemoteControlClient(rcClient.getRcMediaIntent(), /* mediaIntent */ 18384426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi rcClient.getIRemoteControlClient(), /* rcClient */ 18398f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi // used to match media button event receiver and audio focus 18404426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi mContext.getPackageName()); /* packageName */ 18418f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 18428f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlClient"+e); 18438f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18448f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18458f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 18468f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 1847fcd693a21d862ea765006f8987b8dd4b125b28c5Jean-Michel Trivi * Unregisters the remote control client that was providing information to display on the 1848466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * remote controls. 1849466ade5ad66e7bfb1814d5e5ac76a17f8a0bcd3aJean-Michel Trivi * @param rcClient The remote control client to unregister. 18504426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi * @see #registerRemoteControlClient(RemoteControlClient) 18518f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 18524426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi public void unregisterRemoteControlClient(RemoteControlClient rcClient) { 1853f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { 18548f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi return; 18558f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18568f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi IAudioService service = getService(); 18578f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi try { 1858f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi service.unregisterRemoteControlClient(rcClient.getRcMediaIntent(), /* mediaIntent */ 1859f0cff0456258478ba768097f73d4367ab67fd7a3Jean-Michel Trivi rcClient.getIRemoteControlClient()); /* rcClient */ 18608f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } catch (RemoteException e) { 18618f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlClient"+e); 18628f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18638f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi } 18648f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 186544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 186644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 186744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Registers a remote control display that will be sent information by remote control clients. 186844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 186944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 187044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void registerRemoteControlDisplay(IRemoteControlDisplay rcd) { 187144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 187244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 187344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 187444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 187544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 187644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.registerRemoteControlDisplay(rcd); 187744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 187844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); 187944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 188044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 188144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 188244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 188344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 188444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Unregisters a remote control display that was sent information by remote control clients. 188544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 188644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 188744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void unregisterRemoteControlDisplay(IRemoteControlDisplay rcd) { 188844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 188944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 189044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 189144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 189244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 189344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.unregisterRemoteControlDisplay(rcd); 189444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 189544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); 189644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 189744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 189844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi 189944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi /** 190044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @hide 190144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * Sets the artwork size a remote control display expects when receiving bitmaps. 190244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param rcd 190344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param w the maximum width of the expected bitmap. Negative values indicate it is 190444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 190544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * @param h the maximum height of the expected bitmap. Negative values indicate it is 190644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi * useless to send artwork. 190744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi */ 190844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi public void remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay rcd, int w, int h) { 190944413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi if (rcd == null) { 191044413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi return; 191144413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 191244413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi IAudioService service = getService(); 191344413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi try { 191444413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi service.remoteControlDisplayUsesBitmapSize(rcd, w, h); 191544413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } catch (RemoteException e) { 191644413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi Log.e(TAG, "Dead object in remoteControlDisplayUsesBitmapSize " + e); 191744413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 191844413e5b514a91806a4bb4c7780029ea43be6f81Jean-Michel Trivi } 1919ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh 19204426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi // FIXME remove because we are not using intents anymore between AudioService and RcDisplay 1921ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh /** 1922ced110ec5970c632f523dfc0350b6071461ea9bcNeel Parekh * @hide 19238f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * Broadcast intent action indicating that the displays on the remote controls 19248f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * should be updated because a new remote control client is now active. If there is no 19258f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * {@link #EXTRA_REMOTE_CONTROL_CLIENT}, the remote control display should be cleared 19268f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * because there is no valid client to supply it with information. 19278f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * 19288f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @see #EXTRA_REMOTE_CONTROL_CLIENT 19298f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 19308f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi public static final String REMOTE_CONTROL_CLIENT_CHANGED = 19318f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi "android.media.REMOTE_CONTROL_CLIENT_CHANGED"; 19328f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 19334426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi // FIXME remove because we are not using intents anymore between AudioService and RcDisplay 19348f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 19358f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @hide 1936178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * The IRemoteControlClientDispatcher monotonically increasing generation counter. 1937178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * 1938178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 1939178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi */ 1940178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_CLIENT_GENERATION = 1941178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_CLIENT_GENERATION"; 1942178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi 19434426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi // FIXME remove because we are not using intents anymore between AudioService and RcDisplay 1944178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi /** 1945178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * @hide 1946178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * The name of the RemoteControlClient. 1947178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * This String is passed as the client name when calling methods from the 1948178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * IRemoteControlClientDispatcher interface. 19498f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * 19508f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 19518f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi */ 1952178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_CLIENT_NAME = 1953178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_CLIENT_NAME"; 19548f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi 19554426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi // FIXME remove because we are not using intents anymore between AudioService and RcDisplay 19568f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi /** 19578f619182cb759718f64ab95fd6d61c16138f6952Jean-Michel Trivi * @hide 1958178889eff7fa3361a5cb08d6d43846a1baf5216bJean-Michel Trivi * The media button event receiver associated with the RemoteControlClient. 19590a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * The {@link android.content.ComponentName} value of the event receiver can be retrieved with 19600a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * {@link android.content.ComponentName#unflattenFromString(String)} 19610a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * 19620a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 19630a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi */ 19640a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_EVENT_RECEIVER = 19650a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_EVENT_RECEIVER"; 19660a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi 19674426e42ac6107bf6b09f7c4cdad39eb161d8b9caJean-Michel Trivi // FIXME remove because we are not using intents anymore between AudioService and RcDisplay 19680a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi /** 19690a9faa8cf934ef38319cd945b600825c6bb88b9cJean-Michel Trivi * @hide 1970b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi * The flags describing what information has changed in the current remote control client. 1971b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi * 1972b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION 1973b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi */ 1974b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi public static final String EXTRA_REMOTE_CONTROL_CLIENT_INFO_CHANGED = 1975b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi "android.media.EXTRA_REMOTE_CONTROL_CLIENT_INFO_CHANGED"; 1976b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi 1977b5f04d6dbf5106140df367ae07f0e7708e1b650eJean-Michel Trivi /** 19784050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * @hide 19794050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * Reload audio settings. This method is called by Settings backup 19804050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * agent when audio settings are restored and causes the AudioService 19814050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent * to read and apply restored settings. 19824050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent */ 19834050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent public void reloadAudioSettings() { 19844050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent IAudioService service = getService(); 19854050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent try { 19864050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent service.reloadAudioSettings(); 19874050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } catch (RemoteException e) { 19884050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent Log.e(TAG, "Dead object in reloadAudioSettings"+e); 19894050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 19904050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent } 19914050c93601b3c3609b21cc1e18a29b64747e7fa9Eric Laurent 19929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 19949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 199530c918ce7fbe171944b28fc91b3f22b3d631872dGlenn Kasten private final IBinder mICallBack = new Binder(); 19967f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 19977f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten /** 19987f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * Checks whether the phone is in silent mode, with or without vibrate. 19997f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 20007f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @return true if phone is in silent mode, with or without vibrate. 20017f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 20027f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @see #getRingerMode() 20037f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * 20047f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten * @hide pending API Council approval 20057f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten */ 20067f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten public boolean isSilentMode() { 20077f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten int ringerMode = getRingerMode(); 20087f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten boolean silentMode = 20097f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_SILENT) || 20107f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten (ringerMode == RINGER_MODE_VIBRATE); 20117f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten return silentMode; 20127f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten } 20137f9b1fa6719dde575f8ea9858313358733fbd6c9Glenn Kasten 20148b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // This section re-defines new output device constants from AudioSystem, because the AudioSystem 20158b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // class is not used by other parts of the framework, which instead use definitions and methods 20168b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. 20178b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 20188b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the small speaker at the front of the device used 20198b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * when placing calls. Does not refer to an in-ear headphone without attached microphone, 20208b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a 20218b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}. 20228b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20238b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; 20248b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for the built-in speaker */ 20258b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; 20268b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headset with attached microphone */ 20278b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; 20288b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a wired headphone without attached microphone */ 20298b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; 20308b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth SCO, for voice */ 20318b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; 20328b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO Headset Profile (HSP) and 20338b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Hands-Free Profile (HFP), for voice 20348b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20358b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 20368b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; 20378b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth SCO car audio, for voice */ 20388b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 20398b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; 20408b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for generic Bluetooth A2DP, for music */ 20418b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; 20428b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP headphones, for music */ 20438b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 20448b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; 20458b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for Bluetooth A2DP external speaker, for music */ 20468b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 20478b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; 20488b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for S/PDIF or HDMI */ 20498b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; 20508b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for an analog wired headset attached via a 20518b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 20528b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20538b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; 20548b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} The audio output device code for a digital wired headset attached via a 20558b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * docking station 20568b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20578b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; 20588b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** {@hide} This is not used as a returned value from {@link #getDevicesForStream}, but could be 20598b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * used in the future in a set method to select whatever default device is chosen by the 20608b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * platform-specific implementation. 20618b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 20628b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; 20638b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 20648b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten /** 20658b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Return the enabled devices for the specified output stream type. 20668b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20678b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @param streamType The stream type to query. One of 20688b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_VOICE_CALL}, 20698b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_SYSTEM}, 20708b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_RING}, 20718b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_MUSIC}, 20728b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_ALARM}, 20738b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_NOTIFICATION}, 20748b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #STREAM_DTMF}. 20758b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20768b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * @return The bit-mask "or" of audio output device codes for all enabled devices on this 20778b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * stream. Zero or more of 20788b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_EARPIECE}, 20798b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_SPEAKER}, 20808b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADSET}, 20818b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_WIRED_HEADPHONE}, 20828b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO}, 20838b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, 20848b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, 20858b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, 20868b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, 20878b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, 20888b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_AUX_DIGITAL}, 20898b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, 20908b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. 20918b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@link #DEVICE_OUT_DEFAULT} is not used here. 20928b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20938b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * The implementation may support additional device codes beyond those listed, so 20948b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * the application should ignore any bits which it does not recognize. 20958b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * Note that the information may be imprecise when the implementation 20968b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * cannot distinguish whether a particular device is enabled. 20978b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * 20988b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten * {@hide} 20998b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten */ 21008b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten public int getDevicesForStream(int streamType) { 21018b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten switch (streamType) { 21028b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_VOICE_CALL: 21038b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_SYSTEM: 21048b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_RING: 21058b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_MUSIC: 21068b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_ALARM: 21078b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_NOTIFICATION: 21088b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten case STREAM_DTMF: 21098b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return AudioSystem.getDevicesForStream(streamType); 21108b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten default: 21118b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten return 0; 21128b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 21138b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten } 21148b4b97a14ad9b5b982d8fe92755efabec8ad0076Glenn Kasten 21159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2116