이벤트
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 응답값 중 하나인 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}…의 형태를 가지고 있다. (ex. 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. |