Mulai cepat: Menemukan ruang yang tersedia dengan menggunakan Azure Digital Twins

  • Artikel

Penting

Versi baru layanan Azure Digital Twins telah dirilis. Mengingat kemampuan layanan baru yang diperluas, layanan Azure Digital Twins asli (dijelaskan dalam set dokumentasi ini) telah dihentikan.

Untuk melihat dokumentasi layanan baru, kunjungi Dokumentasi Azure Digital Twins aktif.

Layanan Azure Digital Twins memungkinkan Anda membuat ulang gambar digital lingkungan fisik Anda. Anda kemudian dapat mendapatkan pemberitahuan oleh peristiwa di lingkungan Anda dan menyesuaikan respons Anda terhadapnya.

Mulai cepat ini menggunakan sepasang sampel .NET untuk mendigitalkan gedung kantor imajiner. Ini menunjukkan kepada Anda cara menemukan kamar yang tersedia di gedung itu. Dengan Digital Twins, Anda dapat mengaitkan banyak sensor dengan lingkungan Anda. Anda juga dapat mengetahui apakah kualitas udara ruangan yang tersedia optimal dengan bantuan sensor simulasi untuk karbon dioksida. Salah satu aplikasi sampel menghasilkan data sensor acak untuk membantu Anda memvisualisasikan skenario ini.

Video berikut ini meringkas penyiapan mulai cepat:

Prasyarat

  1. Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

  2. Dua aplikasi konsol yang Anda jalankan dalam mulai cepat ini ditulis dengan menggunakan C#. Instal .NET Core SDK versi 2.1.403 atau lebih tinggi pada komputer pengembangan Anda. Jika Anda telah menginstal .NET Core SDK, verifikasi versi C# saat ini pada komputer pengembangan Anda. Jalankan dotnet --version di prompt perintah.

  3. Unduh sampel proyek C#. Ekstrak arsip digital-twins-samples-csharp-master.zip.

Membuat instans Digital Twins

Buat instans baru Digital Twins di portal dengan mengikuti langkah-langkah di bagian ini.

  1. Masuk ke portal Microsoft Azure.

  2. Pilih bilah sisi beranda, lalu + Buat sumber daya.

    Perluas bilah sisi beranda, lalu pilih + Buat sumber daya

  3. Cari Digital Twins, dan pilih Digital Twins.

    Pilihan untuk membuat instans Digital Twins baru

    Atau, pilih Internet of Things, dan pilih Digital Twins (pratinjau).

  4. Pilih Buat untuk memulai proses penyebaran.

    Membuat dan mengonfirmasi penyebaran sumber daya

  5. Di panel Digital Twins , masukkan informasi berikut ini:

    • Nama Sumber Daya: Buat nama unik untuk instans Digital Twins Anda.

    • Langganan: Pilih langganan yang ingin Anda gunakan untuk membuat instans Digital Twins ini.

    • Grup sumber daya: Pilih atau buat grup sumber daya untuk instans Digital Twins.

    • Lokasi: Pilih lokasi terdekat dengan perangkat Anda.

      Panel Digital Twins dengan informasi yang dimasukkan

  6. Tinjau informasi Digital Twins Anda, lalu pilih Buat. Instans Digital Twins Anda mungkin memerlukan waktu beberapa menit untuk dibuat. Anda bisa memantau kemajuannya di panel Pemberitahuan.

  7. Buka panel Gambaran Umum instans Digital Twins Anda. Perhatikan tautan di bawah API Manajemen. URL API Manajemen diformat sebagai:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/swagger

    URL ini membawa Anda ke dokumentasi REST API Azure Digital Twins yang berlaku untuk instans Anda. Baca Cara menggunakan Azure Digital Twins Swagger untuk mempelajari cara membaca dan menggunakan dokumentasi API ini. Salin dan ubah URL API Manajemen ke format ini:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/

    Aplikasi Anda akan menggunakan URL yang dimodifikasi sebagai URL dasar untuk mengakses instans Anda. Salin URL yang dimodifikasi ini ke file sementara. Anda akan membutuhkan ini di bagian berikutnya.

    Gambaran umum API Manajemen

