StreamSharingBuilder.java
/*
* Copyright 2023 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.core.streamsharing;
import static androidx.camera.core.internal.TargetConfig.OPTION_TARGET_CLASS;
import static androidx.camera.core.internal.TargetConfig.OPTION_TARGET_NAME;
import android.os.Build;
import androidx.annotation.NonNull;
import androidx.annotation.RequiresApi;
import androidx.camera.core.CameraSelector;
import androidx.camera.core.UseCase;
import androidx.camera.core.impl.CaptureConfig;
import androidx.camera.core.impl.MutableConfig;
import androidx.camera.core.impl.MutableOptionsBundle;
import androidx.camera.core.impl.OptionsBundle;
import androidx.camera.core.impl.SessionConfig;
import androidx.camera.core.impl.UseCaseConfig;
import androidx.camera.core.internal.TargetConfig;
import java.util.UUID;
/**
* A empty builder for {@link StreamSharing}.
*
* <p> {@link StreamSharing} does not need a public builder. Instead, the caller should call the
* constructor directly. This class exists because the {@link UseCase#getUseCaseConfigBuilder}
* method requires a builder for each {@link UseCase}.
*/
@RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
class StreamSharingBuilder implements
UseCaseConfig.Builder<StreamSharing, StreamSharingConfig, StreamSharingBuilder> {
private static final String UNSUPPORTED_MESSAGE =
"Operation not supported by StreamSharingBuilder.";
private final MutableOptionsBundle mMutableConfig;
StreamSharingBuilder() {
this(MutableOptionsBundle.create());
}
StreamSharingBuilder(@NonNull MutableOptionsBundle mutableConfig) {
mMutableConfig = mutableConfig;
Class<?> oldConfigClass =
mutableConfig.retrieveOption(TargetConfig.OPTION_TARGET_CLASS, null);
if (oldConfigClass != null && !oldConfigClass.equals(StreamSharing.class)) {
throw new IllegalArgumentException(
"Invalid target class configuration for "
+ StreamSharingBuilder.this
+ ": "
+ oldConfigClass);
}
setTargetClass(StreamSharing.class);
}
@NonNull
@Override
public MutableConfig getMutableConfig() {
return mMutableConfig;
}
@NonNull
@Override
public StreamSharing build() {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setDefaultSessionConfig(@NonNull SessionConfig sessionConfig) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setDefaultCaptureConfig(@NonNull CaptureConfig captureConfig) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setSessionOptionUnpacker(
@NonNull SessionConfig.OptionUnpacker optionUnpacker) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setCaptureOptionUnpacker(
@NonNull CaptureConfig.OptionUnpacker optionUnpacker) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setSurfaceOccupancyPriority(int priority) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setCameraSelector(@NonNull CameraSelector cameraSelector) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setZslDisabled(boolean disabled) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingBuilder setHighResolutionDisabled(boolean disabled) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
@NonNull
@Override
public StreamSharingConfig getUseCaseConfig() {
return new StreamSharingConfig(OptionsBundle.from(mMutableConfig));
}
@NonNull
@Override
public StreamSharingBuilder setTargetClass(@NonNull Class<StreamSharing> targetClass) {
getMutableConfig().insertOption(OPTION_TARGET_CLASS, targetClass);
// If no name is set yet, then generate a unique name
if (null == getMutableConfig().retrieveOption(OPTION_TARGET_NAME, null)) {
String targetName = targetClass.getCanonicalName() + "-" + UUID.randomUUID();
setTargetName(targetName);
}
return this;
}
@NonNull
@Override
public StreamSharingBuilder setTargetName(@NonNull String targetName) {
getMutableConfig().insertOption(OPTION_TARGET_NAME, targetName);
return this;
}
@NonNull
@Override
public StreamSharingBuilder setUseCaseEventCallback(
@NonNull UseCase.EventCallback eventCallback) {
throw new UnsupportedOperationException(UNSUPPORTED_MESSAGE);
}
}