Hızlı başlangıç: Azure dijital TWINS kullanarak kullanılabilir odaları bulma

  • Makale
  • Okumak için 7 dakika

Azure dijital TWINS hizmeti, fiziksel ortamınızın dijital görüntüsünü yeniden oluşturmanızı sağlar. Bu işlemin ardından ortamınızdaki olaylarla ilgili bildirimler alabilir ve verdiğiniz yanıtları özelleştirebilirsiniz.

Bu hızlı başlangıç, bir sanal Office oluşturmayı dijital olarak oluşturmak için bir çift .net örneği kullanır. Bu, bu binadaki kullanılabilir odaların nasıl bulunacağını gösterir. Dijital TWINS sayesinde, ortamınızdaki birçok sensöri ilişkilendirebilirsiniz. Ayrıca, kullanılabilir odanın hava kalitesi ' nin, karbon dilü için bir sanal algılayıcı yardımıyla en uygun olup olmadığını da öğrenebilirsiniz. Örnek uygulamalardan biri, bu senaryoyu görselleştirmenize yardımcı olmak için rastgele algılayıcı verileri oluşturur.

Aşağıdaki video hızlı başlangıç kurulumunu özetler:

Ön koşullar

  1. Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.

  2. Bu hızlı başlangıçta çalıştırdığınız iki konsol uygulaması C# kullanılarak yazılmıştır. Geliştirme makinenize .NET Core SDK sürüm 2.1.403 veya üstünü yükler. .NET Core SDK yüklüyse, geliştirme makinenizde geçerli C# sürümünü doğrulayın. dotnet --versionKomutunu bir komut isteminde çalıştırın.

  3. Örnek C# projesiniindirin. digital-twins-samples-csharp-master.zip arşivini ayıklayın.

Digital Twins örneği oluşturma

Bu bölümdeki adımları izleyerek portalda dijital TWINS 'in yeni bir örneğini oluşturun.

  1. Azure Portal oturum açın.

  2. Giriş yan çubuğunu seçin ve ardından kaynak oluştur ' atıklayın.

    Giriş yan çubuğunu genişletin ve + kaynak oluştur ' u seçin.

  3. Dijital TWINSaraması yapın ve dijital TWINS' i seçin.

    Yeni dijital TWINS örneği oluşturma seçimleri

    Alternatif olarak, nesnelerin internetiöğesini seçin ve dijital TWINS (Önizleme) öğesini seçin.

  4. Dağıtım işlemini başlatmak için Oluştur’u seçin.

    Kaynağın dağıtımını oluşturma ve onaylama

  5. Digital Twins bölmesine şu bilgileri girin:

    • Kaynak Adı: Digital Twins örneğiniz için benzersiz bir ad oluşturun.

    • Abonelik: Bu Digital Twins örneğini oluşturmak için kullanmak istediğiniz aboneliği seçin.

    • Kaynak grubu: Digital Twins örneği için bir kaynak grubu seçin veya oluşturun.

    • Konum: Cihazlarınıza en yakın konumu seçin.

      Girilen bilgileri içeren dijital TWINS bölmesi

  6. Dijital TWINS bilgilerinizi gözden geçirin ve ardından Oluştur' u seçin. Dijital TWINS örneğinizin oluşturulması birkaç dakika sürebilir. İlerleme durumunu Bildirimler bölmesinden izleyebilirsiniz.

  7. Digital Twins örneğinizin Genel Bakış bölmesini açın. Yönetim API 'sialtındaki bağlantıyı aklınızda edin. YÖNETIM API URL 'si şöyle biçimlendirilir:

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

    Bu URL, örneğiniz için geçerli olan Azure Digital Twins REST API belgesini açar. Bu API belgelerini okumayı ve kullanmayı öğrenmek için bkz. Azure Digital Twins Swagger'ı kullanma. YÖNETIM API 'si URL 'sini şu biçimde kopyalayın ve değiştirin:

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

    Uygulamanız, değiştirilen URL'yi örneğinize erişmek için temel URL olarak kullanır. Değiştirdiğiniz URL'yi geçici bir dosyaya kopyalayın. Bu, sonraki bölümde gerekecektir.

    Yönetim API 'sine genel bakış

Uygulamanızın izinlerini ayarlama

