2e7dd4bfc2
Unhide the new method to query the Virtualizer effect implementation about its capabilities in terms of input, device support, and virtual speaker angles. Change-Id: I4478f7837efe8c9d52978244a3402c7f8590e585
232 lines
11 KiB
Java
232 lines
11 KiB
Java
/*
|
|
* Copyright (C) 2014 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.util.SparseIntArray;
|
|
|
|
/**
|
|
* Class to provide information about the audio devices.
|
|
*/
|
|
public class AudioDevice {
|
|
|
|
/**
|
|
* A device type associated with an unknown or uninitialized device.
|
|
*/
|
|
public static final int DEVICE_TYPE_UNKNOWN = 0;
|
|
/**
|
|
* A device type describing the attached earphone speaker.
|
|
*/
|
|
public static final int DEVICE_TYPE_BUILTIN_EARPIECE = 1;
|
|
/**
|
|
* A device type describing the speaker system (i.e. a mono speaker or stereo speakers) built
|
|
* in a device.
|
|
*/
|
|
public static final int DEVICE_TYPE_BUILTIN_SPEAKER = 2;
|
|
/**
|
|
* A device type describing a headset, which is the combination of a headphones and microphone.
|
|
*/
|
|
public static final int DEVICE_TYPE_WIRED_HEADSET = 3;
|
|
/**
|
|
* A device type describing a pair of wired headphones .
|
|
*/
|
|
public static final int DEVICE_TYPE_WIRED_HEADPHONES = 4;
|
|
/**
|
|
* A device type describing an analog line-level connection.
|
|
*/
|
|
public static final int DEVICE_TYPE_LINE_ANALOG = 5;
|
|
/**
|
|
* A device type describing a digital line connection (e.g. SPDIF).
|
|
*/
|
|
public static final int DEVICE_TYPE_LINE_DIGITAL = 6;
|
|
/**
|
|
* A device type describing a Bluetooth device typically used for telephony .
|
|
*/
|
|
public static final int DEVICE_TYPE_BLUETOOTH_SCO = 7;
|
|
/**
|
|
* A device type describing a Bluetooth device supporting the A2DP profile.
|
|
*/
|
|
public static final int DEVICE_TYPE_BLUETOOTH_A2DP = 8;
|
|
/**
|
|
* A device type describing an HDMI connection .
|
|
*/
|
|
public static final int DEVICE_TYPE_HDMI = 9;
|
|
/**
|
|
* A device type describing the Audio Return Channel of an HDMI connection.
|
|
*/
|
|
public static final int DEVICE_TYPE_HDMI_ARC = 10;
|
|
/**
|
|
* A device type describing a USB audio device.
|
|
*/
|
|
public static final int DEVICE_TYPE_USB_DEVICE = 11;
|
|
/**
|
|
* A device type describing a USB audio device in accessory mode.
|
|
*/
|
|
public static final int DEVICE_TYPE_USB_ACCESSORY = 12;
|
|
/**
|
|
* A device type describing the audio device associated with a dock.
|
|
*/
|
|
public static final int DEVICE_TYPE_DOCK = 13;
|
|
/**
|
|
* A device type associated with the transmission of audio signals over FM.
|
|
*/
|
|
public static final int DEVICE_TYPE_FM = 14;
|
|
/**
|
|
* A device type describing the microphone(s) built in a device.
|
|
*/
|
|
public static final int DEVICE_TYPE_BUILTIN_MIC = 15;
|
|
/**
|
|
* A device type for accessing the audio content transmitted over FM.
|
|
*/
|
|
public static final int DEVICE_TYPE_FM_TUNER = 16;
|
|
/**
|
|
* A device type for accessing the audio content transmitted over the TV tuner system.
|
|
*/
|
|
public static final int DEVICE_TYPE_TV_TUNER = 17;
|
|
/**
|
|
* A device type describing the transmission of audio signals over the telephony network.
|
|
*/
|
|
public static final int DEVICE_TYPE_TELEPHONY = 18;
|
|
/**
|
|
* A device type describing the auxiliary line-level connectors.
|
|
*/
|
|
public static final int DEVICE_TYPE_AUX_LINE = 19;
|
|
|
|
AudioDevicePortConfig mConfig;
|
|
|
|
AudioDevice(AudioDevicePortConfig config) {
|
|
mConfig = new AudioDevicePortConfig(config);
|
|
}
|
|
|
|
/**
|
|
* @hide
|
|
* CANDIDATE FOR PUBLIC API
|
|
* @return
|
|
*/
|
|
public boolean isInputDevice() {
|
|
return (mConfig.port().role() == AudioPort.ROLE_SOURCE);
|
|
}
|
|
|
|
/**
|
|
* @hide
|
|
* CANDIDATE FOR PUBLIC API
|
|
* @return
|
|
*/
|
|
public boolean isOutputDevice() {
|
|
return (mConfig.port().role() == AudioPort.ROLE_SINK);
|
|
}
|
|
|
|
/**
|
|
* @hide
|
|
* CANDIDATE FOR PUBLIC API
|
|
* @return
|
|
*/
|
|
public int getDeviceType() {
|
|
return INT_TO_EXT_DEVICE_MAPPING.get(mConfig.port().type(), DEVICE_TYPE_UNKNOWN);
|
|
}
|
|
|
|
/**
|
|
* @hide
|
|
* CANDIDATE FOR PUBLIC API
|
|
* @return
|
|
*/
|
|
public String getAddress() {
|
|
return mConfig.port().address();
|
|
}
|
|
|
|
/** @hide */
|
|
public static int convertDeviceTypeToInternalDevice(int deviceType) {
|
|
return EXT_TO_INT_DEVICE_MAPPING.get(deviceType, AudioSystem.DEVICE_NONE);
|
|
}
|
|
|
|
/** @hide */
|
|
public static int convertInternalDeviceToDeviceType(int intDevice) {
|
|
return INT_TO_EXT_DEVICE_MAPPING.get(intDevice, DEVICE_TYPE_UNKNOWN);
|
|
}
|
|
|
|
private static final SparseIntArray INT_TO_EXT_DEVICE_MAPPING;
|
|
|
|
private static final SparseIntArray EXT_TO_INT_DEVICE_MAPPING;
|
|
|
|
static {
|
|
INT_TO_EXT_DEVICE_MAPPING = new SparseIntArray();
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_EARPIECE, DEVICE_TYPE_BUILTIN_EARPIECE);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_SPEAKER, DEVICE_TYPE_BUILTIN_SPEAKER);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_WIRED_HEADSET, DEVICE_TYPE_WIRED_HEADSET);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_WIRED_HEADPHONE, DEVICE_TYPE_WIRED_HEADPHONES);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_BLUETOOTH_SCO, DEVICE_TYPE_BLUETOOTH_SCO);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_HEADSET, DEVICE_TYPE_BLUETOOTH_SCO);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_BLUETOOTH_SCO_CARKIT, DEVICE_TYPE_BLUETOOTH_SCO);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP, DEVICE_TYPE_BLUETOOTH_A2DP);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES, DEVICE_TYPE_BLUETOOTH_A2DP);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER, DEVICE_TYPE_BLUETOOTH_A2DP);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_HDMI, DEVICE_TYPE_HDMI);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET, DEVICE_TYPE_DOCK);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_DGTL_DOCK_HEADSET, DEVICE_TYPE_DOCK);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_USB_ACCESSORY, DEVICE_TYPE_USB_ACCESSORY);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_USB_DEVICE, DEVICE_TYPE_USB_DEVICE);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_TELEPHONY_TX, DEVICE_TYPE_TELEPHONY);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_LINE, DEVICE_TYPE_LINE_ANALOG);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_HDMI_ARC, DEVICE_TYPE_HDMI_ARC);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_SPDIF, DEVICE_TYPE_LINE_DIGITAL);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_FM, DEVICE_TYPE_FM);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_OUT_AUX_LINE, DEVICE_TYPE_AUX_LINE);
|
|
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_BUILTIN_MIC, DEVICE_TYPE_BUILTIN_MIC);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_BLUETOOTH_SCO_HEADSET, DEVICE_TYPE_BLUETOOTH_SCO);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_WIRED_HEADSET, DEVICE_TYPE_WIRED_HEADSET);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_HDMI, DEVICE_TYPE_HDMI);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_TELEPHONY_RX, DEVICE_TYPE_TELEPHONY);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_BACK_MIC, DEVICE_TYPE_BUILTIN_MIC);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_ANLG_DOCK_HEADSET, DEVICE_TYPE_DOCK);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_DGTL_DOCK_HEADSET, DEVICE_TYPE_DOCK);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_USB_ACCESSORY, DEVICE_TYPE_USB_ACCESSORY);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_USB_DEVICE, DEVICE_TYPE_USB_DEVICE);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_FM_TUNER, DEVICE_TYPE_FM_TUNER);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_TV_TUNER, DEVICE_TYPE_TV_TUNER);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_LINE, DEVICE_TYPE_LINE_ANALOG);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_SPDIF, DEVICE_TYPE_LINE_DIGITAL);
|
|
INT_TO_EXT_DEVICE_MAPPING.put(AudioSystem.DEVICE_IN_BLUETOOTH_A2DP, DEVICE_TYPE_BLUETOOTH_A2DP);
|
|
|
|
// not covered here, legacy
|
|
//AudioSystem.DEVICE_OUT_REMOTE_SUBMIX
|
|
//AudioSystem.DEVICE_IN_REMOTE_SUBMIX
|
|
|
|
// privileges mapping to output device
|
|
EXT_TO_INT_DEVICE_MAPPING = new SparseIntArray();
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_BUILTIN_EARPIECE, AudioSystem.DEVICE_OUT_EARPIECE);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_BUILTIN_SPEAKER, AudioSystem.DEVICE_OUT_SPEAKER);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_WIRED_HEADSET, AudioSystem.DEVICE_OUT_WIRED_HEADSET);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_WIRED_HEADPHONES, AudioSystem.DEVICE_OUT_WIRED_HEADPHONE);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_LINE_ANALOG, AudioSystem.DEVICE_OUT_LINE);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_LINE_DIGITAL, AudioSystem.DEVICE_OUT_SPDIF);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_BLUETOOTH_SCO, AudioSystem.DEVICE_OUT_BLUETOOTH_SCO);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_BLUETOOTH_A2DP, AudioSystem.DEVICE_OUT_BLUETOOTH_A2DP);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_HDMI, AudioSystem.DEVICE_OUT_HDMI);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_HDMI_ARC, AudioSystem.DEVICE_OUT_HDMI_ARC);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_USB_DEVICE, AudioSystem.DEVICE_OUT_USB_DEVICE);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_USB_ACCESSORY, AudioSystem.DEVICE_OUT_USB_ACCESSORY);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_DOCK, AudioSystem.DEVICE_OUT_ANLG_DOCK_HEADSET);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_FM, AudioSystem.DEVICE_OUT_FM);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_BUILTIN_MIC, AudioSystem.DEVICE_IN_BUILTIN_MIC);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_FM_TUNER, AudioSystem.DEVICE_IN_FM_TUNER);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_TV_TUNER, AudioSystem.DEVICE_IN_TV_TUNER);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_TELEPHONY, AudioSystem.DEVICE_OUT_TELEPHONY_TX);
|
|
EXT_TO_INT_DEVICE_MAPPING.put(DEVICE_TYPE_AUX_LINE, AudioSystem.DEVICE_OUT_AUX_LINE);
|
|
}
|
|
}
|
|
|