BaseActivityPose

public abstract class BaseActivityPose<RtActivityPoseType extends ActivityPose> implements ActivityPose

Known direct subclasses
BaseEntity

The BaseEntity is an implementation of Entity interface that wraps a platform entity.
CameraView

A ActivityPose which tracks a camera's position and view into physical space.
Head

Head is a ActivityPose used to track the position of the user's head.
PerceptionSpace

PerceptionSpace is ActivityPose used to track the origin of the space used by ARCore for XR APIs.
Known indirect subclasses
ActivityPanelEntity

ActivityPanelEntity creates a spatial panel for embedding an Activity in Android XR.
ActivitySpace

ActivitySpace is an Entity used to track the system-managed pose and boundary of the volume associated with this Spatialized Activity.
AnchorEntity

An AnchorEntity is created to track a Pose relative to some position or surface in the "Real World." Children of this Entity will remain positioned relative to that location in the real world, for the purposes of creating Augmented Reality experiences.
BasePanelEntity

Provides implementations for common Panel functionality.
ContentlessEntity

An Entity that itself has no content.
GltfModelEntity

GltfModelEntity is a concrete implementation of Entity that hosts a glTF model.
PanelEntity

PanelEntity creates a spatial panel in Android XR.
SurfaceEntity

SurfaceEntity is a concrete implementation of Entity that hosts a StereoSurface Canvas.

The BaseActivityPose is an implementation of ActivityPose interface that wraps a platformAdapter ActivityPose.

Summary

Public constructors
<RtActivityPoseType extends ActivityPose> BaseActivityPose(
    @NonNull RtActivityPoseType rtActivityPose
)

Public methods
@NonNull Pose

Returns the activity space pose for this ActivityPose.
@NonNull ListenableFuture<@NonNull HitTestResult>
hitTestAsync(@NonNull Vector3 origin, @NonNull Vector3 direction)

Creates a hit test from the specified origin in the specified direction into the scene.
@NonNull ListenableFuture<@NonNull HitTestResult>
hitTestAsync(
    @NonNull Vector3 origin,
    @NonNull Vector3 direction,
    @ActivityPose.HitTestFilterValue int hitTestFilter
)

Creates a hit test from the specified origin in the specified direction into the scene.
@NonNull Pose

Returns a pose relative to this ActivityPose transformed into a pose relative to the destination.

Public constructors

BaseActivityPose

public <RtActivityPoseType extends ActivityPose> BaseActivityPose(
    @NonNull RtActivityPoseType rtActivityPose
)

Public methods

getActivitySpacePose

public @NonNull Pose getActivitySpacePose()

Returns the activity space pose for this ActivityPose.

Returns
@NonNull Pose

Current Pose relative to the activity space root.

hitTestAsync

public @NonNull ListenableFuture<@NonNull HitTestResult> hitTestAsync(@NonNull Vector3 origin, @NonNull Vector3 direction)

Creates a hit test from the specified origin in the specified direction into the scene.

Parameters
@NonNull Vector3 origin

The translation of the origin of the hit test relative to this ActivityPose.
@NonNull Vector3 direction

The direction for the hit test ray from the origin.
Returns
@NonNull ListenableFuture<@NonNull HitTestResult>

a ListenableFuture. The HitResult describes if it hit something and where relative to this ActivityPose. Listeners will be called on the main thread if Runnable::run is supplied.

hitTestAsync

public @NonNull ListenableFuture<@NonNull HitTestResult> hitTestAsync(
    @NonNull Vector3 origin,
    @NonNull Vector3 direction,
    @ActivityPose.HitTestFilterValue int hitTestFilter
)

Creates a hit test from the specified origin in the specified direction into the scene.

Parameters
@NonNull Vector3 origin

The translation of the origin of the hit test relative to this ActivityPose.
@NonNull Vector3 direction

The direction for the hit test ray from the origin
@ActivityPose.HitTestFilterValue int hitTestFilter

Filter for which scenes to hit test. Hitting other scenes is only allowed for apps with the android.permission.ACCESS_OVERLAY_SPACE permission.
Returns
@NonNull ListenableFuture<@NonNull HitTestResult>

a ListenableFuture. The HitResult describes if it hit something and where relative to this ActivityPose. Listeners will be called on the main thread if Runnable::run is supplied.

transformPoseTo

public @NonNull Pose transformPoseTo(@NonNull Pose pose, @NonNull ActivityPose destination)

Returns a pose relative to this ActivityPose transformed into a pose relative to the destination.

Parameters
@NonNull Pose pose

A pose in this ActivityPose's local coordinate space.
@NonNull ActivityPose destination

The ActivityPose which the returned pose will be relative to.
Returns
@NonNull Pose

The pose relative to the destination ActivityPose.