การจัดการอุปกรณ์
แพลตฟอร์มหลักdevice_health_readการจัดการอุปกรณ์เปรียบเทียบผลการทดสอบความเร็วอินเทอร์เน็ตล่าสุดของสถานที่กับสิ่งที่อุปกรณ์ต้องการ network ส่งคืนความเร็วดาวน์โหลดและอัปโหลดเป็น Mbps และสำหรับหน้าจอ กล้อง (การบันทึกและการสตรีมสด) และระบบลำโพงที่เชื่อมต่อซึ่งพบใน 24 ชั่วโมงที่ผ่านมา: จำนวนอุปกรณ์ แบนด์วิดท์ที่แต่ละประเภทต้องการ และการเชื่อมต่อเพียงพอหรือไม่ ใช้เพื่อวินิจฉัยอุปกรณ์ที่ช้าหรือหลุดการเชื่อมต่อ หรือก่อนเพิ่มอุปกรณ์ ส่ง facilityIds เพื่อตรวจสอบหลายสถานที่
การดำเนินการ:
- network: ตรวจสอบแบนด์วิดท์เครือข่าย
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
action* | "network" | สิ่งที่ต้องการทำ การดำเนินการแต่ละรายการมีคำอธิบายอยู่ในคำอธิบายของเครื่องมือ |
facilityId | string | ID ของสถานที่ ไม่จำเป็นต้องระบุหากหมายถึงสถานที่ที่เชื่อมต่ออยู่ |
facilityIds | array | ID ของหลายสถานที่ เพื่อเรียกใช้คำขอเดียวกันในแต่ละสถานที่ ใช้แทน facilityId |
device_inventory_readการจัดการอุปกรณ์อุปกรณ์ทุกเครื่องที่ลงทะเบียนกับสถานที่: หน้าจอแสดงผล กล้องคลาวด์ กล้องเครือข่าย AI Edge Processor ปุ่ม Duress ตัวควบคุมประตู ตัวแทน AI และเซ็นเซอร์ IoT ใช้เพื่อแก้ปัญหา ตรวจสอบอุปกรณ์ หรือหา ID ของอุปกรณ์
อุปกรณ์แต่ละเครื่องมีประเภท รุ่น ID (deviceUuid; deviceID สำหรับหน้าจอ; deviceSerialNumber สำหรับปุ่ม Duress) ตำแหน่ง รายละเอียดเครือข่าย (IP, Wi-Fi หรือ Ethernet, SSID, ช่องสัญญาณ เครือข่ายใกล้เคียง; metadata.networkStats มีพอร์ตสวิตช์ PoE) สถานะ (อุณหภูมิ CPU หน่วยความจำ ระยะเวลาทำงาน) และ metadata.updated ซึ่งเป็น heartbeat ล่าสุดในหน่วย Unix ms ออฟไลน์หมายถึงไม่มี heartbeat เป็นเวลา 5 นาที อุปกรณ์ที่ออฟไลน์นานกว่า 7 วันและมีอุปกรณ์คู่ที่ออนไลน์ (อุปกรณ์ ชื่อ หรือตำแหน่งเดียวกัน) มีแนวโน้มสูงว่าถูกเปลี่ยนแล้ว แถว networkCamera คือสตรีมที่ Edge Processor ใน edgeProcessorUUID ดึงมา deviceUuid ของแถวเหล่านี้ (ขึ้นต้นด้วย ep_) รับคำสั่งไม่ได้ ข้อมูลรับรองใน URL สตรีมจะแสดงเป็น : เว้นแต่จะตั้ง includeCredentials แนะนำให้ใช้ Ethernet แบบมีสายแทน Wi-Fi
ที่เกี่ยวข้อง: cctv_cameras_read และ cctv_cameras_write (กล้อง), cctv_edge_processors_write (Edge Processor), 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 ของสตรีมพร้อมชื่อผู้ใช้และรหัสผ่าน ปิดโดยค่าเริ่มต้น (ข้อมูลรับรองแสดงเป็น ***:***) ตั้งค่านี้เฉพาะเมื่อผู้ใช้ต้องการข้อมูลรับรองอย่างชัดเจนเท่านั้น และต้องมีสิทธิ์เข้าถึงกล้องวงจรปิดที่สถานที่ |
limit | integer | จำนวนรายการต่อหน้า (ค่าเริ่มต้น 25 สูงสุด 100) |
cursor | string | nextCursor จากหน้าก่อนหน้า |
device_inventory_writeการจัดการอุปกรณ์เปลี่ยนอุปกรณ์ที่ลงทะเบียนกับสถานที่ rename_screen และ configure_screen เปลี่ยนหน้าจอแสดงผล (ระบุด้วย deviceID จาก device_inventory_read) สำหรับกลุ่ม แท็ก หรือโหมดการแสดงผลของหน้าจอ ให้ใช้เครื่องมือ display แทน move ย้ายหน้าจอ กล้องคลาวด์ ปุ่ม Duress ตัวควบคุมประตู ตัวแทน AI หรือ AI Edge Processor ไปยังสถานที่อื่นในองค์กรเดียวกัน
การดำเนินการ:
- rename_screen: เปลี่ยนชื่อหน้าจอ มีผลทันที รวมถึงหน้าจอที่ออฟไลน์หรือหมดอายุการใช้งาน ต้องระบุ deviceID, displayName
- configure_screen: เปลี่ยนการตั้งค่าฮาร์ดแวร์ของหน้าจอ เฉพาะการตั้งค่าที่คุณส่งเท่านั้นที่จะเปลี่ยน การตั้งค่าจะถูกส่งไปยังอุปกรณ์และอาจรีสตาร์ตการแสดงผล หน้าจอที่ออฟไลน์และหมดอายุการใช้งาน (สถานะ 409) ทำได้เพียงเปลี่ยนชื่อ ต้องระบุ deviceID ขอการยืนยัน
- move: ย้ายอุปกรณ์ไปยังสถานที่อื่น facilityId คือสถานที่ปัจจุบันของอุปกรณ์ และคุณต้องมีสิทธิ์เข้าถึงสถานที่ปลายทางด้วย การย้าย Edge Processor จะย้ายกล้องเครือข่ายไปด้วย หากต้องการย้ายกล้องเครือข่ายทีละตัว ให้ใช้ transfer_cameras ของ cctv_edge_processors_write ต้องระบุ 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 | PIN ของ AirPlay 4 หลัก ค่าว่างเพื่อลบ (configure_screen) |
duressEnabled | boolean | ตัวสแกนปุ่ม Duress ผ่าน Bluetooth (configure_screen) |
sonosEnabled | boolean | การควบคุมลำโพง Sonos (configure_screen) |
wifiSupport | boolean | พอร์ทัลตั้งค่า Wi-Fi แบบ captive (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 | deviceUuid ของกล้อง ตัวควบคุมประตู ตัวแทน AI หรือ Edge Processor (move) |
deviceSerialNumber | string | หมายเลขซีเรียลของปุ่ม Duress (move) |
confirm | boolean | ตั้งค่าเฉพาะหลังจากผู้ใช้ยืนยันตัวอย่างที่ได้จากการเรียกครั้งแรกแล้วเท่านั้น |
device_send_commandการจัดการอุปกรณ์ส่งคำสั่งแบบเรียลไทม์ไปยังอุปกรณ์หนึ่งเครื่อง หรือทุกอุปกรณ์ที่สถานที่: รีบูต เปิดหรือปิดจอแสดงผล รีสตาร์ตเบราว์เซอร์ แสดงข้อความ โหลดหน้าเว็บ ติดตั้งอัปเดต หรือตัดและจ่ายไฟพอร์ต PoE ใหม่ อุปกรณ์ที่ออนไลน์จะดำเนินการภายในไม่กี่วินาที อุปกรณ์ที่ออฟไลน์จะไม่ได้รับคำสั่ง ทุกคำสั่งจะขอการยืนยันก่อน
ระบุอุปกรณ์หนึ่งเครื่องด้วย uuid (deviceUuid จาก device_inventory_read) หรือทุกอุปกรณ์ด้วย broadcast: true ส่ง facilityIds เพื่อเรียกใช้ที่หลายสถานที่ หน้าจอรับได้ทุกคำสั่ง กล้องรับ rebootDevice และ unlockUpdates กล้องเครือข่าย (deviceUuid ขึ้นต้นด้วย ep_) รับคำสั่งไม่ได้ ให้ส่งไปยัง Edge Processor ของกล้อง (edgeProcessorUUID) หรือตัดและจ่ายไฟพอร์ต PoE ของกล้องใหม่แทน
หากต้องการกู้กล้อง PoE ที่ออฟไลน์ ให้อ่าน metadata.networkStats (switchID, sw_port) ของกล้องใน device_inventory_read แล้วส่ง powerCyclePort ไปยังอุปกรณ์ที่ออนไลน์เครื่องใดก็ได้ที่สถานที่พร้อม arguments {switchID, switchPort} อุปกรณ์นั้นจะขอให้ตัวควบคุมเครือข่ายของสถานที่ตัดและจ่ายไฟให้พอร์ตใหม่
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
facilityId | string | ID ของสถานที่ ไม่จำเป็นต้องระบุหากหมายถึงสถานที่ที่เชื่อมต่ออยู่ |
facilityIds | array | ID ของหลายสถานที่ เพื่อเรียกใช้คำขอเดียวกันในแต่ละสถานที่ ใช้แทน facilityId |
command* | "displayOff" | "displayOn" | "unlockUpdates" | "rebootDevice" | "restartBrowser" | "gpuDebugOn" | "gpuDebugOff" | "restartBleScanner" | "osd" | "loadUrl" | "powerCyclePort" | คำสั่งที่จะส่ง ให้ broadcast restartBleScanner เมื่อตรวจไม่พบปุ่ม Duress การเพิ่ม ย้าย หรือนำปุ่มออกจะทำสิ่งนี้อยู่แล้ว และหน้าจอจะโหลดรายการใหม่ทุก ~10 นาที |
broadcast | boolean | ส่งไปยังทุกอุปกรณ์ที่สถานที่แทน uuid เดียว |
uuid | string | deviceUuid จาก device_inventory_read ไม่ต้องส่งเมื่อ broadcast |
arguments | objectstring | osd: ข้อความที่แสดงทับเนื้อหาปัจจุบัน loadUrl: URL แบบ http(s) ที่แสดงจนกว่าจะโหลดโปรแกรมครั้งถัดไปหรือรีบูต powerCyclePort: {switchID, switchPort} ไม่ต้องส่งสำหรับคำสั่งอื่น |
confirm | boolean | ตั้งค่าเฉพาะหลังจากผู้ใช้ยืนยันตัวอย่างที่ได้จากการเรียกครั้งแรกแล้วเท่านั้น |