버전: docs v25.02

Forward Event

EVA의 AI 탐지 결과를 외부 시스템과 연동해야 할 경우, System 셋팅의 Forward 기능을 사용하여 HTTP API로 이벤트 데이터를 전송할 수 있습니다.

이 기능은 EVA가 탐지한 모든 상황과 분석 결과를 다른 통합 관제 시스템(VMS)이나 비즈니스 애플리케이션에서 활용할 수 있게 합니다.

외부 API 연동 설정

System 셋팅에서 이벤트(EVENT)를 수신할 외부 시스템의 HTTP API 주소를 등록합니다. EVA에서 상황이 탐지될 때마다 해당 API로 다음의 상세 정보가 JSON 형태로 전송되도록 설정할 수 있습니다.

필드명	설명	예시 데이터
`device`	EVA에 등록된 디바이스(카메라)의 고유 시퀀스 ID	`1234`
`device_source`	카메라의 스트리밍 주소 (URL)	`rtsp://...`
`event_time`	이벤트가 탐지된 정확한 시간 (타임스탬프)	`2025-10-12T03:00:00Z`
`vision_model`	탐지에 사용된 Vision ML 모델의 이름	`helmet_detection_v2`
`detect_target`	탐지된 객체들의 이름 목록	`['person', 'car', 'person']`
`detect_count`	탐지된 객체의 총 개수	`3`
`confidences`	탐지된 객체들의 신뢰도 점수 목록	`[0.98, 0.95, 0.88]`
`phrases`	LLM/VLM이 생성한 상황 설명 문구	`['안전모 미착용', '지정 구역 이탈']`
`llm_model`	상황 분석에 사용된 LLM 모델 이름	`genmma3`
`alert`	알람의 심각도 또는 이미지 기반 경고 메시지	`True`
`message`	AI가 최종적으로 판단한 상황 분석 메시지	`작업자가 안전모를 착용하지 않고 위험 구역에 진입했습니다.`
`image_data`	Base64 인코딩된 스냅샷 이미지 데이터	`(Base64 인코딩된 문자열)`

외부 API의 요구사항에 맞춰 전송되는 데이터와 방식을 유연하게 설정할 수 있습니다.

인증(Authorization): API 호출에 Token과 같은 추가적인 Authorization 헤더가 필요한 경우, 해당 정보를 기입하여 안전하게 데이터를 전송할 수 있습니다.
이미지 데이터 제어:
- 제외: Image를 API로 직접 수신하는 것이 불필요하거나, 데이터 전송 부하를 줄여야 하는 경우 image_data 필드를 전송에서 제외하도록 설정할 수 있습니다.
- 해상도 조정: 이미지 전송이 필요한 경우에도, 네트워크 대역폭을 절약하기 위해 전송되는 이미지의 해상도를 낮춰서 전송하도록 설정할 수 있습니다.