디바이스 관리
핵심 플랫폼device_health_read디바이스 관리시설의 최신 인터넷 속도 테스트 결과를 기기의 요구 사항과 비교합니다. network는 다운로드 및 업로드 속도(Mbps)를 반환하며, 최근 24시간 동안 확인된 화면, 카메라(녹화 및 라이브 스트리밍) 및 연결된 스피커 시스템에 대해 기기 수, 각 기기에 필요한 대역폭, 연결이 충분한지 여부를 반환합니다. 느리거나 연결이 끊기는 기기를 진단하거나 기기를 추가하기 전에 사용합니다. 여러 시설을 확인하려면 facilityIds를 전달하십시오.
작업:
- network: 네트워크 대역폭 확인.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
action* | "network" | 수행할 작업입니다. 각 작업은 도구 설명에 설명되어 있습니다. |
facilityId | string | 시설 ID입니다. 연결된 시설을 대상으로 하는 경우 생략할 수 있습니다. |
facilityIds | array | 동일한 요청을 각 시설에서 실행할 여러 시설 ID입니다. facilityId 대신 사용합니다. |
device_inventory_read디바이스 관리시설에 등록된 모든 기기: 디스플레이 화면, 클라우드 카메라, 네트워크 카메라, AI 엣지 프로세서, Duress 버튼, 출입문 컨트롤러, AI 에이전트 및 IoT 센서. 문제 해결, 장비 감사 또는 기기 ID 확인에 사용합니다.
각 기기에는 유형, 모델, ID(deviceUuid, 화면은 deviceID, Duress 버튼은 deviceSerialNumber), 위치, 네트워크 세부 정보(IP, Wi-Fi 또는 이더넷, SSID, 채널, 주변 네트워크, metadata.networkStats에 PoE 스위치 포트), 상태(CPU 온도, 메모리, 가동 시간) 및 마지막 하트비트(Unix ms)인 metadata.updated가 있습니다. 오프라인은 5분 동안 하트비트가 없음을 의미하며, 7일 넘게 오프라인이고 온라인 상태의 쌍둥이 기기(같은 장비, 이름 또는 위치)가 있는 기기는 교체되었을 가능성이 높습니다. networkCamera 행은 edgeProcessorUUID의 엣지 프로세서가 가져오는 스트림이며, 해당 deviceUuid(ep_로 시작)는 명령을 받을 수 없습니다. includeCredentials를 설정하지 않으면 스트림 URL 자격 증명은 ***:***로 표시됩니다. Wi-Fi보다 유선 이더넷을 권장하십시오.
관련 도구: cctv_cameras_read 및 cctv_cameras_write(카메라), cctv_edge_processors_write(엣지 프로세서), device_inventory_write(이름 변경, 구성, 이동), device_send_command(제어), device_health_read(대역폭).
작업:
- list: 기기 목록. 시설의 기기를 유형 또는 이름으로 필터링합니다. facilityIds를 지정하면 각 시설의 첫 페이지를 반환합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
action* | "list" | 수행할 작업입니다. 각 작업은 도구 설명에 설명되어 있습니다. |
facilityId | string | 시설 ID입니다. 연결된 시설을 대상으로 하는 경우 생략할 수 있습니다. |
facilityIds | array | 동일한 요청을 각 시설에서 실행할 여러 시설 ID입니다. facilityId 대신 사용합니다. |
deviceType | string | deviceType과 같은 이 유형만: screen, camera, networkCamera, duress 등 |
query | string | 이름, 공간, deviceID, deviceUuid 또는 일련번호에 이 값이 포함됨 |
includeCredentials | boolean | 사용자 이름과 비밀번호가 포함된 스트림 URL을 반환합니다. 기본적으로 꺼져 있습니다(자격 증명은 ***:***로 표시). 사용자가 명시적으로 자격 증명을 필요로 할 때만 설정하십시오. 해당 시설에 대한 CCTV 접근 권한이 필요합니다. |
limit | integer | 페이지당 항목 수(기본값 25, 최대 100) |
cursor | string | 이전 페이지의 nextCursor |
device_inventory_write디바이스 관리시설에 등록된 기기를 변경합니다. rename_screen과 configure_screen은 디스플레이 화면을 변경합니다(device_inventory_read의 deviceID로 식별). 화면의 그룹, 태그 또는 디스플레이 모드는 디스플레이 도구를 대신 사용하십시오. move는 화면, 클라우드 카메라, Duress 버튼, 출입문 컨트롤러, AI 에이전트 또는 AI 엣지 프로세서를 같은 조직의 다른 시설로 이동합니다.
작업:
- rename_screen: 화면 이름을 변경합니다. 오프라인 또는 수명이 다한 화면에도 즉시 적용됩니다. 필요한 값: deviceID, displayName.
- configure_screen: 화면의 하드웨어 설정을 변경합니다. 전달한 설정만 변경됩니다. 설정은 기기로 전송되며 디스플레이가 다시 시작될 수 있습니다. 오프라인 및 수명이 다한 화면(상태 409)은 이름만 변경할 수 있습니다. 필요한 값: deviceID. 확인을 요청합니다.
- move: 기기를 다른 시설로 이동합니다. facilityId는 기기의 현재 위치이며, 대상 시설에 대한 접근 권한도 필요합니다. 엣지 프로세서를 이동하면 해당 네트워크 카메라도 이동합니다. 개별 네트워크 카메라를 이동하려면 cctv_edge_processors_write transfer_cameras를 사용하십시오. 필요한 값: targetFacilityId, deviceType. 확인을 요청합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
action* | "rename_screen" | "configure_screen" | "move" | 수행할 작업입니다. 각 작업은 도구 설명에 설명되어 있습니다. |
deviceID | string | 화면 deviceID(6자리 코드) |
displayName | string | 새 화면 이름(rename_screen, configure_screen) |
facilityId | string | 시설 ID입니다. 연결된 시설을 대상으로 하는 경우 생략할 수 있습니다. |
orientation | "normal" | "left" | "right" | "inverted" | 화면 회전(configure_screen) |
resolution | "auto" | "1920x1080" | "1280x720" | "720x400" | 출력 해상도. auto는 디스플레이가 보고하는 값을 사용합니다(configure_screen) |
scheduledReboot | "disabled" | "daily" | "weekly" | "monthly" | 화면이 자동으로 재부팅되는 시점(configure_screen) |
displayBrightness | integer | 백라이트 밝기, 0~100(configure_screen) |
airplayEnabled | boolean | 화면에서 AirPlay를 허용합니다(configure_screen) |
airplayName | string | 사용자 지정 AirPlay 수신기 이름. 자동 이름을 사용하려면 비워 두십시오(configure_screen) |
airplayPin | string | 4자리 AirPlay PIN. 제거하려면 비워 두십시오(configure_screen) |
duressEnabled | boolean | Bluetooth Duress 버튼 스캐너(configure_screen) |
sonosEnabled | boolean | Sonos 스피커 제어(configure_screen) |
wifiSupport | boolean | 캡티브 Wi-Fi 설정 포털(configure_screen) |
cameraRestreamingEnabled | boolean | 화면에서 로컬 카메라 피드를 재스트리밍합니다(configure_screen) |
sessionTimerEnabled | boolean | Synchronised session timer (master clock) and its bells (configure_screen) |
targetFacilityId | string | 기기를 이동할 시설(move) |
deviceType | "screen" | "camera" | "duress" | "door-controller" | "ph-ai-agent" | "ai-edge-processor" | 기기 종류. 전달할 식별자를 결정합니다(move) |
deviceUuid | string | 카메라, 출입문 컨트롤러, AI 에이전트 또는 엣지 프로세서의 deviceUuid(move) |
deviceSerialNumber | string | Duress 버튼 일련번호(move) |
confirm | boolean | 첫 번째 호출에서 반환된 미리 보기를 사용자가 확인한 후에만 설정합니다 |
device_send_command디바이스 관리기기 하나 또는 시설의 모든 기기에 실시간 명령을 보냅니다: 재부팅, 디스플레이 켜기/끄기, 브라우저 다시 시작, 메시지 표시, 페이지 로드, 업데이트 설치 또는 PoE 포트 전원 재투입. 온라인 기기는 몇 초 이내에 실행하며, 오프라인 기기는 명령을 받지 못합니다. 모든 명령은 먼저 확인을 요청합니다.
기기 하나를 대상으로 하려면 uuid(device_inventory_read의 deviceUuid)를, 모든 기기를 대상으로 하려면 broadcast: true를 사용하십시오. 여러 시설에서 실행하려면 facilityIds를 전달하십시오. 화면은 모든 명령을 받으며, 카메라는 rebootDevice와 unlockUpdates를 받습니다. 네트워크 카메라(deviceUuid가 ep_로 시작)는 명령을 받을 수 없으므로 해당 엣지 프로세서(edgeProcessorUUID)를 대상으로 하거나 PoE 포트 전원을 재투입하십시오.
오프라인 PoE 카메라를 복구하려면 device_inventory_read에서 해당 metadata.networkStats(switchID, sw_port)를 읽은 다음, 인수 {switchID, switchPort}와 함께 시설의 온라인 기기 아무것에나 powerCyclePort를 보내십시오. 해당 기기가 시설의 네트워크 컨트롤러에 포트 전원을 차단했다가 복구하도록 요청합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
facilityId | string | 시설 ID입니다. 연결된 시설을 대상으로 하는 경우 생략할 수 있습니다. |
facilityIds | array | 동일한 요청을 각 시설에서 실행할 여러 시설 ID입니다. facilityId 대신 사용합니다. |
command* | "displayOff" | "displayOn" | "unlockUpdates" | "rebootDevice" | "restartBrowser" | "gpuDebugOn" | "gpuDebugOff" | "restartBleScanner" | "osd" | "loadUrl" | "powerCyclePort" | 보낼 명령. Duress 버튼이 감지되지 않으면 restartBleScanner를 브로드캐스트하십시오. 버튼을 추가, 이동 또는 제거하면 이미 이 작업이 수행되며, 화면은 약 10분마다 목록을 다시 로드합니다. |
broadcast | boolean | uuid 하나 대신 시설의 모든 기기에 보냅니다 |
uuid | string | device_inventory_read에서 가져온 deviceUuid. 브로드캐스트할 때는 생략하십시오 |
arguments | objectstring | osd: 현재 콘텐츠 위에 표시되는 메시지 텍스트. loadUrl: http(s) URL로, 다음 프로그램 로드 또는 재부팅까지 표시됩니다. powerCyclePort: {switchID, switchPort}. 다른 명령에서는 생략하십시오. |
confirm | boolean | 첫 번째 호출에서 반환된 미리 보기를 사용자가 확인한 후에만 설정합니다 |