Hızlı Başlangıç: Azure dijital İkizlerini kullanarak kullanılabilir odaları bulun.Quickstart: Find available rooms by using Azure Digital Twins

Azure dijital İkizlerini service, fiziksel ortamınızın dijital bir görüntüsünü yeniden oluşturmak sağlar.The Azure Digital Twins service allows you to re-create a digital image of your physical environment. Bu işlemin ardından ortamınızdaki olaylarla ilgili bildirimler alabilir ve verdiğiniz yanıtları özelleştirebilirsiniz.You can then get notified by events in your environment and customize your responses to them.

Bu hızlı başlangıçta kullanılmaktadır .NET örnekleri çifti sanal ofis binasını dijitalleştirerek.This quickstart uses a pair of .NET samples to digitize an imaginary office building. Bu yapı içinde kullanılabilir odaları nasıl gösterir.It shows you how to find available rooms in that building. Dijital İkizlerini kullanmaya birçok sensörlerden ortamınız ile ilişkilendirebilirsiniz.With Digital Twins, you can associate many sensors with your environment. Bunu ayrıca kullanılabilir odanıza hava kalitesini sanal algılayıcı tasarruf edilen karbon dioksit için Yardım en uygun olup olmadığını öğrenebilirsiniz.You also can find out if the air quality of your available room is optimal with the help of a simulated sensor for carbon dioxide. Örnek uygulamalarından biridir, bu senaryo görselleştirmenize yardımcı olmak için rastgele sensör verilerini oluşturur.One of the sample applications generates random sensor data to help you visualize this scenario.

Aşağıdaki videoda hızlı başlangıç ayarları özetlenir:The following video summarizes quickstart setup:

ÖnkoşullarPrerequisites

  1. Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.If you don't have an Azure account, create a free account before you begin.

  2. Bu hızlı başlangıçta çalıştırdığınız iki konsol uygulamaları kullanılarak yazılan C#.The two console applications you run in this quickstart are written by using C#. Yükleme .NET Core SDK'sı sürüm 2.1.403 veya yukarıdaki geliştirme makinenizde.Install the .NET Core SDK version 2.1.403 or above on your development machine. .NET Core SDK varsa, geçerli sürümünü doğrulama C# geliştirme makinenizde.If you have the .NET Core SDK installed, verify the current version of C# on your development machine. Çalıştırma dotnet --version bir komut isteminde.Run dotnet --version in a command prompt.

  3. İndirme örnek C# proje.Download the sample C# project. Dijital-twins-samples-csharp-master.zip arşivini ayıklayın.Extract the digital-twins-samples-csharp-master.zip archive.

Digital Twins örneği oluşturmaCreate a Digital Twins instance

Dijital İkizlerini yeni bir örneğini oluşturma portalı bu bölümdeki adımları izleyerek.Create a new instance of Digital Twins in the portal by following the steps in this section.

  1. Azure portalında oturum açın.Sign in to the Azure portal.

  2. Giriş yan çubuğunu seçin ve ardından kaynak oluştur ' atıklayın.Select the home side-bar, then + Create a resource.

    giriş yan çubuğunu genişletip + kaynak oluştur ' u seçin.Expand the home side-bar, then select + Create a resource

  3. Dijital TWINSaraması yapın ve dijital TWINS' i seçin.Search for Digital Twins, and select Digital Twins.

    Yeni bir dijital TWINS örneği oluşturmak için seçimleriSelections for creating a new Digital Twins instance

    Alternatif olarak, nesnelerin internetiöğesini seçin ve dijital TWINS (Önizleme) öğesini seçin.Alternatively, select Internet of Things, and select Digital Twins (preview).

  4. Dağıtım işlemini başlatmak için Oluştur’u seçin.Select Create to start the deployment process.

    kaynağın dağıtımını oluşturma ve onaylamaCreate and confirm the deployment of the resource

  5. Digital Twins bölmesine şu bilgileri girin:In the Digital Twins pane, enter the following information:

    • Kaynak Adı: Digital Twins örneğiniz için benzersiz bir ad oluşturun.Resource Name: Create a unique name for your Digital Twins instance.

    • Abonelik: Bu Digital Twins örneğini oluşturmak için kullanmak istediğiniz aboneliği seçin.Subscription: Choose the subscription that you want to use to create this Digital Twins instance.

    • Kaynak grubu: Digital Twins örneği için bir kaynak grubu seçin veya oluşturun.Resource group: Select or create a resource group for the Digital Twins instance.

    • Konum: Cihazlarınıza en yakın konumu seçin.Location: Select the closest location to your devices.

      girilen bilgilerle dijital TWINS bölmesi Digital Twins pane with entered information

  6. Dijital TWINS bilgilerinizi gözden geçirin ve ardından Oluştur' u seçin.Review your Digital Twins information, and then select Create. Dijital TWINS örneğinizin oluşturulması birkaç dakika sürebilir.Your Digital Twins instance might take a few minutes to be created. İlerleme durumunu Bildirimler bölmesinden izleyebilirsiniz.You can monitor the progress in the Notifications pane.

  7. Digital Twins örneğinizin Genel Bakış bölmesini açın.Open the Overview pane of your Digital Twins instance. Yönetim API 'sialtındaki bağlantıyı aklınızda edin.Note the link under Management API. YÖNETIM API URL 'si şöyle biçimlendirilir:The Management API URL is formatted as:

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

    Bu URL, örneğiniz için geçerli olan Azure Digital Twins REST API belgesini açar.This URL takes you to the Azure Digital Twins REST API documentation that applies to your instance. Bu API belgelerini okumayı ve kullanmayı öğrenmek için bkz. Azure Digital Twins Swagger'ı kullanma.Read How to use Azure Digital Twins Swagger to learn how to read and use this API documentation. YÖNETIM API 'si URL 'sini şu biçimde kopyalayın ve değiştirin:Copy and modify the Management API URL to this format:

    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.Your application will use the modified URL as the base URL to access your instance. Değiştirdiğiniz URL'yi geçici bir dosyaya kopyalayın.Copy this modified URL to a temporary file. Bu, sonraki bölümde gerekecektir.You'll need this in the next section.

    yönetim API 'sine genel bakışManagement API overview

