Wikitude SDK APIリファレンス

バージョン: 8.1.0
表示:

ObjectTrackerクラス

継承元: ARchitectObject
モジュール: AR

ObjectTrackerは、カメラ画像ストリームのターゲットコレクション内（ AR.TargetCollectionResource ）で定義されているターゲットオブジェクトの位置を特定します。 この情報は、AR.ObjectTrackablesと組み合わせて使用され、正しい位置に正しい拡張（AR.Drawables）を描画します。

Trackerオブジェクトは、特定のAR.ObjectTrackables（ターゲットコレクション内のターゲット）を参照するために使用されます。

トラッカーを有効または無効にすることができます。 一度にアクティブにできるトラッカーは1つだけです。 トラッカーの現在の有効/無効状態はenabledプロパティに反映されます。ARchitectファイルで複数のトラッカーが使用されている場合、次のロジックが適用されて現在アクティブなトラッカーが指定されます。

  • 新しいトラッカーが作成されると、enabledにfalseを設定して作成した場合を除き、自動的にアクティブなトラッカーに設定されます。

  • 特定のトラッカーが有効になっている場合、自動的にアクティブなトラッカーに設定されます。 先にアクティブだったトラッカーは、システムによって無効になります。
トラッカーがシステムによって無効になっている場合、開発者はonDisabledトリガーによって通知を受けます。

例:
var World = {
    [...]

    init: function initFn() {
        World.createTracker();
    },

    createTracker: function createTrackerFn() {
        this.targetCollectionResource = new AR.TargetCollectionResource("assets/firetruck_map.wto", {
        });

        this.tracker = new AR.ObjectTracker(this.targetCollectionResource, {
            onError: function(errorMessage) {
                alert(errorMessage);
            }
        });

        this.objectTrackable = new AR.ObjectTrackable(this.tracker, "*", {
            drawables: {
                cam: [...]
            },
            onObjectRecognized: this.objectRecognized,
            onObjectLost: this.objectLost,
            onError: function(errorMessage) {
                alert(errorMessage);
            }
        });
    },

    objectRecognized: function objectRecognizedFn() {
        [...]
    },

    objectLost: function objectLostFn() {
        [...]
    }
}

World.init();

コンストラクター

ObjectTracker

(
  • Tracker
  • options
)

パラメーター:

  • Tracker TargetCollectionResource

    Wikitude Studio Managerで作成されたTarget Collectionを保持するソース。

  • options Object オプション

    追加のオブジェクトプロパティをカスタマイズするためのパラメーター。

    設定可能なプロパティは以下のとおりです。

    • enabled (defaults to true) Boolean オプション
    • onTargetsLoaded Function オプション
    • onError Function オプション
    • onDisabled Function オプション

項目索引

メソッド

プロパティ

イベント

メソッド

destroy

()

継承元: ARchitectObject

オブジェクトを破棄します。

プロパティ

destroyed

Boolean

継承元: ARchitectObject

オブジェクトがすでに破棄されているかどうかを示します。

enabled

Boolean

トラッカーの現在の活動状態。このプロパティは、別のトラッカーが有効になっている場合にシステムによって自動的に変更され、トラッカーが無効になる可能性があります。この場合、onDisabledトリガーが呼び出されます。

イベント

onDisabled

トリガーは、システムによってトラッカーが無効になっているときに起動します。enabledがfalseに手動で設定されている場合は起動しません。

このトリガーのデフォルト値はnullであり、トリガーが発生したときに何もアクションは実行されません。開発者は、カスタム機能をonDisabledに割り当てることによって、カスタム機能を追加できます。

onError

トラッカーがエンジンによってロードできなかったときにトリガーが発生します。

このトリガーのデフォルト値はnullであり、トリガーが発生したときに何もアクションは実行されません。開発者は、カスタム関数をonErrorに割り当てることによって、カスタム機能を追加できます。

onTargetsLoaded

トラッカーのターゲットコレクションが正常にロードされ、トラッカーがエンジンによってロードされたときにトリガーが発生します。 このトラッカーに関連するObjectTrackablesは、トラッカーが正常に読み込まれた後にのみトラッキングできます。

このトリガーのデフォルト値はnullであり、トリガーが発生したときに何もアクションは実行されません。開発者は、カスタム関数をonTargetsLoadedに割り当てることによって、カスタム機能を追加できます。