/* * Copyright (C) 2007 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.media; import android.annotation.SdkConstant; import android.annotation.SdkConstant.SdkConstantType; import android.app.PendingIntent; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.database.ContentObserver; import android.graphics.Bitmap; import android.os.Binder; import android.os.Handler; import android.os.IBinder; import android.os.Looper; import android.os.Message; import android.os.RemoteException; import android.os.SystemClock; import android.os.ServiceManager; import android.provider.Settings; import android.util.Log; import android.view.KeyEvent; import android.view.VolumePanel; import java.util.Iterator; import java.util.HashMap; /** * AudioManager provides access to volume and ringer mode control. *

* Use Context.getSystemService(Context.AUDIO_SERVICE) to get * an instance of this class. */ public class AudioManager { private final Context mContext; private final Handler mHandler; private long mVolumeKeyUpTime; private int mVolumeControlStream = -1; private static String TAG = "AudioManager"; private static boolean localLOGV = false; /** * Broadcast intent, a hint for applications that audio is about to become * 'noisy' due to a change in audio outputs. For example, this intent may * be sent when a wired headset is unplugged, or when an A2DP audio * sink is disconnected, and the audio system is about to automatically * switch audio route to the speaker. Applications that are controlling * audio streams may consider pausing, reducing volume or some other action * on receipt of this intent so as not to surprise the user with audio * from the speaker. */ @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String ACTION_AUDIO_BECOMING_NOISY = "android.media.AUDIO_BECOMING_NOISY"; /** * Sticky broadcast intent action indicating that the ringer mode has * changed. Includes the new ringer mode. * * @see #EXTRA_RINGER_MODE */ @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; /** * The new ringer mode. * * @see #RINGER_MODE_CHANGED_ACTION * @see #RINGER_MODE_NORMAL * @see #RINGER_MODE_SILENT * @see #RINGER_MODE_VIBRATE */ public static final String EXTRA_RINGER_MODE = "android.media.EXTRA_RINGER_MODE"; /** * Broadcast intent action indicating that the vibrate setting has * changed. Includes the vibrate type and its new setting. * * @see #EXTRA_VIBRATE_TYPE * @see #EXTRA_VIBRATE_SETTING */ @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String VIBRATE_SETTING_CHANGED_ACTION = "android.media.VIBRATE_SETTING_CHANGED"; /** * @hide Broadcast intent when the volume for a particular stream type changes. * Includes the stream, the new volume and previous volumes * * @see #EXTRA_VOLUME_STREAM_TYPE * @see #EXTRA_VOLUME_STREAM_VALUE * @see #EXTRA_PREV_VOLUME_STREAM_VALUE */ @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String VOLUME_CHANGED_ACTION = "android.media.VOLUME_CHANGED_ACTION"; /** * The new vibrate setting for a particular type. * * @see #VIBRATE_SETTING_CHANGED_ACTION * @see #EXTRA_VIBRATE_TYPE * @see #VIBRATE_SETTING_ON * @see #VIBRATE_SETTING_OFF * @see #VIBRATE_SETTING_ONLY_SILENT */ public static final String EXTRA_VIBRATE_SETTING = "android.media.EXTRA_VIBRATE_SETTING"; /** * The vibrate type whose setting has changed. * * @see #VIBRATE_SETTING_CHANGED_ACTION * @see #VIBRATE_TYPE_NOTIFICATION * @see #VIBRATE_TYPE_RINGER */ public static final String EXTRA_VIBRATE_TYPE = "android.media.EXTRA_VIBRATE_TYPE"; /** * @hide The stream type for the volume changed intent. */ public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE"; /** * @hide The volume associated with the stream for the volume changed intent. */ public static final String EXTRA_VOLUME_STREAM_VALUE = "android.media.EXTRA_VOLUME_STREAM_VALUE"; /** * @hide The previous volume associated with the stream for the volume changed intent. */ public static final String EXTRA_PREV_VOLUME_STREAM_VALUE = "android.media.EXTRA_PREV_VOLUME_STREAM_VALUE"; /** The audio stream for phone calls */ public static final int STREAM_VOICE_CALL = AudioSystem.STREAM_VOICE_CALL; /** The audio stream for system sounds */ public static final int STREAM_SYSTEM = AudioSystem.STREAM_SYSTEM; /** The audio stream for the phone ring */ public static final int STREAM_RING = AudioSystem.STREAM_RING; /** The audio stream for music playback */ public static final int STREAM_MUSIC = AudioSystem.STREAM_MUSIC; /** The audio stream for alarms */ public static final int STREAM_ALARM = AudioSystem.STREAM_ALARM; /** The audio stream for notifications */ public static final int STREAM_NOTIFICATION = AudioSystem.STREAM_NOTIFICATION; /** @hide The audio stream for phone calls when connected to bluetooth */ public static final int STREAM_BLUETOOTH_SCO = AudioSystem.STREAM_BLUETOOTH_SCO; /** @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ public static final int STREAM_SYSTEM_ENFORCED = AudioSystem.STREAM_SYSTEM_ENFORCED; /** The audio stream for DTMF Tones */ public static final int STREAM_DTMF = AudioSystem.STREAM_DTMF; /** @hide The audio stream for text to speech (TTS) */ public static final int STREAM_TTS = AudioSystem.STREAM_TTS; /** Number of audio streams */ /** * @deprecated Use AudioSystem.getNumStreamTypes() instead */ @Deprecated public static final int NUM_STREAMS = AudioSystem.NUM_STREAMS; /** @hide Default volume index values for audio streams */ public static final int[] DEFAULT_STREAM_VOLUME = new int[] { 4, // STREAM_VOICE_CALL 7, // STREAM_SYSTEM 5, // STREAM_RING 11, // STREAM_MUSIC 6, // STREAM_ALARM 5, // STREAM_NOTIFICATION 7, // STREAM_BLUETOOTH_SCO 7, // STREAM_SYSTEM_ENFORCED 11, // STREAM_DTMF 11 // STREAM_TTS }; /** * Increase the ringer volume. * * @see #adjustVolume(int, int) * @see #adjustStreamVolume(int, int, int) */ public static final int ADJUST_RAISE = 1; /** * Decrease the ringer volume. * * @see #adjustVolume(int, int) * @see #adjustStreamVolume(int, int, int) */ public static final int ADJUST_LOWER = -1; /** * Maintain the previous ringer volume. This may be useful when needing to * show the volume toast without actually modifying the volume. * * @see #adjustVolume(int, int) * @see #adjustStreamVolume(int, int, int) */ public static final int ADJUST_SAME = 0; // Flags should be powers of 2! /** * Show a toast containing the current volume. * * @see #adjustStreamVolume(int, int, int) * @see #adjustVolume(int, int) * @see #setStreamVolume(int, int, int) * @see #setRingerMode(int) */ public static final int FLAG_SHOW_UI = 1 << 0; /** * Whether to include ringer modes as possible options when changing volume. * For example, if true and volume level is 0 and the volume is adjusted * with {@link #ADJUST_LOWER}, then the ringer mode may switch the silent or * vibrate mode. *

* By default this is on for the ring stream. If this flag is included, * this behavior will be present regardless of the stream type being * affected by the ringer mode. * * @see #adjustVolume(int, int) * @see #adjustStreamVolume(int, int, int) */ public static final int FLAG_ALLOW_RINGER_MODES = 1 << 1; /** * Whether to play a sound when changing the volume. *

* If this is given to {@link #adjustVolume(int, int)} or * {@link #adjustSuggestedStreamVolume(int, int, int)}, it may be ignored * in some cases (for example, the decided stream type is not * {@link AudioManager#STREAM_RING}, or the volume is being adjusted * downward). * * @see #adjustStreamVolume(int, int, int) * @see #adjustVolume(int, int) * @see #setStreamVolume(int, int, int) */ public static final int FLAG_PLAY_SOUND = 1 << 2; /** * Removes any sounds/vibrate that may be in the queue, or are playing (related to * changing volume). */ public static final int FLAG_REMOVE_SOUND_AND_VIBRATE = 1 << 3; /** * Whether to vibrate if going into the vibrate ringer mode. */ public static final int FLAG_VIBRATE = 1 << 4; /** * forces use of specified stream * @hide */ public static final int FLAG_FORCE_STREAM = 1 << 5; /** * Ringer mode that will be silent and will not vibrate. (This overrides the * vibrate setting.) * * @see #setRingerMode(int) * @see #getRingerMode() */ public static final int RINGER_MODE_SILENT = 0; /** * Ringer mode that will be silent and will vibrate. (This will cause the * phone ringer to always vibrate, but the notification vibrate to only * vibrate if set.) * * @see #setRingerMode(int) * @see #getRingerMode() */ public static final int RINGER_MODE_VIBRATE = 1; /** * Ringer mode that may be audible and may vibrate. It will be audible if * the volume before changing out of this mode was audible. It will vibrate * if the vibrate setting is on. * * @see #setRingerMode(int) * @see #getRingerMode() */ public static final int RINGER_MODE_NORMAL = 2; // maximum valid ringer mode value. Values must start from 0 and be contiguous. private static final int RINGER_MODE_MAX = RINGER_MODE_NORMAL; /** * Vibrate type that corresponds to the ringer. * * @see #setVibrateSetting(int, int) * @see #getVibrateSetting(int) * @see #shouldVibrate(int) */ public static final int VIBRATE_TYPE_RINGER = 0; /** * Vibrate type that corresponds to notifications. * * @see #setVibrateSetting(int, int) * @see #getVibrateSetting(int) * @see #shouldVibrate(int) */ public static final int VIBRATE_TYPE_NOTIFICATION = 1; /** * Vibrate setting that suggests to never vibrate. * * @see #setVibrateSetting(int, int) * @see #getVibrateSetting(int) */ public static final int VIBRATE_SETTING_OFF = 0; /** * Vibrate setting that suggests to vibrate when possible. * * @see #setVibrateSetting(int, int) * @see #getVibrateSetting(int) */ public static final int VIBRATE_SETTING_ON = 1; /** * Vibrate setting that suggests to only vibrate when in the vibrate ringer * mode. * * @see #setVibrateSetting(int, int) * @see #getVibrateSetting(int) */ public static final int VIBRATE_SETTING_ONLY_SILENT = 2; /** * Suggests using the default stream type. This may not be used in all * places a stream type is needed. */ public static final int USE_DEFAULT_STREAM_TYPE = Integer.MIN_VALUE; private static IAudioService sService; /** * @hide */ public AudioManager(Context context) { mContext = context; mHandler = new Handler(context.getMainLooper()); } private static IAudioService getService() { if (sService != null) { return sService; } IBinder b = ServiceManager.getService(Context.AUDIO_SERVICE); sService = IAudioService.Stub.asInterface(b); return sService; } /** * @hide */ public void preDispatchKeyEvent(int keyCode, int stream) { /* * If the user hits another key within the play sound delay, then * cancel the sound */ if (keyCode != KeyEvent.KEYCODE_VOLUME_DOWN && keyCode != KeyEvent.KEYCODE_VOLUME_UP && keyCode != KeyEvent.KEYCODE_VOLUME_MUTE && mVolumeKeyUpTime + VolumePanel.PLAY_SOUND_DELAY > SystemClock.uptimeMillis()) { /* * The user has hit another key during the delay (e.g., 300ms) * since the last volume key up, so cancel any sounds. */ adjustSuggestedStreamVolume(AudioManager.ADJUST_SAME, stream, AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE); } } /** * @hide */ public void handleKeyDown(int keyCode, int stream) { switch (keyCode) { case KeyEvent.KEYCODE_VOLUME_UP: case KeyEvent.KEYCODE_VOLUME_DOWN: /* * Adjust the volume in on key down since it is more * responsive to the user. */ int flags = FLAG_SHOW_UI | FLAG_VIBRATE; if (mVolumeControlStream != -1) { stream = mVolumeControlStream; flags |= FLAG_FORCE_STREAM; } adjustSuggestedStreamVolume( keyCode == KeyEvent.KEYCODE_VOLUME_UP ? ADJUST_RAISE : ADJUST_LOWER, stream, flags); break; case KeyEvent.KEYCODE_VOLUME_MUTE: // TODO: Actually handle MUTE. break; } } /** * @hide */ public void handleKeyUp(int keyCode, int stream) { switch (keyCode) { case KeyEvent.KEYCODE_VOLUME_UP: case KeyEvent.KEYCODE_VOLUME_DOWN: /* * Play a sound. This is done on key up since we don't want the * sound to play when a user holds down volume down to mute. */ int flags = FLAG_PLAY_SOUND; if (mVolumeControlStream != -1) { stream = mVolumeControlStream; flags |= FLAG_FORCE_STREAM; } adjustSuggestedStreamVolume( ADJUST_SAME, stream, flags); mVolumeKeyUpTime = SystemClock.uptimeMillis(); break; case KeyEvent.KEYCODE_VOLUME_MUTE: // TODO: Actually handle MUTE. break; } } /** * Adjusts the volume of a particular stream by one step in a direction. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param streamType The stream type to adjust. One of {@link #STREAM_VOICE_CALL}, * {@link #STREAM_SYSTEM}, {@link #STREAM_RING}, {@link #STREAM_MUSIC} or * {@link #STREAM_ALARM} * @param direction The direction to adjust the volume. One of * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or * {@link #ADJUST_SAME}. * @param flags One or more flags. * @see #adjustVolume(int, int) * @see #setStreamVolume(int, int, int) */ public void adjustStreamVolume(int streamType, int direction, int flags) { IAudioService service = getService(); try { service.adjustStreamVolume(streamType, direction, flags); } catch (RemoteException e) { Log.e(TAG, "Dead object in adjustStreamVolume", e); } } /** * Adjusts the volume of the most relevant stream. For example, if a call is * active, it will have the highest priority regardless of if the in-call * screen is showing. Another example, if music is playing in the background * and a call is not active, the music stream will be adjusted. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param direction The direction to adjust the volume. One of * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or * {@link #ADJUST_SAME}. * @param flags One or more flags. * @see #adjustSuggestedStreamVolume(int, int, int) * @see #adjustStreamVolume(int, int, int) * @see #setStreamVolume(int, int, int) */ public void adjustVolume(int direction, int flags) { IAudioService service = getService(); try { service.adjustVolume(direction, flags); } catch (RemoteException e) { Log.e(TAG, "Dead object in adjustVolume", e); } } /** * Adjusts the volume of the most relevant stream, or the given fallback * stream. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param direction The direction to adjust the volume. One of * {@link #ADJUST_LOWER}, {@link #ADJUST_RAISE}, or * {@link #ADJUST_SAME}. * @param suggestedStreamType The stream type that will be used if there * isn't a relevant stream. {@link #USE_DEFAULT_STREAM_TYPE} is valid here. * @param flags One or more flags. * @see #adjustVolume(int, int) * @see #adjustStreamVolume(int, int, int) * @see #setStreamVolume(int, int, int) */ public void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags) { IAudioService service = getService(); try { service.adjustSuggestedStreamVolume(direction, suggestedStreamType, flags); } catch (RemoteException e) { Log.e(TAG, "Dead object in adjustVolume", e); } } /** * Returns the current ringtone mode. * * @return The current ringtone mode, one of {@link #RINGER_MODE_NORMAL}, * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. * @see #setRingerMode(int) */ public int getRingerMode() { IAudioService service = getService(); try { return service.getRingerMode(); } catch (RemoteException e) { Log.e(TAG, "Dead object in getRingerMode", e); return RINGER_MODE_NORMAL; } } /** * Checks valid ringer mode values. * * @return true if the ringer mode indicated is valid, false otherwise. * * @see #setRingerMode(int) * @hide */ public static boolean isValidRingerMode(int ringerMode) { if (ringerMode < 0 || ringerMode > RINGER_MODE_MAX) { return false; } return true; } /** * Returns the maximum volume index for a particular stream. * * @param streamType The stream type whose maximum volume index is returned. * @return The maximum valid volume index for the stream. * @see #getStreamVolume(int) */ public int getStreamMaxVolume(int streamType) { IAudioService service = getService(); try { return service.getStreamMaxVolume(streamType); } catch (RemoteException e) { Log.e(TAG, "Dead object in getStreamMaxVolume", e); return 0; } } /** * Returns the current volume index for a particular stream. * * @param streamType The stream type whose volume index is returned. * @return The current volume index for the stream. * @see #getStreamMaxVolume(int) * @see #setStreamVolume(int, int, int) */ public int getStreamVolume(int streamType) { IAudioService service = getService(); try { return service.getStreamVolume(streamType); } catch (RemoteException e) { Log.e(TAG, "Dead object in getStreamVolume", e); return 0; } } /** * Get last audible volume before stream was muted. * * @hide */ public int getLastAudibleStreamVolume(int streamType) { IAudioService service = getService(); try { return service.getLastAudibleStreamVolume(streamType); } catch (RemoteException e) { Log.e(TAG, "Dead object in getLastAudibleStreamVolume", e); return 0; } } /** * Sets the ringer mode. *

* Silent mode will mute the volume and will not vibrate. Vibrate mode will * mute the volume and vibrate. Normal mode will be audible and may vibrate * according to user settings. * * @param ringerMode The ringer mode, one of {@link #RINGER_MODE_NORMAL}, * {@link #RINGER_MODE_SILENT}, or {@link #RINGER_MODE_VIBRATE}. * @see #getRingerMode() */ public void setRingerMode(int ringerMode) { if (!isValidRingerMode(ringerMode)) { return; } IAudioService service = getService(); try { service.setRingerMode(ringerMode); } catch (RemoteException e) { Log.e(TAG, "Dead object in setRingerMode", e); } } /** * Sets the volume index for a particular stream. * * @param streamType The stream whose volume index should be set. * @param index The volume index to set. See * {@link #getStreamMaxVolume(int)} for the largest valid value. * @param flags One or more flags. * @see #getStreamMaxVolume(int) * @see #getStreamVolume(int) */ public void setStreamVolume(int streamType, int index, int flags) { IAudioService service = getService(); try { service.setStreamVolume(streamType, index, flags); } catch (RemoteException e) { Log.e(TAG, "Dead object in setStreamVolume", e); } } /** * Solo or unsolo a particular stream. All other streams are muted. *

* The solo command is protected against client process death: if a process * with an active solo request on a stream dies, all streams that were muted * because of this request will be unmuted automatically. *

* The solo requests for a given stream are cumulative: the AudioManager * can receive several solo requests from one or more clients and the stream * will be unsoloed only when the same number of unsolo requests are received. *

* For a better user experience, applications MUST unsolo a soloed stream * in onPause() and solo is again in onResume() if appropriate. * * @param streamType The stream to be soloed/unsoloed. * @param state The required solo state: true for solo ON, false for solo OFF */ public void setStreamSolo(int streamType, boolean state) { IAudioService service = getService(); try { service.setStreamSolo(streamType, state, mICallBack); } catch (RemoteException e) { Log.e(TAG, "Dead object in setStreamSolo", e); } } /** * Mute or unmute an audio stream. *

* The mute command is protected against client process death: if a process * with an active mute request on a stream dies, this stream will be unmuted * automatically. *

* The mute requests for a given stream are cumulative: the AudioManager * can receive several mute requests from one or more clients and the stream * will be unmuted only when the same number of unmute requests are received. *

* For a better user experience, applications MUST unmute a muted stream * in onPause() and mute is again in onResume() if appropriate. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param streamType The stream to be muted/unmuted. * @param state The required mute state: true for mute ON, false for mute OFF */ public void setStreamMute(int streamType, boolean state) { IAudioService service = getService(); try { service.setStreamMute(streamType, state, mICallBack); } catch (RemoteException e) { Log.e(TAG, "Dead object in setStreamMute", e); } } /** * get stream mute state. * * @hide */ public boolean isStreamMute(int streamType) { IAudioService service = getService(); try { return service.isStreamMute(streamType); } catch (RemoteException e) { Log.e(TAG, "Dead object in isStreamMute", e); return false; } } /** * forces the stream controlled by hard volume keys * specifying streamType == -1 releases control to the * logic. * * @hide */ public void forceVolumeControlStream(int streamType) { mVolumeControlStream = streamType; } /** * Returns whether a particular type should vibrate according to user * settings and the current ringer mode. *

* This shouldn't be needed by most clients that use notifications to * vibrate. The notification manager will not vibrate if the policy doesn't * allow it, so the client should always set a vibrate pattern and let the * notification manager control whether or not to actually vibrate. * * @param vibrateType The type of vibrate. One of * {@link #VIBRATE_TYPE_NOTIFICATION} or * {@link #VIBRATE_TYPE_RINGER}. * @return Whether the type should vibrate at the instant this method is * called. * @see #setVibrateSetting(int, int) * @see #getVibrateSetting(int) */ public boolean shouldVibrate(int vibrateType) { IAudioService service = getService(); try { return service.shouldVibrate(vibrateType); } catch (RemoteException e) { Log.e(TAG, "Dead object in shouldVibrate", e); return false; } } /** * Returns whether the user's vibrate setting for a vibrate type. *

* This shouldn't be needed by most clients that want to vibrate, instead * see {@link #shouldVibrate(int)}. * * @param vibrateType The type of vibrate. One of * {@link #VIBRATE_TYPE_NOTIFICATION} or * {@link #VIBRATE_TYPE_RINGER}. * @return The vibrate setting, one of {@link #VIBRATE_SETTING_ON}, * {@link #VIBRATE_SETTING_OFF}, or * {@link #VIBRATE_SETTING_ONLY_SILENT}. * @see #setVibrateSetting(int, int) * @see #shouldVibrate(int) */ public int getVibrateSetting(int vibrateType) { IAudioService service = getService(); try { return service.getVibrateSetting(vibrateType); } catch (RemoteException e) { Log.e(TAG, "Dead object in getVibrateSetting", e); return VIBRATE_SETTING_OFF; } } /** * Sets the setting for when the vibrate type should vibrate. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param vibrateType The type of vibrate. One of * {@link #VIBRATE_TYPE_NOTIFICATION} or * {@link #VIBRATE_TYPE_RINGER}. * @param vibrateSetting The vibrate setting, one of * {@link #VIBRATE_SETTING_ON}, * {@link #VIBRATE_SETTING_OFF}, or * {@link #VIBRATE_SETTING_ONLY_SILENT}. * @see #getVibrateSetting(int) * @see #shouldVibrate(int) */ public void setVibrateSetting(int vibrateType, int vibrateSetting) { IAudioService service = getService(); try { service.setVibrateSetting(vibrateType, vibrateSetting); } catch (RemoteException e) { Log.e(TAG, "Dead object in setVibrateSetting", e); } } /** * Sets the speakerphone on or off. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param on set true to turn on speakerphone; * false to turn it off */ public void setSpeakerphoneOn(boolean on){ IAudioService service = getService(); try { service.setSpeakerphoneOn(on); } catch (RemoteException e) { Log.e(TAG, "Dead object in setSpeakerphoneOn", e); } } /** * Checks whether the speakerphone is on or off. * * @return true if speakerphone is on, false if it's off */ public boolean isSpeakerphoneOn() { IAudioService service = getService(); try { return service.isSpeakerphoneOn(); } catch (RemoteException e) { Log.e(TAG, "Dead object in isSpeakerphoneOn", e); return false; } } //==================================================================== // Bluetooth SCO control /** * Sticky broadcast intent action indicating that the bluetoooth SCO audio * connection state has changed. The intent contains on extra {@link #EXTRA_SCO_AUDIO_STATE} * indicating the new state which is either {@link #SCO_AUDIO_STATE_DISCONNECTED} * or {@link #SCO_AUDIO_STATE_CONNECTED} * * @see #startBluetoothSco() * @deprecated Use {@link #ACTION_SCO_AUDIO_STATE_UPDATED} instead */ @Deprecated @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String ACTION_SCO_AUDIO_STATE_CHANGED = "android.media.SCO_AUDIO_STATE_CHANGED"; /** * Sticky broadcast intent action indicating that the bluetoooth SCO audio * connection state has been updated. *

This intent has two extras: *

*

EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE can be any of: *

* @see #startBluetoothSco() */ @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String ACTION_SCO_AUDIO_STATE_UPDATED = "android.media.ACTION_SCO_AUDIO_STATE_UPDATED"; /** * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_CHANGED} or * {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the new bluetooth SCO connection state. */ public static final String EXTRA_SCO_AUDIO_STATE = "android.media.extra.SCO_AUDIO_STATE"; /** * Extra for intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} containing the previous * bluetooth SCO connection state. */ public static final String EXTRA_SCO_AUDIO_PREVIOUS_STATE = "android.media.extra.SCO_AUDIO_PREVIOUS_STATE"; /** * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE * indicating that the SCO audio channel is not established */ public static final int SCO_AUDIO_STATE_DISCONNECTED = 0; /** * Value for extra {@link #EXTRA_SCO_AUDIO_STATE} or {@link #EXTRA_SCO_AUDIO_PREVIOUS_STATE} * indicating that the SCO audio channel is established */ public static final int SCO_AUDIO_STATE_CONNECTED = 1; /** * Value for extra EXTRA_SCO_AUDIO_STATE or EXTRA_SCO_AUDIO_PREVIOUS_STATE * indicating that the SCO audio channel is being established */ public static final int SCO_AUDIO_STATE_CONNECTING = 2; /** * Value for extra EXTRA_SCO_AUDIO_STATE indicating that * there was an error trying to obtain the state */ public static final int SCO_AUDIO_STATE_ERROR = -1; /** * Indicates if current platform supports use of SCO for off call use cases. * Application wanted to use bluetooth SCO audio when the phone is not in call * must first call thsi method to make sure that the platform supports this * feature. * @return true if bluetooth SCO can be used for audio when not in call * false otherwise * @see #startBluetoothSco() */ public boolean isBluetoothScoAvailableOffCall() { return mContext.getResources().getBoolean( com.android.internal.R.bool.config_bluetooth_sco_off_call); } /** * Start bluetooth SCO audio connection. *

Requires Permission: * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. *

This method can be used by applications wanting to send and received audio * to/from a bluetooth SCO headset while the phone is not in call. *

As the SCO connection establishment can take several seconds, * applications should not rely on the connection to be available when the method * returns but instead register to receive the intent {@link #ACTION_SCO_AUDIO_STATE_UPDATED} * and wait for the state to be {@link #SCO_AUDIO_STATE_CONNECTED}. *

As the ACTION_SCO_AUDIO_STATE_UPDATED intent is sticky, the application can check the SCO * audio state before calling startBluetoothSco() by reading the intent returned by the receiver * registration. If the state is already CONNECTED, no state change will be received via the * intent after calling startBluetoothSco(). It is however useful to call startBluetoothSco() * so that the connection stays active in case the current initiator stops the connection. *

Unless the connection is already active as described above, the state will always * transition from DISCONNECTED to CONNECTING and then either to CONNECTED if the connection * succeeds or back to DISCONNECTED if the connection fails (e.g no headset is connected). *

When finished with the SCO connection or if the establishment fails, the application must * call {@link #stopBluetoothSco()} to clear the request and turn down the bluetooth connection. *

Even if a SCO connection is established, the following restrictions apply on audio * output streams so that they can be routed to SCO headset: *

*

The following restrictions apply on input streams: *

*

Note that the phone application always has the priority on the usage of the SCO * connection for telephony. If this method is called while the phone is in call * it will be ignored. Similarly, if a call is received or sent while an application * is using the SCO connection, the connection will be lost for the application and NOT * returned automatically when the call ends. * @see #stopBluetoothSco() * @see #ACTION_SCO_AUDIO_STATE_UPDATED */ public void startBluetoothSco(){ IAudioService service = getService(); try { service.startBluetoothSco(mICallBack); } catch (RemoteException e) { Log.e(TAG, "Dead object in startBluetoothSco", e); } } /** * Stop bluetooth SCO audio connection. *

Requires Permission: * {@link android.Manifest.permission#MODIFY_AUDIO_SETTINGS}. *

This method must be called by applications having requested the use of * bluetooth SCO audio with {@link #startBluetoothSco()} * when finished with the SCO connection or if connection fails. * @see #startBluetoothSco() */ public void stopBluetoothSco(){ IAudioService service = getService(); try { service.stopBluetoothSco(mICallBack); } catch (RemoteException e) { Log.e(TAG, "Dead object in stopBluetoothSco", e); } } /** * Request use of Bluetooth SCO headset for communications. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param on set true to use bluetooth SCO for communications; * false to not use bluetooth SCO for communications */ public void setBluetoothScoOn(boolean on){ IAudioService service = getService(); try { service.setBluetoothScoOn(on); } catch (RemoteException e) { Log.e(TAG, "Dead object in setBluetoothScoOn", e); } } /** * Checks whether communications use Bluetooth SCO. * * @return true if SCO is used for communications; * false if otherwise */ public boolean isBluetoothScoOn() { IAudioService service = getService(); try { return service.isBluetoothScoOn(); } catch (RemoteException e) { Log.e(TAG, "Dead object in isBluetoothScoOn", e); return false; } } /** * @param on set true to route A2DP audio to/from Bluetooth * headset; false disable A2DP audio * @deprecated Do not use. */ @Deprecated public void setBluetoothA2dpOn(boolean on){ } /** * Checks whether A2DP audio routing to the Bluetooth headset is on or off. * * @return true if A2DP audio is being routed to/from Bluetooth headset; * false if otherwise */ public boolean isBluetoothA2dpOn() { if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_BLUETOOTH_A2DP,"") == AudioSystem.DEVICE_STATE_UNAVAILABLE) { return false; } else { return true; } } /** * Sets audio routing to the wired headset on or off. * * @param on set true to route audio to/from wired * headset; false disable wired headset audio * @deprecated Do not use. */ @Deprecated public void setWiredHeadsetOn(boolean on){ } /** * Checks whether a wired headset is connected or not. *

This is not a valid indication that audio playback is * actually over the wired headset as audio routing depends on other conditions. * * @return true if a wired headset is connected. * false if otherwise * @deprecated Use only to check is a headset is connected or not. */ public boolean isWiredHeadsetOn() { if (AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADSET,"") == AudioSystem.DEVICE_STATE_UNAVAILABLE && AudioSystem.getDeviceConnectionState(DEVICE_OUT_WIRED_HEADPHONE,"") == AudioSystem.DEVICE_STATE_UNAVAILABLE) { return false; } else { return true; } } /** * Sets the microphone mute on or off. *

* This method should only be used by applications that replace the platform-wide * management of audio settings or the main telephony application. * * @param on set true to mute the microphone; * false to turn mute off */ public void setMicrophoneMute(boolean on){ AudioSystem.muteMicrophone(on); } /** * Checks whether the microphone mute is on or off. * * @return true if microphone is muted, false if it's not */ public boolean isMicrophoneMute() { return AudioSystem.isMicrophoneMuted(); } /** * Sets the audio mode. *

* The audio mode encompasses audio routing AND the behavior of * the telephony layer. Therefore this method should only be used by applications that * replace the platform-wide management of audio settings or the main telephony application. * In particular, the {@link #MODE_IN_CALL} mode should only be used by the telephony * application when it places a phone call, as it will cause signals from the radio layer * to feed the platform mixer. * * @param mode the requested audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). * Informs the HAL about the current audio state so that * it can route the audio appropriately. */ public void setMode(int mode) { IAudioService service = getService(); try { service.setMode(mode, mICallBack); } catch (RemoteException e) { Log.e(TAG, "Dead object in setMode", e); } } /** * Returns the current audio mode. * * @return the current audio mode ({@link #MODE_NORMAL}, {@link #MODE_RINGTONE}, * {@link #MODE_IN_CALL} or {@link #MODE_IN_COMMUNICATION}). * Returns the current current audio state from the HAL. */ public int getMode() { IAudioService service = getService(); try { return service.getMode(); } catch (RemoteException e) { Log.e(TAG, "Dead object in getMode", e); return MODE_INVALID; } } /* modes for setMode/getMode/setRoute/getRoute */ /** * Audio harware modes. */ /** * Invalid audio mode. */ public static final int MODE_INVALID = AudioSystem.MODE_INVALID; /** * Current audio mode. Used to apply audio routing to current mode. */ public static final int MODE_CURRENT = AudioSystem.MODE_CURRENT; /** * Normal audio mode: not ringing and no call established. */ public static final int MODE_NORMAL = AudioSystem.MODE_NORMAL; /** * Ringing audio mode. An incoming is being signaled. */ public static final int MODE_RINGTONE = AudioSystem.MODE_RINGTONE; /** * In call audio mode. A telephony call is established. */ public static final int MODE_IN_CALL = AudioSystem.MODE_IN_CALL; /** * In communication audio mode. An audio/video chat or VoIP call is established. */ public static final int MODE_IN_COMMUNICATION = AudioSystem.MODE_IN_COMMUNICATION; /* Routing bits for setRouting/getRouting API */ /** * Routing audio output to earpiece * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public static final int ROUTE_EARPIECE = AudioSystem.ROUTE_EARPIECE; /** * Routing audio output to speaker * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public static final int ROUTE_SPEAKER = AudioSystem.ROUTE_SPEAKER; /** * @deprecated use {@link #ROUTE_BLUETOOTH_SCO} * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public static final int ROUTE_BLUETOOTH = AudioSystem.ROUTE_BLUETOOTH_SCO; /** * Routing audio output to bluetooth SCO * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public static final int ROUTE_BLUETOOTH_SCO = AudioSystem.ROUTE_BLUETOOTH_SCO; /** * Routing audio output to headset * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public static final int ROUTE_HEADSET = AudioSystem.ROUTE_HEADSET; /** * Routing audio output to bluetooth A2DP * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = AudioSystem.ROUTE_BLUETOOTH_A2DP; /** * Used for mask parameter of {@link #setRouting(int,int,int)}. * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public static final int ROUTE_ALL = AudioSystem.ROUTE_ALL; /** * Sets the audio routing for a specified mode * * @param mode audio mode to change route. E.g., MODE_RINGTONE. * @param routes bit vector of routes requested, created from one or * more of ROUTE_xxx types. Set bits indicate that route should be on * @param mask bit vector of routes to change, created from one or more of * ROUTE_xxx types. Unset bits indicate the route should be left unchanged * * @deprecated Do not set audio routing directly, use setSpeakerphoneOn(), * setBluetoothScoOn() methods instead. */ @Deprecated public void setRouting(int mode, int routes, int mask) { } /** * Returns the current audio routing bit vector for a specified mode. * * @param mode audio mode to get route (e.g., MODE_RINGTONE) * @return an audio route bit vector that can be compared with ROUTE_xxx * bits * @deprecated Do not query audio routing directly, use isSpeakerphoneOn(), * isBluetoothScoOn(), isBluetoothA2dpOn() and isWiredHeadsetOn() methods instead. */ @Deprecated public int getRouting(int mode) { return -1; } /** * Checks whether any music is active. * * @return true if any music tracks are active. */ public boolean isMusicActive() { return AudioSystem.isStreamActive(STREAM_MUSIC, 0); } /* * Sets a generic audio configuration parameter. The use of these parameters * are platform dependant, see libaudio * * ** Temporary interface - DO NOT USE * * TODO: Replace with a more generic key:value get/set mechanism * * param key name of parameter to set. Must not be null. * param value value of parameter. Must not be null. */ /** * @hide * @deprecated Use {@link #setPrameters(String)} instead */ @Deprecated public void setParameter(String key, String value) { setParameters(key+"="+value); } /** * Sets a variable number of parameter values to audio hardware. * * @param keyValuePairs list of parameters key value pairs in the form: * key1=value1;key2=value2;... * */ public void setParameters(String keyValuePairs) { AudioSystem.setParameters(keyValuePairs); } /** * Sets a varaible number of parameter values to audio hardware. * * @param keys list of parameters * @return list of parameters key value pairs in the form: * key1=value1;key2=value2;... */ public String getParameters(String keys) { return AudioSystem.getParameters(keys); } /* Sound effect identifiers */ /** * Keyboard and direction pad click sound * @see #playSoundEffect(int) */ public static final int FX_KEY_CLICK = 0; /** * Focus has moved up * @see #playSoundEffect(int) */ public static final int FX_FOCUS_NAVIGATION_UP = 1; /** * Focus has moved down * @see #playSoundEffect(int) */ public static final int FX_FOCUS_NAVIGATION_DOWN = 2; /** * Focus has moved left * @see #playSoundEffect(int) */ public static final int FX_FOCUS_NAVIGATION_LEFT = 3; /** * Focus has moved right * @see #playSoundEffect(int) */ public static final int FX_FOCUS_NAVIGATION_RIGHT = 4; /** * IME standard keypress sound * @see #playSoundEffect(int) */ public static final int FX_KEYPRESS_STANDARD = 5; /** * IME spacebar keypress sound * @see #playSoundEffect(int) */ public static final int FX_KEYPRESS_SPACEBAR = 6; /** * IME delete keypress sound * @see #playSoundEffect(int) */ public static final int FX_KEYPRESS_DELETE = 7; /** * IME return_keypress sound * @see #playSoundEffect(int) */ public static final int FX_KEYPRESS_RETURN = 8; /** * @hide Number of sound effects */ public static final int NUM_SOUND_EFFECTS = 9; /** * Plays a sound effect (Key clicks, lid open/close...) * @param effectType The type of sound effect. One of * {@link #FX_KEY_CLICK}, * {@link #FX_FOCUS_NAVIGATION_UP}, * {@link #FX_FOCUS_NAVIGATION_DOWN}, * {@link #FX_FOCUS_NAVIGATION_LEFT}, * {@link #FX_FOCUS_NAVIGATION_RIGHT}, * {@link #FX_KEYPRESS_STANDARD}, * {@link #FX_KEYPRESS_SPACEBAR}, * {@link #FX_KEYPRESS_DELETE}, * {@link #FX_KEYPRESS_RETURN}, * NOTE: This version uses the UI settings to determine * whether sounds are heard or not. */ public void playSoundEffect(int effectType) { if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { return; } if (!querySoundEffectsEnabled()) { return; } IAudioService service = getService(); try { service.playSoundEffect(effectType); } catch (RemoteException e) { Log.e(TAG, "Dead object in playSoundEffect"+e); } } /** * Plays a sound effect (Key clicks, lid open/close...) * @param effectType The type of sound effect. One of * {@link #FX_KEY_CLICK}, * {@link #FX_FOCUS_NAVIGATION_UP}, * {@link #FX_FOCUS_NAVIGATION_DOWN}, * {@link #FX_FOCUS_NAVIGATION_LEFT}, * {@link #FX_FOCUS_NAVIGATION_RIGHT}, * {@link #FX_KEYPRESS_STANDARD}, * {@link #FX_KEYPRESS_SPACEBAR}, * {@link #FX_KEYPRESS_DELETE}, * {@link #FX_KEYPRESS_RETURN}, * @param volume Sound effect volume. * The volume value is a raw scalar so UI controls should be scaled logarithmically. * If a volume of -1 is specified, the AudioManager.STREAM_MUSIC stream volume minus 3dB will be used. * NOTE: This version is for applications that have their own * settings panel for enabling and controlling volume. */ public void playSoundEffect(int effectType, float volume) { if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) { return; } IAudioService service = getService(); try { service.playSoundEffectVolume(effectType, volume); } catch (RemoteException e) { Log.e(TAG, "Dead object in playSoundEffect"+e); } } /** * Settings has an in memory cache, so this is fast. */ private boolean querySoundEffectsEnabled() { return Settings.System.getInt(mContext.getContentResolver(), Settings.System.SOUND_EFFECTS_ENABLED, 0) != 0; } /** * Load Sound effects. * This method must be called when sound effects are enabled. */ public void loadSoundEffects() { IAudioService service = getService(); try { service.loadSoundEffects(); } catch (RemoteException e) { Log.e(TAG, "Dead object in loadSoundEffects"+e); } } /** * Unload Sound effects. * This method can be called to free some memory when * sound effects are disabled. */ public void unloadSoundEffects() { IAudioService service = getService(); try { service.unloadSoundEffects(); } catch (RemoteException e) { Log.e(TAG, "Dead object in unloadSoundEffects"+e); } } /** * Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration. * @see OnAudioFocusChangeListener#onAudioFocusChange(int) * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) */ public static final int AUDIOFOCUS_GAIN = 1; /** * Used to indicate a temporary gain or request of audio focus, anticipated to last a short * amount of time. Examples of temporary changes are the playback of driving directions, or an * event notification. * @see OnAudioFocusChangeListener#onAudioFocusChange(int) * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) */ public static final int AUDIOFOCUS_GAIN_TRANSIENT = 2; /** * Used to indicate a temporary request of audio focus, anticipated to last a short * amount of time, and where it is acceptable for other audio applications to keep playing * after having lowered their output level (also referred to as "ducking"). * Examples of temporary changes are the playback of driving directions where playback of music * in the background is acceptable. * @see OnAudioFocusChangeListener#onAudioFocusChange(int) * @see #requestAudioFocus(OnAudioFocusChangeListener, int, int) */ public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3; /** * Used to indicate a loss of audio focus of unknown duration. * @see OnAudioFocusChangeListener#onAudioFocusChange(int) */ public static final int AUDIOFOCUS_LOSS = -1 * AUDIOFOCUS_GAIN; /** * Used to indicate a transient loss of audio focus. * @see OnAudioFocusChangeListener#onAudioFocusChange(int) */ public static final int AUDIOFOCUS_LOSS_TRANSIENT = -1 * AUDIOFOCUS_GAIN_TRANSIENT; /** * Used to indicate a transient loss of audio focus where the loser of the audio focus can * lower its output volume if it wants to continue playing (also referred to as "ducking"), as * the new focus owner doesn't require others to be silent. * @see OnAudioFocusChangeListener#onAudioFocusChange(int) */ public static final int AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK = -1 * AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; /** * Interface definition for a callback to be invoked when the audio focus of the system is * updated. */ public interface OnAudioFocusChangeListener { /** * Called on the listener to notify it the audio focus for this listener has been changed. * The focusChange value indicates whether the focus was gained, * whether the focus was lost, and whether that loss is transient, or whether the new focus * holder will hold it for an unknown amount of time. * When losing focus, listeners can use the focus change information to decide what * behavior to adopt when losing focus. A music player could for instance elect to lower * the volume of its music stream (duck) for transient focus losses, and pause otherwise. * @param focusChange the type of focus change, one of {@link AudioManager#AUDIOFOCUS_GAIN}, * {@link AudioManager#AUDIOFOCUS_LOSS}, {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT} * and {@link AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK}. */ public void onAudioFocusChange(int focusChange); } /** * Map to convert focus event listener IDs, as used in the AudioService audio focus stack, * to actual listener objects. */ private HashMap mAudioFocusIdListenerMap = new HashMap(); /** * Lock to prevent concurrent changes to the list of focus listeners for this AudioManager * instance. */ private final Object mFocusListenerLock = new Object(); private OnAudioFocusChangeListener findFocusListener(String id) { return mAudioFocusIdListenerMap.get(id); } /** * Handler for audio focus events coming from the audio service. */ private FocusEventHandlerDelegate mAudioFocusEventHandlerDelegate = new FocusEventHandlerDelegate(); /** * Helper class to handle the forwarding of audio focus events to the appropriate listener */ private class FocusEventHandlerDelegate { private final Handler mHandler; FocusEventHandlerDelegate() { Looper looper; if ((looper = Looper.myLooper()) == null) { looper = Looper.getMainLooper(); } if (looper != null) { // implement the event handler delegate to receive audio focus events mHandler = new Handler(looper) { @Override public void handleMessage(Message msg) { OnAudioFocusChangeListener listener = null; synchronized(mFocusListenerLock) { listener = findFocusListener((String)msg.obj); } if (listener != null) { listener.onAudioFocusChange(msg.what); } } }; } else { mHandler = null; } } Handler getHandler() { return mHandler; } } private IAudioFocusDispatcher mAudioFocusDispatcher = new IAudioFocusDispatcher.Stub() { public void dispatchAudioFocusChange(int focusChange, String id) { Message m = mAudioFocusEventHandlerDelegate.getHandler().obtainMessage(focusChange, id); mAudioFocusEventHandlerDelegate.getHandler().sendMessage(m); } }; private String getIdForAudioFocusListener(OnAudioFocusChangeListener l) { if (l == null) { return new String(this.toString()); } else { return new String(this.toString() + l.toString()); } } /** * @hide * Registers a listener to be called when audio focus changes. Calling this method is optional * before calling {@link #requestAudioFocus(OnAudioFocusChangeListener, int, int)}, as it * will register the listener as well if it wasn't registered already. * @param l the listener to be notified of audio focus changes. */ public void registerAudioFocusListener(OnAudioFocusChangeListener l) { synchronized(mFocusListenerLock) { if (mAudioFocusIdListenerMap.containsKey(getIdForAudioFocusListener(l))) { return; } mAudioFocusIdListenerMap.put(getIdForAudioFocusListener(l), l); } } /** * @hide * Causes the specified listener to not be called anymore when focus is gained or lost. * @param l the listener to unregister. */ public void unregisterAudioFocusListener(OnAudioFocusChangeListener l) { // remove locally synchronized(mFocusListenerLock) { mAudioFocusIdListenerMap.remove(getIdForAudioFocusListener(l)); } } /** * A failed focus change request. */ public static final int AUDIOFOCUS_REQUEST_FAILED = 0; /** * A successful focus change request. */ public static final int AUDIOFOCUS_REQUEST_GRANTED = 1; /** * Request audio focus. * Send a request to obtain the audio focus * @param l the listener to be notified of audio focus changes * @param streamType the main audio stream type affected by the focus request * @param durationHint use {@link #AUDIOFOCUS_GAIN_TRANSIENT} to indicate this focus request * is temporary, and focus will be abandonned shortly. Examples of transient requests are * for the playback of driving directions, or notifications sounds. * Use {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} to indicate also that it's ok for * the previous focus owner to keep playing if it ducks its audio output. * Use {@link #AUDIOFOCUS_GAIN} for a focus request of unknown duration such * as the playback of a song or a video. * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} */ public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) { int status = AUDIOFOCUS_REQUEST_FAILED; if ((durationHint < AUDIOFOCUS_GAIN) || (durationHint > AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK)) { Log.e(TAG, "Invalid duration hint, audio focus request denied"); return status; } registerAudioFocusListener(l); //TODO protect request by permission check? IAudioService service = getService(); try { status = service.requestAudioFocus(streamType, durationHint, mICallBack, mAudioFocusDispatcher, getIdForAudioFocusListener(l), mContext.getPackageName() /* package name */); } catch (RemoteException e) { Log.e(TAG, "Can't call requestAudioFocus() from AudioService due to "+e); } return status; } /** * Abandon audio focus. Causes the previous focus owner, if any, to receive focus. * @param l the listener with which focus was requested. * @return {@link #AUDIOFOCUS_REQUEST_FAILED} or {@link #AUDIOFOCUS_REQUEST_GRANTED} */ public int abandonAudioFocus(OnAudioFocusChangeListener l) { int status = AUDIOFOCUS_REQUEST_FAILED; unregisterAudioFocusListener(l); IAudioService service = getService(); try { status = service.abandonAudioFocus(mAudioFocusDispatcher, getIdForAudioFocusListener(l)); } catch (RemoteException e) { Log.e(TAG, "Can't call abandonAudioFocus() from AudioService due to "+e); } return status; } //==================================================================== // Remote Control /** * Register a component to be the sole receiver of MEDIA_BUTTON intents. * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} * that will receive the media button intent. This broadcast receiver must be declared * in the application manifest. The package of the component must match that of * the context you're registering from. */ public void registerMediaButtonEventReceiver(ComponentName eventReceiver) { if (eventReceiver == null) { return; } if (!eventReceiver.getPackageName().equals(mContext.getPackageName())) { Log.e(TAG, "registerMediaButtonEventReceiver() error: " + "receiver and context package names don't match"); return; } // construct a PendingIntent for the media button and register it Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); // the associated intent will be handled by the component being registered mediaButtonIntent.setComponent(eventReceiver); PendingIntent pi = PendingIntent.getBroadcast(mContext, 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); registerMediaButtonIntent(pi, eventReceiver); } /** * @hide * no-op if (pi == null) or (eventReceiver == null) */ public void registerMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { if ((pi == null) || (eventReceiver == null)) { Log.e(TAG, "Cannot call registerMediaButtonIntent() with a null parameter"); return; } IAudioService service = getService(); try { // pi != null service.registerMediaButtonIntent(pi, eventReceiver); } catch (RemoteException e) { Log.e(TAG, "Dead object in registerMediaButtonIntent"+e); } } /** * Unregister the receiver of MEDIA_BUTTON intents. * @param eventReceiver identifier of a {@link android.content.BroadcastReceiver} * that was registered with {@link #registerMediaButtonEventReceiver(ComponentName)}. */ public void unregisterMediaButtonEventReceiver(ComponentName eventReceiver) { if (eventReceiver == null) { return; } // construct a PendingIntent for the media button and unregister it Intent mediaButtonIntent = new Intent(Intent.ACTION_MEDIA_BUTTON); // the associated intent will be handled by the component being registered mediaButtonIntent.setComponent(eventReceiver); PendingIntent pi = PendingIntent.getBroadcast(mContext, 0/*requestCode, ignored*/, mediaButtonIntent, 0/*flags*/); unregisterMediaButtonIntent(pi, eventReceiver); } /** * @hide */ public void unregisterMediaButtonIntent(PendingIntent pi, ComponentName eventReceiver) { IAudioService service = getService(); try { service.unregisterMediaButtonIntent(pi, eventReceiver); } catch (RemoteException e) { Log.e(TAG, "Dead object in unregisterMediaButtonIntent"+e); } } /** * Registers the remote control client for providing information to display on the remote * controls. * @param rcClient The remote control client from which remote controls will receive * information to display. * @see RemoteControlClient */ public void registerRemoteControlClient(RemoteControlClient rcClient) { if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { return; } IAudioService service = getService(); try { service.registerRemoteControlClient(rcClient.getRcMediaIntent(), /* mediaIntent */ rcClient.getIRemoteControlClient(), /* rcClient */ // used to match media button event receiver and audio focus mContext.getPackageName()); /* packageName */ } catch (RemoteException e) { Log.e(TAG, "Dead object in registerRemoteControlClient"+e); } } /** * Unregisters the remote control client that was providing information to display on the * remote controls. * @param rcClient The remote control client to unregister. * @see #registerRemoteControlClient(RemoteControlClient) */ public void unregisterRemoteControlClient(RemoteControlClient rcClient) { if ((rcClient == null) || (rcClient.getRcMediaIntent() == null)) { return; } IAudioService service = getService(); try { service.unregisterRemoteControlClient(rcClient.getRcMediaIntent(), /* mediaIntent */ rcClient.getIRemoteControlClient()); /* rcClient */ } catch (RemoteException e) { Log.e(TAG, "Dead object in unregisterRemoteControlClient"+e); } } /** * @hide * Registers a remote control display that will be sent information by remote control clients. * @param rcd */ public void registerRemoteControlDisplay(IRemoteControlDisplay rcd) { if (rcd == null) { return; } IAudioService service = getService(); try { service.registerRemoteControlDisplay(rcd); } catch (RemoteException e) { Log.e(TAG, "Dead object in registerRemoteControlDisplay " + e); } } /** * @hide * Unregisters a remote control display that was sent information by remote control clients. * @param rcd */ public void unregisterRemoteControlDisplay(IRemoteControlDisplay rcd) { if (rcd == null) { return; } IAudioService service = getService(); try { service.unregisterRemoteControlDisplay(rcd); } catch (RemoteException e) { Log.e(TAG, "Dead object in unregisterRemoteControlDisplay " + e); } } /** * @hide * Sets the artwork size a remote control display expects when receiving bitmaps. * @param rcd * @param w the maximum width of the expected bitmap. Negative values indicate it is * useless to send artwork. * @param h the maximum height of the expected bitmap. Negative values indicate it is * useless to send artwork. */ public void remoteControlDisplayUsesBitmapSize(IRemoteControlDisplay rcd, int w, int h) { if (rcd == null) { return; } IAudioService service = getService(); try { service.remoteControlDisplayUsesBitmapSize(rcd, w, h); } catch (RemoteException e) { Log.e(TAG, "Dead object in remoteControlDisplayUsesBitmapSize " + e); } } // FIXME remove because we are not using intents anymore between AudioService and RcDisplay /** * @hide * Broadcast intent action indicating that the displays on the remote controls * should be updated because a new remote control client is now active. If there is no * {@link #EXTRA_REMOTE_CONTROL_CLIENT}, the remote control display should be cleared * because there is no valid client to supply it with information. * * @see #EXTRA_REMOTE_CONTROL_CLIENT */ public static final String REMOTE_CONTROL_CLIENT_CHANGED = "android.media.REMOTE_CONTROL_CLIENT_CHANGED"; // FIXME remove because we are not using intents anymore between AudioService and RcDisplay /** * @hide * The IRemoteControlClientDispatcher monotonically increasing generation counter. * * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION */ public static final String EXTRA_REMOTE_CONTROL_CLIENT_GENERATION = "android.media.EXTRA_REMOTE_CONTROL_CLIENT_GENERATION"; // FIXME remove because we are not using intents anymore between AudioService and RcDisplay /** * @hide * The name of the RemoteControlClient. * This String is passed as the client name when calling methods from the * IRemoteControlClientDispatcher interface. * * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION */ public static final String EXTRA_REMOTE_CONTROL_CLIENT_NAME = "android.media.EXTRA_REMOTE_CONTROL_CLIENT_NAME"; // FIXME remove because we are not using intents anymore between AudioService and RcDisplay /** * @hide * The media button event receiver associated with the RemoteControlClient. * The {@link android.content.ComponentName} value of the event receiver can be retrieved with * {@link android.content.ComponentName#unflattenFromString(String)} * * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION */ public static final String EXTRA_REMOTE_CONTROL_EVENT_RECEIVER = "android.media.EXTRA_REMOTE_CONTROL_EVENT_RECEIVER"; // FIXME remove because we are not using intents anymore between AudioService and RcDisplay /** * @hide * The flags describing what information has changed in the current remote control client. * * @see #REMOTE_CONTROL_CLIENT_CHANGED_ACTION */ public static final String EXTRA_REMOTE_CONTROL_CLIENT_INFO_CHANGED = "android.media.EXTRA_REMOTE_CONTROL_CLIENT_INFO_CHANGED"; /** * @hide * Reload audio settings. This method is called by Settings backup * agent when audio settings are restored and causes the AudioService * to read and apply restored settings. */ public void reloadAudioSettings() { IAudioService service = getService(); try { service.reloadAudioSettings(); } catch (RemoteException e) { Log.e(TAG, "Dead object in reloadAudioSettings"+e); } } /** * {@hide} */ private IBinder mICallBack = new Binder(); /** * Checks whether the phone is in silent mode, with or without vibrate. * * @return true if phone is in silent mode, with or without vibrate. * * @see #getRingerMode() * * @hide pending API Council approval */ public boolean isSilentMode() { int ringerMode = getRingerMode(); boolean silentMode = (ringerMode == RINGER_MODE_SILENT) || (ringerMode == RINGER_MODE_VIBRATE); return silentMode; } // This section re-defines new output device constants from AudioSystem, because the AudioSystem // class is not used by other parts of the framework, which instead use definitions and methods // from AudioManager. AudioSystem is an internal class used by AudioManager and AudioService. /** {@hide} The audio output device code for the small speaker at the front of the device used * when placing calls. Does not refer to an in-ear headphone without attached microphone, * such as earbuds, earphones, or in-ear monitors (IEM). Those would be handled as a * {@link #DEVICE_OUT_WIRED_HEADPHONE}. */ public static final int DEVICE_OUT_EARPIECE = AudioSystem.DEVICE_OUT_EARPIECE; /** {@hide} The audio output device code for the built-in speaker */ public static final int DEVICE_OUT_SPEAKER = AudioSystem.DEVICE_OUT_SPEAKER; /** {@hide} The audio output device code for a wired headset with attached microphone */ public static final int DEVICE_OUT_WIRED_HEADSET = AudioSystem.DEVICE_OUT_WIRED_HEADSET; /** {@hide} The audio output device code for a wired headphone without attached microphone */ public static final int DEVICE_OUT_WIRED_HEADPHONE = AudioSystem.DEVICE_OUT_WIRED_HEADPHONE; /** {@hide} The audio output device code for generic Bluetooth SCO, for voice */ public static final int DEVICE_OUT_BLUETOOTH_SCO = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO; /** {@hide} The audio output device code for Bluetooth SCO Headset Profile (HSP) and * Hands-Free Profile (HFP), for voice */ public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET; /** {@hide} The audio output device code for Bluetooth SCO car audio, for voice */ public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT; /** {@hide} The audio output device code for generic Bluetooth A2DP, for music */ public static final int DEVICE_OUT_BLUETOOTH_A2DP = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP; /** {@hide} The audio output device code for Bluetooth A2DP headphones, for music */ public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; /** {@hide} The audio output device code for Bluetooth A2DP external speaker, for music */ public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; /** {@hide} The audio output device code for S/PDIF or HDMI */ public static final int DEVICE_OUT_AUX_DIGITAL = AudioSystem.DEVICE_OUT_AUX_DIGITAL; /** {@hide} The audio output device code for an analog wired headset attached via a * docking station */ public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET; /** {@hide} The audio output device code for a digital wired headset attached via a * docking station */ public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET; /** {@hide} This is not used as a returned value from {@link #getDevicesForStream}, but could be * used in the future in a set method to select whatever default device is chosen by the * platform-specific implementation. */ public static final int DEVICE_OUT_DEFAULT = AudioSystem.DEVICE_OUT_DEFAULT; /** * Return the enabled devices for the specified output stream type. * * @param streamType The stream type to query. One of * {@link #STREAM_VOICE_CALL}, * {@link #STREAM_SYSTEM}, * {@link #STREAM_RING}, * {@link #STREAM_MUSIC}, * {@link #STREAM_ALARM}, * {@link #STREAM_NOTIFICATION}, * {@link #STREAM_DTMF}. * * @return The bit-mask "or" of audio output device codes for all enabled devices on this * stream. Zero or more of * {@link #DEVICE_OUT_EARPIECE}, * {@link #DEVICE_OUT_SPEAKER}, * {@link #DEVICE_OUT_WIRED_HEADSET}, * {@link #DEVICE_OUT_WIRED_HEADPHONE}, * {@link #DEVICE_OUT_BLUETOOTH_SCO}, * {@link #DEVICE_OUT_BLUETOOTH_SCO_HEADSET}, * {@link #DEVICE_OUT_BLUETOOTH_SCO_CARKIT}, * {@link #DEVICE_OUT_BLUETOOTH_A2DP}, * {@link #DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES}, * {@link #DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER}, * {@link #DEVICE_OUT_AUX_DIGITAL}, * {@link #DEVICE_OUT_ANLG_DOCK_HEADSET}, * {@link #DEVICE_OUT_DGTL_DOCK_HEADSET}. * {@link #DEVICE_OUT_DEFAULT} is not used here. * * The implementation may support additional device codes beyond those listed, so * the application should ignore any bits which it does not recognize. * Note that the information may be imprecise when the implementation * cannot distinguish whether a particular device is enabled. * * {@hide} */ public int getDevicesForStream(int streamType) { switch (streamType) { case STREAM_VOICE_CALL: case STREAM_SYSTEM: case STREAM_RING: case STREAM_MUSIC: case STREAM_ALARM: case STREAM_NOTIFICATION: case STREAM_DTMF: return AudioSystem.getDevicesForStream(streamType); default: return 0; } } }