VLResponseEventData
수신한 VL 응답에 대한 정보. VLSDKManager의 OnVLPoseResponded 이벤트가 호출될 때 사용된다.
| Property | Type | Description |
|---|---|---|
| Status | ResponseStatus | VL 응답 상태 |
| Timestamp | long | VL 요청을 보내는 순간의 timestamp. 단위는 ms. |
| Message | string | VL 요청 실패에 대한 세부 정보. |
| ResponseBody | string | 응답 받은 VL 결과. json 형태의 원본 데이터. |
| IsVLPassed | bool | VL 요청 자체의 성공 여부. IsVLPassed는 true지만 VLSDK의 내부 필터링 로직으로 인해 ResponseStatus는 Success가 아닐 수 있다. |
| VLPosition | Vector3 | 응답 받은 VL Pose의 Unity 좌표계 기준 위치. |
| VLRotation | Quaternion | 응답 받은 VL Pose의 Unity 좌표계 기준 회전. |
| Confidence | float | 응답 받은 VL Pose의 신뢰도 값. [0,1] |
Message
Message 필드는 VL 응답의 처리 실패에 대한 세부 정보를 나타냅니다. 해당 필드를 통해 전달되는 정보는 다음과 같습니다. 아래의 내용에서 확인되지 않는 메시지는 Github Issue를 통해 문의 부탁드립니다.
| 메시지 내용 | 메시지 출력 원인 | 조치 사항 |
|---|---|---|
| DISTANCE_OUTLIER | VL 위치 응답과 현재 위치 간의 거리 차이가 큼 | VLSDK 사용 간 문제가 없을 경우 조치 불필요 |
| ROTATION_OUTLIER | VL 위치 응답과 현재 위치 간의 회전 차이가 큼 | VLSDK 사용 간 문제가 없을 경우 조치 불필요 |
| INACCURATE_VL_POSE (inlier:X, confidence: X) | VL 성공 응답은 수신했으나 정확도가 떨어짐. Inlier 값이 100 이하이거나 confidence 값이 VL Quality에서 설정한 값 이하 | VLSDK 사용 간 문제가 없을 경우 조치 불필요 |
| EXPIRED_RESPONSE | VL 성공 응답은 수신했으나 Reset 등으로 인한 세션 만료 이후에 수신함 | VLSDK 사용 간 문제가 없을 경우 조치 불필요 |
| Current position is out of VL scanning area. | 위치 인식 후 VL 스캔 영역 밖에서 요청을 보낸 경우 | VL 스캔 영역 안으로 이동 |
| Invalid response. Both 'pose' and 'globalPose' fields are missing. | VL 위치 응답을 수신하지 못함 | DEBUG 로그 확인 및 관리자 문의 필요. |
| Invalid response. 'datasetInfo' field is missing. | VL 응답 중 'datasetInfo' 필드가 비어있음 | DEBUG 로그 확인 및 관리자 문의 필요. |
| Invalid response. 'status' field is missing. | VL 응답 중 'status' 필드가 비어있음 | DEBUG 로그 확인 및 관리자 문의 필요. |
| Invalid response. status code: XXX | 추적되지 않은 오류 | DEBUG 로그 확인 및 관리자 문의 필요. |