Uygulamanızın izinlerini ayarlamaSet permissions for your app

Dijital İkizlerini örneğinizin erişebilmesi için bu bölümde, örnek uygulamanızı Azure Active Directory (Azure AD) kaydeder.This section registers your sample application to Azure Active Directory (Azure AD) so that it can access your Digital Twins instance. Bir Azure AD uygulama kaydı zaten varsa, Örneğiniz için yeniden kullanın.If you already have an Azure AD app registration, reuse it for your sample. Bu bölümde açıklanan şekilde yapılandırıldığından emin olun.Make sure that it's configured as described in this section.

Not

Bu bölümde Azure AD uygulama kaydıiçin yönergeler sağlanmaktadır.This section provides instructions for Azure AD app registration.

  1. Azure Portal, Genişletilebilir sol menüden Azure Active Directory açın ve uygulama kayıtları bölmesini açın.In the Azure portal, open Azure Active Directory from the expandable left menu, and then open the App registrations pane.

    Azure Active Directory bölmesini seçinSelect the Azure Active Directory pane

  2. + Yeni kayıt düğmesini seçin.Select the + New registration button.

    yeni kayıt düğmesini seçinSelect the New registration button

  3. Ad kutusuna bu uygulama kaydı için kolay bir ad verin.Give a friendly name for this app registration in the Name box. Yeniden yönlendirme URI 'si (isteğe bağlı) bölümünde, sol taraftaki açılan menüden ortak istemci/yerel (mobil & Masaüstü) öğesini seçin ve sağdaki metin kutusuna https://microsoft.com girin.Under the Redirect URI (optional) section, choose Public client/native (mobile & desktop) in the drop-down menu on the left, and enter https://microsoft.com in the textbox on the right. Kaydol’u seçin.Select Register.

    oluştur bölmesiCreate pane

  4. Uygulamanın bir ortak istemciolarak kaydedildiğindenemin olmak için, uygulama kaydlarınızın kimlik doğrulama bölmesini açın ve bu bölmeyi aşağı kaydırın.To make sure that the app is registered as a public client, open the Authentication pane for your app registration, and scroll down in that pane. Varsayılan istemci türü bölümünde, uygulamayı ortak istemci olarak değerlendir' i seçin ve Kaydet' i tıklayın.In the Default client type section, choose Yes for Treat application as a public client, and hit Save.

    Manifest. JSON 'inizdeki oauth2AllowImplicitFlow ayarını etkinleştirmek için erişim belirteçlerini denetleyin.Check Access tokens to enable the oauth2AllowImplicitFlow setting in your Manifest.json.

    ortak istemci yapılandırma ayarıPublic client configuration setting

  5. 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.Open the Overview pane of your registered app, and copy the values of the following entities to a temporary file. Aşağıdaki bölümlerde örnek uygulamanızı yapılandırmak için bu değerleri kullanacaksınız.You'll use these values to configure your sample application in the following sections.

    • Uygulama (istemci) KIMLIĞIApplication (client) ID
    • Dizin (kiracı) KIMLIĞIDirectory (tenant) ID

    Azure Active Directory uygulama KIMLIĞIAzure Active Directory application ID

  6. Uygulama kaydınız için API izinleri bölmesini açın.Open the API permissions pane for your app registration. + Izin Ekle düğmesini seçin.Select + Add a permission button. API Izinleri iste bölmesinde Kuruluşumun kullandığı API 'leri seçin ve ardından aşağıdakilerden birini arayın:In the Request API permissions pane, select the APIs my organization uses tab, and then search for one of the following:

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

      arama API 'SI veya Azure dijital TWINSSearch API or Azure Digital Twins

    2. Alternatif olarak, Azure Smart Spaces Serviceiçin arama yapın.Alternatively, search for Azure Smart Spaces Service. Azure akıllı boşluklar hizmeti API 'sini seçin.Select the Azure Smart Spaces Service API.

      Azure akıllı alanları için Search API Search API for Azure Smart Spaces

    Önemli

    Görüntülenecek Azure AD API adı ve KIMLIĞI, kiracınıza bağlı olarak değişir:The Azure AD API name and ID that will appear depends on your tenant:

    • Test kiracının ve müşteri hesaplarının Azure Digital Twinsaraması gerekir.Test tenant and customer accounts should search for Azure Digital Twins.
    • Diğer Microsoft hesaplarının Azure Smart Spaces Servicearaması gerekir.Other Microsoft accounts should search for Azure Smart Spaces Service.
  7. Her iki API, aynı istek API 'si izinleri bölmesinde Azure dijital TWINS olarak gösterilir.Either API once selected shows up as Azure Digital Twins in the same Request API permissions pane. Oku açılan seçeneğini belirleyin ve ardından oku. yazma onay kutusunu seçin.Select the Read drop-down option, and then select the Read.Write checkbox. Izin Ekle düğmesini seçin.Select the Add permissions button.

    API izinleri eklemeAdd API permissions

  8. 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.Depending on your organization's settings, you might need to take additional steps to grant admin access to this API. Daha fazla bilgi için yöneticinize başvurun.Contact your administrator for more information. Yönetici erişimi onaylandıktan sonra, API izinleri bölmesindeki yönetici onayı gerekli sütunu, izinlerinizi görüntüler.Once the admin access is approved, the Admin Consent Required column in the API permissions pane will display your permissions.

    Yönetici onay onayını Admin consent approval

    Azure dijital TWINS 'in göründüğünü doğrulayın.Verify that Azure Digital Twins appears.

