SpatialPointerComponent

Artifact: androidx.xr.scenecore:scenecore

Kotlin |Java

public final class SpatialPointerComponent extends Component

java.lang.Object
↳	androidx.xr.scenecore.Component
	↳	androidx.xr.scenecore.SpatialPointerComponent

Component that modifies the pointer icon that is rendered on the component's Entity. If this Component is not present on an Entity the default, system-determined icon is used. Removing this Component will set the Entity's pointer back to the default icon.

Summary

Public methods
`static final @NonNull SpatialPointerComponent`	`create(@NonNull Session session)` Creates a new `SpatialPointerComponent`.
`final @NonNull SpatialPointerIcon`	`getSpatialPointerIcon()` The `SpatialPointerIcon` that will be rendered on the component's `Entity` when the pointer is located on the entity.
`final void`	`setSpatialPointerIcon(@NonNull SpatialPointerIcon value)` The `SpatialPointerIcon` that will be rendered on the component's `Entity` when the pointer is located on the entity.

Protected methods
`boolean`	`onAttach(@NonNull Entity entity)` Called by the framework when this component is being added to an `Entity`.
`void`	`onDetach(@NonNull Entity entity)` Called by the framework when this component is being removed from an `Entity`.

Public methods

create

Added in 1.0.0-beta01

public static final @NonNull SpatialPointerComponent create(@NonNull Session session)

Creates a new SpatialPointerComponent.

Parameters
`@NonNull Session session`	The `Session` to use for creating the component.

Returns
`@NonNull SpatialPointerComponent`	A new `SpatialPointerComponent`.

getSpatialPointerIcon

Added in 1.0.0-beta01

public final @NonNull SpatialPointerIcon getSpatialPointerIcon()

The SpatialPointerIcon that will be rendered on the component's Entity when the pointer is located on the entity. A SpatialPointerIcon.DEFAULT value indicates the default pointer icon should be used.

setSpatialPointerIcon

Added in 1.0.0-beta01

public final void setSpatialPointerIcon(@NonNull SpatialPointerIcon value)

Protected methods

onAttach

protected boolean onAttach(@NonNull Entity entity)

Called by the framework when this component is being added to an Entity.

This method is triggered when Entity.addComponent is invoked. Implementations should override this method to perform setup logic or to validate if the component is compatible with the provided entity.

Parameters
`@NonNull Entity entity`	The `Entity` to which this component is being attached.

Returns
`boolean`	`true` if the component was successfully attached; `false` if the `entity` does not support this component or if attachment failed.

onDetach

protected void onDetach(@NonNull Entity entity)

Called by the framework when this component is being removed from an Entity.

This method is triggered when Entity.removeComponent is invoked. Implementations should override this method to release resources or undo any changes made during onAttach.

Parameters
`@NonNull Entity entity`	The `Entity` from which this component is being detached.