Mengatur izin untuk aplikasi Anda

Bagian ini mendaftarkan aplikasi sampel Anda ke Azure Active Directory (Azure AD) sehingga dapat mengakses instans Digital Twins Anda. Jika Anda sudah memiliki pendaftaran aplikasi Azure AD, gunakan kembali untuk sampel Anda. Pastikan konfigurasinya seperti yang dijelaskan di bagian ini.

Catatan

Bagian ini menyediakan instruksi untuk pendaftaran aplikasi Azure AD.

  1. Di portal Azure, buka Azure Active Directory dari menu kiri yang dapat diperluas, lalu buka panel Pendaftaran aplikasi.

    Pilih panel Azure Active Directory

  2. Pilih tombol + Pendaftaran baru .

    Pilih tombol Pendaftaran baru

  3. Berikan nama yang mudah diingat untuk pendaftaran aplikasi ini di kotak Nama .

    1. Di bawah bagian Alihkan URI (opsional) , masukkan https://microsoft.com di kotak teks.

    2. Verifikasi akun dan penyewa mana yang didukung oleh aplikasi Azure Active Directory Anda.

    3. Pilih Daftar.

    Buat panel

  4. Bilah Autentikasi menentukan pengaturan konfigurasi autentikasi penting.

    1. Tambahkan URI Pengalihan dan konfigurasikan Token Akses dengan memilih + Tambahkan platform.

    2. Pilih Ya untuk menentukan bahwa aplikasi adalah klien publik.

    3. Verifikasi akun dan penyewa mana yang didukung oleh aplikasi Azure Active Directory Anda.

    Pengaturan konfigurasi klien publik

  5. Setelah memilih platform yang sesuai, konfigurasikan URI Pengalihan dan Token Akses Anda di panel samping di sebelah kanan antarmuka pengguna.

    1. URI Pengalihan harus cocok dengan alamat yang diberikan oleh permintaan autentikasi:

      • Untuk aplikasi yang dihosting di lingkungan pengembangan lokal, pilih Klien publik (seluler & desktop) . Memastikan untuk mengatur klien publik ke Ya.
      • Untuk Aplikasi Satu Hahalaman yang dihosting di Azure App Service, pilih Web.

    2. Menentukan apakah URL Keluar sudah sesuai.

    3. Mengaktifkan aliran hibah implisit dengan mencentang Token akses atau token ID.

    Mengonfigurasi URI Pengalihan

    Klik Konfigurasikan, lalu Simpan.

  6. Buka panel Gambaran Umum aplikasi terdaftar Anda, dan salin nilai entitas berikut ke file sementara. Anda akan menggunakan nilai-nilai ini untuk mengonfigurasi aplikasi sampel Anda di bagian berikut.

    • ID aplikasi (klien)
    • ID direktori (tenant)

    ID aplikasi Azure Active Directory

  7. Buka panel izin API untuk pendaftaran aplikasi Anda. Pilih tombol + Tambahkan izin . Di panel Minta izin API , pilih tab API yang digunakan organisasi saya , lalu cari salah satu hal berikut ini:

    1. Azure Digital Twins. Pilih AZURE Digital Twins API.

      Cari API atau Azure Digital Twins

    2. Atau, cari Azure Smart Spaces Service. Pilih Azure Smart Spaces Service API.

      API Pencarian untuk Azure Smart Spaces

    Penting

    Nama dan ID API Azure AD yang akan muncul tergantung pada penyewa Anda:

    • Penyewa pengujian dan akun pelanggan harus mencari Azure Digital Twins.
    • Akun Microsoft lainnya harus mencari Azure Smart Spaces Service.

  8. Salah satu API akan muncul sebagai Azure Digital Twins di panel izin Request API yang sama setelah dipilih. Pilih opsi drop-down Baca , lalu pilih kotak centang Baca.Tulis . Pilih tombol Tambahkan izin akses.

    Menambahkan izin API

  9. Bergantung pada pengaturan organisasi, Anda mungkin perlu mengambil langkah tambahan untuk memberikan akses admin ke API ini. Hubungi administrator Anda untuk informasi lebih lanjut. Setelah akses admin disetujui, kolom Admin Diperlukan Persetujuan di panel izin API akan menampilkan izin Anda.

    persetujuan Admin

    Verifikasi bahwa Azure Digital Twins muncul.