Uygulama oluşturmaBuild application

Sahiplik uygulamayı aşağıdaki adımları izleyerek oluşturun.Build the occupancy application by following these steps.

  1. Bir komut istemi açın.Open a command prompt. digital-twins-samples-csharp-master.zip dosyalarınızın ayıklandığı klasöre gidin.Go to the folder where your digital-twins-samples-csharp-master.zip files were extracted.

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

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

  4. appSettings.json dosyasını düzenleyerek aşağıdaki değişkenleri güncelleştirin:Edit appSettings.json to update the following variables:

    • ClientID: önceki bölümde belirtilen Azure AD uygulama kaydı uygulama Kimliğini girin.ClientId: Enter the Application ID of your Azure AD app registration, noted in the preceding section.
    • Kiracı: Ayrıca önceki bölümde belirtilen Azure AD kiracınızda dizin Kimliğini girin.Tenant: Enter the Directory ID of your Azure AD tenant, also noted in the previous section.
    • BaseUrl: dijital İkizlerini örneğinizin yönetim API URL biçiminde olan https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/.BaseUrl: The Management API URL of your Digital Twins instance is in the format https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Bu URL içindeki yer tutucuları önceki bölümde Örneğiniz için değerlerle değiştirin.Replace the placeholders in this URL with values for your instance from the previous section.

    Güncelleştirilen dosyayı kaydedin.Save the updated file.

Grafı sağlamaProvision graph

Bu adım, dijital İkizlerini uzamsal grafik ile sağlar:This step provisions your Digital Twins spatial graph with:

  • Çeşitli alanları.Several spaces.
  • Bir cihaz.One device.
  • İki algılayıcılar.Two sensors.
  • Özel bir işlev.A custom function.
  • Bir rol ataması.One role assignment.

