Öğretici: Azure dijital TWINS önizlemesi dağıtma ve uzamsal bir grafik yapılandırmaTutorial: Deploy Azure Digital Twins Preview and configure a spatial graph

Azure Digital TWINS önizleme hizmetini kullanarak, kişileri, yerleri ve cihazları tutarlı bir uzamsal sisteme bir araya getirebilirsiniz.You can use the Azure Digital Twins Preview service to bring together people, places, and devices in a coherent spatial system. Bu öğretici serisinde, sıcaklık ve hava kalitesinin en iyi koşullarına sahip oda dolışını algılamak için Azure dijital TWINS 'in nasıl kullanılacağı gösterilmektedir.This series of tutorials demonstrates how to use Azure Digital Twins to detect room occupancy with optimal conditions of temperature and air quality.

Bu öğreticiler, bir Office binasının senaryosunu oluşturmak için bir .NET konsol uygulamasında size kılavuzluk eder.These tutorials will walk you through a .NET console application to build a scenario of an office building. Binanın her bir tabandaki birden fazla kat ve oda vardır.The building has multiple floors and rooms within each floor. Odalar, hareket, çevresel sıcaklık ve hava kalitesini algılayan eklenmiş sensörlerle cihazları içerir.The rooms contain devices with attached sensors that detect motion, ambient temperature, and air quality.

Azure Digital TWINS hizmetini kullanarak bina Dijital nesnelerinde fiziksel alanların ve varlıkların nasıl çoğaltılacağını öğreneceksiniz.You'll learn how to replicate the physical areas and entities in the building as digital objects by using the Azure Digital Twins service. Başka bir konsol uygulaması kullanarak cihaz olaylarını benzetireceksiniz.You'll simulate device events by using another console application. Daha sonra, bu fiziksel alanlardan ve varlıklardan neredeyse gerçek zamanlı olarak gelen olayların nasıl izleneceğini öğreneceksiniz.Then, you'll learn how to monitor the events that come from these physical areas and entities in near real time.

Office Yöneticisi bu bilgileri kullanarak, bu binada çalışan bir çalışanın en iyi koşullara sahip toplantı odalarını defterlerine yardımcı olur.An office administrator can use this information to help an employee working in this building to book meeting rooms with optimal conditions. Office tesisler Yöneticisi, odaların kullanım eğilimlerini almak ve bakım amaçlarıyla çalışma koşullarını izlemek için kurulumunuzu kullanabilir.An office facilities manager can use your setup to get usage trends of the rooms, and to monitor working conditions for maintenance purposes.

Bu serinin ilk öğreticisinde şunları yapmayı öğreneceksiniz:In the first tutorial of this series, you learn how to:

  • Dijital TWINS dağıtın.Deploy Digital Twins.
  • Uygulamanıza izin verin.Grant permissions to your app.
  • Dijital bir TWINS örnek uygulamasını değiştirme.Modify a Digital Twins sample app.
  • Binınızı sağlayın.Provision your building.

Bu öğreticiler, kavramların daha ayrıntılı ve derinlemesine bir kapsamı için, kullanılabilir odaları bulmak için hızlı başlangıç ile aynı örnekleri kullanır ve değiştirir.These tutorials use and modify the same samples that the quickstart to find available rooms uses, for a more detailed and in-depth coverage of the concepts.

PrerequisitesPrerequisites

  • Bir Azure aboneliği.An Azure subscription. Azure hesabınız yoksa ücretsiz bir hesapoluşturun.If you don’t have an Azure account, create a free account.

  • .NET Core SDK.The .NET Core SDK. Bu öğreticilerde kullanılan Azure dijital TWINS örnekleri içinde C#yazılmıştır.The Azure Digital Twins samples used in these tutorials are written in C#. Örneği derlemek ve çalıştırmak için geliştirme makinenize .NET Core SDK sürüm 2.1.403 veya sonraki bir sürümü yüklediğinizden emin olun.Make sure to install .NET Core SDK version 2.1.403 or later on your development machine to build and run the sample. Bir komut penceresinde dotnet --version çalıştırarak doğru sürümün makinenizde yüklü olduğundan emin olun.Check that the right version is installed on your machine by running dotnet --version in a command window.

  • Örnek kodu araştırmak için Visual Studio Code .Visual Studio Code to explore the sample code.

Dijital TWINS dağıtmaDeploy Digital Twins