Membangun aplikasi

Bangun aplikasi hunian dengan mengikuti langkah-langkah ini.

  1. Buka prompt perintah. Buka folder tempat file Anda digital-twins-samples-csharp-master.zip diekstrak.

  2. Jalankan cd occupancy-quickstart/src.

  3. Jalankan dotnet restore.

  4. Edit appSettings.json untuk memperbarui variabel berikut:

    • ClientId: Masukkan ID Aplikasi pendaftaran aplikasi Azure AD Anda, yang tercantum di bagian sebelumnya.
    • Penyewa: Masukkan ID Direktori penyewa Azure AD Anda, juga dicatat di bagian sebelumnya.
    • BaseUrl: URL API Manajemen instans Digital Twins Anda dalam format https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Ganti tempat penampung di URL ini dengan nilai untuk instans Anda dari bagian sebelumnya.

    Simpan file yang diperbarui.

Grafik provisi

Langkah ini menyediakan grafik spasial Digital Twins Anda dengan:

  • Beberapa spasi.
  • Satu perangkat.
  • Dua sensor.
  • Fungsi kustom.
  • Satu penetapan peran.

Grafik spasial disediakan dengan menggunakan file provisionSample.yaml .

  1. Jalankan dotnet run ProvisionSample.

    Catatan

    Alat Device Login Azure CLI digunakan untuk mengautentikasi pengguna untuk Azure AD. Pengguna harus memasukkan kode tertentu untuk mengautentikasi dengan menggunakan halaman masuk Microsoft . Setelah kode dimasukkan, ikuti langkah-langkah untuk mengautentikasi. Pengguna harus mengautentikasi ketika alat berjalan.

    Tip

    Saat Anda menjalankan langkah ini, pastikan variabel Anda disalin dengan benar jika pesan kesalahan berikut muncul: EXIT: Unexpected error: The input is not a valid Base-64 string ...

  2. Langkah provisi mungkin memakan waktu beberapa menit. Ini juga menyediakan IoT Hub dalam instans Digital Twins Anda. Ini mengulang hingga IoT Hub menunjukkan Status=Running.

    Provisikan sampel - Status=Running

  3. Di akhir eksekusi, salin ConnectionString perangkat untuk digunakan dalam sampel simulator perangkat. Salin hanya string yang diuraikan dalam gambar ini.

    Salin string koneksi

    Tip

    Anda dapat melihat dan mengubah grafik spasial menggunakan Penampil Grafik Azure Digital Twins.

Biarkan jendela konsol terbuka untuk digunakan lagi nanti.

Mengirim data sensor

Bangun dan jalankan aplikasi perangkat simulator sensor dengan mengikuti langkah-langkah ini.

  1. Buka prompt perintah baru. Buka proyek yang Anda unduh di digital-twins-samples-csharp-master folder .

  2. Jalankan cd device-connectivity.

  3. Jalankan dotnet restore.

  4. Edit appsettings.json untuk memperbarui DeviceConnectionString dengan yang sebelumnya ConnectionString. Simpan file yang diperbarui.

  5. Jalankan dotnet run untuk mulai mengirim data sensor. Ini akan dikirim ke Azure Digital Twins seperti yang ditunjukkan pada gambar berikut.

    Konektivitas Perangkat

  6. Biarkan simulator ini berjalan sehingga Anda dapat melihat hasil berdampingan dengan tindakan langkah berikutnya. Jendela ini menunjukkan kepada Anda data sensor yang disimulasikan yang dikirim ke Digital Twins. Langkah selanjutnya mengkueri secara real time untuk menemukan kamar yang tersedia dengan udara segar.

    Tip

    Saat Anda menjalankan langkah ini, pastikan DeviceConnectionString disalin dengan benar jika pesan kesalahan berikut muncul: EXIT: Unexpected error: The input is not a valid Base-64 string ...

Temukan ruang yang tersedia dengan udara segar

Sampel sensor mensimulasikan nilai data acak untuk dua sensor. Mereka bergerak dan karbon dioksida. Ruang yang tersedia dengan udara segar didefinisikan dalam sampel tanpa kehadiran di ruangan. Mereka juga didefinisikan oleh tingkat karbon dioksida di bawah 1.000 ppm. Jika kondisi tidak terpenuhi, ruang tidak tersedia atau kualitas udara buruk.

  1. Buka perintah yang Anda gunakan untuk menjalankan langkah provisi sebelumnya.

  2. Jalankan dotnet run GetAvailableAndFreshSpaces.

  3. Lihat perintah ini dan prompt perintah data sensor berdampingan.

    Prompt perintah data sensor mengirimkan data gerakan dan karbon dioksida yang disimulasikan ke Digital Twins setiap lima detik. Prompt perintah lainnya membaca grafik secara real time untuk mengetahui ruang yang tersedia dengan udara segar berdasarkan data simulasi acak. Ini menampilkan salah satu kondisi ini dalam waktu dekat secara real time berdasarkan data sensor yang terakhir dikirim:

    • Room is available and air is fresh

    • Room is not available or air quality is poor

      Dapatkan ruang yang tersedia dengan udara segar

Untuk memahami apa yang terjadi dalam mulai cepat ini dan API apa yang dipanggil, buka Visual Studio Code dengan proyek ruang kerja kode yang ditemukan di digital-twins-samples-csharp. Gunakan perintah berikut:

<path>\occupancy-quickstart\src>code ..\..\digital-twins-samples.code-workspace

Tutorial masuk jauh ke dalam kode. Mereka mengajari Anda cara memodifikasi data konfigurasi dan API apa yang dipanggil. Untuk informasi selengkapnya tentang API Manajemen, buka halaman Digital Twins Swagger Anda:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
Nama Ganti dengan
YOUR_INSTANCE_NAME Nama instans Digital Twins Anda
YOUR_LOCATION Wilayah server tempat instans Anda dihosting

Atau untuk kenyamanan, telusuri ke Digital Twins Swagger.

Membersihkan sumber daya

Tutorial menjelaskan secara rinci tentang cara:

  • Membangun aplikasi bagi manajer fasilitas untuk meningkatkan produktivitas penghuni.
  • Mengoperasikan gedung dengan lebih efisien.

Untuk melanjutkan ke tutorial, jangan bersihkan sumber daya yang dibuat dalam mulai cepat ini. Jika Anda tidak berencana untuk melanjutkan, hapus semua sumber daya yang dibuat oleh mulai cepat ini.

  1. Hapus folder yang dibuat saat Anda mengunduh repositori sampel.

  2. Dari menu di sebelah kiri di portal Azure, pilih Semua sumber daya. Kemudian pilih sumber daya Digital Twins Anda. Di bagian atas panel Semua sumber daya , pilih Hapus.

    Tip

    Jika sebelumnya Anda mengalami masalah saat menghapus instans Digital Twins, pembaruan layanan telah diluncurkan dengan perbaikan. Silakan coba lagi menghapus instans Anda.

Langkah berikutnya

Mulai cepat ini menggunakan skenario sederhana dan aplikasi sampel untuk menunjukkan bagaimana Digital Twins dapat digunakan untuk menemukan ruangan dengan kondisi kerja yang baik. Untuk analisis mendalam tentang skenario ini, baca tutorial ini:

Tutorial: Menyebarkan Azure Digital Twins dan mengonfigurasi grafik spasial