ManifestProperty

Added in 1.0.0-alpha05

public final class ManifestProperty


Summary

Public fields

static final @NonNull String

Application or Activity level PackageManager.Property for an app to inform the system of the activity launch mode in XR.

static final @NonNull String

Application or Activity level PackageManager.Property for an app to inform the system of the type of safety boundary recommended for the activity.

static final @NonNull String

Application or Activity level PackageManager.Property to inform the system if it should play a system provided default animation when the app requests to enter or exit managed full space mode in XR.

static final @NonNull String

Defines the value to launch an activity in managed full space mode in XR, where the system is rendering the activity from a scene graph.

static final @NonNull String

Defines the value to launch an activity in unmanaged full space mode in XR, where the activity itself is rendering the space and controls its own scene graph.

static final @NonNull String

Defines the value to launch an activity in home space mode in XR.

static final @NonNull String

The default value if not specified.

static final @NonNull String

Defines the value to launch an activity with a large boundary recommended.

static final @NonNull String

Defines the value to launch an activity with no recommendations for the type of safety boundary.

Public fields

PROPERTY_XR_ACTIVITY_START_MODE

public static final @NonNull String PROPERTY_XR_ACTIVITY_START_MODE

Application or Activity level PackageManager.Property for an app to inform the system of the activity launch mode in XR. When it is declared at the application level, all activities are set to the defined value, unless it is overridden at the activity level.

The default value is XR_ACTIVITY_START_MODE_UNDEFINED.

The available values are:

Syntax:

<application>
<property
android:name="android.window.PROPERTY_ACTIVITY_XR_START_MODE"
android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED|
XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED|
XR_ACTIVITY_START_MODE_HOME_SPACE|
XR_ACTIVITY_START_MODE_UNDEFINED" />
</application>

Constant Value: "android.window.PROPERTY_XR_ACTIVITY_START_MODE"

PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

public static final @NonNull String PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

Application or Activity level PackageManager.Property for an app to inform the system of the type of safety boundary recommended for the activity. When it is declared at the application level, all activities are set to the defined value, unless it is overridden at the activity level. When not declared, the system will not enforce any recommendations for a type of safety boundary and will continue to use the type that is currently in use.

The default value is XR_BOUNDARY_TYPE_NO_RECOMMENDATION.

The available values are:

Syntax:

<application>
<property
android:name="android.window.PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED"
android:value="XR_BOUNDARY_TYPE_LARGE|
XR_BOUNDARY_TYPE_NO_RECOMMENDATION"
/>
</
application>

Constant Value: "android.window.PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED"

PROPERTY_XR_USES_CUSTOM_FULL_SPACE_MANAGED_ANIMATION

public static final @NonNull String PROPERTY_XR_USES_CUSTOM_FULL_SPACE_MANAGED_ANIMATION

Application or Activity level PackageManager.Property to inform the system if it should play a system provided default animation when the app requests to enter or exit managed full space mode in XR. When set to true, the system provided default animation is not played and the app is responsible for playing a custom enter or exit animation. When it is declared at the application level, all activities are set to the defined value, unless it is overridden at the activity level.

The default value is false.

Syntax:

<application>
<property
android:name="android.window.PROPERTY_XR_USES_CUSTOM_FULL_SPACE_MANAGED_ANIMATION"
android:value="false|true"/>
</application>

Constant Value: "android.window.PROPERTY_XR_USES_CUSTOM_FULL_SPACE_MANAGED_ANIMATION"

XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

public static final @NonNull String XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

Defines the value to launch an activity in managed full space mode in XR, where the system is rendering the activity from a scene graph.

See also
PROPERTY_XR_ACTIVITY_START_MODE

Constant Value: "XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED"

XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED

public static final @NonNull String XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED

Defines the value to launch an activity in unmanaged full space mode in XR, where the activity itself is rendering the space and controls its own scene graph. This should be used for all activities that use OpenXR to render.

See also
PROPERTY_XR_ACTIVITY_START_MODE

Constant Value: "XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED"

XR_ACTIVITY_START_MODE_HOME_SPACE

public static final @NonNull String XR_ACTIVITY_START_MODE_HOME_SPACE

Defines the value to launch an activity in home space mode in XR.

See also
PROPERTY_XR_ACTIVITY_START_MODE

Constant Value: "XR_ACTIVITY_START_MODE_HOME_SPACE"

XR_ACTIVITY_START_MODE_UNDEFINED

public static final @NonNull String XR_ACTIVITY_START_MODE_UNDEFINED

The default value if not specified. If used, the actual launching mode will be determined by the system based on the launching activity's current mode and the launching flags. When PROPERTY_XR_ACTIVITY_START_MODE is used at the application level, apps can use this value to reset at individual activity level.

See also
PROPERTY_XR_ACTIVITY_START_MODE

Constant Value: "XR_ACTIVITY_START_MODE_UNDEFINED"

XR_BOUNDARY_TYPE_LARGE

public static final @NonNull String XR_BOUNDARY_TYPE_LARGE

Defines the value to launch an activity with a large boundary recommended. This is useful for activities which expect users to be moving around. The system will ask the user to use a larger size for their safety boundary and check that their space is clear, if the larger size is not already in use. This larger size will be determined by the system.

See also
PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

Constant Value: "XR_BOUNDARY_TYPE_LARGE"

XR_BOUNDARY_TYPE_NO_RECOMMENDATION

public static final @NonNull String XR_BOUNDARY_TYPE_NO_RECOMMENDATION

Defines the value to launch an activity with no recommendations for the type of safety boundary. The system will continue to use the type of safety boundary that is currently in use.

See also
PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

Constant Value: "XR_BOUNDARY_TYPE_NO_RECOMMENDATION"