Bu bölüm, dijital TWINS örneğinizi erişebilmeleri için örnek uygulamanızı Azure Active Directory (Azure AD) olarak kaydeder. Zaten bir Azure AD uygulama kaydınız varsa, örnek için onu yeniden kullanın. Bu bölümde açıklandığı gibi yapılandırıldığından emin olun.

Not

Bu bölümde Azure AD uygulama kaydıiçin yönergeler sağlanmaktadır.

  1. Azure Portal, Genişletilebilir sol menüden Azure Active Directory açın ve uygulama kayıtları bölmesini açın.

    Azure Active Directory bölmesini seçin

  2. + Yeni kayıt düğmesini seçin.

    Yeni kayıt düğmesini seçin

  3. Ad kutusuna bu uygulama kaydı için kolay bir ad verin.

    1. Yeniden yönlendirme URI 'si (isteğe bağlı) bölümünde, https://microsoft.com metin kutusuna yazın.

    2. Azure Active Directory uygulamanız tarafından hangi hesapların ve kiracıların desteklendiğini doğrulayın.

    3. Kaydol’u seçin.

    Bölme oluştur

  4. Kimlik doğrulama dikey penceresi, önemli kimlik doğrulama yapılandırma ayarlarını belirtir.

    1. + Platform Ekle' ye tıklayarak yeniden yönlendirme URI 'Leri ekleyin ve erişim belirteçlerini yapılandırın.

    2. Uygulamanın ortak bir istemciolduğunu belirtmek için Evet ' i seçin.

    3. Azure Active Directory uygulamanız tarafından hangi hesapların ve kiracıların desteklendiğini doğrulayın.

    Ortak istemci yapılandırma ayarı

  5. Uygun platformu seçtikten sonra, yeniden yönlendirme URI 'larınızı ve yan paneldeki erişim belirteçlerinizi Kullanıcı arabiriminin sağına yapılandırın.

    1. Yeniden yönlendirme URI 'leri , kimlik doğrulama isteği tarafından sağlanan adresle eşleşmelidir:

      • Yerel bir geliştirme ortamında barındırılan uygulamalar için ortak istemci (mobil & Masaüstü) öğesini seçin. Ortak Istemciyi Evetolarak ayarladığınızdan emin olun.
      • Azure App Service barındırılan tek sayfalı uygulamalar için Web' i seçin.

    2. Oturum kapatma URL 'sinin uygun olup olmadığını belirleme.

    3. Erişim belirteçlerini veya kimlik belirteçlerinidenetleyerek örtük izin akışını etkinleştirin.

    Yeniden yönlendirme URI 'Lerini yapılandırma

    Yapılandır' a ve ardından Kaydet' e tıklayın.

  6. Kayıtlı uygulamanızın genel bakış bölmesini açın ve aşağıdaki varlıkların değerlerini geçici bir dosyaya kopyalayın. Aşağıdaki bölümlerde örnek uygulamanızı yapılandırmak için bu değerleri kullanacaksınız.

    • Uygulama (istemci) kimliği
    • Dizin (kiracı) kimliği

    Azure Active Directory uygulama KIMLIĞI

  7. Uygulama kaydınız için API izinleri bölmesini açın. + Izin Ekle düğmesini seçin. API Izinleri iste bölmesinde Kuruluşumun kullandığı API 'leri seçin ve ardından aşağıdakilerden birini arayın:

    1. Azure Digital Twins. Azure dijital TWINS API 'sini seçin.

      Arama API 'SI veya Azure dijital TWINS

    2. Alternatif olarak, araması yapın Azure Smart Spaces Service . Azure akıllı boşluklar hizmeti API 'sini seçin.

      Azure akıllı alanları için API arama

    Önemli

    Görüntülenecek Azure AD API adı ve KIMLIĞI, kiracınıza bağlı olarak değişir:

    • Test kiracısı ve müşteri hesapları için arama yapılmalıdır Azure Digital Twins .
    • Diğer Microsoft hesapları için arama yapılmalıdır Azure Smart Spaces Service .

  8. Her iki API de aynı istek API 'si izinleri bölmesinde seçildikten sonra Azure dijital TWINS olarak görünür. Oku açılan seçeneğini belirleyin ve ardından oku. yazma onay kutusunu seçin. Izin Ekle düğmesini seçin.

    API izinleri ekleme

  9. Kuruluşunuzun ayarlarına bağlı olarak, bu API 'ye yönetici erişimi sağlamak için ek adımlar gerçekleştirmeniz gerekebilir. Daha fazla bilgi için yöneticinize başvurun. Yönetici erişimi onaylandıktan sonra, API izinleri bölmesindeki yönetici onayı gerekli sütunu, izinlerinizi görüntüler.

    Yönetici onayı onayı

    Azure dijital TWINS 'in göründüğünü doğrulayın.

