ManifestProperty

Added in 1.0.0-alpha04

public final class ManifestProperty


Summary

Public fields

static final @NonNull String

Application or Activity level {@link android.content.pm.PackageManager.Property PackageManager.Property} for an app to inform the system of the activity launch mode in XR.

static final @NonNull String

Application and Activity level {@link android.content.pm.PackageManager.Property PackageManager.Property} for an app to inform the system of the type of safety boundary recommended for the activity.

static final @NonNull String

Application and Activity level {@link android.content.pm.PackageManager.Property 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 {@link android.content.pm.PackageManager.Property 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 {@link #XR_ACTIVITY_START_MODE_UNDEFINED}.

The available values are:

  • {@link #XR_ACTIVITY_START_MODE_FULL_SPACE_UNMANAGED}
  • {@link #XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED}
  • {@link #XR_ACTIVITY_START_MODE_HOME_SPACE}
  • {@link #XR_ACTIVITY_START_MODE_UNDEFINED}

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>

PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

public static final @NonNull String PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

Application and Activity level {@link android.content.pm.PackageManager.Property 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 {@link #XR_BOUNDARY_TYPE_NO_RECOMMENDATION}.

The available values are:

  • {@link #XR_BOUNDARY_TYPE_LARGE}
  • {@link #XR_BOUNDARY_TYPE_NO_RECOMMENDATION}

Syntax:

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

PROPERTY_XR_USES_CUSTOM_FULL_SPACE_MANAGED_ANIMATION

public static final @NonNull String PROPERTY_XR_USES_CUSTOM_FULL_SPACE_MANAGED_ANIMATION

Application and Activity level {@link android.content.pm.PackageManager.Property 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 {@code 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 {@code false}.

Syntax:

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

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.

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.

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.

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 {@link #PROPERTY_XR_ACTIVITY_START_MODE} is used at the application level, apps can use this value to reset at individual activity level.

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.

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.