Uzamsal graph kullanılarak sağlanan provisionSample.yaml dosya.The spatial graph is provisioned by using the provisionSample.yaml file.

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

    Not

    Cihaz oturum açma Azure CLI aracını, Azure ad kullanıcının kimliğini doğrulamak için kullanılır.The Device Login Azure CLI tool is used to authenticate the user to Azure AD. Kullanıcı kimlik doğrulaması için belirli bir kod girmeden Microsoft oturum açma sayfası.The user must enter a given code to authenticate by using the Microsoft login page. İlgili kod girildikten sonra kimlik doğrulaması için adımları izleyin.After code is entered, follow the steps to authenticate. Aracı çalıştırırken, kullanıcının kimliğini doğrulaması gerekir.The user must authenticate when the tool is running.

    İpucu

    Bu adımı çalıştırdığınızda aşağıdaki hata iletisi görüntülenirse, değişkenlerinizi düzgün bir şekilde kopyalanan emin olun: EXIT: Unexpected error: The input is not a valid Base-64 string ...When you run this step, make sure your variables were copied properly if the following error message appears: EXIT: Unexpected error: The input is not a valid Base-64 string ...

  2. Sağlama adım birkaç dakika sürebilir.The provisioning step might take a few minutes. Ayrıca, IOT hub'ı dijital İkizlerini örneğinizin içinde sağlar.It also provisions an IoT Hub within your Digital Twins instance. IOT hub'ı durum gösterilene kadar aracılığıyla döngü =Running.It loops through until the IoT Hub shows Status=Running.

    örnek durum = çalışıyor sağlamaProvision the sample - Status=Running

  3. Yürütme sonunda kopyalama ConnectionString cihazın kullanılmak üzere cihaz simülatörü örnek.At the end of the execution, copy the ConnectionString of the device for use in the device simulator sample. Yalnızca bu görüntüde ana hatlarıyla belirtilen dizeyi kopyalayın.Copy only the string outlined in this image.

    bağlantı dizesini kopyalamak Copy the connection string

    İpucu

    Görüntüleyebilir ve uzamsal graph aracılığıyla değiştirmek Azure dijital İkizlerini graf Görüntüleyicisi.You can view and modify your spatial graph using the Azure Digital Twins Graph Viewer.

Daha sonra kullanmak üzere konsol penceresini açık tutun.Keep the console window open for use again later.

Sensör verilerini göndermeSend sensor data

Aşağıdaki adımları izleyerek algılayıcı simülatörü cihaz uygulamasını derleyin ve çalıştırın.Build and run the sensor simulator device application by following these steps.

  1. Yeni bir komut istemi açın.Open a new command prompt. digital-twins-samples-csharp-master klasörüne indirdiğiniz projeye gidin.Go to the project you downloaded in the digital-twins-samples-csharp-master folder.

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

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

  4. Düzen appsettings.json güncelleştirilecek DeviceConnectionString önceki ile ConnectionString.Edit appsettings.json to update DeviceConnectionString with the previous ConnectionString. Güncelleştirilen dosyayı kaydedin.Save the updated file.

  5. Çalıştırma dotnet run sensör verilerini göndermeyi başlatamadı.%n%nolası.Run dotnet run to start sending sensor data. Aşağıdaki görüntüde gösterildiği gibi sayısal çiftleri için gönderilen görürsünüz.You see it sent to Digital Twins as shown in the following image.

    cihaz bağlantısıDevice Connectivity

  6. Bu simülatörünü çalıştırın, böylece sonraki adım eylemi ile yan yana sonuçlarını görüntüleyebilirsiniz olanak tanır.Let this simulator run so that you can view results side by side with the next step action. Bu pencere dijital çiftleri için gönderilen sanal sensör verilerini gösterir.This window shows you the simulated sensor data sent to Digital Twins. Sonraki adım sorgular gerçek zamanlı olarak güncel hava ile kullanılabilir odaları bulunacak.The next step queries in real time to find available rooms with fresh air.

    İpucu

    Bu adımı çalıştırdığınızda emin DeviceConnectionString aşağıdaki hata iletisi görüntülenirse düzgün bir şekilde kopyalandı: EXIT: Unexpected error: The input is not a valid Base-64 string ...When you run this step, make sure DeviceConnectionString was copied properly if the following error message appears: EXIT: Unexpected error: The input is not a valid Base-64 string ...

Temiz havaya sahip olan odaları bulmaFind available spaces with fresh air

Sensör örnek iki algılayıcılar için rastgele veri değerleri benzetimini yapar.The sensor sample simulates random data values for two sensors. Bunlar, hareket ve tasarruf edilen karbon dioksit hedeflenmiştir.They're motion and carbon dioxide. Kullanılabilir alanları ile yeni hava örnekte hiçbir durum odadaki tanımlanır.Available spaces with fresh air are defined in the sample by no presence in the room. Ayrıca bir tasarruf edilen karbon dioksit düzeyi altında 1.000 ppm tanımlı.They're also defined by a carbon dioxide level under 1,000 ppm. Koşul yerine değil, alanı mevcut değil veya uzaktan kalite düşük.If the condition isn't fulfilled, the space isn't available or the air quality is poor.

  1. Daha önce sağlama adımını çalıştırmak için kullandığınız komut istemi ' ni açın.Open the command prompt you used to run the provisioning step earlier.

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

  3. Bu komut istemi ve sensör verilerini komut istemi yan yana bakın.Look at this command prompt and the sensor data command prompt side by side.

    Algılayıcı verileri komut istemi, her beş saniyede bir dijital TWINS 'e benzetimli hareket ve karbon dioksit verileri gönderir.The sensor data command prompt sends simulated motion and carbon dioxide data to Digital Twins every five seconds. 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.The other command prompt reads the graph in real time to find out available rooms with fresh air based on random simulated data. Bu koşullardan biri son gönderilen algılayıcı verileri temel alan neredeyse gerçek zamanlı gösterir:It displays one of these conditions in near real time based on the sensor data that was sent last:

    • Room is available and air is fresh

    • Room is not available or air quality is poor

      yeni hava ile kullanılabilir alanlar AlGet available spaces with fresh air

Bu hızlı başlangıçta ne olduğunu ve hangi API 'Lerin çağrıldığını anlamak için, digital-twins-samples-csharp' de bulunan kod çalışma alanı projesiyle Visual Studio Code açın.To understand what happened in this quickstart and what APIs were called, open Visual Studio Code with the code workspace project found in digital-twins-samples-csharp. Aşağıdaki komutu kullanın:Use the following command:

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

Öğreticiler, derin koda gidin.The tutorials go deep into the code. Bunlar, yapılandırma verisini değiştirmesine nasıl ve hangi API'ler çağrıldığında öğretin.They teach you how to modify configuration data and what APIs are called. Yönetim API'leri hakkında daha fazla bilgi için dijital İkizlerini Swagger sayfanıza gidin:For more information on Management APIs, go to your Digital Twins Swagger page:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
AdName Şununla değiştirReplace with
YOUR_INSTANCE_NAMEYOUR_INSTANCE_NAME Dijital İkizlerini örneğinizin adıThe name of your Digital Twins instance
YOUR_LOCATIONYOUR_LOCATION Örneğinizin barındırıldığı sunucu bölgesiThe server region where your instance is hosted

Veya kolaylık sağlamak için göz atın dijital İkizlerini Swagger.Or for convenience, browse to Digital Twins Swagger.

Kaynakları temizlemeClean up resources

Öğreticiler kullanma hakkında daha fazla ayrıntıya gidin:The tutorials go into detail about how to:

  • Tesis yöneticilerinin occupant üretkenliği artırmak için bir uygulama oluşturun.Build an application for facility managers to increase occupant productivity.
  • Oluşturmaya çalışması daha verimli bir şekilde.Operate the building more efficiently.

Öğreticilerine devam etmek için kaynakları oluşturulan temizlemeyin Bu hızlı başlangıçta.To continue to the tutorials, don't clean up the resources created in this quickstart. Devam etmeyi planlamıyorsanız, bu hızlı başlangıç ile oluşturulan tüm kaynakları silin.If you don't plan to continue, delete all the resources created by this quickstart.

  1. Örnek depoyu indirildiğinde oluşturduğunuz klasörü silin.Delete the folder that was created when you downloaded the sample repository.

  2. İçinde soldaki menüden Azure portalındaseçin tüm kaynakları.From the menu on the left in the Azure portal, select All resources. Ardından dijital İkizlerini kaynağınızı seçin.Then select your Digital Twins resource. Üst kısmındaki tüm kaynakları bölmesinde Sil.At the top of the All resources pane, select Delete.

    İ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ı.If you previously experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. Örneğiniz silme yeniden deneyin.Please retry deleting your instance.

Sonraki adımlarNext steps

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ı.This quickstart used a simple scenario and sample applications to show how Digital Twins can be used to find rooms with good working conditions. Bu senaryonun ayrıntılı analiz için bu öğreticiye bakın:For in-depth analysis of this scenario, see this tutorial: