public final class

DeviceParametersBuilders

extends java.lang.Object

 java.lang.Object

↳androidx.wear.protolayout.DeviceParametersBuilders

Gradle dependencies

compile group: 'androidx.wear.protolayout', name: 'protolayout', version: '1.2.0'

  • groupId: androidx.wear.protolayout
  • artifactId: protolayout
  • version: 1.2.0

Artifact androidx.wear.protolayout:protolayout:1.2.0 it located at Google repository (https://maven.google.com/)

Overview

Builders for request messages used to fetch layouts and resources.

Summary

Fields
public static final intDEVICE_PLATFORM_UNDEFINED

Device platform is undefined.

public static final intDEVICE_PLATFORM_WEAR_OS

Device is a Wear OS device.

public static final intSCREEN_SHAPE_RECT

Rectangular screens.

public static final intSCREEN_SHAPE_ROUND

A round screen (typically found on most Wear devices).

public static final intSCREEN_SHAPE_UNDEFINED

Screen shape is undefined.

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

Fields

public static final int DEVICE_PLATFORM_UNDEFINED

Device platform is undefined.

public static final int DEVICE_PLATFORM_WEAR_OS

Device is a Wear OS device.

public static final int SCREEN_SHAPE_UNDEFINED

Screen shape is undefined.

public static final int SCREEN_SHAPE_ROUND

A round screen (typically found on most Wear devices).

public static final int SCREEN_SHAPE_RECT

Rectangular screens.

Source

/*
 * Copyright 2022 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.wear.protolayout;

import static androidx.annotation.Dimension.DP;

import androidx.annotation.Dimension;
import androidx.annotation.FloatRange;
import androidx.annotation.IntDef;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.annotation.OptIn;
import androidx.annotation.RestrictTo;
import androidx.annotation.RestrictTo.Scope;
import androidx.wear.protolayout.expression.ProtoLayoutExperimental;
import androidx.wear.protolayout.expression.RequiresSchemaVersion;
import androidx.wear.protolayout.expression.VersionBuilders.VersionInfo;
import androidx.wear.protolayout.proto.DeviceParametersProto;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

/** Builders for request messages used to fetch layouts and resources. */
public final class DeviceParametersBuilders {
    private DeviceParametersBuilders() {}

    /** The platform of the device requesting a layout. */
    @RequiresSchemaVersion(major = 1, minor = 0)
    @RestrictTo(RestrictTo.Scope.LIBRARY)
    @IntDef({DEVICE_PLATFORM_UNDEFINED, DEVICE_PLATFORM_WEAR_OS})
    @Retention(RetentionPolicy.SOURCE)
    public @interface DevicePlatform {}

    /** Device platform is undefined. */
    @RequiresSchemaVersion(major = 1, minor = 0)
    public static final int DEVICE_PLATFORM_UNDEFINED = 0;

    /** Device is a Wear OS device. */
    @RequiresSchemaVersion(major = 1, minor = 0)
    public static final int DEVICE_PLATFORM_WEAR_OS = 1;

    /** The shape of a screen. */
    @RequiresSchemaVersion(major = 1, minor = 0)
    @RestrictTo(RestrictTo.Scope.LIBRARY)
    @IntDef({SCREEN_SHAPE_UNDEFINED, SCREEN_SHAPE_ROUND, SCREEN_SHAPE_RECT})
    @Retention(RetentionPolicy.SOURCE)
    public @interface ScreenShape {}

    /** Screen shape is undefined. */
    @RequiresSchemaVersion(major = 1, minor = 0)
    public static final int SCREEN_SHAPE_UNDEFINED = 0;

    /** A round screen (typically found on most Wear devices). */
    @RequiresSchemaVersion(major = 1, minor = 0)
    public static final int SCREEN_SHAPE_ROUND = 1;

    /** Rectangular screens. */
    @RequiresSchemaVersion(major = 1, minor = 0)
    public static final int SCREEN_SHAPE_RECT = 2;

    /**
     * Parameters describing the device requesting a layout update. This contains physical and
     * logical characteristics about the device (e.g. screen size and density, etc).
     */
    @RequiresSchemaVersion(major = 1, minor = 0)
    public static final class DeviceParameters {
        private final DeviceParametersProto.DeviceParameters mImpl;

        DeviceParameters(DeviceParametersProto.DeviceParameters impl) {
            this.mImpl = impl;
        }

        /** Gets width of the device's screen in DP. */
        @Dimension(unit = DP)
        public int getScreenWidthDp() {
            return mImpl.getScreenWidthDp();
        }

        /** Gets height of the device's screen in DP. */
        @Dimension(unit = DP)
        public int getScreenHeightDp() {
            return mImpl.getScreenHeightDp();
        }

        /**
         * Gets density of the display. This value is the scaling factor to get from DP to Pixels
         * (px = dp * density).
         */
        @FloatRange(from = 0.0, fromInclusive = false, toInclusive = false)
        public float getScreenDensity() {
            return mImpl.getScreenDensity();
        }

        /**
         * Gets current user preference for the scaling factor for fonts displayed on the display.
         * This value is used to get from SP to DP (dp = sp * font_scale).
         */
        @FloatRange(from = 0.0, fromInclusive = false, toInclusive = false)
        public float getFontScale() {
            return mImpl.getFontScale();
        }

        /** Gets the platform of the device. */
        @DevicePlatform
        public int getDevicePlatform() {
            return mImpl.getDevicePlatform().getNumber();
        }

        /** Gets the shape of the device's screen. */
        @ScreenShape
        public int getScreenShape() {
            return mImpl.getScreenShape().getNumber();
        }

        /**
         * Gets the maximum schema version supported by the current renderer. When building a layout
         * that uses features not available on schema version 1.0 , this can be used to
         * conditionally choose which feature to use.
         */
        @NonNull
        public VersionInfo getRendererSchemaVersion() {
            if (mImpl.hasRendererSchemaVersion()) {
                return VersionInfo.fromProto(mImpl.getRendererSchemaVersion());
            } else {
                return new VersionInfo.Builder().setMajor(1).setMinor(0).build();
            }
        }

        /** Gets renderer supported {@link Capabilities}. */
        @ProtoLayoutExperimental
        @Nullable
        public Capabilities getCapabilities() {
            if (mImpl.hasCapabilities()) {
                return Capabilities.fromProto(mImpl.getCapabilities());
            } else {
                return null;
            }
        }

        /** Creates a new wrapper instance from the proto. */
        @RestrictTo(Scope.LIBRARY_GROUP)
        @NonNull
        public static DeviceParameters fromProto(
                @NonNull DeviceParametersProto.DeviceParameters proto) {
            return new DeviceParameters(proto);
        }

        /** Returns the internal proto instance. */
        @RestrictTo(Scope.LIBRARY_GROUP)
        @NonNull
        public DeviceParametersProto.DeviceParameters toProto() {
            return mImpl;
        }

        @Override
        @OptIn(markerClass = ProtoLayoutExperimental.class)
        @NonNull
        public String toString() {
            return "DeviceParameters{"
                    + "screenWidthDp="
                    + getScreenWidthDp()
                    + ", screenHeightDp="
                    + getScreenHeightDp()
                    + ", screenDensity="
                    + getScreenDensity()
                    + ", fontScale="
                    + getFontScale()
                    + ", devicePlatform="
                    + getDevicePlatform()
                    + ", screenShape="
                    + getScreenShape()
                    + ", rendererSchemaVersion="
                    + getRendererSchemaVersion()
                    + ", capabilities="
                    + getCapabilities()
                    + "}";
        }

        /** Builder for {@link DeviceParameters} */
        public static final class Builder {
            private final DeviceParametersProto.DeviceParameters.Builder mImpl =
                    DeviceParametersProto.DeviceParameters.newBuilder();

            /** Creates an instance of {@link Builder}. */
            public Builder() {}

            /** Sets width of the device's screen in DP. */
            @RequiresSchemaVersion(major = 1, minor = 0)
            @NonNull
            public Builder setScreenWidthDp(@Dimension(unit = DP) int screenWidthDp) {
                mImpl.setScreenWidthDp(screenWidthDp);
                return this;
            }

            /** Sets height of the device's screen in DP. */
            @RequiresSchemaVersion(major = 1, minor = 0)
            @NonNull
            public Builder setScreenHeightDp(@Dimension(unit = DP) int screenHeightDp) {
                mImpl.setScreenHeightDp(screenHeightDp);
                return this;
            }

            /**
             * Sets density of the display. This value is the scaling factor to get from DP to
             * Pixels (px = dp * density).
             */
            @RequiresSchemaVersion(major = 1, minor = 0)
            @NonNull
            public Builder setScreenDensity(
                    @FloatRange(from = 0.0, fromInclusive = false, toInclusive = false)
                            float screenDensity) {
                mImpl.setScreenDensity(screenDensity);
                return this;
            }

            /**
             * Sets current user preference for the scaling factor for fonts displayed on the
             * display. This value is used to get from SP to DP (dp = sp * font_scale).
             */
            @RequiresSchemaVersion(major = 1, minor = 200)
            @NonNull
            public Builder setFontScale(
                    @FloatRange(from = 0.0, fromInclusive = false, toInclusive = false)
                            float fontScale) {
                mImpl.setFontScale(fontScale);
                return this;
            }

            /** Sets the platform of the device. */
            @RequiresSchemaVersion(major = 1, minor = 0)
            @NonNull
            public Builder setDevicePlatform(@DevicePlatform int devicePlatform) {
                mImpl.setDevicePlatform(
                        DeviceParametersProto.DevicePlatform.forNumber(devicePlatform));
                return this;
            }

            /** Sets the shape of the device's screen. */
            @RequiresSchemaVersion(major = 1, minor = 0)
            @NonNull
            public Builder setScreenShape(@ScreenShape int screenShape) {
                mImpl.setScreenShape(DeviceParametersProto.ScreenShape.forNumber(screenShape));
                return this;
            }

            /**
             * Sets the maximum schema version supported by the current renderer. When building a
             * layout that uses features not available on schema version 1.0 , this can be used to
             * conditionally choose which feature to use.
             */
            @RequiresSchemaVersion(major = 1, minor = 0)
            @NonNull
            public Builder setRendererSchemaVersion(@NonNull VersionInfo rendererSchemaVersion) {
                mImpl.setRendererSchemaVersion(rendererSchemaVersion.toProto());
                return this;
            }

            /** Sets renderer supported {@link Capabilities}. */
            @RequiresSchemaVersion(major = 1, minor = 200)
            @ProtoLayoutExperimental
            @NonNull
            public Builder setCapabilities(@NonNull Capabilities capabilities) {
                mImpl.setCapabilities(capabilities.toProto());
                return this;
            }

            /** Builds an instance from accumulated values. */
            @NonNull
            public DeviceParameters build() {
                return DeviceParameters.fromProto(mImpl.build());
            }
        }
    }

    /**
     * {@link Capabilities} describing the features that the renderer supports. These features are
     * not necessarily tied to a specific schema version. {@link
     * androidx.wear.protolayout.LayoutElementBuilders.Layout} providers can use these information
     * to conditionally generate different layouts based on the presence/value of a feature.
     */
    @RequiresSchemaVersion(major = 1, minor = 200)
    @ProtoLayoutExperimental
    public static final class Capabilities {
        private final DeviceParametersProto.Capabilities mImpl;

        Capabilities(DeviceParametersProto.Capabilities impl) {
            this.mImpl = impl;
        }

        /**
         * Gets current minimum freshness limit in milliseconds for a layout. This can change based
         * on various factors. Any freshness request lower than the current limit will be replaced
         * by that limit. A value of 0 here signifies that the minimum freshness limit in unknown.
         */
        public long getMinimumFreshnessLimitMillis() {
            return mImpl.getMinimumFreshnessLimitMillis();
        }

        /** Creates a new wrapper instance from the proto. */
        @RestrictTo(Scope.LIBRARY_GROUP)
        @NonNull
        public static Capabilities fromProto(@NonNull DeviceParametersProto.Capabilities proto) {
            return new Capabilities(proto);
        }

        /** Returns the internal proto instance. */
        @RestrictTo(Scope.LIBRARY_GROUP)
        @NonNull
        public DeviceParametersProto.Capabilities toProto() {
            return mImpl;
        }

        @Override
        @NonNull
        public String toString() {
            return "Capabilities{"
                    + "minimumFreshnessLimitMillis="
                    + getMinimumFreshnessLimitMillis()
                    + "}";
        }

        /** Builder for {@link Capabilities} */
        public static final class Builder {
            private final DeviceParametersProto.Capabilities.Builder mImpl =
                    DeviceParametersProto.Capabilities.newBuilder();

            /** Creates an instance of {@link Builder}. */
            public Builder() {}

            /**
             * Sets current minimum freshness limit in milliseconds for a layout. This can change
             * based on various factors. Any freshness request lower than the current limit will be
             * replaced by that limit. A value of 0 here signifies that the minimum freshness limit
             * in unknown.
             */
            @RequiresSchemaVersion(major = 1, minor = 200)
            @NonNull
            public Builder setMinimumFreshnessLimitMillis(long minimumFreshnessLimitMillis) {
                mImpl.setMinimumFreshnessLimitMillis(minimumFreshnessLimitMillis);
                return this;
            }

            /** Builds an instance from accumulated values. */
            @NonNull
            public Capabilities build() {
                return Capabilities.fromProto(mImpl.build());
            }
        }
    }
}