Component

Artifact: androidx.xr.scenecore:scenecore

Kotlin |Java

public abstract class Component

Known direct subclasses

BoundsComponent, InteractableComponent, MovableComponent, PointerCaptureComponent, PositionalAudioComponent, ResizableComponent, SoundEffectPoolComponent, SoundFieldAudioComponent, SpatialPointerComponent

`BoundsComponent`	A component that monitors the bounds of an entity and notifies registered listeners of changes.
`InteractableComponent`	Provides access to raw `InputEvent`s for given `Entity`, so a client can implement their own interaction logic.
`MovableComponent`	This `Component` can be attached to a single instance of an `Entity`.
`PointerCaptureComponent`	Provides pointer capture capabilities for a given `Entity`.
`PositionalAudioComponent`	A Component that provides positional spatial audio playback for an `Entity`.
`ResizableComponent`	This `Component` can be attached to a single instance of an `Entity`.
`SoundEffectPoolComponent`	Provides positional sound pool audio playback for an `Entity`.
`SoundFieldAudioComponent`	Provides spatial audio playback for a sound field associated with an `Entity`.
`SpatialPointerComponent`	`Component` that modifies the pointer icon that is rendered on the component's `Entity`.

A Component adds functionality or behaviors to an Entity.

Summary

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

Protected methods

onAttach

Added in 1.0.0-beta01

protected abstract 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

Added in 1.0.0-beta01

protected abstract 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.