Uygulama oluşturma

Bu adımları izleyerek, öğrenci uygulamasını oluşturun.

  1. Bir komut istemi açın. digital-twins-samples-csharp-master.zipDosyalarınızın ayıklandığı klasöre gidin.

  2. cd occupancy-quickstart/src öğesini çalıştırın.

  3. dotnet restore öğesini çalıştırın.

  4. appSettings.json dosyasını düzenleyerek aşağıdaki değişkenleri güncelleştirin:

    • ClientID: önceki bölümde BELIRTILEN Azure AD uygulama KAYDLARıNıZıN uygulama kimliğini girin.
    • Kiracı: önceki bölümde da BELIRTILEN Azure AD kiracınızın dizin kimliğini girin.
    • BaseUrl: dijital TWINS ÖRNEĞINIZIN yönetim API 'si URL 'si biçimindedir https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/ . Bu URL 'deki yer tutucuları, önceki bölümde örneğinizin değerleriyle değiştirin.

    Güncelleştirilen dosyayı kaydedin.

Grafı sağlama

Bu adım, dijital TWINS uzamsal grafiklerinizi şunları sağlar:

  • Birkaç boşluk.
  • Bir cihaz.
  • İki algılayıcı.
  • Özel bir işlev.
  • Tek bir rol ataması.

Uzamsal grafik, Provisionsample. YAML dosyası kullanılarak sağlanır.

  1. dotnet run ProvisionSample öğesini çalıştırın.

    Not

    Azure AD 'de kullanıcının kimliğini doğrulamak için cihaz oturumu açma Azure CLı aracı kullanılır. Kullanıcı, Microsoft oturum açma sayfasını kullanarak kimlik doğrulamak için belirli bir kod girmelidir. Kod girildikten sonra kimlik doğrulaması için adımları izleyin. Araç çalışırken kullanıcının kimlik doğrulaması gerekir.

    İpucu

    Bu adımı çalıştırdığınızda, aşağıdaki hata iletisi görünürse değişkenlerinizin doğru şekilde kopyalandığından emin olun:EXIT: Unexpected error: The input is not a valid Base-64 string ...

  2. Sağlama adımı birkaç dakika sürebilir. Ayrıca, dijital TWINS örneğiniz içinde bir IoT Hub sağlar. IoT Hub durum = gösterdiği sürece döngüsü geçer Running .

    Örnek durum = çalışıyor olarak sağlama

  3. Yürütmenin sonunda cihazın ConnectionString cihaz simülatör örneğinde kullanılmak üzere cihazını kopyalayın. Yalnızca bu görüntüde özetlenen dizeyi kopyalayın.

    Bağlantı dizesini kopyalayın

    İpucu

    Azure dijital TWINS grafik Görüntüleyicisi 'nikullanarak uzamsal grafınızı görüntüleyebilir ve değiştirebilirsiniz.

Daha sonra kullanmak üzere konsol penceresini açık tutun.

Sensör verilerini gönderme

Aşağıdaki adımları izleyerek algılayıcı simülatörü cihaz uygulamasını derleyin ve çalıştırın.

  1. Yeni bir komut istemi açın. Klasörüne indirdiğiniz projeye gidin digital-twins-samples-csharp-master .

  2. cd device-connectivity öğesini çalıştırın.

  3. dotnet restore öğesini çalıştırın.

  4. Deviceconnectionstring 'i öncekiyle güncelleştirmek için appsettings.js' i düzenleyin ConnectionString . Güncelleştirilen dosyayı kaydedin.

  5. dotnet runAlgılayıcı verileri göndermeye başlamak için ' i çalıştırın. Aşağıdaki görüntüde gösterildiği gibi Azure dijital TWINS 'e gönderilir.

    Cihaz bağlantısı

  6. Sonraki adım eylemiyle sonuçları yan yana görüntüleyebilmeniz için bu simülatör çalışmasına izin verin. Bu pencere, dijital TWINS 'e gönderilen sanal algılayıcı verilerini gösterir. Sonraki adım, yeni uçak ile kullanılabilir odaları bulmak için gerçek zamanlı olarak sorgular.

    İpucu

    Bu adımı çalıştırdığınızda DeviceConnectionString aşağıdaki hata iletisi görüntülenirse doğru şekilde kopyalandığından emin olun:EXIT: Unexpected error: The input is not a valid Base-64 string ...

