| /* |
| * 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); |
| } |
| } |
| |