a937979b4d
Short audio descriptor is defined in HDMI specification 1.4b section 7 that is used to describe the audio capabilities over HDMI. The encapsulation types represent the encapsulation formats that must be used when sending the audio data with the format associated with the AudioProfile to Android. Bug: 131736540 Bug: 178619392 Test: atest AudioManagerTest Change-Id: Icc1d02bd1239561f7f3740bf7bd9ecf17fc1420b
91 lines
3.2 KiB
Java
91 lines
3.2 KiB
Java
/*
|
|
* Copyright (C) 2021 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.IntDef;
|
|
import android.annotation.NonNull;
|
|
|
|
import java.lang.annotation.Retention;
|
|
import java.lang.annotation.RetentionPolicy;
|
|
|
|
/**
|
|
* The AudioDescriptor contains the information to describe the audio playback/capture
|
|
* capabilities. The capabilities are described by a byte array, which is defined by a
|
|
* particular standard. This is used when the format is unrecognized to the platform.
|
|
*/
|
|
public class AudioDescriptor {
|
|
/**
|
|
* The audio standard is not specified.
|
|
*/
|
|
public static final int STANDARD_NONE = 0;
|
|
/**
|
|
* The Extended Display Identification Data (EDID) standard for a short audio descriptor.
|
|
*/
|
|
public static final int STANDARD_EDID = 1;
|
|
|
|
/** @hide */
|
|
@IntDef({
|
|
STANDARD_NONE,
|
|
STANDARD_EDID,
|
|
})
|
|
@Retention(RetentionPolicy.SOURCE)
|
|
public @interface AudioDescriptorStandard {}
|
|
|
|
private final int mStandard;
|
|
private final byte[] mDescriptor;
|
|
private final int mEncapsulationType;
|
|
|
|
AudioDescriptor(int standard, int encapsulationType, @NonNull byte[] descriptor) {
|
|
mStandard = standard;
|
|
mEncapsulationType = encapsulationType;
|
|
mDescriptor = descriptor;
|
|
}
|
|
|
|
/**
|
|
* @return the standard that defines audio playback/capture capabilities.
|
|
*/
|
|
public @AudioDescriptorStandard int getStandard() {
|
|
return mStandard;
|
|
}
|
|
|
|
/**
|
|
* @return a byte array that describes audio playback/capture capabilities as encoded by the
|
|
* standard for this AudioDescriptor.
|
|
*/
|
|
public @NonNull byte[] getDescriptor() {
|
|
return mDescriptor;
|
|
}
|
|
|
|
/**
|
|
* The encapsulation type indicates what encapsulation type is required when the framework is
|
|
* using this extra audio descriptor for playing to a device exposing this audio profile.
|
|
* When encapsulation is required, only playback with {@link android.media.AudioTrack} API is
|
|
* supported. But playback with {@link android.media.MediaPlayer} is not.
|
|
* When an encapsulation type is required, the {@link AudioFormat} encoding selected when
|
|
* creating the {@link AudioTrack} must match the encapsulation type, e.g
|
|
* AudioFormat#ENCODING_IEC61937 for AudioProfile.AUDIO_ENCAPSULATION_TYPE_IEC61937.
|
|
*
|
|
* @return an integer representing the encapsulation type
|
|
*
|
|
* @see AudioProfile#AUDIO_ENCAPSULATION_TYPE_NONE
|
|
* @see AudioProfile#AUDIO_ENCAPSULATION_TYPE_IEC61937
|
|
*/
|
|
public @AudioProfile.EncapsulationType int getEncapsulationType() {
|
|
return mEncapsulationType;
|
|
}
|
|
}
|