Udostępnij za pośrednictwem

Ruch przychodzący danych telemetrycznych i łączność urządzeń

  • Artykuł

Ważne

Wydano nową wersję usługi Azure Digital Twins. W świetle rozszerzonych możliwości nowej usługi oryginalna usługa Azure Digital Twins (opisana w tym zestawie dokumentacji) została wycofana.

Aby wyświetlić dokumentację nowej usługi, odwiedź aktywną dokumentację usługi Azure Digital Twins.

Dane telemetryczne wysyłane przez urządzenia i czujniki tworzą szkielet dowolnego rozwiązania IoT. Jak reprezentować te różne zasoby i zarządzać nimi w kontekście lokalizacji są głównymi problemami w zakresie tworzenia aplikacji IoT. Usługa Azure Digital Twins upraszcza proces tworzenia rozwiązań IoT, łącząc urządzenia i czujniki z wykresem analizy przestrzennej.

Aby rozpocząć, utwórz zasób Azure IoT Hub w katalogu głównym grafu przestrzennego. Zasób IoT Hub umożliwia wysyłanie komunikatów wszystkim urządzeniom poniżej obszaru głównego. Po utworzeniu IoT Hub zarejestruj urządzenia z czujnikami w wystąpieniu usługi Digital Twins. Urządzenia mogą wysyłać dane do usługi Digital Twins za pośrednictwem zestawu SDK urządzenia Azure IoT.

Aby zapoznać się z przewodnikiem krok po kroku dotyczącym dołączania urządzeń, przeczytaj samouczek dotyczący wdrażania i konfigurowania usługi Digital Twins. Na pierwszy rzut oka kroki są następujące:

  • Wdróż wystąpienie usługi Digital Twins z Azure Portal.
  • Utwórz spacje na wykresie.
  • Utwórz zasób IoT Hub i przypisz go do miejsca na wykresie.
  • Utwórz urządzenia i czujniki na wykresie i przypisz je do przestrzeni utworzonych w poprzednich krokach.
  • Utwórz element matcher do filtrowania komunikatów telemetrycznych na podstawie warunków.
  • Utwórz funkcję zdefiniowaną przez użytkownika i przypisz ją do obszaru na grafie na potrzeby niestandardowego przetwarzania komunikatów telemetrycznych.
  • Przypisz rolę, aby umożliwić funkcji zdefiniowanej przez użytkownika dostęp do danych grafu.
  • Pobierz parametry połączenia urządzenia IoT Hub z interfejsów API zarządzania usługą Digital Twins.
  • Skonfiguruj parametry połączenia urządzenia na urządzeniu przy użyciu zestawu SDK urządzenia usługi Azure IoT.

W poniższych sekcjach dowiesz się, jak uzyskać parametry połączenia urządzenia IoT Hub z interfejsu API zarządzania usługą Digital Twins. Dowiesz się również, jak używać formatu komunikatów telemetrycznych IoT Hub do wysyłania danych telemetrycznych opartych na czujnikach. Usługa Digital Twins wymaga każdego elementu danych telemetrycznych, które odbiera do skojarzenia z czujnikiem na wykresie przestrzennym. To wymaganie zapewnia, że dane są przetwarzane i kierowane w odpowiednim kontekście przestrzennym.

Pobieranie parametrów połączenia urządzenia IoT Hub z interfejsu API zarządzania

W poniższych YOUR_MANAGEMENT_API_URL przykładach odwołuje się do identyfikatora URI interfejsów API usługi Digital Twins:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
Nazwa Zamień na
YOUR_INSTANCE_NAME Nazwa wystąpienia usługi Azure Digital Twins
YOUR_LOCATION Region, w którym jest hostowane twoje wystąpienie

Wykonaj wywołanie GET w interfejsie API urządzenia za pomocą includes=ConnectionString parametru , aby uzyskać parametry połączenia urządzenia IoT Hub. Filtruj według identyfikatora GUID urządzenia lub identyfikatora sprzętu, aby znaleźć dane urządzenie.

YOUR_MANAGEMENT_API_URL/devices/YOUR_DEVICE_GUID?includes=ConnectionString
Parametr Zamień na
YOUR_DEVICE_GUID Identyfikator urządzenia 
YOUR_MANAGEMENT_API_URL/devices?HardwareIds=YOUR_DEVICE_HARDWARE_ID&includes=ConnectionString
Wartość parametru Zamień na
YOUR_DEVICE_HARDWARE_ID Identyfikator sprzętu urządzenia

W ładunku odpowiedzi skopiuj właściwość connectionString urządzenia. Jest on używany podczas wywoływania zestawu SDK urządzenia usługi Azure IoT do wysyłania danych do usługi Digital Twins.

Komunikat urządzenie-chmura

Możesz dostosować format i ładunek komunikatów urządzenia, aby dopasować go do potrzeb rozwiązania. Użyj dowolnego kontraktu danych, który można serializować do tablicy bajtów lub strumienia obsługiwanego przez klasę Komunikat klienta urządzenia usługi Azure IoT, Message(byte[] byteArray). Komunikat może być wybranym niestandardowym formatem binarnym, o ile zdekodujesz kontrakt danych w odpowiedniej funkcji zdefiniowanej przez użytkownika. Istnieje tylko jedno wymaganie dotyczące komunikatu urządzenie-chmura. Zachowaj zestaw właściwości, aby upewnić się, że komunikat jest odpowiednio kierowany do aparatu przetwarzania.

Właściwości telemetrii

Zawartość ładunku wiadomości może być dowolną ilością danych do 256 KB. Istnieje kilka wymagań oczekiwanych dla właściwości Message.Properties typu. W tabeli przedstawiono wymagane i opcjonalne właściwości obsługiwane przez system.

Nazwa właściwości Wartość Wymagane Opis
DigitalTwins-Telemetry 1.0 Tak Stała wartość, która identyfikuje komunikat do systemu.
DigitalTwins-SensorHardwareId string(72) Tak Unikatowy identyfikator czujnika, który wysyła komunikat. Ta wartość musi być zgodna z właściwością HardwareId obiektu, aby system go przetworzył. Na przykład 00FF0643BE88-CO2.
CreationTimeUtc string Nie Ciąg daty sformatowany w formacie ISO 8601 , który identyfikuje czas próbkowania ładunku. Na przykład 2018-09-20T07:35:00.8587882-07:00.
CorrelationId string Nie Identyfikator UUID używany do śledzenia zdarzeń w systemie. Na przykład cec16751-ab27-405d-8fe6-c68e1412ce1f.

Wysyłanie wiadomości do usługi Digital Twins

Użyj wywołania DeviceClient SendEventAsync lub SendEventBatchAsync , aby wysłać wiadomość do usługi Digital Twins.

Następne kroki