Temiz havaya sahip olan odaları bulma

Algılayıcı örneği, iki sensör için rastgele veri değerlerinin benzetimini yapar. Bunlar hareket ve karbon dioksit. Yeni AIR ile kullanılabilen boşluklar, odada bulunmayan bir şekilde örnekte tanımlanmıştır. Ayrıca, 1.000 ppm altında bir karbon dioksit düzeyi ile de tanımlanırlar. Koşul karşılanmazsa, alan kullanılamaz veya hava kalitesi zayıf olur.

  1. Daha önce sağlama adımını çalıştırmak için kullandığınız komut istemi ' ni açın.

  2. dotnet run GetAvailableAndFreshSpaces öğesini çalıştırın.

  3. Bu komut istemine ve algılayıcı verileri komut istemine yan yana bakın.

    Algılayıcı verileri komut istemi, her beş saniyede bir dijital TWINS 'e benzetimli hareket ve karbon dioksit verileri gönderir. Diğer komut istemi, rastgele sanal verilere göre yeni uçak ile kullanılabilir Odalar bulmak için grafı gerçek zamanlı olarak okur. Bu koşullardan birini, son gönderilen algılayıcı verilerine göre neredeyse gerçek zamanlı olarak görüntüler:

    • Room is available and air is fresh

    • Room is not available or air quality is poor

      Temiz havaya sahip olan odaları alma

Bu hızlı başlangıçta ne olduğunu ve hangi API 'Lerin çağrıldığını anlamak için, içinde bulunan kod çalışma alanı projesiyle Visual Studio Code açın digital-twins-samples-csharp . Aşağıdaki komutu kullanın:

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

Öğreticiler koda göre daha derin gider. Yapılandırma verilerini ve API 'Leri nasıl değiştireceğiniz hakkında öğretir. Yönetim API 'Leri hakkında daha fazla bilgi için dijital TWINS Swagger sayfanıza gidin:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
Name Şununla değiştir
YOUR_INSTANCE_NAME Dijital TWINS örneğinizin adı
YOUR_LOCATION Örneğinizin barındırıldığı sunucu bölgesi

Veya kolaylık sağlaması için, dijital TWINS Swaggeröğesine gidin.

Kaynakları temizleme

Öğreticiler şu şekilde bir ayrıntıya gider:

  • Tesis yöneticileri için, işant üretkenliğini artırmak üzere bir uygulama oluşturun.
  • Oluşturmayı daha verimli bir şekilde çalıştırın.

Öğreticilere devam etmek için, bu hızlı başlangıçta oluşturulan kaynakları temizlemeyin. Devam etmeyi planlamıyorsanız, bu hızlı başlangıç tarafından oluşturulan tüm kaynakları silin.

  1. Örnek depoyu indirdiğiniz sırada oluşturulan klasörü silin.

  2. Azure Portalsol taraftaki menüden tüm kaynaklar' ı seçin. Ardından dijital TWINS kaynağını seçin. Tüm kaynaklar bölmesinin en üstünde Sil' i seçin.

    İpucu

    Daha önce dijital TWINS örneğinizi silme konusunda sorun yaşıyorsanız, bu, düzeltmeyle birlikte bir hizmet güncelleştirmesi kullanıma alındı. Lütfen örneğinizi silmeyi yeniden deneyin.

Sonraki adımlar

Bu hızlı başlangıç, dijital TWINS 'in iyi çalışma koşullarına sahip odaları bulmak için nasıl kullanılabileceğini göstermek üzere basit bir senaryo ve örnek uygulamalar kullandı. Bu senaryonun derinlemesine çözümlenmesi için bu öğreticiyi okuyun:

Öğretici: Azure Digital Twins'i dağıtma ve uzamsal graf yapılandırma