Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is [available too].

Previous page WebSocket을 사용하여 카메라 이벤트 가져오기  레이아웃 및 비디오 월 작업 Next page

레이아웃 및 비디오 월 작업

작업 순서

Attention!

  • 모든 클라이언트 HTTP API 요청은 VMS 클라이언트에서 실행해야 하며, 클라이언트는 관리자 권한으로 실행되어야 합니다.
  • 명령을 실행할 때 명령 프롬프트를 관리자 권한으로 실행해야 합니다.
  • 요청에는 클라이언트의 IP 주소가 포함되어야 합니다.
  • 포트 8888은 비어 있어야 합니다.
  • 백신 프로그램과 방화벽은 비활성화되어야 합니다.

클라이언트 HTTP API 요청을 시작하기 전에 명령 프롬프트에서 다음 명령을 실행하십시오.

netsh http add urlacl url=http://IP-address:8888/ user=DOMAIN\username

여기서

  • IP-address—클라이언트 HTTP API 요청이 실행되어야 하는 클라이언트의 IP 주소
  • DOMAIN\username—사용자 이름. 사용자 이름을 확인하려면 명령 프롬프트에 whoami 명령을 입력하십시오.

Note

Linux에서는 추가적인 명령이 필요하지 않습니다.

명령이 성공적으로 실행된 후, 아래에 설명된 쿼리를 실행할 수 있습니다.

레이아웃 목록 가져오기

GET http://IP-adress:8888/GetLayouts − 현재 로그인한 사용자의 사용 가능한 레이아웃을 가져옵니다.

샘플 응답:

{
    "Description": "",
    "Status": "OK",
    "LayoutInfo": [
        {
            "Id": "102",
            "Name": "Layout name 2"
        },
        { 
			"Id": "103",
            "Name": "Layout name 3"
        }
    ]
}

여기 오류 메시지 예시가 있습니다:

 {
\"result\":\"no layouts\"
}

Note

서버 레이아웃 목록을 요청하는 동안 UAC(사용자 계정 컨트롤)가 서버에서 활성화되어 있으면 오류가 발생할 수 있습니다. 이 오류를 해결하려면 UAC 기능을 비활성화해야 합니다.

화면에서 레이아웃 전환

GET http://IPaddress:8888/SwitchLayout
파라미터필수설명
layoutIdYes레이아웃 id (레이아웃 목록 가져오기 참조).
displayIdYes모니터 id (디스플레이 목록 가져오기 참조).

샘플 요청:

GET http://127.0.0.1:8888/SwitchLayout?layoutId=102&displayId=\\.\DISPLAY1

샘플 응답:

{
    "Description": "",
    "Status": "OK"
}

여기 오류 메세지 예시가 있습니다.

{
	\"result\":\"error\"
}

Note

존재하지 않는 ID를 가진 레이아웃을 지정하면 오류가 발생할 수 있습니다.

레이아웃에 표시된 카메라 목록 가져오기

GET http://IPaddress:8888/GetCameras
파라미터필수설명
layoutIdYes

레이아웃 id (레이아웃 목록 가져오기 참조).

지정된 ID를 가진 레이아웃을 찾을 수 없는 경우, 쿼리는 지정된 디스플레이에 대한 현재 레이아웃의 카메라 목록을 반환합니다.

displayIdYes모니터 id (디스플레이 목록 가져오기 참조).

샘플 요청:

GET http://127.0.0.1:8888/GetCameras?layoutId=102&displayId=\\.\DISPLAY1

샘플 응답:

{
    "Description": "",
    "Status": "OK",
    "CameraInfo": [
        {
            "DisplayName": "1.Camera",
            "Id": "1",
            "Name": "host/HOSTNAME/DeviceIpint1/SourceEndPoint.video:0:0"
        },
        {
            "DisplayName": "2.Camera",
            "Id": "2",
            "Name": " host/HOSTNAME/DeviceIpint2/SourceEndPoint.video:0:0"
        }
    ]
}

카메라 추가 및 제거


On page:

현재 레이아웃에서 카메라 제거

GET http://IP-address:8888/RemoveCamera

파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)
cameraNameYes

레이아웃에 표시된 카메라 목록 가져오기 요청에 대한 응답에서 카메라 이름

샘플 요청:

GET http://127.0.0.1:8888/RemoveCamera?displayId=\\.\DISPLAY1&cameraName=host/HOSTNAME/DeviceIpint1/SourceEndPoint.video:0:0

