TrackEvent

• TrackEvent

  TrackEvent 는 onTrackStart, onTrackMove, onTrackEnd 의 세가지로 구분되며 각각의 이벤트가 발생할 때, callback 함수에 인자를 전달합니다. 해당 인자를 통해 tracking 대상에 대한 상태, 위치 정보를 전달받으며 해당 정보를 바탕으로 증강 대상(XRElement, 3D Object)의 상태값을 업데이트하여 증강현실이 동작될 수 있게 합니다. 각 이벤트 콜백함수에 전달되는 Event 객체 정보의 모양은 다음과 같습니다.

  • Event 객체

• onTrackStart

  인식대상으로 등록된 Entity 가 현재 카메라 frame 내에서 탐지가 되면, Letsee WebAR SDK 의 tracking engine이 해당 Entity에 대한 인식, 추적이 시작됨을 알립니다.

  letsee.onTrackStart API를 통해 callback function 을 등록하면, Entity가 탐지되었을 때 등록된 callback 함수를 동작시킵니다. callback function 은 event 객체를 인자로 받으며, 해당 event 객체는 type 과 trace 정보를 가지고 있습니다.

  • onTrackStart callback 함수의 등록

• trackstart 이후에 지속적으로 인식대상이 현재 카메라 frame 내에서 탐지가 되면, Letsee WebAR SDK 의 tracking engine은 인식된 대상을 추적합니다.

  letsee.onTrackMove API를 통해 callback function 을 등록하면, Entity가 추적중일 때 등록된 callback 함수를 동작시킵니다. 마찬가지로 callback function 은 event 객체를 인자로 받으며, 해당 event 객체는 type 과 trace 정보를 가지고 있습니다.

  • onTrackMove callback 함수의 등록

• 인식대상을 현재 카메라 frame 내에서 놓치게 되면, Letsee WebAR SDK 의 tracking engine이 해당 Entity에 대한 인식, 추적이 중지되었음을 알립니다.

  letsee.onTrackEnd API를 통해 callback function 을 등록하면, Entity가 추적 중지되었을 때 등록된 callback 함수를 동작시킵니다. 마찬가지로 callback function 은 event 객체를 인자로 받으며, 해당 event 객체는 type 과 trace 정보를 가지고 있습니다.

  • onTrackEnd callback 함수의 등록