Konektivitas perangkat dan ingress telemetri
Penting
Versi baru layanan Azure Digital Twins telah dirilis. Mengingat kemampuan layanan baru yang diperluas, layanan Azure Digital Twins asli (dijelaskan dalam kumpulan dokumentasi ini) telah dihentikan.
Untuk melihat dokumentasi layanan baru, kunjungi Dokumentasi Azure Digital Twins aktif.
Data telemetri yang dikirim oleh perangkat dan sensor membentuk tulang punggung solusi IoT apa pun. Cara mewakili sumber daya yang berbeda ini dan mengelolanya dalam konteks lokasi adalah kekhawatiran utama dalam pengembangan aplikasi IoT. Azure Digital Twins menyederhanakan proses pengembangan solusi IoT dengan menyatukan perangkat dan sensor dengan grafik kecerdasan spasial.
Untuk memulai, buat sumber daya Azure IoT Hub di akar grafik spasial. Sumber daya IoT Hub memungkinkan semua perangkat di bawah ruang akar untuk mengirim pesan. Setelah IoT Hub dibuat, daftarkan perangkat dengan sensor dalam instans Digital Twins. Perangkat dapat mengirim data ke layanan Digital Twins melalui SDK perangkat Azure IoT.
Untuk panduan langkah demi langkah tentang cara mengaktifkan perangkat, baca Tutorial untuk menyebarkan dan mengonfigurasi Digital Twins. Sekilas, langkah-langkahnya adalah:
- Sebarkan instans Digital Twins dari portal Azure.
- Buat spasi di grafik Anda.
- Buat sumber daya IoT Hub, dan tetapkan ke spasi di grafik Anda.
- Buat perangkat dan sensor di grafik Anda, dan tetapkan ke spasi yang dibuat di langkah-langkah sebelumnya.
- Buat pencocokan untuk memfilter pesan telemetri berdasarkan kondisi.
- Buat fungsi yang ditentukan pengguna, dan tetapkan ke ruang dalam grafik untuk pemrosesan kustom pesan telemetri Anda.
- Tetapkan peran untuk memungkinkan fungsi yang ditentukan pengguna mengakses data grafik.
- Dapatkan string koneksi perangkat IoT Hub dari API Manajemen Digital Twins.
- Konfigurasikan string koneksi perangkat pada perangkat dengan SDK perangkat Azure IoT.
Di bagian berikut, Anda mempelajari cara mendapatkan string koneksi perangkat IoT Hub dari DIGITAL Twins Management API. Anda juga mempelajari cara menggunakan format pesan telemetri IoT Hub untuk mengirim telemetri berbasis sensor. Digital Twins memerlukan setiap bagian telemetri yang diterimanya untuk dikaitkan dengan sensor dalam grafik spasial. Persyaratan ini memastikan data diproses dan dirutekan dalam konteks spasial yang sesuai.
Mendapatkan string koneksi perangkat IoT Hub dari API Manajemen
Dalam contoh di bawah ini, YOUR_MANAGEMENT_API_URL mengacu pada URI API Digital Twins:
https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
| Nama | Ganti dengan |
|---|---|
| YOUR_INSTANCE_NAME | Nama instans Azure Digital Twins Anda |
| YOUR_LOCATION | Wilayah tempat instans Anda dihosting |
Lakukan panggilan GET pada API Perangkat dengan includes=ConnectionString parameter untuk mendapatkan string koneksi perangkat IoT Hub. Filter menurut GUID perangkat atau ID perangkat keras untuk menemukan perangkat yang diberikan.
YOUR_MANAGEMENT_API_URL/devices/YOUR_DEVICE_GUID?includes=ConnectionString
| Parameter | Ganti dengan |
|---|---|
| YOUR_DEVICE_GUID | ID perangkat |
YOUR_MANAGEMENT_API_URL/devices?HardwareIds=YOUR_DEVICE_HARDWARE_ID&includes=ConnectionString
| Nilai parameter | Ganti dengan |
|---|---|
| YOUR_DEVICE_HARDWARE_ID | ID perangkat keras perangkat |
Dalam payload respons, salin properti connectionString perangkat. Anda menggunakannya saat memanggil SDK perangkat Azure IoT untuk mengirim data ke Digital Twins.
Pesan perangkat ke cloud
Anda dapat menyesuaikan format dan payload pesan perangkat agar sesuai dengan kebutuhan solusi Anda. Gunakan kontrak data apa pun yang dapat diserialisasikan ke dalam array byte atau aliran yang didukung oleh kelas Pesan Klien Perangkat Azure IoT, Message(byte[] byteArray). Pesan dapat berupa format biner kustom pilihan Anda, selama Anda mendekode kontrak data dalam fungsi yang ditentukan pengguna yang sesuai. Hanya ada satu persyaratan untuk pesan perangkat ke cloud. Pertahankan sekumpulan properti untuk memastikan pesan Anda dirutekan dengan tepat ke mesin pemrosesan.
Properti telemetri
Konten payload Pesan dapat berupa data arbitrer berukuran hingga 256 KB. Ada beberapa persyaratan yang diharapkan untuk properti jenis tersebut Message.Properties . Tabel memperlihatkan properti yang diperlukan dan opsional yang didukung oleh sistem.
| Nama properti | Nilai | Diperlukan | Deskripsi |
|---|---|---|---|
| DigitalTwins-Telemetry | 1.0 | Ya | Nilai konstanta yang mengidentifikasi pesan ke sistem. |
| DigitalTwins-SensorHardwareId | string(72) |
Ya | Pengidentifikasi unik sensor yang mengirim Pesan. Nilai ini harus cocok dengan properti HardwareId objek agar sistem dapat memprosesnya. Contohnya:00FF0643BE88-CO2 |
| CreationTimeUtc | string |
Tidak | String tanggal berformat ISO 8601 yang mengidentifikasi waktu pengambilan sampel payload. Contohnya:2018-09-20T07:35:00.8587882-07:00 |
| CorrelationId | string |
Tidak | UUID yang digunakan untuk melacak peristiwa di seluruh sistem. Contohnya:cec16751-ab27-405d-8fe6-c68e1412ce1f |
Mengirim pesan Anda ke Digital Twins
Gunakan panggilan DeviceClient SendEventAsync atau SendEventBatchAsync untuk mengirim pesan Anda ke Digital Twins.
Langkah berikutnya
- Untuk mempelajari tentang pemrosesan data Azure Digital Twins dan kemampuan fungsi yang ditentukan pengguna, baca Pemrosesan data Azure Digital Twins dan fungsi yang ditentukan pengguna.