Zarządzanie urządzeniami

Porównuje najnowszy test prędkości internetu w obiekcie z wymaganiami jego urządzeń. network zwraca prędkość pobierania i wysyłania w Mb/s oraz — dla ekranów, kamer (nagrywanie i transmisja na żywo) i podłączonych systemów głośników widzianych w ciągu ostatnich 24 godzin — liczbę urządzeń, przepustowość potrzebną każdemu z nich i informację, czy połączenie wystarcza. Użyj tego do diagnozowania wolnych lub rozłączających się urządzeń albo przed dodaniem urządzeń. Przekaż facilityIds, aby sprawdzić kilka obiektów.

Akcje:

• network: Sprawdzenie przepustowości sieci.

Każde urządzenie zarejestrowane w obiekcie: ekrany wyświetlające, kamery chmurowe, kamery sieciowe, urządzenia Edge Processor, przyciski napadowe, kontrolery drzwi, agenty AI i czujniki IoT. Użyj tego do rozwiązywania problemów, audytu sprzętu lub znalezienia identyfikatora urządzenia.

Każde urządzenie ma typ, model, identyfikatory (deviceUuid; deviceID dla ekranów; deviceSerialNumber dla przycisków napadowych), lokalizację, dane sieciowe (IP, Wi-Fi lub Ethernet, SSID, kanał, pobliskie sieci; metadata.networkStats zawiera port przełącznika PoE), stan (temperatura CPU, pamięć, czas pracy) oraz metadata.updated, czyli ostatni sygnał heartbeat w ms Unix. Offline oznacza brak sygnału heartbeat przez 5 minut; urządzenie offline dłużej niż 7 dni, które ma bliźniaka online (ten sam sprzęt, nazwa lub lokalizacja), zostało najprawdopodobniej wymienione. Wiersze networkCamera to strumienie pobierane przez Edge Processor wskazany w edgeProcessorUUID; ich deviceUuid (zaczynający się od ep_) nie może odbierać poleceń. Dane uwierzytelniające w adresach URL strumieni są widoczne jako :, chyba że ustawiono includeCredentials. Zalecaj przewodowe połączenie Ethernet zamiast Wi-Fi.

Powiązane: cctv_cameras_read i cctv_cameras_write (kamery), cctv_edge_processors_write (urządzenia Edge Processor), device_inventory_write (zmiana nazwy, konfiguracja, przenoszenie), device_send_command (sterowanie), device_health_read (przepustowość).

Akcje:

• list: Lista urządzeń. Urządzenia w obiekcie, filtrowane według typu lub nazwy. Z facilityIds każdy obiekt zwraca swoją pierwszą stronę.

Zmienia urządzenie zarejestrowane w obiekcie. rename_screen i configure_screen zmieniają ekran wyświetlający (wskaż go za pomocą deviceID z device_inventory_read); do grup, tagów lub trybu wyświetlania ekranu używaj zamiast tego narzędzi display. move przenosi ekran, kamerę chmurową, przycisk napadowy, kontroler drzwi, agenta AI lub Edge Processor do innego obiektu w tej samej organizacji.

Akcje:

• rename_screen: Zmiana nazwy ekranu. Stosowana od razu, także dla ekranów offline lub wycofanych ze wsparcia. Wymaga: deviceID, displayName.
• configure_screen: Zmiana ustawień sprzętowych ekranu. Zmieniają się tylko przekazane ustawienia. Są wysyłane do urządzenia i mogą zrestartować jego wyświetlacz. Ekranom offline i wycofanym ze wsparcia (status 409) można tylko zmienić nazwę. Wymaga: deviceID. Prosi o potwierdzenie.
• move: Przeniesienie urządzenia do innego obiektu. facilityId to obiekt, w którym urządzenie jest teraz; potrzebny jest też dostęp do obiektu docelowego. Przeniesienie urządzenia Edge Processor przenosi jego kamery sieciowe; aby przenieść pojedyncze kamery sieciowe, użyj cctv_edge_processors_write transfer_cameras. Wymaga: targetFacilityId, deviceType. Prosi o potwierdzenie.

Wysyła polecenie na żywo do jednego urządzenia lub do każdego urządzenia w obiekcie: restart, włączenie lub wyłączenie wyświetlacza, restart przeglądarki, wyświetlenie komunikatu, załadowanie strony, instalacja aktualizacji lub cykl zasilania portu PoE. Urządzenia online reagują w ciągu kilku sekund; urządzenia offline nigdy go nie otrzymują. Każde polecenie najpierw prosi o potwierdzenie.

Wskaż jedno urządzenie za pomocą uuid (jego deviceUuid z device_inventory_read) lub wszystkie urządzenia za pomocą broadcast: true. Przekaż facilityIds, aby wykonać polecenie w kilku obiektach. Ekrany przyjmują każde polecenie; kamery przyjmują rebootDevice i unlockUpdates. Kamery sieciowe (deviceUuid zaczynający się od ep_) nie mogą odbierać poleceń; wskaż ich Edge Processor (edgeProcessorUUID) lub wykonaj cykl zasilania ich portu PoE.

Aby przywrócić kamerę PoE offline, odczytaj jej metadata.networkStats (switchID, sw_port) w device_inventory_read, a następnie wyślij powerCyclePort do dowolnego urządzenia online w obiekcie z argumentami {switchID, switchPort}. To urządzenie poprosi kontroler sieci obiektu o odcięcie i przywrócenie zasilania portu.