Azure Digital TWINS hizmetinin yeni bir örneğini oluşturmak için bu bölümdeki adımları kullanın.Use the steps in this section to create a new instance of the Azure Digital Twins service. Her abonelik için yalnızca bir örnek oluşturulabilir.Only one instance can be created per subscription. Zaten çalışır durumda olan bir sonraki bölüme atlayın.Skip to the next section if you already have one running.

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

  2. Sol bölmeden kaynak oluştur' u seçin.From the left pane, select Create a resource. Dijital TWINSaraması yapın ve dijital TWINS' i seçin.Search for digital twins, and select Digital Twins. Dağıtım işlemini başlatmak için Oluştur ' u seçin.Select Create to start the deployment process.

     yeni bir dijital TWINS örneği oluşturmaya yönelik seçimlerSelections for creating a new Digital Twins instance

  3. Dijital TWINS bölmesinde aşağıdaki bilgileri girin:In the Digital Twins pane, enter the following information:

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

    • Abonelik: Bu dijital 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: dijital 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ızın en yakın konumunu seçin.Location: Select the closest location to your devices.

      Dijital TWINS bölmesi, girilen bilgilerle birlikteDigital Twins pane with entered information

  4. 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ölmesinde izleyebilirsiniz.You can monitor the progress in the Notifications pane.

  5. Dijital 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 https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/swagger olarak biçimlendirilir.The Management API URL is formatted as https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/swagger. Bu URL sizi, örneğiniz için geçerli olan Azure dijital TWINS REST API belgelerine götürür.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 Azure Digital TWINS Swagger 'Yi nasıl kullanacağınızı okuyun.Read How to use Azure Digital Twins Swagger to learn how to read and use this API documentation.

    YÖNETIM API 'si URL 'sini bu biçimle değiştirin https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/.Modify the Management API URL to this format https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Uygulamanız, örneğinize erişmek için temel URL olarak değiştirilen URL 'yi kullanacaktır.Your application will use the modified URL as the base URL to access your instance. Bu değiştirilmiş 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 'SIManagement API

Uygulamanıza izin verinGrant permissions to your app

Dijital TWINS, hizmete okuma/yazma erişimini denetlemek için Azure ACTIVE DIRECTORY (Azure AD) kullanır.Digital Twins uses Azure Active Directory (Azure AD) to control read/write access to the service. Dijital TWINS örneğinizle bağlantı kurmak için gereken tüm uygulamaların Azure AD 'ye kayıtlı olması gerekir.Any application that needs to connect with your Digital Twins instance must be registered with Azure AD. Bu bölümdeki adımlarda, örnek uygulamanızın nasıl kaydedileceği gösterilmektedir.The steps in this section show how to register your sample app.

Zaten bir uygulama kaydınız varsa, örnek için onu yeniden kullanabilirsiniz.If you already have an app registration, you can reuse it for your sample. Ancak, uygulama kaydlarınızın doğru şekilde yapılandırıldığından emin olmak için bu bölüme göz atabilirsiniz.However, browse through this section to make sure your app registration is configured correctly.

Not

Bu bölüm, yeni Azure AD uygulama kaydıiçin yönergeler sağlar.This section provides instructions for the new Azure AD app registration. Hala eski bir yerel uygulama kaydınız varsa, desteklenmiş olduğu sürece bu dosyayı kullanabilirsiniz.If you still have legacy native app registration, you may use it as long as it's supported. Ek olarak, bazı nedenlerle uygulama kayıt defteri 'nin yeni yolu kurulumda çalışmadıysanız, eski bir yerel AAD uygulaması oluşturmayı deneyebilirsiniz.Additionally, if for some reason the new way of app registation is not working in your setup, you may try to create a legacy native AAD app. Daha fazla yönerge için Azure dijital Twins uygulamanızı Azure Active Directory eski adıyla kaydet bölümünü okuyun.Read Register your Azure Digital Twins app with Azure Active Directory legacy for more instructions.

  1. Azure Portalsol bölmeden Azure Active Directory açın ve uygulama kayıtları bölmesini açın.In the Azure portal, open Azure Active Directory from the left pane, and then open the App registrations pane. Yeni kayıt düğmesini seçin.Select the New registration button.

    Uygulama kaydedildiApp registered

  2. 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 kutuda ortak istemci (mobil & Masaüstü) öğesini seçin ve sağdaki metin kutusuna https://microsoft.com girin.Under the Redirect URI (optional) section, choose Public client (mobile & desktop) in the drop-down on the left, and enter https://microsoft.com in the textbox on the right. Kaydol' u seçin.Select Register.

     pencere oluşturCreate pane

  3. Uygulamanın yerel bir uygulamaolarak 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 native app, 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ğerlendiriçin Evet ' i seçin.In the Default client type section, choose Yes for Treat application as a public client.

     varsayılan yerelDefault native

  4. 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 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

  5. 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 şunu arayın:In the Request API permissions pane, select the APIs my organization uses tab, and then search for:

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

      Search API veya Azure dijital TWINSSearch API or Azure Digital Twins

    2. Alternatif olarak, Azure Smart Spaces Service ' ı arayı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ı boşluklar için API aramaSearch 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ısı ve müşteri hesaplarının Azure Digital Twins araması gerekir.Test tenant and customer accounts should search for Azure Digital Twins.
    • Diğer Microsoft hesaplarının Azure Smart Spaces Service araması gerekir.Other Microsoft accounts should search for Azure Smart Spaces Service.
  6. Seçilen API, aynı istek API 'si izinleri bölmesinde Azure dijital TWINS olarak gösterilir.The selected API shows up as Azure Digital Twins in the same Request API permissions pane. Oku (1) açılır öğesini seçin ve ardından oku. yazma onay kutusunu seçin.Select the Read (1) drop down, and then select Read.Write checkbox. Izin Ekle düğmesini seçin.Select the Add permissions button.

    Apı izinleri eklemeAdd API permissions

  7. 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, API 'leriniz için aşağıdakine benzer şekilde görünür:Once the admin access is approved, the ADMIN CONSENT REQUIRED column in the API permissions pane will show similar to the following for your APIs:

    Apı izinleri eklemeAdd API permissions

Dijital TWINS örneğini yapılandırmaConfigure the Digital Twins sample

Bu bölümde, dijital TWıNS REST API 'leriile iletişim kuran bir Azure dijital TWINS uygulaması adım adım açıklanmaktadır.This section walks you through an Azure Digital Twins application that communicates with the Digital Twins REST APIs.

Örneği indirinDownload the sample

Hızlı başlangıç için yüklenmiş örnekleri zaten varsa, mevcut odaları bulmak içinbu adımları atlayabilirsiniz.If you already have the samples downloaded for the quickstart to find available rooms, you can skip these steps.

  1. Dijital TWINS .net örnekleriniindirin.Download the Digital Twins .NET samples.
  2. Makinenizde zip klasörünün içeriğini ayıklayın.Extract the contents of the zip folder on your machine.

Örneği keşfetExplore the sample

Ayıklanan örnek klasöründe, Digital-Twins-Samples-csharp\digital-Twins-Samples.Code-Workspace dosyasını Visual Studio Code açın.In the extracted sample folder, open the file digital-twins-samples-csharp\digital-twins-samples.code-workspace in Visual Studio Code. İki proje içerir:It contains two projects:

  • Bir uzamsal zeka grafiğiniyapılandırmak ve sağlamak için örnek ön hızlı başlangıç sağlama örneğini kullanabilirsiniz.You can use the provisioning sample occupancy-quickstart to configure and provision a spatial intelligence graph. Bu grafik, fiziksel boşlukların ve içerdikleri kaynakların sayısal görüntüsüdür.This graph is the digitized image of your physical spaces and the resources in them. Akıllı bir bina için nesneleri tanımlayan bir nesne modelikullanır.It uses an object model, which defines objects for a smart building. Dijital TWINS nesnelerinin ve REST API 'lerinin tüm listesi için, bu REST API belgelerini veya örneğiniziçin oluşturulmuş yönetim API URL 'sini ziyaret edin.For a complete list of Digital Twins objects and REST APIs, visit this REST API documentation or the Management API URL that was created for your instance.

    Dijital TWINS örneğiniz ile nasıl iletişim kuracağını görmek üzere örneği araştırmak için src\actions klasörüyle başlayabilirsiniz.To explore the sample to see how it communicates with your Digital Twins instance, you can start with the src\actions folder. Bu klasördeki dosyalar, bu öğreticilerde kullanacağınız komutları uygular:The files in this folder implement the commands that you'll use in these tutorials:

    • ProvisionSample.cs dosyası, uzamsal grafınızı nasıl sağlayacağınızı gösterir.The provisionSample.cs file shows how to provision your spatial graph.
    • GetSpaces.cs dosyası, sağlanan alanlarla ilgili bilgileri alır.The getSpaces.cs file gets information about the provisioned spaces.
    • GetAvailableAndFreshSpaces.cs dosyası, Kullanıcı tanımlı işlev olarak adlandırılan özel bir işlevin sonuçlarını alır.The getAvailableAndFreshSpaces.cs file gets the results of a custom function called a user-defined function.
    • CreateEndpoints.cs dosyası diğer hizmetlerle etkileşimde bulunmak için uç noktalar oluşturur.The createEndpoints.cs file creates endpoints to interact with other services.
  • Simülasyon örneği cihaz bağlantısı , algılayıcı verilerinin benzetimini yapar ve bunu dijital TWINS örneğiniz Için sağlanan IoT Hub 'ına gönderir.The simulation sample device-connectivity simulates sensor data and sends it to the IoT hub that's provisioned for your Digital Twins instance. Bu örneği , uzamsal grafınızı sağladığınızda sonraki öğreticidekullanacaksınız.You'll use this sample in the next tutorial after you provision your spatial graph. Bu örneği yapılandırmak için kullandığınız algılayıcı ve cihaz tanımlayıcıları, grafınızı sağlamak için kullanacağınız ile aynı olmalıdır.The sensor and device identifiers that you use to configure this sample should be the same as what you'll use to provision your graph.

Sağlama örneğini yapılandırmaConfigure the provisioning sample

  1. Bir komut penceresi açın ve indirilen örneğe gidin.Open a command window and go to the downloaded sample. Şu komutu çalıştırın:Run the following command:

    cd occupancy-quickstart/src
    
  2. Şu komutu çalıştırarak bağımlılıkları örnek projeye geri yükleyin:Restore dependencies to the sample project by running this command:

    dotnet restore
    
  3. Visual Studio Code, is-QuickStart projesinde appSettings. JSON dosyasını açın.In Visual Studio Code, open the appSettings.json file in the occupancy-quickstart project. Aşağıdaki değerleri güncelleştirin:Update the following values:

    • ClientID: Azure AD uygulama kaydlarınızın uygulama kimliğini girin.ClientId: Enter the application ID of your Azure AD app registration. Uygulama izinlerini ayarladığınızbölümde bu kimliği not etmiştiniz.You noted this ID in the section where you set app permissions.
    • Kiracı: Azure AD KIRACıNıZıNdizin kimliğini girin.Tenant: Enter the directory ID of your Azure AD tenant. Ayrıca, bu KIMLIĞI uygulama izinlerini ayarladığınızbölümde de not etmiştiniz.You also noted this ID in the section where you set app permissions.
    • BaseUrl: dijital TWINS örneğinizin URL 'sini girin.BaseUrl: Enter the URL of your Digital Twins instance. Bu URL 'YI almak için, bu URL 'deki yer tutucuları örneğinizin değerleriyle değiştirin: https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/.To get this URL, replace the placeholders in this URL with values for your instance: https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Dağıtım bölümündeyönetim API URL 'sini değiştirerek bu URL 'yi de alabilirsiniz.You can also get this URL by modifying the Management API URL from the deployment section. Swagger/ , api/v 1.0/ ile değiştirin.Replace swagger/ with api/v1.0/.
  4. Örneği kullanarak keşfedebileceğiniz dijital TWINS özelliklerinin listesini görüntüleyin.See a list of Digital Twins features that you can explore by using the sample. Şu komutu çalıştırın:Run the following command:

    dotnet run
    

Sağlama sürecini anlayınUnderstand the provisioning process

Bu bölümde, örneğin bir bina için uzamsal grafik sağlama şekli gösterilmektedir.This section shows how the sample provisions a spatial graph of a building.

Visual Studio Code ' de Occupancy-quickstart\src\actions klasörüne gidin ve provisionSample.csdosyasını açın.In Visual Studio Code, browse to the occupancy-quickstart\src\actions folder and open the file provisionSample.cs. Aşağıdaki işlevi aklınızda edin:Note the following function:

public static async Task<IEnumerable<ProvisionResults.Space>> ProvisionSample(HttpClient httpClient, ILogger logger)
{
    IEnumerable<SpaceDescription> spaceCreateDescriptions;
    using (var r = new StreamReader("actions/provisionSample.yaml"))
    {
        spaceCreateDescriptions = await GetProvisionSampleTopology(r);
    }

    var results = await CreateSpaces(httpClient, logger, spaceCreateDescriptions, Guid.Empty);

    Console.WriteLine($"Completed Provisioning: {JsonConvert.SerializeObject(results, Formatting.Indented)}");

    return results;
}

Bu işlev, aynı klasörde Provisionsample. YAML 'yi kullanır.This function uses provisionSample.yaml in the same folder. Bu dosyayı açın ve Office oluşturma: mekan, Floor, Areave Odalarhiyerarşisini göz önünde edin.Open this file, and note the hierarchy of an office building: Venue, Floor, Area, and Rooms. Bu fiziksel boşlukların herhangi biri, cihazlar ve Algılayıcılariçerebilir.Any of these physical spaces can contain devices and sensors. Her giriş için önceden tanımlanmış bir @no__t vardır-0 @ no__t-1örneğin, Floor, oda.Each entry has a predefined type—for example, Floor, Room.

Örnek YAML dosyası, Default dijital TWINS nesne modelini kullanan bir uzamsal grafiği gösterir.The sample yaml file shows a spatial graph that uses the Default Digital Twins object model. Bu model çoğu tür için genel adlar sağlar.This model provides generic names for most types. Genel adlar bir bina için yeterlidir.Generic names are sufficient for a building. SensorDataType için sıcaklık ve SpaceBlobType için eşleme örnekleri.Examples are Temperature for SensorDataType, and Map for SpaceBlobType. Örnek boşluk türü, alt tür Focusoda, ConferenceRoom vb. ile birlikte yer alır.An example space type is Room with subtypes FocusRoom, ConferenceRoom, and so on.

Fabrika gibi farklı tür bir mekan için uzamsal bir grafik oluşturmanız gerekiyordu, farklı bir nesne modeline ihtiyacınız vardır.If you had to create a spatial graph for a different type venue, such as a factory, you might need a different object model. Sağlama örneği için komut satırında dotnet run GetOntologies komutunu çalıştırarak hangi modellerin kullanılabilir olduğunu bulabilirsiniz.You can find out which models are available to use by running the command dotnet run GetOntologies on the command line for the provisioning sample.

Uzamsal grafikler ve nesne modelleri hakkında daha fazla bilgi için bkz. dijital TWINS nesne modellerini ve uzamsal zeka grafiğini anlama.For more information on spatial graphs and object models, read Understanding Digital Twins object models and spatial intelligence graph.

Örnek uzamsal grafiği değiştirmeModify the sample spatial graph

