イベント

VLSDKManager は VL 認識および VLSDKManager の状態に関連する各種情報を伝達するイベントを提供しています。

各イベントの詳細説明は以下の通りです。

OnVLPoseRequested

public UnityEvent<VLRequestedEventData> OnVLPoseRequested;

VL リクエストを送信する際に呼び出されるイベントです。VLRequestedEventDataには VL リクエストを送信するその時の情報が含まれています。

name	Type	Description
eventData	VLRequestedEventData	VL リクエスト送信時に使用される情報。

OnVLPoseResponded

public UnityEvent<VLResponseEventData> OnVLPoseResponded;

VL 応答を受信する際に呼び出されるイベントです。VLResponseEventDataには VL 応答を受信するその時の情報が含まれています。

name	Type	Description
eventData	VLResponseEventData	受信した VL 応答に関連する情報。

OnStateChanged

public UnityEvent<TrackerState> OnStateChanged;

VLSDK 内部で VL 認識状態が変更されるたびに呼び出されるイベントです。

name	Type	Description
state	TrackerState	VLSDK セッションの状態。INITIAL、VL_RECEIVED、VL_PASS、VL_FAIL、VL_OUT_OF_SERVICEの値を持つ。

OnLayerInfoChanged

public UnityEvent<string> OnLayerInfoChanged;

VL が認識されるレイヤーが変更された場合に呼び出されるイベントです。渡される値は VL 応答値の 1 つであるdatasetInfoから最後のレイヤー情報を除いたLayer Info値が渡されます。応答を受けた datasetInfo 値が'NAVER_GND_device03172309'の場合、Layer Info値は'NAVER_GND'になります。

VLSDK がInitial状態の場合、最初に認識される空間に対するLayer Info値を渡します。Initial状態以外の場合、最も最近に入力された 20 個のLayer Info値の中で最も多い数を持つ値がリターンされます。

name	Type	Description
layerInfo	string	VL 応答ボディの'datasetInfo'フィールド値の最後のレイヤー情報を除いた値。{レイヤー1}_{レイヤー2}_{レイヤー3}…の形式を持つ。(例: NAVER_GND)

OnPoseUpdated

public UnityEvent<Matrix4x4, Matrix4x4, Matrix4x4, Double> OnPoseUpdated;

毎フレーム呼び出されるイベントです。カメラの位置に関連する情報を渡します。

name	Type	Description
viewMatrix	Matrix4x4	カメラのビュー行列を表す 4x4 行列
projMatrix	Matrix4x4	カメラの投影行列を表す 4x4 行列
texMatrix	Matrix4x4	カメラプレビューのレンダリング情報を表す 4x4 行列。左上の 3x3 空間のみ使用
relativeAltitude	Double	カメラの相対高度。VLSDK が初期化されるときを 0 に設定した相対高度値。単位は m。

OnGeoCoordUpdated

public UnityEvent<Double, Double> OnGeoCoordUpdated;

GPS 位置認識が実行されるたびに呼び出されるイベントです。Unity の Input.location.lastData を通じて取得した GPS 情報を渡します。

name	Type	Description
latitude	Double	緯度
longitude	Double	経度

OnRelativeAltitudeUpdated

public UnityEvent<Double> OnRelativeAltitudeUpdated;

カメラの相対高度が変更された場合に呼び出されるイベントです。OnPoseUpdatedイベントでの relativeAltitude は呼び出しの瞬間の相対高度を常に渡しますが、OnRelativeAltitudeUpdatedイベントは相対高度値が変更された場合のみ呼び出されます。

name	Type	Description
relativeAltitude	Double	カメラの相対高度。VLSDK が初期化されるときを 0 に設定した相対高度値。単位は m。