Aygıt Yönetimi
Temel platformdevice_health_readAygıt YönetimiBir tesisin en son internet hız testini cihazlarının ihtiyaçlarıyla karşılaştırır. network, Mbps cinsinden indirme ve yükleme hızını; son 24 saatte görülen ekranlar, kameralar (kayıt ve canlı yayın) ve bağlı hoparlör sistemleri için cihaz sayısını, her birinin gerektirdiği bant genişliğini ve bağlantının yeterli olup olmadığını döndürür. Yavaşlayan veya bağlantısı kopan cihazları teşhis etmek ya da cihaz eklemeden önce kullanın. Birden fazla tesisi kontrol etmek için facilityIds gönderin.
Eylemler:
- network: Ağ bant genişliği kontrolü.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "network" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
facilityIds | array | Aynı isteği her birinde çalıştırmak için birden fazla tesis kimliği. facilityId yerine kullanın. |
device_inventory_readAygıt YönetimiBir tesise kayıtlı her cihaz: ekranlar, bulut kameraları, ağ kameraları, yapay zeka Edge Processor'ları, duress butonları, kapı denetleyicileri, Yapay Zeka Ajanları ve IoT sensörleri. Sorun gidermek, ekipmanı denetlemek veya bir cihazın kimliğini bulmak için kullanın.
Her cihazın türü, modeli, kimlikleri (deviceUuid; ekranlar için deviceID; duress butonları için deviceSerialNumber), konumu, ağ ayrıntıları (IP, Wi-Fi veya Ethernet, SSID, kanal, yakındaki ağlar; metadata.networkStats PoE anahtarı bağlantı noktasını içerir), sağlık durumu (CPU sıcaklığı, bellek, çalışma süresi) ve Unix ms cinsinden son sinyal olan metadata.updated değeri vardır. Çevrimdışı, 5 dakika boyunca sinyal alınmadığı anlamına gelir; 7 günden uzun süredir çevrimdışı olan ve çevrimiçi bir ikizi (aynı ekipman, ad veya konum) bulunan bir cihaz büyük olasılıkla değiştirilmiştir. networkCamera satırları, edgeProcessorUUID içindeki Edge Processor tarafından çekilen akışlardır; deviceUuid değerleri (ep_ ile başlar) komut alamaz. includeCredentials ayarlanmadıkça akış URL'si kimlik bilgileri : olarak gösterilir. Wi-Fi yerine kablolu Ethernet önerin.
İlgili: cctv_cameras_read ve cctv_cameras_write (kameralar), cctv_edge_processors_write (Edge Processor'lar), device_inventory_write (yeniden adlandırma, yapılandırma, taşıma), device_send_command (kontrol), device_health_read (bant genişliği).
Eylemler:
- list: Cihazları listeleyin. Tesisteki cihazlar, türe veya ada göre filtrelenmiş. facilityIds ile her tesis ilk sayfasını döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "list" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
facilityIds | array | Aynı isteği her birinde çalıştırmak için birden fazla tesis kimliği. facilityId yerine kullanın. |
deviceType | string | Yalnızca bu tür, deviceType'taki gibi: screen, camera, networkCamera, duress vb. |
query | string | Ad, oda, deviceID, deviceUuid veya seri numarası bunu içerir |
includeCredentials | boolean | Akış URL'lerini kullanıcı adı ve parolalarıyla birlikte döndürür. Varsayılan olarak kapalıdır (kimlik bilgileri ***:*** olarak gösterilir). Yalnızca kullanıcı kimlik bilgilerine açıkça ihtiyaç duyduğunda ayarlayın; tesiste güvenlik kamerası erişimi gerektirir. |
limit | integer | Sayfa başına öğe (varsayılan 25, en fazla 100) |
cursor | string | Önceki sayfadan nextCursor |
device_inventory_writeAygıt YönetimiBir tesise kayıtlı bir cihazı değiştirir. rename_screen ve configure_screen bir ekranı değiştirir (ekranı device_inventory_read sonucundaki deviceID ile belirtin); bir ekranın grupları, etiketleri veya görüntüleme modu için bunun yerine ekran araçlarını kullanın. move; bir ekranı, bulut kamerasını, duress butonunu, kapı denetleyicisini, Yapay Zeka Ajanını veya yapay zeka Edge Processor'ını aynı organizasyondaki başka bir tesise taşır.
Eylemler:
- rename_screen: Bir ekranı yeniden adlandırın. Çevrimdışı veya kullanım ömrü dolmuş ekranlar için de hemen uygulanır. Gerekli: deviceID, displayName.
- configure_screen: Bir ekranın donanım ayarlarını değiştirin. Yalnızca gönderdiğiniz ayarlar değişir. Ayarlar cihaza gönderilir ve ekranı yeniden başlatabilir. Çevrimdışı ve kullanım ömrü dolmuş ekranlar (durum 409) yalnızca yeniden adlandırılabilir. Gerekli: deviceID. Onay ister.
- move: Bir cihazı başka bir tesise taşıyın. facilityId, cihazın şu anda bulunduğu tesistir; hedef tesise de erişiminiz olmalıdır. Bir Edge Processor'ı taşımak ağ kameralarını da taşır; tek tek ağ kameralarını taşımak için cctv_edge_processors_write transfer_cameras kullanın. Gerekli: targetFacilityId, deviceType. Onay ister.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "rename_screen" | "configure_screen" | "move" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
deviceID | string | Ekran deviceID değeri (6 karakterlik kod) |
displayName | string | Yeni ekran adı (rename_screen, configure_screen) |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
orientation | "normal" | "left" | "right" | "inverted" | Ekran döndürme (configure_screen) |
resolution | "auto" | "1920x1080" | "1280x720" | "720x400" | Çıkış çözünürlüğü; auto, ekranın bildirdiği değeri kullanır (configure_screen) |
scheduledReboot | "disabled" | "daily" | "weekly" | "monthly" | Ekranın kendini yeniden başlatacağı zaman (configure_screen) |
displayBrightness | integer | Arka ışık parlaklığı, 0-100 (configure_screen) |
airplayEnabled | boolean | Ekran AirPlay kabul eder (configure_screen) |
airplayName | string | Özel AirPlay alıcı adı; otomatik ad için boş bırakın (configure_screen) |
airplayPin | string | 4 haneli AirPlay PIN'i; kaldırmak için boş bırakın (configure_screen) |
duressEnabled | boolean | Bluetooth duress butonu tarayıcısı (configure_screen) |
sonosEnabled | boolean | Sonos hoparlör kontrolü (configure_screen) |
wifiSupport | boolean | Captive Wi-Fi kurulum portalı (configure_screen) |
cameraRestreamingEnabled | boolean | Yerel kamera yayınlarını ekrandan yeniden yayınla (configure_screen) |
sessionTimerEnabled | boolean | Synchronised session timer (master clock) and its bells (configure_screen) |
targetFacilityId | string | Cihazın taşınacağı tesis (move) |
deviceType | "screen" | "camera" | "duress" | "door-controller" | "ph-ai-agent" | "ai-edge-processor" | Cihaz türü; hangi tanımlayıcının gönderileceğini belirler (move) |
deviceUuid | string | Kamera, kapı denetleyicisi, Yapay Zeka Ajanı veya Edge Processor deviceUuid değeri (move) |
deviceSerialNumber | string | Duress butonu seri numarası (move) |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
device_send_commandAygıt YönetimiBir cihaza veya bir tesisteki her cihaza canlı bir komut gönderir: yeniden başlatma, ekranı açma veya kapatma, tarayıcıyı yeniden başlatma, mesaj gösterme, sayfa yükleme, güncellemeleri yükleme veya bir PoE bağlantı noktasının gücünü kapatıp açma. Çevrimiçi cihazlar saniyeler içinde işlem yapar; çevrimdışı cihazlar komutu hiç almaz. Her komut önce onay ister.
Tek bir cihazı uuid (device_inventory_read sonucundaki deviceUuid) ile veya her cihazı broadcast: true ile hedefleyin. Birden fazla tesiste çalıştırmak için facilityIds gönderin. Ekranlar her komutu alır; kameralar rebootDevice ve unlockUpdates alır. Ağ kameraları (deviceUuid ep_ ile başlar) komut alamaz; bunların Edge Processor'ını (edgeProcessorUUID) hedefleyin veya PoE bağlantı noktalarının gücünü kapatıp açın.
Çevrimdışı bir PoE kamerayı yeniden çalıştırmak için device_inventory_read içinde metadata.networkStats (switchID, sw_port) değerini okuyun, ardından {switchID, switchPort} bağımsız değişkenleriyle tesisteki çevrimiçi herhangi bir cihaza powerCyclePort gönderin. O cihaz, tesisin ağ denetleyicisinden bağlantı noktasının gücünü kesip yeniden vermesini ister.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
facilityIds | array | Aynı isteği her birinde çalıştırmak için birden fazla tesis kimliği. facilityId yerine kullanın. |
command* | "displayOff" | "displayOn" | "unlockUpdates" | "rebootDevice" | "restartBrowser" | "gpuDebugOn" | "gpuDebugOff" | "restartBleScanner" | "osd" | "loadUrl" | "powerCyclePort" | Gönderilecek komut. Duress butonları algılanmadığında restartBleScanner komutunu yayınlayın; bir buton eklemek, taşımak veya kaldırmak bunu zaten yapar ve ekranlar listeyi yaklaşık her 10 dakikada bir yeniden yükler. |
broadcast | boolean | Tek bir uuid yerine tesisteki her cihaza gönder |
uuid | string | device_inventory_read sonucundaki deviceUuid; yayın yaparken göndermeyin |
arguments | objectstring | osd: mevcut içeriğin üzerinde gösterilen mesaj metni. loadUrl: bir sonraki program yüklemesine veya yeniden başlatmaya kadar gösterilen bir http(s) URL'si. powerCyclePort: {switchID, switchPort}. Diğer komutlar için göndermeyin. |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |