/* * Copyright (C) 2006 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.content.Context; import android.content.pm.PackageManager; import android.media.audiopolicy.AudioMix; import android.util.Log; import java.util.ArrayList; /* IF YOU CHANGE ANY OF THE CONSTANTS IN THIS FILE, DO NOT FORGET * TO UPDATE THE CORRESPONDING NATIVE GLUE AND AudioManager.java. * THANK YOU FOR YOUR COOPERATION. */ /** * @hide */ public class AudioSystem { private static final String TAG = "AudioSystem"; /* These values must be kept in sync with system/audio.h */ /* * If these are modified, please also update Settings.System.VOLUME_SETTINGS * and attrs.xml and AudioManager.java. */ /* The default audio stream */ public static final int STREAM_DEFAULT = -1; /* The audio stream for phone calls */ public static final int STREAM_VOICE_CALL = 0; /* The audio stream for system sounds */ public static final int STREAM_SYSTEM = 1; /* The audio stream for the phone ring and message alerts */ public static final int STREAM_RING = 2; /* The audio stream for music playback */ public static final int STREAM_MUSIC = 3; /* The audio stream for alarms */ public static final int STREAM_ALARM = 4; /* The audio stream for notifications */ public static final int STREAM_NOTIFICATION = 5; /* @hide The audio stream for phone calls when connected on bluetooth */ public static final int STREAM_BLUETOOTH_SCO = 6; /* @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */ public static final int STREAM_SYSTEM_ENFORCED = 7; /* @hide The audio stream for DTMF tones */ public static final int STREAM_DTMF = 8; /* @hide The audio stream for text to speech (TTS) */ public static final int STREAM_TTS = 9; /** * @deprecated Use {@link #numStreamTypes() instead} */ public static final int NUM_STREAMS = 5; // Expose only the getter method publicly so we can change it in the future private static final int NUM_STREAM_TYPES = 10; public static final int getNumStreamTypes() { return NUM_STREAM_TYPES; } public static final String[] STREAM_NAMES = new String[] { "STREAM_VOICE_CALL", "STREAM_SYSTEM", "STREAM_RING", "STREAM_MUSIC", "STREAM_ALARM", "STREAM_NOTIFICATION", "STREAM_BLUETOOTH_SCO", "STREAM_SYSTEM_ENFORCED", "STREAM_DTMF", "STREAM_TTS" }; /* * Sets the microphone mute on or off. * * @param on set true to mute the microphone; * false to turn mute off * @return command completion status see AUDIO_STATUS_OK, see AUDIO_STATUS_ERROR */ public static native int muteMicrophone(boolean on); /* * Checks whether the microphone mute is on or off. * * @return true if microphone is muted, false if it's not */ public static native boolean isMicrophoneMuted(); /* modes for setPhoneState, must match AudioSystem.h audio_mode */ public static final int MODE_INVALID = -2; public static final int MODE_CURRENT = -1; public static final int MODE_NORMAL = 0; public static final int MODE_RINGTONE = 1; public static final int MODE_IN_CALL = 2; public static final int MODE_IN_COMMUNICATION = 3; public static final int NUM_MODES = 4; /* Routing bits for the former setRouting/getRouting API */ /** @deprecated */ @Deprecated public static final int ROUTE_EARPIECE = (1 << 0); /** @deprecated */ @Deprecated public static final int ROUTE_SPEAKER = (1 << 1); /** @deprecated use {@link #ROUTE_BLUETOOTH_SCO} */ @Deprecated public static final int ROUTE_BLUETOOTH = (1 << 2); /** @deprecated */ @Deprecated public static final int ROUTE_BLUETOOTH_SCO = (1 << 2); /** @deprecated */ @Deprecated public static final int ROUTE_HEADSET = (1 << 3); /** @deprecated */ @Deprecated public static final int ROUTE_BLUETOOTH_A2DP = (1 << 4); /** @deprecated */ @Deprecated public static final int ROUTE_ALL = 0xFFFFFFFF; // Keep in sync with system/media/audio/include/system/audio.h public static final int AUDIO_SESSION_ALLOCATE = 0; /* * Checks whether the specified stream type is active. * * return true if any track playing on this stream is active. */ public static native boolean isStreamActive(int stream, int inPastMs); /* * Checks whether the specified stream type is active on a remotely connected device. The notion * of what constitutes a remote device is enforced by the audio policy manager of the platform. * * return true if any track playing on this stream is active on a remote device. */ public static native boolean isStreamActiveRemotely(int stream, int inPastMs); /* * Checks whether the specified audio source is active. * * return true if any recorder using this source is currently recording */ public static native boolean isSourceActive(int source); /* * Returns a new unused audio session ID */ public static native int newAudioSessionId(); /* * Sets a group generic audio configuration parameters. The use of these parameters * are platform dependent, see libaudio * * param keyValuePairs list of parameters key value pairs in the form: * key1=value1;key2=value2;... */ public static native int setParameters(String keyValuePairs); /* * Gets a group generic audio configuration parameters. The use of these parameters * are platform dependent, see libaudio * * param keys list of parameters * return value: list of parameters key value pairs in the form: * key1=value1;key2=value2;... */ public static native String getParameters(String keys); // These match the enum AudioError in frameworks/base/core/jni/android_media_AudioSystem.cpp /* Command sucessful or Media server restarted. see ErrorCallback */ public static final int AUDIO_STATUS_OK = 0; /* Command failed or unspecified audio error. see ErrorCallback */ public static final int AUDIO_STATUS_ERROR = 1; /* Media server died. see ErrorCallback */ public static final int AUDIO_STATUS_SERVER_DIED = 100; private static ErrorCallback mErrorCallback; /* * Handles the audio error callback. */ public interface ErrorCallback { /* * Callback for audio server errors. * param error error code: * - AUDIO_STATUS_OK * - AUDIO_STATUS_SERVER_DIED * - AUDIO_STATUS_ERROR */ void onError(int error); }; /* * Registers a callback to be invoked when an error occurs. * @param cb the callback to run */ public static void setErrorCallback(ErrorCallback cb) { synchronized (AudioSystem.class) { mErrorCallback = cb; if (cb != null) { cb.onError(checkAudioFlinger()); } } } private static void errorCallbackFromNative(int error) { ErrorCallback errorCallback = null; synchronized (AudioSystem.class) { if (mErrorCallback != null) { errorCallback = mErrorCallback; } } if (errorCallback != null) { errorCallback.onError(error); } } /** * Handles events for the audio policy manager about dynamic audio policies * @see android.media.audiopolicy.AudioPolicy */ public interface DynamicPolicyCallback { void onDynamicPolicyMixStateUpdate(String regId, int state); } //keep in sync with include/media/AudioPolicy.h private final static int DYNAMIC_POLICY_EVENT_MIX_STATE_UPDATE = 0; private static DynamicPolicyCallback sDynPolicyCallback; public static void setDynamicPolicyCallback(DynamicPolicyCallback cb) { synchronized (AudioSystem.class) { sDynPolicyCallback = cb; native_register_dynamic_policy_callback(); } } private static void dynamicPolicyCallbackFromNative(int event, String regId, int val) { DynamicPolicyCallback cb = null; synchronized (AudioSystem.class) { if (sDynPolicyCallback != null) { cb = sDynPolicyCallback; } } if (cb != null) { switch(event) { case DYNAMIC_POLICY_EVENT_MIX_STATE_UPDATE: cb.onDynamicPolicyMixStateUpdate(regId, val); break; default: Log.e(TAG, "dynamicPolicyCallbackFromNative: unknown event " + event); } } } /* * Error codes used by public APIs (AudioTrack, AudioRecord, AudioManager ...) * Must be kept in sync with frameworks/base/core/jni/android_media_AudioErrors.h */ public static final int SUCCESS = 0; public static final int ERROR = -1; public static final int BAD_VALUE = -2; public static final int INVALID_OPERATION = -3; public static final int PERMISSION_DENIED = -4; public static final int NO_INIT = -5; public static final int DEAD_OBJECT = -6; /* * AudioPolicyService methods */ // // audio device definitions: must be kept in sync with values in system/core/audio.h // public static final int DEVICE_NONE = 0x0; // reserved bits public static final int DEVICE_BIT_IN = 0x80000000; public static final int DEVICE_BIT_DEFAULT = 0x40000000; // output devices, be sure to update AudioManager.java also public static final int DEVICE_OUT_EARPIECE = 0x1; public static final int DEVICE_OUT_SPEAKER = 0x2; public static final int DEVICE_OUT_WIRED_HEADSET = 0x4; public static final int DEVICE_OUT_WIRED_HEADPHONE = 0x8; public static final int DEVICE_OUT_BLUETOOTH_SCO = 0x10; public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 0x20; public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 0x40; public static final int DEVICE_OUT_BLUETOOTH_A2DP = 0x80; public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100; public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 0x200; public static final int DEVICE_OUT_AUX_DIGITAL = 0x400; public static final int DEVICE_OUT_HDMI = DEVICE_OUT_AUX_DIGITAL; public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = 0x800; public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = 0x1000; public static final int DEVICE_OUT_USB_ACCESSORY = 0x2000; public static final int DEVICE_OUT_USB_DEVICE = 0x4000; public static final int DEVICE_OUT_REMOTE_SUBMIX = 0x8000; public static final int DEVICE_OUT_TELEPHONY_TX = 0x10000; public static final int DEVICE_OUT_LINE = 0x20000; public static final int DEVICE_OUT_HDMI_ARC = 0x40000; public static final int DEVICE_OUT_SPDIF = 0x80000; public static final int DEVICE_OUT_FM = 0x100000; public static final int DEVICE_OUT_AUX_LINE = 0x200000; public static final int DEVICE_OUT_SPEAKER_SAFE = 0x400000; public static final int DEVICE_OUT_IP = 0x800000; public static final int DEVICE_OUT_DEFAULT = DEVICE_BIT_DEFAULT; public static final int DEVICE_OUT_ALL = (DEVICE_OUT_EARPIECE | DEVICE_OUT_SPEAKER | DEVICE_OUT_WIRED_HEADSET | DEVICE_OUT_WIRED_HEADPHONE | DEVICE_OUT_BLUETOOTH_SCO | DEVICE_OUT_BLUETOOTH_SCO_HEADSET | DEVICE_OUT_BLUETOOTH_SCO_CARKIT | DEVICE_OUT_BLUETOOTH_A2DP | DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER | DEVICE_OUT_HDMI | DEVICE_OUT_ANLG_DOCK_HEADSET | DEVICE_OUT_DGTL_DOCK_HEADSET | DEVICE_OUT_USB_ACCESSORY | DEVICE_OUT_USB_DEVICE | DEVICE_OUT_REMOTE_SUBMIX | DEVICE_OUT_TELEPHONY_TX | DEVICE_OUT_LINE | DEVICE_OUT_HDMI_ARC | DEVICE_OUT_SPDIF | DEVICE_OUT_FM | DEVICE_OUT_AUX_LINE | DEVICE_OUT_SPEAKER_SAFE | DEVICE_OUT_IP | DEVICE_OUT_DEFAULT); public static final int DEVICE_OUT_ALL_A2DP = (DEVICE_OUT_BLUETOOTH_A2DP | DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER); public static final int DEVICE_OUT_ALL_SCO = (DEVICE_OUT_BLUETOOTH_SCO | DEVICE_OUT_BLUETOOTH_SCO_HEADSET | DEVICE_OUT_BLUETOOTH_SCO_CARKIT); public static final int DEVICE_OUT_ALL_USB = (DEVICE_OUT_USB_ACCESSORY | DEVICE_OUT_USB_DEVICE); public static final int DEVICE_OUT_ALL_HDMI_SYSTEM_AUDIO = (DEVICE_OUT_AUX_LINE | DEVICE_OUT_HDMI_ARC | DEVICE_OUT_SPDIF); public static final int DEVICE_ALL_HDMI_SYSTEM_AUDIO_AND_SPEAKER = (DEVICE_OUT_ALL_HDMI_SYSTEM_AUDIO | DEVICE_OUT_SPEAKER); // input devices public static final int DEVICE_IN_COMMUNICATION = DEVICE_BIT_IN | 0x1; public static final int DEVICE_IN_AMBIENT = DEVICE_BIT_IN | 0x2; public static final int DEVICE_IN_BUILTIN_MIC = DEVICE_BIT_IN | 0x4; public static final int DEVICE_IN_BLUETOOTH_SCO_HEADSET = DEVICE_BIT_IN | 0x8; public static final int DEVICE_IN_WIRED_HEADSET = DEVICE_BIT_IN | 0x10; public static final int DEVICE_IN_AUX_DIGITAL = DEVICE_BIT_IN | 0x20; public static final int DEVICE_IN_HDMI = DEVICE_IN_AUX_DIGITAL; public static final int DEVICE_IN_VOICE_CALL = DEVICE_BIT_IN | 0x40; public static final int DEVICE_IN_TELEPHONY_RX = DEVICE_IN_VOICE_CALL; public static final int DEVICE_IN_BACK_MIC = DEVICE_BIT_IN | 0x80; public static final int DEVICE_IN_REMOTE_SUBMIX = DEVICE_BIT_IN | 0x100; public static final int DEVICE_IN_ANLG_DOCK_HEADSET = DEVICE_BIT_IN | 0x200; public static final int DEVICE_IN_DGTL_DOCK_HEADSET = DEVICE_BIT_IN | 0x400; public static final int DEVICE_IN_USB_ACCESSORY = DEVICE_BIT_IN | 0x800; public static final int DEVICE_IN_USB_DEVICE = DEVICE_BIT_IN | 0x1000; public static final int DEVICE_IN_FM_TUNER = DEVICE_BIT_IN | 0x2000; public static final int DEVICE_IN_TV_TUNER = DEVICE_BIT_IN | 0x4000; public static final int DEVICE_IN_LINE = DEVICE_BIT_IN | 0x8000; public static final int DEVICE_IN_SPDIF = DEVICE_BIT_IN | 0x10000; public static final int DEVICE_IN_BLUETOOTH_A2DP = DEVICE_BIT_IN | 0x20000; public static final int DEVICE_IN_LOOPBACK = DEVICE_BIT_IN | 0x40000; public static final int DEVICE_IN_IP = DEVICE_BIT_IN | 0x80000; public static final int DEVICE_IN_DEFAULT = DEVICE_BIT_IN | DEVICE_BIT_DEFAULT; public static final int DEVICE_IN_ALL = (DEVICE_IN_COMMUNICATION | DEVICE_IN_AMBIENT | DEVICE_IN_BUILTIN_MIC | DEVICE_IN_BLUETOOTH_SCO_HEADSET | DEVICE_IN_WIRED_HEADSET | DEVICE_IN_HDMI | DEVICE_IN_TELEPHONY_RX | DEVICE_IN_BACK_MIC | DEVICE_IN_REMOTE_SUBMIX | DEVICE_IN_ANLG_DOCK_HEADSET | DEVICE_IN_DGTL_DOCK_HEADSET | DEVICE_IN_USB_ACCESSORY | DEVICE_IN_USB_DEVICE | DEVICE_IN_FM_TUNER | DEVICE_IN_TV_TUNER | DEVICE_IN_LINE | DEVICE_IN_SPDIF | DEVICE_IN_BLUETOOTH_A2DP | DEVICE_IN_LOOPBACK | DEVICE_IN_IP | DEVICE_IN_DEFAULT); public static final int DEVICE_IN_ALL_SCO = DEVICE_IN_BLUETOOTH_SCO_HEADSET; public static final int DEVICE_IN_ALL_USB = (DEVICE_IN_USB_ACCESSORY | DEVICE_IN_USB_DEVICE); // device states, must match AudioSystem::device_connection_state public static final int DEVICE_STATE_UNAVAILABLE = 0; public static final int DEVICE_STATE_AVAILABLE = 1; private static final int NUM_DEVICE_STATES = 1; public static final String DEVICE_OUT_EARPIECE_NAME = "earpiece"; public static final String DEVICE_OUT_SPEAKER_NAME = "speaker"; public static final String DEVICE_OUT_WIRED_HEADSET_NAME = "headset"; public static final String DEVICE_OUT_WIRED_HEADPHONE_NAME = "headphone"; public static final String DEVICE_OUT_BLUETOOTH_SCO_NAME = "bt_sco"; public static final String DEVICE_OUT_BLUETOOTH_SCO_HEADSET_NAME = "bt_sco_hs"; public static final String DEVICE_OUT_BLUETOOTH_SCO_CARKIT_NAME = "bt_sco_carkit"; public static final String DEVICE_OUT_BLUETOOTH_A2DP_NAME = "bt_a2dp"; public static final String DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES_NAME = "bt_a2dp_hp"; public static final String DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER_NAME = "bt_a2dp_spk"; public static final String DEVICE_OUT_AUX_DIGITAL_NAME = "aux_digital"; public static final String DEVICE_OUT_HDMI_NAME = "hdmi"; public static final String DEVICE_OUT_ANLG_DOCK_HEADSET_NAME = "analog_dock"; public static final String DEVICE_OUT_DGTL_DOCK_HEADSET_NAME = "digital_dock"; public static final String DEVICE_OUT_USB_ACCESSORY_NAME = "usb_accessory"; public static final String DEVICE_OUT_USB_DEVICE_NAME = "usb_device"; public static final String DEVICE_OUT_REMOTE_SUBMIX_NAME = "remote_submix"; public static final String DEVICE_OUT_TELEPHONY_TX_NAME = "telephony_tx"; public static final String DEVICE_OUT_LINE_NAME = "line"; public static final String DEVICE_OUT_HDMI_ARC_NAME = "hmdi_arc"; public static final String DEVICE_OUT_SPDIF_NAME = "spdif"; public static final String DEVICE_OUT_FM_NAME = "fm_transmitter"; public static final String DEVICE_OUT_AUX_LINE_NAME = "aux_line"; public static final String DEVICE_OUT_SPEAKER_SAFE_NAME = "speaker_safe"; public static final String DEVICE_OUT_IP_NAME = "ip"; public static final String DEVICE_IN_COMMUNICATION_NAME = "communication"; public static final String DEVICE_IN_AMBIENT_NAME = "ambient"; public static final String DEVICE_IN_BUILTIN_MIC_NAME = "mic"; public static final String DEVICE_IN_BLUETOOTH_SCO_HEADSET_NAME = "bt_sco_hs"; public static final String DEVICE_IN_WIRED_HEADSET_NAME = "headset"; public static final String DEVICE_IN_AUX_DIGITAL_NAME = "aux_digital"; public static final String DEVICE_IN_TELEPHONY_RX_NAME = "telephony_rx"; public static final String DEVICE_IN_BACK_MIC_NAME = "back_mic"; public static final String DEVICE_IN_REMOTE_SUBMIX_NAME = "remote_submix"; public static final String DEVICE_IN_ANLG_DOCK_HEADSET_NAME = "analog_dock"; public static final String DEVICE_IN_DGTL_DOCK_HEADSET_NAME = "digital_dock"; public static final String DEVICE_IN_USB_ACCESSORY_NAME = "usb_accessory"; public static final String DEVICE_IN_USB_DEVICE_NAME = "usb_device"; public static final String DEVICE_IN_FM_TUNER_NAME = "fm_tuner"; public static final String DEVICE_IN_TV_TUNER_NAME = "tv_tuner"; public static final String DEVICE_IN_LINE_NAME = "line"; public static final String DEVICE_IN_SPDIF_NAME = "spdif"; public static final String DEVICE_IN_BLUETOOTH_A2DP_NAME = "bt_a2dp"; public static final String DEVICE_IN_LOOPBACK_NAME = "loopback"; public static final String DEVICE_IN_IP_NAME = "ip"; public static String getOutputDeviceName(int device) { switch(device) { case DEVICE_OUT_EARPIECE: return DEVICE_OUT_EARPIECE_NAME; case DEVICE_OUT_SPEAKER: return DEVICE_OUT_SPEAKER_NAME; case DEVICE_OUT_WIRED_HEADSET: return DEVICE_OUT_WIRED_HEADSET_NAME; case DEVICE_OUT_WIRED_HEADPHONE: return DEVICE_OUT_WIRED_HEADPHONE_NAME; case DEVICE_OUT_BLUETOOTH_SCO: return DEVICE_OUT_BLUETOOTH_SCO_NAME; case DEVICE_OUT_BLUETOOTH_SCO_HEADSET: return DEVICE_OUT_BLUETOOTH_SCO_HEADSET_NAME; case DEVICE_OUT_BLUETOOTH_SCO_CARKIT: return DEVICE_OUT_BLUETOOTH_SCO_CARKIT_NAME; case DEVICE_OUT_BLUETOOTH_A2DP: return DEVICE_OUT_BLUETOOTH_A2DP_NAME; case DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES: return DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES_NAME; case DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER: return DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER_NAME; case DEVICE_OUT_HDMI: return DEVICE_OUT_HDMI_NAME; case DEVICE_OUT_ANLG_DOCK_HEADSET: return DEVICE_OUT_ANLG_DOCK_HEADSET_NAME; case DEVICE_OUT_DGTL_DOCK_HEADSET: return DEVICE_OUT_DGTL_DOCK_HEADSET_NAME; case DEVICE_OUT_USB_ACCESSORY: return DEVICE_OUT_USB_ACCESSORY_NAME; case DEVICE_OUT_USB_DEVICE: return DEVICE_OUT_USB_DEVICE_NAME; case DEVICE_OUT_REMOTE_SUBMIX: return DEVICE_OUT_REMOTE_SUBMIX_NAME; case DEVICE_OUT_TELEPHONY_TX: return DEVICE_OUT_TELEPHONY_TX_NAME; case DEVICE_OUT_LINE: return DEVICE_OUT_LINE_NAME; case DEVICE_OUT_HDMI_ARC: return DEVICE_OUT_HDMI_ARC_NAME; case DEVICE_OUT_SPDIF: return DEVICE_OUT_SPDIF_NAME; case DEVICE_OUT_FM: return DEVICE_OUT_FM_NAME; case DEVICE_OUT_AUX_LINE: return DEVICE_OUT_AUX_LINE_NAME; case DEVICE_OUT_SPEAKER_SAFE: return DEVICE_OUT_SPEAKER_SAFE_NAME; case DEVICE_OUT_IP: return DEVICE_OUT_IP_NAME; case DEVICE_OUT_DEFAULT: default: return Integer.toString(device); } } public static String getInputDeviceName(int device) { switch(device) { case DEVICE_IN_COMMUNICATION: return DEVICE_IN_COMMUNICATION_NAME; case DEVICE_IN_AMBIENT: return DEVICE_IN_AMBIENT_NAME; case DEVICE_IN_BUILTIN_MIC: return DEVICE_IN_BUILTIN_MIC_NAME; case DEVICE_IN_BLUETOOTH_SCO_HEADSET: return DEVICE_IN_BLUETOOTH_SCO_HEADSET_NAME; case DEVICE_IN_WIRED_HEADSET: return DEVICE_IN_WIRED_HEADSET_NAME; case DEVICE_IN_AUX_DIGITAL: return DEVICE_IN_AUX_DIGITAL_NAME; case DEVICE_IN_TELEPHONY_RX: return DEVICE_IN_TELEPHONY_RX_NAME; case DEVICE_IN_BACK_MIC: return DEVICE_IN_BACK_MIC_NAME; case DEVICE_IN_REMOTE_SUBMIX: return DEVICE_IN_REMOTE_SUBMIX_NAME; case DEVICE_IN_ANLG_DOCK_HEADSET: return DEVICE_IN_ANLG_DOCK_HEADSET_NAME; case DEVICE_IN_DGTL_DOCK_HEADSET: return DEVICE_IN_DGTL_DOCK_HEADSET_NAME; case DEVICE_IN_USB_ACCESSORY: return DEVICE_IN_USB_ACCESSORY_NAME; case DEVICE_IN_USB_DEVICE: return DEVICE_IN_USB_DEVICE_NAME; case DEVICE_IN_FM_TUNER: return DEVICE_IN_FM_TUNER_NAME; case DEVICE_IN_TV_TUNER: return DEVICE_IN_TV_TUNER_NAME; case DEVICE_IN_LINE: return DEVICE_IN_LINE_NAME; case DEVICE_IN_SPDIF: return DEVICE_IN_SPDIF_NAME; case DEVICE_IN_BLUETOOTH_A2DP: return DEVICE_IN_BLUETOOTH_A2DP_NAME; case DEVICE_IN_LOOPBACK: return DEVICE_IN_LOOPBACK_NAME; case DEVICE_IN_IP: return DEVICE_IN_IP_NAME; case DEVICE_IN_DEFAULT: default: return Integer.toString(device); } } // phone state, match audio_mode??? public static final int PHONE_STATE_OFFCALL = 0; public static final int PHONE_STATE_RINGING = 1; public static final int PHONE_STATE_INCALL = 2; // device categories config for setForceUse, must match AudioSystem::forced_config public static final int FORCE_NONE = 0; public static final int FORCE_SPEAKER = 1; public static final int FORCE_HEADPHONES = 2; public static final int FORCE_BT_SCO = 3; public static final int FORCE_BT_A2DP = 4; public static final int FORCE_WIRED_ACCESSORY = 5; public static final int FORCE_BT_CAR_DOCK = 6; public static final int FORCE_BT_DESK_DOCK = 7; public static final int FORCE_ANALOG_DOCK = 8; public static final int FORCE_DIGITAL_DOCK = 9; public static final int FORCE_NO_BT_A2DP = 10; public static final int FORCE_SYSTEM_ENFORCED = 11; public static final int FORCE_HDMI_SYSTEM_AUDIO_ENFORCED = 12; private static final int NUM_FORCE_CONFIG = 13; public static final int FORCE_DEFAULT = FORCE_NONE; // usage for setForceUse, must match AudioSystem::force_use public static final int FOR_COMMUNICATION = 0; public static final int FOR_MEDIA = 1; public static final int FOR_RECORD = 2; public static final int FOR_DOCK = 3; public static final int FOR_SYSTEM = 4; public static final int FOR_HDMI_SYSTEM_AUDIO = 5; private static final int NUM_FORCE_USE = 6; // usage for AudioRecord.startRecordingSync(), must match AudioSystem::sync_event_t public static final int SYNC_EVENT_NONE = 0; public static final int SYNC_EVENT_PRESENTATION_COMPLETE = 1; /** * @return command completion status, one of {@link #AUDIO_STATUS_OK}, * {@link #AUDIO_STATUS_ERROR} or {@link #AUDIO_STATUS_SERVER_DIED} */ public static native int setDeviceConnectionState(int device, int state, String device_address, String device_name); public static native int getDeviceConnectionState(int device, String device_address); public static native int setPhoneState(int state); public static native int setForceUse(int usage, int config); public static native int getForceUse(int usage); public static native int initStreamVolume(int stream, int indexMin, int indexMax); public static native int setStreamVolumeIndex(int stream, int index, int device); public static native int getStreamVolumeIndex(int stream, int device); public static native int setMasterVolume(float value); public static native float getMasterVolume(); public static native int setMasterMute(boolean mute); public static native boolean getMasterMute(); public static native int getDevicesForStream(int stream); // helpers for android.media.AudioManager.getProperty(), see description there for meaning public static native int getPrimaryOutputSamplingRate(); public static native int getPrimaryOutputFrameCount(); public static native int getOutputLatency(int stream); public static native int setLowRamDevice(boolean isLowRamDevice); public static native int checkAudioFlinger(); public static native int listAudioPorts(ArrayList ports, int[] generation); public static native int createAudioPatch(AudioPatch[] patch, AudioPortConfig[] sources, AudioPortConfig[] sinks); public static native int releaseAudioPatch(AudioPatch patch); public static native int listAudioPatches(ArrayList patches, int[] generation); public static native int setAudioPortConfig(AudioPortConfig config); // declare this instance as having a dynamic policy callback handler private static native final void native_register_dynamic_policy_callback(); // must be kept in sync with value in include/system/audio.h public static final int AUDIO_HW_SYNC_INVALID = 0; public static native int getAudioHwSyncForSession(int sessionId); public static native int registerPolicyMixes(ArrayList mixes, boolean register); public static native int systemReady(); // Items shared with audio service /** * The delay before playing a sound. This small period exists so the user * can press another key (non-volume keys, too) to have it NOT be audible. *

* PhoneWindow will implement this part. */ public static final int PLAY_SOUND_DELAY = 300; /** * Constant to identify a focus stack entry that is used to hold the focus while the phone * is ringing or during a call. Used by com.android.internal.telephony.CallManager when * entering and exiting calls. */ public final static String IN_VOICE_COMM_FOCUS_ID = "AudioFocus_For_Phone_Ring_And_Calls"; /** * @see AudioManager#setVibrateSetting(int, int) */ public static int getValueForVibrateSetting(int existingValue, int vibrateType, int vibrateSetting) { // First clear the existing setting. Each vibrate type has two bits in // the value. Note '3' is '11' in binary. existingValue &= ~(3 << (vibrateType * 2)); // Set into the old value existingValue |= (vibrateSetting & 3) << (vibrateType * 2); return existingValue; } public static int getDefaultStreamVolume(int streamType) { return DEFAULT_STREAM_VOLUME[streamType]; } public static 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 }; public static String streamToString(int stream) { if (stream >= 0 && stream < STREAM_NAMES.length) return STREAM_NAMES[stream]; if (stream == AudioManager.USE_DEFAULT_STREAM_TYPE) return "USE_DEFAULT_STREAM_TYPE"; return "UNKNOWN_STREAM_" + stream; } /** The platform has no specific capabilities */ public static final int PLATFORM_DEFAULT = 0; /** The platform is voice call capable (a phone) */ public static final int PLATFORM_VOICE = 1; /** The platform is a television or a set-top box */ public static final int PLATFORM_TELEVISION = 2; /** * Return the platform type that this is running on. One of: *

{@link #PLATFORM_VOICE}
{@link #PLATFORM_TELEVISION}
{@link #PLATFORM_DEFAULT}

*/ public static int getPlatformType(Context context) { if (context.getResources().getBoolean(com.android.internal.R.bool.config_voice_capable)) { return PLATFORM_VOICE; } else if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_LEANBACK)) { return PLATFORM_TELEVISION; } else { return PLATFORM_DEFAULT; } } public static final int DEFAULT_MUTE_STREAMS_AFFECTED = (1 << STREAM_MUSIC) | (1 << STREAM_RING) | (1 << STREAM_NOTIFICATION) | (1 << STREAM_SYSTEM); /** * Event posted by AudioTrack and AudioRecord JNI (JNIDeviceCallback) when routing changes. * Keep in sync with core/jni/android_media_DeviceCallback.h. */ final static int NATIVE_EVENT_ROUTING_CHANGE = 1000; }