샘플 응답:

{ 
	"Description": "", 
	"Status": "OK" 
}

여기 오류 메시지 예시가 있습니다.

{ 
	"Description": "Error description", 
	"Status": "ERROR" 
}

현재 레이아웃에서 모든 카메라 제거

GET http://IP-address:8888/RemoveAllCameras

파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)

샘플 요청:

GET http://127.0.0.1:8888/RemoveAllCameras?displayId=\\.\DISPLAY1

현재 레이아웃에 카메라 추가

GET http://IP-address:8888/AddCamera

파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)
cameraNameYes

레이아웃에 표시된 카메라 목록 가져오기 요청에 대한 응답에서 카메라 이름


샘플 요청:

GET http://127.0.0.1:8888/AddCamera?displayId=\\.\DISPLAY1&cameraName=host/HOSTNAME/DeviceIpint1/SourceEndPoint.video:0:0

디스플레이 목록 가져오기

GET http://IP-address:8888/GetDisplays − 현재 로그인한 사용자의 사용 가능한 displays 목록 가져오기

샘플 응답:

{
    "Description": "",
    "Status": "OK",
    "DisplayInfo": [
        {
            "Id": "\\\\.\\DISPLAY1",
            "IsMainForm": true
        },
        {
            "Id": "\\\\.\\DISPLAY2",
            "IsMainForm": false
        }
    ]
}
파라미터설명
id

디스플레이 ID

IsMainForm

'true' 값은 주 디스플레이에 해당합니다.

주의! 다른 요청에서는 모니터 ID를 다음 형식으로 사용하십시오: \\.\DISPLAY1

여기 오류 메시지 예시가 있습니다.

{
	"{\"result\":\"no displays\"}"
}

활성 디스플레이 선택

GET http://IP-address:8888/SelectDisplay
파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)

샘플 요청:

GET http://127.0.0.1:8888/SelectDisplay?displayId=\\.\DISPLAY1

샘플 응답:

{
"Description": "",  
"Status": "OK"
}

여기 오류 메시지 예시가 있습니다.

{
	\"result\":\"error\"
}

카메라를 아카이브 모드로 전환

GET http://IPaddress:8888/GotoArchive
파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)
cameraNameYes

레이아웃에 표시된 카메라 목록 가져오기 요청에 대한 응답에서 카메라 이름

timestampYes

시간은 ISO 형식으로 제공됩니다.

샘플 요청:

GET http://127.0.0.1:8888/GotoArchive?displayId=\\.\DISPLAY2&cameraName=hosts/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0&timestamp=2017-04-07T00:00:00.000

Note

Use the following query to get the list of groups:

GET http://IPaddress:8888/GetGroups.

Sample responce:

 Id	"4308f2e2-e57c-4cd0-8a4f-826e8b16d39c"
   Name	"Default"

포렌식 검색 모드의 카메라가 포함된 레이아웃으로 전환

GET http://IP-address:8888/SearchArchive
파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)
cameraNameYes

레이아웃에 표시된 카메라 목록 가져오기 요청에 대한 읍답에서 카메라 이름

timestampYes

시간은 ISO 형식으로 제공됩니다.

샘플 요청:

GET http://127.0.0.1:8888/GoToArchive?displayId=\\.\DISPLAY2&cameraName=hosts/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0×tamp=2017-04-07T00:00:00.000

저장된 포렌식 검색 결과로 전환

GET http://IP-address:8888/SearchArchive

파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)
cameraNameYes

레이아웃에 표시된 카메라 목록 가져오기 요청에 대한 응답에서 카메라 이름

query

Yes

저장된 검색 쿼리의 이름 (검색어 저장 참조)

샘플 요청:

GET http://127.0.0.1:8888/SearchArchive?displayId=\\.\DISPLAY1&cameraName=host/HOSTNAME/DeviceIpint1/SourceEndPoint.video:0:0&query=query1

몰입 모드의 카메라가 포함된 레이아웃으로 전환

GET http://IP-address:8888/GotoImmersion
파라미터필수설명
displayIdYes모니터 id (디스플레이 목록 가져오기 참조)
cameraNameYes

레이아웃에 표시된 카메라 목록 가져오기 요청에 대한 응답에서 카메라 이름

샘플 요청:

GET http://127.0.0.1:8888/GotoImmersion?displayId=\\.\DISPLAY1&cameraName=hosts/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0

Content

  • No labels

레이아웃 및 비디오 월 작업