AudioEncoderConfig.java
/*
* Copyright 2020 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 androidx.camera.video.internal.encoder;
import android.media.MediaFormat;
import androidx.annotation.NonNull;
import androidx.annotation.RequiresApi;
import com.google.auto.value.AutoValue;
import java.util.Objects;
/** {@inheritDoc} */
@RequiresApi(21) // TODO(b/200306659): Remove and replace with annotation on package-info.java
@AutoValue
public abstract class AudioEncoderConfig implements EncoderConfig {
// Restrict constructor to same package
AudioEncoderConfig() {
}
/** Returns a build for this config. */
@NonNull
public static Builder builder() {
return new AutoValue_AudioEncoderConfig.Builder()
.setProfile(EncoderConfig.CODEC_PROFILE_NONE);
}
/** {@inheritDoc} */
@Override
@NonNull
public abstract String getMimeType();
/**
* {@inheritDoc}
*
* <p>Default is {@link EncoderConfig#CODEC_PROFILE_NONE}.
*/
@Override
public abstract int getProfile();
/** Gets the bitrate. */
public abstract int getBitrate();
/** Gets the sample bitrate. */
public abstract int getSampleRate();
/** Gets the channel count. */
public abstract int getChannelCount();
/** {@inheritDoc} */
@NonNull
@Override
public MediaFormat toMediaFormat() {
MediaFormat mediaFormat = MediaFormat.createAudioFormat(getMimeType(), getSampleRate(),
getChannelCount());
mediaFormat.setInteger(MediaFormat.KEY_BIT_RATE, getBitrate());
if (getProfile() != CODEC_PROFILE_NONE) {
if (getMimeType().equals(MediaFormat.MIMETYPE_AUDIO_AAC)) {
mediaFormat.setInteger(MediaFormat.KEY_AAC_PROFILE, getProfile());
} else {
mediaFormat.setInteger(MediaFormat.KEY_PROFILE, getProfile());
}
}
return mediaFormat;
}
/** The builder of the config. */
@AutoValue.Builder
public abstract static class Builder {
// Restrict construction to same package
Builder() {
}
/**
* Sets the mime type.
*
* <p>If the mime type is set to AAC, i.e. {@link MediaFormat#MIMETYPE_AUDIO_AAC}, then a
* profile must be set with {@link #setProfile(int)}. If a profile isn't set or is set to
* {@link EncoderConfig#CODEC_PROFILE_NONE}, an IllegalArgumentException will be thrown by
* {@link #build()}.
*/
@NonNull
public abstract Builder setMimeType(@NonNull String mimeType);
/** Sets (optional) profile for the mime type specified by {@link #setMimeType(String)}. */
@NonNull
public abstract Builder setProfile(int profile);
/** Sets the bitrate. */
@NonNull
public abstract Builder setBitrate(int bitrate);
/** Sets the sample rate. */
@NonNull
public abstract Builder setSampleRate(int sampleRate);
/** Sets the channel count. */
@NonNull
public abstract Builder setChannelCount(int channelCount);
@NonNull
abstract AudioEncoderConfig autoBuild();
/** Builds the config instance. */
@NonNull
public AudioEncoderConfig build() {
AudioEncoderConfig config = autoBuild();
if (Objects.equals(config.getMimeType(), MediaFormat.MIMETYPE_AUDIO_AAC)
&& config.getProfile() == CODEC_PROFILE_NONE) {
throw new IllegalArgumentException("Encoder mime set to AAC, but no AAC profile "
+ "was provided.");
}
return config;
}
}
}