public class

DeviceQuirks

extends java.lang.Object

 java.lang.Object

↳androidx.camera.video.internal.compat.quirk.DeviceQuirks

Gradle dependencies

compile group: 'androidx.camera', name: 'camera-video', version: '1.5.0-alpha01'

  • groupId: androidx.camera
  • artifactId: camera-video
  • version: 1.5.0-alpha01

Artifact androidx.camera:camera-video:1.5.0-alpha01 it located at Google repository (https://maven.google.com/)

Overview

Provider of video capture related quirks, which are used for device or API level specific workarounds.

Video related quirks that include depending on API level () or specific devices.

Video specific quirks are lazily loaded, i.e. They are loaded the first time they're needed.

Summary

Methods
public static Quirkget(java.lang.Class<Quirk> quirkClass)

Retrieves a specific video Quirk instance given its type.

public static QuirksgetAll()

Returns all video specific quirks loaded on the current device.

public static java.util.List<Quirk>getAll(java.lang.Class<Quirk> quirkClass)

Retrieves all video Quirk instances that are or inherit the given type.

from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods

public static Quirks getAll()

Returns all video specific quirks loaded on the current device.

public static Quirk get(java.lang.Class<Quirk> quirkClass)

Retrieves a specific video Quirk instance given its type.

Parameters:

quirkClass: The type of video quirk to retrieve.

Returns:

A video Quirk instance of the provided type, or null if it isn't found.

public static java.util.List<Quirk> getAll(java.lang.Class<Quirk> quirkClass)

Retrieves all video Quirk instances that are or inherit the given type.

Parameters:

quirkClass: The super type of video quirk to retrieve.

Returns:

A video Quirk list of the provided type. An empty list is returned if it isn't found.

Source

/*
 * 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.compat.quirk;

import static androidx.camera.core.impl.utils.executor.CameraXExecutors.directExecutor;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.camera.core.Logger;
import androidx.camera.core.impl.Quirk;
import androidx.camera.core.impl.QuirkSettingsHolder;
import androidx.camera.core.impl.Quirks;

import java.util.List;

/**
 * Provider of video capture related quirks, which are used for device or API level specific
 * workarounds.
 * <p>Video related quirks that include depending on API level
 * ({@link android.os.Build.VERSION#SDK_INT}) or specific devices.
 * <p>Video specific quirks are lazily loaded, i.e. They are loaded the first time they're needed.
 */
public class DeviceQuirks {
    private static final String TAG = "DeviceQuirks";

    /** @noinspection NotNullFieldNotInitialized*/
    @NonNull
    private static volatile Quirks sQuirks;

    static {
        // Direct executor will initialize quirks immediately, guaranteeing it's never null.
        QuirkSettingsHolder.instance().observe(directExecutor(), quirkSettings -> {
            sQuirks = new Quirks(DeviceQuirksLoader.loadQuirks(quirkSettings));
            Logger.d(TAG, "video DeviceQuirks = " + Quirks.toString(sQuirks));
        });
    }

    private DeviceQuirks() {
    }

    /** Returns all video specific quirks loaded on the current device. */
    @NonNull
    public static Quirks getAll() {
        return sQuirks;
    }

    /**
     * Retrieves a specific video {@link Quirk} instance given its type.
     *
     * @param quirkClass The type of video quirk to retrieve.
     * @return A video {@link Quirk} instance of the provided type, or {@code null} if it isn't
     * found.
     */
    @Nullable
    public static <T extends Quirk> T get(@NonNull final Class<T> quirkClass) {
        return sQuirks.get(quirkClass);
    }

    /**
     * Retrieves all video {@link Quirk} instances that are or inherit the given type.
     *
     * @param quirkClass The super type of video quirk to retrieve.
     * @return A video {@link Quirk} list of the provided type. An empty list is returned if it
     * isn't found.
     */
    @NonNull
    public static <T extends Quirk> List<T> getAll(@NonNull final Class<T> quirkClass) {
        return sQuirks.getAll(quirkClass);
    }
}