You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
77 lines
3.2 KiB
77 lines
3.2 KiB
using System;
|
|
using UnityEngine.XR.ARSubsystems;
|
|
|
|
namespace UnityEngine.XR.ARFoundation
|
|
{
|
|
/// <summary>
|
|
/// A generic component for trackables. A "trackable" is a feature in the physical
|
|
/// environment that can be detected and tracked by an XR device.
|
|
/// </summary>
|
|
/// <typeparam name="TSessionRelativeData">The raw, session relative data type used to update this trackable.</typeparam>
|
|
/// <typeparam name="TTrackable">The concrete class which derives from <see cref="ARTrackable{TSessionRelativeData, TTrackable}"/>.</typeparam>
|
|
public class ARTrackable<TSessionRelativeData, TTrackable> : MonoBehaviour
|
|
where TSessionRelativeData : struct, ITrackable
|
|
where TTrackable : ARTrackable<TSessionRelativeData, TTrackable>
|
|
{
|
|
[SerializeField]
|
|
[Tooltip("If true, this component's GameObject will be removed immediately when this trackable is removed.")]
|
|
bool m_DestroyOnRemoval = true;
|
|
|
|
/// <summary>
|
|
/// If true, this component's <c>GameObject</c> will be removed immediately when the XR device reports this trackable is no longer tracked.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Setting this to false will keep the <c>GameObject</c> around. You may want to do this, for example,
|
|
/// if you have custom removal logic, such as a fade out.
|
|
/// </remarks>
|
|
public bool destroyOnRemoval
|
|
{
|
|
get { return m_DestroyOnRemoval; }
|
|
set { m_DestroyOnRemoval = value; }
|
|
}
|
|
|
|
/// <summary>
|
|
/// The <c>TrackableId</c> associated with this trackable. <c>TrackableId</c>s
|
|
/// are typically unique to a particular session.
|
|
/// </summary>
|
|
public TrackableId trackableId
|
|
{
|
|
get { return sessionRelativeData.trackableId; }
|
|
}
|
|
|
|
/// <summary>
|
|
/// The tracking state associated with this trackable.
|
|
/// </summary>
|
|
public TrackingState trackingState
|
|
{
|
|
get { return sessionRelativeData.trackingState; }
|
|
}
|
|
|
|
/// <summary>
|
|
/// Pending means the trackable was added manually (usually via an <c>AddTrackable</c>-style method
|
|
/// on its manager) but has not yet been reported as added.
|
|
/// </summary>
|
|
public bool pending { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// The session-relative data associated with this trackable.
|
|
/// </summary>
|
|
protected TSessionRelativeData sessionRelativeData { get; private set; }
|
|
|
|
/// <summary>
|
|
/// Invoked just after the session-relative data has been set.
|
|
/// The <c>GameObject</c>'s transform has already been updated.
|
|
/// You may override this method to perform further updates specific
|
|
/// to the derived trackable.
|
|
/// </summary>
|
|
internal protected virtual void OnAfterSetSessionRelativeData()
|
|
{ }
|
|
|
|
internal void SetSessionRelativeData(TSessionRelativeData sessionRelativeData)
|
|
{
|
|
this.sessionRelativeData = sessionRelativeData;
|
|
transform.localPosition = sessionRelativeData.pose.position;
|
|
transform.localRotation = sessionRelativeData.pose.rotation;
|
|
}
|
|
}
|
|
}
|