ImageTargetController Class

Description

在场景中控制 ImageTarget 的 MonoBehaviour ，在Unity环境下提供功能扩展。加载成功后可以使用 ImageTargetController.Target 访问target数据。

target的数据会单独加载，加载会在session成功启动后发生，生命周期中只会完整加载一次，如加载到一半session停止，将在下次session启动后再次加载。

---

Classes

public abstract class ImageTargetController.SourceData	创建target的数据。
public class ImageTargetController.ImageFileSourceData	创建target的图像数据。
public class ImageTargetController.TargetDataFileSourceData	创建target的target data。Target名字和缩放在etd文件中定义。
public class ImageTargetController.Texture2DSourceData	创建target的 Texture2D 数据。
public class ImageTargetController.TargetSourceData	创建target的 ImageTarget 数据。

---

Properties

Target

C#

public ImageTarget Target { get; }

Target数据，仅在 ImageTargetController.TargetDataLoad 成功之后可用。

Source

C#

public ImageTargetController.SourceData Source { get; set; }

创建target的数据来源。在 MonoBehaviour .Start前修改才有效。

如果存在引用的资源（Texture或Target等），可以在 ImageTargetController.TargetDataLoad 中销毁，提前销毁将导致加载失败。

Tracker

C#

public ImageTrackerFrameFilter Tracker { get; set; }

加载target的 ImageTrackerFrameFilter 。如果设为null，target将会被从之前设置的tracker中卸载。可随时修改，加载只会在session运行时发生。

Size

C#

public Vector2 Size { get; }

ImageTargetController.Target 的物理大小，单位为米。仅在 ImageTargetController.TargetDataLoad 成功之后可用。

ActiveController

C#

public ActiveController ActiveController { get; }

GameObject .activeSelf控制器。

MonoBehaviour .enabled为false可关闭控制。

IsTracked

C#

public bool IsTracked { get; }

目标是否被跟踪。

---

Events

TargetDataLoad

C#

public event Action<bool> TargetDataLoad

Target数据加载完成（不是加载到tracker中）。

TargetFound

C#

public event Action TargetFound

找到跟踪目标的事件。

TargetLost

C#

public event Action TargetLost

丢失跟踪目标的事件。