Manajemen Perangkat
Platform Intidevice_health_readManajemen PerangkatMembandingkan uji kecepatan internet terbaru fasilitas dengan kebutuhan perangkatnya. network mengembalikan kecepatan unduh dan unggah dalam Mbps, dan untuk layar, kamera (perekaman ditambah streaming langsung), serta sistem speaker terhubung yang terlihat dalam 24 jam terakhir: jumlah perangkat, bandwidth yang diperlukan masing-masing, dan apakah koneksinya mencukupi. Gunakan untuk mendiagnosis perangkat yang lambat atau sering terputus, atau sebelum menambahkan perangkat. Kirim facilityIds untuk memeriksa beberapa fasilitas.
Aksi:
- network: Pemeriksaan bandwidth jaringan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "network" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
facilityIds | array | Beberapa ID fasilitas, untuk menjalankan permintaan yang sama di masing-masing fasilitas. Gunakan sebagai pengganti facilityId. |
device_inventory_readManajemen PerangkatSetiap perangkat yang terdaftar di fasilitas: layar tampilan, kamera cloud, kamera jaringan, AI Edge Processor, tombol duress, pengontrol pintu, agen AI, dan sensor IoT. Gunakan untuk memecahkan masalah, mengaudit peralatan, atau menemukan ID perangkat.
Setiap perangkat memiliki jenis, model, ID (deviceUuid; deviceID untuk layar; deviceSerialNumber untuk tombol duress), lokasi, detail jaringan (IP, Wi-Fi atau ethernet, SSID, channel, jaringan di sekitar; metadata.networkStats berisi port switch PoE), kesehatan (suhu CPU, memori, waktu aktif), dan metadata.updated, heartbeat terakhir dalam Unix ms. Offline berarti tidak ada heartbeat selama 5 menit; perangkat yang offline lebih dari 7 hari dengan kembaran yang online (peralatan, nama, atau lokasi yang sama) kemungkinan besar telah diganti. Baris networkCamera adalah stream yang ditarik oleh Edge Processor di edgeProcessorUUID; deviceUuid-nya (diawali ep_) tidak dapat menerima perintah. Kredensial URL stream ditampilkan sebagai : kecuali includeCredentials diatur. Sarankan ethernet kabel daripada Wi-Fi.
Terkait: cctv_cameras_read dan cctv_cameras_write (kamera), cctv_edge_processors_write (Edge Processor), device_inventory_write (ganti nama, konfigurasi, pindah), device_send_command (kontrol), device_health_read (bandwidth).
Aksi:
- list: Mencantumkan perangkat. Perangkat di fasilitas, difilter berdasarkan jenis atau nama. Dengan facilityIds, setiap fasilitas mengembalikan halaman pertamanya.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "list" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
facilityIds | array | Beberapa ID fasilitas, untuk menjalankan permintaan yang sama di masing-masing fasilitas. Gunakan sebagai pengganti facilityId. |
deviceType | string | Hanya jenis ini, seperti pada deviceType: screen, camera, networkCamera, duress, dan sebagainya |
query | string | Nama, ruangan, deviceID, deviceUuid, atau nomor seri mengandung teks ini |
includeCredentials | boolean | Kembalikan URL stream beserta nama pengguna dan kata sandinya. Nonaktif secara default (kredensial ditampilkan sebagai ***:***). Atur ini hanya jika pengguna secara eksplisit memerlukan kredensial; memerlukan akses CCTV di fasilitas. |
limit | integer | Item per halaman (default 25, maksimal 100) |
cursor | string | nextCursor dari halaman sebelumnya |
device_inventory_writeManajemen PerangkatMengubah perangkat yang terdaftar di fasilitas. rename_screen dan configure_screen mengubah layar tampilan (identifikasi dengan deviceID dari device_inventory_read); untuk grup, tag, atau mode tampilan layar, gunakan alat display. move memindahkan layar, kamera cloud, tombol duress, pengontrol pintu, agen AI, atau AI Edge Processor ke fasilitas lain dalam organisasi yang sama.
Aksi:
- rename_screen: Mengganti nama layar. Langsung berlaku, juga untuk layar yang offline atau sudah habis masa pakainya. Memerlukan deviceID, displayName.
- configure_screen: Mengubah pengaturan perangkat keras layar. Hanya pengaturan yang Anda kirim yang berubah. Pengaturan dikirim ke perangkat dan dapat memulai ulang tampilannya. Layar yang offline dan habis masa pakainya (status 409) hanya dapat diganti namanya. Memerlukan deviceID. Meminta konfirmasi.
- move: Memindahkan perangkat ke fasilitas lain. facilityId adalah lokasi perangkat saat ini; Anda juga memerlukan akses ke fasilitas tujuan. Memindahkan Edge Processor juga memindahkan kamera jaringannya; untuk memindahkan kamera jaringan satu per satu, gunakan cctv_edge_processors_write transfer_cameras. Memerlukan targetFacilityId, deviceType. Meminta konfirmasi.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "rename_screen" | "configure_screen" | "move" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
deviceID | string | deviceID layar (kode 6 karakter) |
displayName | string | Nama layar baru (rename_screen, configure_screen) |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
orientation | "normal" | "left" | "right" | "inverted" | Rotasi layar (configure_screen) |
resolution | "auto" | "1920x1080" | "1280x720" | "720x400" | Resolusi keluaran; auto menggunakan yang dilaporkan layar (configure_screen) |
scheduledReboot | "disabled" | "daily" | "weekly" | "monthly" | Kapan layar melakukan reboot sendiri (configure_screen) |
displayBrightness | integer | Kecerahan lampu latar, 0-100 (configure_screen) |
airplayEnabled | boolean | Layar menerima AirPlay (configure_screen) |
airplayName | string | Nama penerima AirPlay khusus; kosongkan untuk nama otomatis (configure_screen) |
airplayPin | string | PIN AirPlay 4 digit; kosongkan untuk menghapus (configure_screen) |
duressEnabled | boolean | Pemindai tombol duress Bluetooth (configure_screen) |
sonosEnabled | boolean | Kontrol speaker Sonos (configure_screen) |
wifiSupport | boolean | Portal penyiapan Wi-Fi captive (configure_screen) |
cameraRestreamingEnabled | boolean | Streaming ulang umpan kamera lokal dari layar (configure_screen) |
sessionTimerEnabled | boolean | Synchronised session timer (master clock) and its bells (configure_screen) |
targetFacilityId | string | Fasilitas tujuan pemindahan perangkat (move) |
deviceType | "screen" | "camera" | "duress" | "door-controller" | "ph-ai-agent" | "ai-edge-processor" | Jenis perangkat; menentukan pengenal mana yang harus dikirim (move) |
deviceUuid | string | deviceUuid kamera, pengontrol pintu, agen AI, atau Edge Processor (move) |
deviceSerialNumber | string | Nomor seri tombol duress (move) |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
device_send_commandManajemen PerangkatMengirim perintah langsung ke satu perangkat, atau ke setiap perangkat di fasilitas: reboot, menyalakan atau mematikan layar, memulai ulang browser, menampilkan pesan, memuat halaman, memasang pembaruan, atau mematikan dan menyalakan ulang port PoE. Perangkat yang online merespons dalam hitungan detik; perangkat yang offline tidak pernah menerimanya. Setiap perintah meminta konfirmasi terlebih dahulu.
Targetkan satu perangkat dengan uuid (deviceUuid-nya dari device_inventory_read), atau setiap perangkat dengan broadcast: true. Kirim facilityIds untuk menjalankan di beberapa fasilitas. Layar menerima setiap perintah; kamera menerima rebootDevice dan unlockUpdates. Kamera jaringan (deviceUuid diawali ep_) tidak dapat menerima perintah; targetkan Edge Processor-nya (edgeProcessorUUID) atau matikan dan nyalakan ulang port PoE-nya.
Untuk memulihkan kamera PoE yang offline, baca metadata.networkStats-nya (switchID, sw_port) di device_inventory_read, lalu kirim powerCyclePort ke perangkat online mana pun di fasilitas dengan argumen {switchID, switchPort}. Perangkat tersebut meminta pengontrol jaringan fasilitas untuk memutus dan memulihkan daya port.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
facilityIds | array | Beberapa ID fasilitas, untuk menjalankan permintaan yang sama di masing-masing fasilitas. Gunakan sebagai pengganti facilityId. |
command* | "displayOff" | "displayOn" | "unlockUpdates" | "rebootDevice" | "restartBrowser" | "gpuDebugOn" | "gpuDebugOff" | "restartBleScanner" | "osd" | "loadUrl" | "powerCyclePort" | Perintah yang akan dikirim. Siarkan restartBleScanner jika tombol duress tidak terdeteksi; menambahkan, memindahkan, atau menghapus tombol sudah melakukan hal ini, dan layar memuat ulang daftar setiap ~10 menit. |
broadcast | boolean | Kirim ke setiap perangkat di fasilitas, bukan ke satu uuid |
uuid | string | deviceUuid dari device_inventory_read; jangan sertakan saat menyiarkan |
arguments | objectstring | osd: teks pesan, ditampilkan di atas konten saat ini. loadUrl: URL http(s), ditampilkan hingga pemuatan program berikutnya atau reboot. powerCyclePort: {switchID, switchPort}. Jangan sertakan untuk perintah lain. |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |