영역 내 객체 (queryType="zone")

figures/shape는 필수 파라미터입니다. 객체가 있을 영역을 다각형 꼭짓점 목록으로 설정합니다. 좌표는 프레임의 너비/높이 비율로 설정되며(값은 0에서 1 사이), 특정 카메라 해상도에 구애받지 않도록 할 수 있습니다.

가장 간단한 요청은 다음과 같습니다:

{
    "queryType": "zone",
    "figures": [
        {
            "shape": [
                [0.3, 0.3],
                [0.7, 0.3],
                [0.7, 0.7],
                [0.3, 0.7]
            ]
        }
    ]
}

여기서 영역은 카메라 시야 중앙의 직사각형을 설명합니다.

queryProperties/action은 요청의 선택적 파라미터입니다:

영역에 들어오는 객체를 검색하는 요청 예시는 다음과 같습니다.

{
    "queryType": "zone",
    "figures": [
        {
            "shape": [
                [0.3, 0.3],
                [0.7, 0.3],
                [0.7, 0.7],
                [0.3, 0.7]
            ]
        }
    ],
    "queryProperties": {
        "action": "enter"
    }
}

객체가 한 영역에서 다른 영역으로 이동 (queryType="transition")

필수 파라미터는 figures 입니다. 이 파라미터는 시작 영역과 끝 영역을 설명하는 두 개의 영역을 포함해야 합니다.

선택적 파라미터는 없습니다.

프레임의 왼쪽 부분에서 오른쪽 부분으로 이동한 객체를 검색하는 요청은 다음과 같습니다.

 {
    "queryType": "transition",
    "figures": [
        {
            "shape": [
                [0, 0],
                [0.45, 0],
                [0.45, 1],
                [0, 1]
            ]
        },
        {
            "shape": [
                [0.55, 0],
                [1, 0],
                [1, 1],
                [0.55, 1]
            ]
        }
    ]
}

라인 크로싱 (queryType="line")

필수 파라미터 figures는 조건을 트리거하는 선분을 정의합니다. 이 선분은 두 점으로 설정되어야 합니다.

 {
    "queryType": "line",
    "figures": [
        {
            "shape": [
                [0.5, 0.8],
                [0.5, 0.2]
            ]
        }
    ]
}

선택적 파라미터 queryProperties/direction은 선 교차의 방향을 설정합니다.

 {
    "queryType": "line",
    "figures": [
        {
            "shape": [
                [0.5, 0.8],
                [0.5, 0.2]
            ]
        }
    ],
    "queryProperties": {
        "direction": "left"
    }
}