Provisionsample. YAML dosyası aşağıdaki düğümleri içerir:The provisionSample.yaml file contains the following nodes:

  • kaynaklar: resources düğümü, kuruluminizdeki cihazlarla iletişim kurmak Için bir Azure IoT Hub kaynağı oluşturur.resources: The resources node creates an Azure IoT Hub resource to communicate with the devices in your setup. Grafiğinizin kök düğümündeki bir IoT Hub 'ı, grafiğinizde bulunan tüm cihazlar ve sensörlerle iletişim kurabilir.An IoT hub at the root node of your graph can communicate with all the devices and sensors in your graph.

  • boşluk: dijital TWINS nesne modelinde spaces fiziksel konumları temsil eder.spaces: In the Digital Twins object model, spaces represent the physical locations. Her bir boşluk Type @ no__t-1; Örneğin, bölge, mekan veya Customer @ no__t-2 ve kolay bir Name ' ü içerir.Each space has a Type—for example, Region, Venue, or Customer—and a friendly Name. Boşluk, hiyerarşik bir yapı oluşturarak diğer alanlara ait olabilir.Spaces can belong to other spaces, creating a hierarchical structure. ProvisionSample. YAML dosyası, sanal bir binasının uzamsal bir grafiğine sahiptir.The provisionSample.yaml file has a spatial graph of an imaginary building. @No__t-1, Area içinde Floor türündeki boşlukların mantıksal iç içe geçme ve bir alanda @no__t 3 düğümleri olduğunu aklınızda bulundurmayın.Note the logical nesting of spaces of type Floor within Venue, Area in a floor, and Room nodes in an area.

  • cihazlar: boşluklar, bir dizi sensöri yöneten fiziksel veya sanal varlıklar olan devices içerebilir.devices: Spaces can contain devices, which are physical or virtual entities that manage a number of sensors. Örneğin, bir cihaz kullanıcının telefonu, Raspberry PI algılayıcısı Pod veya ağ geçidi olabilir.For example, a device might be a user’s phone, a Raspberry Pi sensor pod, or a gateway. Örneğinizdeki sanal Bina içinde, odak odası adlı odanın bir Raspberry Pi 3 a1 cihazı nasıl içerdiğini aklınızda tutun.In the imaginary building in your sample, note how the room named Focus Room contains a Raspberry Pi 3 A1 device. Her cihaz düğümü, örnekte sabit olarak kodlanmış benzersiz bir @no__t (0) tarafından tanımlanır.Each device node is identified by a unique hardwareId, which is hardcoded in the sample. Bu örneği gerçek bir üretim için yapılandırmak üzere, bunları kurulumdaki değerlerle değiştirin.To configure this sample for an actual production, replace these with values from your setup.

  • Algılayıcılar: bir cihaz birden çok @no__t içerebilir-1.sensors: A device can contain multiple sensors. Sıcaklık, hareket ve pil düzeyi gibi fiziksel değişiklikleri algılayıp kaydedebilirler.They can detect and record physical changes like temperature, motion, and battery level. Her algılayıcı düğümü, burada bir hardwareId tarafından benzersiz şekilde tanımlanır.Each sensor node is uniquely identified by a hardwareId, hardcoded here. Gerçek bir uygulama için, bu ayarları, kuruluminizdeki sensörların benzersiz tanımlayıcılarını kullanarak değiştirin.For an actual application, replace these by using the unique identifiers of the sensors in your setup. ProvisionSample. YAML dosyasının hareketi ve Carbondioksitkayıt işlemini yapmak için iki sensöri vardır.The provisionSample.yaml file has two sensors to record Motion and CarbonDioxide. Karbondioksit algılayıcı için satırların altına aşağıdaki satırları ekleyerek sıcaklığınıkaydetmek için başka bir algılayıcı ekleyin.Add another sensor to record Temperature, by adding the following lines, below the lines for the CarbonDioxide sensor. Bunların, yorumlanan Sample. YAML 'de açıklamalı çizgiler olarak sağlandığını unutmayın.Note that these are provided in provisionSample.yaml as commented-out lines. Her satırın önünde # karakterini kaldırarak bu açıklamaları özelleştirebilirsiniz.You can uncomment them by removing the # character in the front of each line.

            - dataType: Temperature
              hardwareId: SAMPLE_SENSOR_TEMPERATURE
    

    Not

    @No__t-0 ve hardwareId anahtarlarının Bu kod parçacığının üzerindeki deyimlerle hizalanmasına dikkat edin.Make sure the dataType and hardwareId keys align with the statements above this snippet. Ayrıca, Düzenleyicinizde boşlukları sekmelerle değiştirmez emin olun.Also make sure that your editor does not replace spaces with tabs.

ProvisionSample. YAML dosyasını kaydedin ve kapatın.Save and close the provisionSample.yaml file. Sonraki öğreticide bu dosyaya daha fazla bilgi ekleyecek ve ardından Azure dijital TWINS örnek binınızı sağlayacaksınız.In the next tutorial, you'll add more information to this file, and then provision your Azure Digital Twins sample building.

İpucu

Azure dijital TWINS grafik Görüntüleyicisi 'nikullanarak uzamsal grafınızı görüntüleyebilir ve değiştirebilirsiniz.You can view and modify your spatial graph using the Azure Digital Twins Graph Viewer.

Kaynakları TemizlemeClean up resources

Bu noktada Azure dijital TWINS araştırmalarını durdurmak istiyorsanız bu öğreticide oluşturulan kaynakları silebilirsiniz:If you want to stop exploring Azure Digital Twins at this point, feel free to delete resources created in this tutorial:

  1. Azure Portalsol menüden tüm kaynaklar' ı seçin, dijital TWINS kaynak grubunuzu seçin ve Sil' i seçin.From the left menu in the Azure portal, select All resources, select your Digital Twins resource group, and select Delete.

    İpucu

    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 experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. Lütfen örneğinizi silmeyi yeniden deneyin.Please retry deleting your instance.

  2. Gerekirse, iş makinenizdeki örnek uygulamayı silin.If necessary, delete the sample application on your work machine.

Sonraki adımlarNext steps

Örnek binaınızdaki koşulları izlemek üzere özel bir mantık uygulamayı öğrenmek için, serideki bir sonraki Öğreticiye gidin:To learn how to implement a custom logic to monitor conditions in your sample building, go to the next tutorial in the series: