Tworzenie scen 3D za pomocą programu 3D Scenes Studio (wersja zapoznawcza) dla usługi Azure Digital Twins

Azure Digital Twins 3D Scenes Studio (wersja zapoznawcza) to immersywne środowisko 3D, w którym pracownicy biznesowi i frontonu mogą wykorzystywać i badać dane operacyjne z rozwiązań usługi Azure Digital Twins z kontekstem wizualnym.

Wymagania wstępne

Do korzystania z programu 3D Scenes Studio potrzebne są następujące zasoby.

  • Wystąpienie usługi Azure Digital Twins. Aby uzyskać instrukcje, zobacz Konfigurowanie wystąpienia i uwierzytelniania.

    • Uzyskaj dostęp właściciela danych usługi Azure Digital Twins lub czytnika danych usługi Azure Digital Twins do wystąpienia. Aby uzyskać instrukcje, zobacz Konfigurowanie uprawnień dostępu użytkowników.
    • Zanotuj nazwę hosta wystąpienia do późniejszego użycia.
  • Konto usługi Azure Storage. Aby uzyskać instrukcje, zobacz Tworzenie konta magazynu.

    • Zanotuj adres URL konta magazynu do późniejszego użycia.
  • Prywatny kontener na koncie magazynu. Aby uzyskać instrukcje, zobacz Tworzenie kontenera.

    • Zanotuj nazwę kontenera magazynu do późniejszego użycia.
  • Uprawnienia do zasobów magazynu, w tym:

    • Dostęp do płaszczyzny kontroli co najmniej czytelnika
    • Rola dostępu do danych właściciela danych obiektu blob usługi Storage lub współautora danych obiektu blob usługi Storage

    Wymagane role można przyznać na poziomie konta magazynu lub na poziomie kontenera. Aby uzyskać instrukcje i więcej informacji na temat uprawnień do usługi Azure Storage, zobacz Przypisywanie roli platformy Azure.

  • Skonfiguruj mechanizm CORS dla konta magazynu (zobacz szczegółowe informacje w poniższej sekcji).

Konfigurowanie mechanizmu CORS

Należy skonfigurować mechanizm CORS dla konta magazynu, aby program 3D Scenes Studio mógł uzyskać dostęp do kontenera magazynu.

Te nagłówki CORS są zawsze wymagane:

  • Autoryzacja
  • x-ms-version
  • x-ms-blob-type

Te dodatkowe nagłówki CORS są wymagane, jeśli planujesz korzystanie z funkcji łączy prywatnych:

  • Typ zawartości
  • Długość zawartości
  • x-ms-copy-source
  • x-ms-requires-sync

Poniżej przedstawiono polecenie interfejsu wiersza polecenia platformy Azure, które ustawi metody, źródła i nagłówki wymienione powyżej dla mechanizmu CORS na koncie magazynu. Polecenie zawiera jeden symbol zastępczy nazwy konta magazynu.

az storage cors add --services b --methods GET OPTIONS POST PUT --origins https://explorer.digitaltwins.azure.net --allowed-headers Authorization Content-Type Content-Length x-ms-version x-ms-blob-type x-ms-copy-source x-ms-requires-sync --account-name <your-storage-account>

Teraz masz wszystkie zasoby niezbędne do pracy ze scenami w programie 3D Scenes Studio.

Inicjowanie środowiska 3D Scenes Studio

W tej sekcji ustawisz środowisko w programie 3D Scenes Studio i dostosujesz scenę dla przykładowego grafu, który znajduje się w wystąpieniu usługi Azure Digital Twins.

  1. Przejdź do programu 3D Scenes Studio. Studio zostanie otwarte, połączone z wystąpieniem usługi Azure Digital Twins, do którego ostatnio uzyskiwano dostęp w eksploratorze usługi Azure Digital Twins.

  2. Wybierz ikonę Edytuj obok nazwy wystąpienia, aby skonfigurować szczegóły wystąpienia i kontenera magazynu.

    Screenshot of 3D Scenes Studio highlighting the edit environment icon, which looks like a pencil.

    1. Adres URL wystąpienia usługi Azure Digital Twins powinien zaczynać się od https://, a następnie nazwy hosta wystąpienia z sekcji Wymagania wstępne.

    2. W polu Adres URL konta usługi Azure Storage wprowadź adres URL kontenera magazynu w sekcji Wymagania wstępne . W polu Nazwa kontenera usługi Azure Storage wprowadź nazwę kontenera magazynu w sekcji Wymagania wstępne .

    3. Wybierz pozycję Zapisz.

    Screenshot of 3D Scenes Studio highlighting the Save button for the environment.

Tworzenie, edytowanie i wyświetlanie scen

Reprezentacja 3D środowiska w programie 3D Scenes Studio jest nazywana sceną. Scena składa się z pliku 3D i pliku konfiguracji, który jest tworzony automatycznie.

Aby utworzyć scenę, zacznij od segmentowanego pliku 3D w pliku . GLTF lub . Format GLB . Możesz pobrać i wyświetlić przykładowy plik 3D, korzystając z tego linku: Pobierz plik RobotArms.glb.

Napiwek

Program 3D Scenes Studio obsługuje animację. Jeśli używasz pliku modelu 3D zawierającego animacje, będą one odtwarzane w scenie.

Możesz użyć programu 3D Scenes Studio z plikiem 3D, który jest już obecny w kontenerze magazynu, lub przekazać plik bezpośrednio do programu 3D Scenes Studio, co spowoduje automatyczne dodanie go do kontenera. Poniżej przedstawiono kroki tworzenia nowej sceny przy użyciu pliku 3D.

  1. Na stronie głównej programu 3D Scenes Studio wybierz przycisk Dodaj scenę 3D, aby rozpocząć tworzenie nowej sceny.

  2. Wprowadź nazwę i opis sceny.

  3. Jeśli chcesz, aby scena pojawiła się w widoku globusa, przełącz pozycję Pokaż na świecie na włączone. Wprowadź wartości Latitude (Szerokość geograficzna ) i Longitude (Długość geograficzna ) dla sceny.

  4. Wybierz jedną z następujących kart w sekcji Plik 3D linku:

    1. Wybierz plik , aby wprowadzić adres URL pliku 3D, który znajduje się już w kontenerze magazynu
    2. Przekazywanie pliku w celu przekazania pliku 3D z komputera

    Screenshot of 3D Scenes Studio, Create new scene dialog.

  5. Wybierz pozycję Utwórz.

Edytowanie scen

Aby edytować lub usunąć scenę po jej utworzeniu, użyj ikon Akcje obok sceny na stronie głównej programu 3D Scenes Studio.

Screenshot of 3D Scenes Studio, highlighting actions for a scene.

Edytowanie sceny spowoduje ponowne otwarcie wszystkich właściwości sceny ustawionych podczas jej tworzenia, co umożliwi ich zmianę i zaktualizowanie sceny.

Wyświetlanie scen w widoku globusu

Na stronie głównej programu 3D Scenes Studio jest wyświetlany widok Listy scen.

Możesz również wybrać widok Globus, aby zobaczyć sceny umieszczone wizualnie na świecie.

Screenshot of 3D Scenes Studio, Globe is highlighted on the home screen.

Wynikowy widok kuli ziemskiej wygląda następująco:

Screenshot of 3D Scenes Studio, showing scenes in Globe view.

Wyświetlanie poszczególnych scen

Możesz wybrać pojedynczą scenę ze strony głównej, aby otworzyć ją w trybie kompilacji . W tym miejscu można zobaczyć siatkę 3D dla sceny i edytować jej elementy i zachowania.

Screenshot of 3D Scenes Studio, showing a scene in the builder.

Możesz przełączyć się na tryb Widok , aby włączyć filtrowanie określonych elementów i wizualizację utworzonych zachowań elementów.

Screenshot of 3D Scenes Studio, showing a scene in the viewer.

W tym miejscu można wyświetlić wszystkie właściwości elementu, a także ich wartości w czasie, jeśli historia danych jest włączona w wystąpieniu. Aby wyświetlić historię właściwości, wybierz ikonę Otwórz eksploratora historii danych.

Screenshot of 3D Scenes Studio, showing the icon to open the data history explorer.

Spowoduje to otwarcie eksploratora historii danych dla właściwości . Aby uzyskać więcej informacji na temat korzystania z eksploratora historii danych, zobacz Weryfikowanie i eksplorowanie właściwości historizowanych.

Screenshot of data history explorer for 3D Scenes Studio.

Osadzanie scen w aplikacjach niestandardowych

Składnik przeglądarki może być również osadzony w aplikacjach niestandardowych poza programem 3D Scenes Studio i może działać w połączeniu ze składnikami innych firm.

Oto przykład tego, jak może wyglądać przeglądarka osadzona w niezależnej aplikacji:

Screenshot of 3D Scenes Studio in embedded view.

Biblioteka składników wizualizacji 3D jest dostępna w usłudze GitHub w repozytorium iot-cardboard-js . Jest to biblioteka składników React typu open source do tworzenia środowisk internetowych Internetu rzeczy (IoT).

Aby uzyskać instrukcje dotyczące osadzania środowisk 3D w aplikacjach niestandardowych przy użyciu biblioteki, zobacz witrynę typu wiki repozytorium Osadzanie scen 3D. Możesz również użyć przykładu CRA IoT Cardboard , który wdraża szablon Tworzenie aplikacji React dla biblioteki, aby rozpocząć tworzenie aplikacji niestandardowej za pomocą osadzonej przeglądarki.

Dodawanie elementów

Element to zdefiniowany samodzielnie zestaw siatk 3D połączonych z danymi na co najmniej jednej podstawowej cyfrowej reprezentacji bliźniaczej.

Jednym ze sposobów utworzenia nowego elementu jest wybranie pozycji Nowy element na karcie Elementy w widoku Kompilacja dla sceny.

Screenshot of 3D Scenes Studio in the builder for a scene. The New element button is highlighted.

Alternatywnie możesz wybrać składnik siatki bezpośrednio z wizualizacji i utworzyć nowy element, który jest już połączony.

Screenshot of 3D Scenes Studio in the builder for a scene. The mesh for a tank is highlighted and there is an option to Create new element.

Spowoduje to otwarcie panelu Nowy element , w którym można wypełnić informacje o elementach.

Screenshot of New element options in 3D Scenes Studio.

Nazwa i główna reprezentacja bliźniacze

Podstawowa reprezentacja bliźniaczka to główny odpowiednik cyfrowej reprezentacji bliźniaczej dla elementu. Połączysz element z reprezentacją bliźniaczą w wystąpieniu usługi Azure Digital Twins, aby element mógł reprezentować reprezentację bliźniaczą i jego dane w wizualizacji 3D.

Na panelu Nowy element lista rozwijana Podstawowa reprezentacja bliźniacze zawiera nazwy wszystkich reprezentacji bliźniaczych w połączonym wystąpieniu usługi Azure Digital Twins. Obok tego pola możesz wybrać ikonę Inspekcja właściwości , aby wyświetlić dane bliźniaczej reprezentacji lub ikonę zaawansowanego wyszukiwania reprezentacji bliźniaczej, aby znaleźć inne reprezentacje bliźniacze, wykonując zapytanie o wartości właściwości.

Screenshot of the New element options in 3D Scenes Studio. The Primary twin dropdown list is highlighted.

Wybierz bliźniętą reprezentację, aby połączyć się z tym elementem. Spowoduje to automatyczne zastosowanie identyfikatora cyfrowej reprezentacji bliźniaczej ($dtId) jako elementu Name. Jeśli chcesz, możesz zmienić nazwę elementu, aby był zrozumiały zarówno dla konstruktorów, jak i odbiorców sceny 3D.

Napiwek

Eksplorator usługi Azure Digital Twins może pomóc w znalezieniu odpowiedniej reprezentacji bliźniaczej, aby połączyć się z elementem, wyświetlając wizualny graf bliźniaczych reprezentacji i umożliwiając wykonywanie zapytań dotyczących określonych warunków bliźniaczych.

Siatki

Karta Siatki to miejsce, w którym można określić, które składniki wizualnej siatki 3D reprezentują ten element.

Jeśli rozpoczęto tworzenie elementów, wybierając siatkę w wizualizacji, ta siatka zostanie już wypełniona tutaj. Możesz teraz wybrać siatki w wizualizacji, aby dodać je do elementu.

Screenshot of the New element options in 3D Scenes Studio. The Meshes tab is highlighted.

Zachowania

Zachowanie to scenariusz dla sceny. Wybierz pozycję Dodaj zachowanie na tej karcie. W tym miejscu możesz wybrać istniejące zachowanie, aby dodać je do tego elementu, lub wybrać pozycję Nowe zachowanie , aby wprowadzić przepływ tworzenia nowego zachowania.

Screenshot of the New element options in 3D Scenes Studio. The Behaviors tab is highlighted.

Aby uzyskać więcej informacji na temat tworzenia nowych zachowań, zobacz Dodawanie zachowań.

Inne bliźniacze reprezentacje

Na drugiej karcie bliźniaczych reprezentacji bliźniaczych można dodać pomocnicze źródła danych cyfrowej reprezentacji bliźniaczej dla elementu. Możesz dodać inne bliźniacze reprezentacje bliźniacze do elementu, jeśli dane w podstawowej reprezentacji bliźniaczej nie będą wystarczające, aby zdefiniować wszystkie zachowania, które chcesz zastosować dla elementu, więc potrzebujesz dostępu do danych dodatkowych reprezentacji bliźniaczych.

Screenshot of the New element options in 3D Scenes Studio. The Other twins tab is highlighted.

Podczas tworzenia nowych elementów nie można dodawać innych reprezentacji bliźniaczych. Aby uzyskać instrukcje dotyczące dodawania innych reprezentacji bliźniaczych, zobacz Bliźnięta jako opcja zachowania.

Po dodaniu innych reprezentacji bliźniaczych do elementu będzie można je wyświetlać i modyfikować na tej karcie.

Dodawanie zachowań

Zachowanie to scenariusz dla sceny, który będzie wykorzystywać określone dane na cyfrowej reprezentacji bliźniaczej powiązanego elementu do wizualizacji przeglądarki.

Jednym ze sposobów utworzenia nowego zachowania jest wybranie nowego zachowania na karcie Zachowania w widoku kompilacji dla sceny.

Screenshot of 3D Scenes Studio in the builder for a scene. The New behavior button is highlighted.

Alternatywnie możesz wybrać element na karcie Elementy i utworzyć nowe zachowanie na karcie Zachowania tego elementu.

Spowoduje to otwarcie panelu Nowe zachowanie , w którym można wypełnić informacje o zachowaniu.

Screenshot of New behavior options in 3D Scenes Studio.

Warstwy nazw i scen

Zacznij od wybrania nazwy wyświetlanej dla zachowania.

Napiwek

Wybierz nazwę, która będzie jasna dla użytkowników końcowych, którzy będą wyświetlać scenę, ponieważ ta nazwa zachowania będzie wyświetlana jako część wizualizacji sceny.

W menu rozwijanym Warstwy sceny możesz dodać to zachowanie do istniejącej warstwy lub utworzyć nową warstwę, aby ułatwić organizowanie tego zachowania. Aby uzyskać więcej informacji na temat warstw, zobacz Zarządzanie warstwami.

Elementy

Na karcie Elementy wybierz elementy, które powinny być przeznaczone dla tego zachowania.

Jeśli rozpoczęto proces tworzenia zachowania z określonego elementu, ten element zostanie już wybrany tutaj. W przeciwnym razie możesz wybrać elementy tutaj po raz pierwszy.

Screenshot of the New behavior options in 3D Scenes Studio. The Elements tab is highlighted.

Bliźniaczki

Na karcie Bliźniacze reprezentacje można zmodyfikować zestaw bliźniaczych reprezentacji, których dane są dostępne dla tego zachowania. Obejmuje to podstawowe reprezentacje bliźniacze elementów docelowych i wszelkie dodatkowe reprezentacje bliźniacze.

Możesz dodać pomocnicze źródła danych cyfrowej reprezentacji bliźniaczej dla elementu. Po skonfigurowaniu innych reprezentacji bliźniaczych będzie można używać właściwości z tych reprezentacji bliźniaczych w wyrażeniach zachowania dla tego elementu. Inne reprezentacje bliźniacze należy dodawać tylko wtedy, gdy istnieją dodatkowe reprezentacje bliźniacze z danymi poza podstawową reprezentacją bliźniaczą, które mają być używane w regułach wizualizacji i widżetach dla tego zachowania.

Aby dodać nowe źródło danych bliźniaczej reprezentacji bliźniaczej, wybierz pozycję Dodaj bliźniaczą reprezentację i Utwórz reprezentację bliźniaczą.

Screenshot of the New behavior options in 3D Scenes Studio. The Twins tab is highlighted.

Spowoduje to otwarcie panelu Nowa reprezentacja bliźniacza, w którym można nazwać dodatkową reprezentację bliźniaczą i wybrać bliźniakę z wystąpienia usługi Azure Digital Twins do mapowania.

Screenshot of the New twin panel in 3D Scenes Studio.

Napiwek

Eksplorator usługi Azure Digital Twins może ułatwić wyświetlanie bliźniaczych reprezentacji bliźniaczych, które mogą być powiązane z podstawową reprezentacją bliźniaczą dla tego elementu. Możesz wykonać zapytanie względem grafu przy użyciu funkcji SELECT * FROM digitaltwins WHERE $dtId="<primary-twin-id>, a następnie użyć funkcji rozszerzenia dwukrotnego kliknięcia w celu eksplorowania powiązanych reprezentacji bliźniaczych.

Reguły wizualizacji

Na karcie Reguły wizualizacji można skonfigurować nakładki oparte na danych na elementach, aby wskazać ich kondycję lub stan w przeglądarce.

Aby utworzyć regułę, zacznij od wybrania pozycji Dodaj regułę.

Screenshot of the New behavior options in 3D Scenes Studio. The Visual Rules tab is highlighted.

Wybierz nazwę wyświetlaną reguły.

Następnie wybierz, czy reguła jest zależna od pojedynczej właściwości , czy niestandardowego (zaawansowanego ) wyrażenia właściwości. W przypadku pojedynczej właściwości uzyskasz listę rozwijaną właściwości liczbowych w głównej reprezentacji bliźniaczej. W przypadku niestandardowego (zaawansowanego) zostanie wyświetlone pole tekstowe, w którym można napisać niestandardowe wyrażenie Języka JavaScript przy użyciu co najmniej jednej właściwości. Wynik wyrażenia musi być zgodny z typem wyniku określonym w polu Typ . Aby uzyskać więcej informacji na temat pisania wyrażeń niestandardowych, zobacz Używanie wyrażeń niestandardowych (zaawansowanych).

Uwaga

Jeśli nie możesz wybrać właściwości z listy rozwijanej, ponieważ lista nie odpowiada, może to oznaczać błąd w niektórych modelach w wystąpieniu. Na przykład posiadanie wartości wyliczenia innych niż unikatowe w atrybutach modelu spowoduje przerwanie tej funkcji. Jeśli tak się stanie, przejrzyj definicje modelu i upewnij się, że wszystkie właściwości są prawidłowe.

Po zdefiniowaniu wyrażenia właściwości wybierz pozycję Dodaj warunek , aby zdefiniować efekty wizualne warunkowe.

Screenshot of the New visual rule options in 3D Scenes Studio. The described fields are highlighted.

W obszarze Dodaj opcje warunku wprowadź etykietę warunku w wizualizacji.

Następnie ustaw wartości, aby zidentyfikować granice wartości dla warunku (dokładny wybór zmieni się w zależności od typu właściwości). W przypadku właściwości liczbowych wartość minimalna każdego zakresu wartości jest włącznie, a maksymalna wartość jest wyłączna.

W obszarze Akcje zdefiniuj, co się dzieje w wizualizacji sceny po spełnieniu warunku. Kolorowanie siatki można użyć do kontrolowania koloru wyrażenia właściwości w przeglądarce lub znaczka, aby wyświetlić wskaźnik określonego koloru i ikony po spełnieniu warunku wyrażenia właściwości.

Screenshot of the New visual rule options in 3D Scenes Studio. The Add condition options are highlighted.

Po zakończeniu wybierz opcję Zapisz.

Widgety

Widżety są zarządzane na karcie Widżety . Widżety to wizualizacje oparte na danych, które zapewniają dodatkowy kontekst i dane, aby ułatwić zrozumienie scenariusza reprezentowanego przez zachowanie. Skonfigurowanie widżetów ułatwia upewnienie się, że odpowiednie dane są wykrywalne, gdy określony warunek jest aktywny.

Wybierz pozycję Dodaj widżet, aby wyświetlić bibliotekę widżetów, w której można wybrać inny typ dostępnych widżetów.

Screenshot of the New behavior options in 3D Scenes Studio. The Widgets tab is highlighted and the Widget library is visible.

Poniżej przedstawiono typy widżetów, które można utworzyć:

  • Miernik: do reprezentowania liczbowych punktów danych wizualnie

    Wprowadź nazwę wyświetlaną i jednostkę miary, a następnie wybierz, czy miernik odzwierciedla pojedynczą właściwość, czy niestandardowe (zaawansowane) wyrażenie właściwości. W przypadku pojedynczej właściwości uzyskasz listę rozwijaną właściwości liczbowych w głównej reprezentacji bliźniaczej. W przypadku niestandardowego (zaawansowanego) zostanie wyświetlone pole tekstowe, w którym można napisać niestandardowe wyrażenie Języka JavaScript przy użyciu co najmniej jednej właściwości. Wyrażenie powinno mieć wynik liczbowy. Aby uzyskać więcej informacji na temat pisania wyrażeń niestandardowych, zobacz Używanie wyrażeń niestandardowych (zaawansowanych).

    Po zdefiniowaniu wyrażenia właściwości ustaw zakresy wartości, które mają być wyświetlane w określonych kolorach miernika. Minimalna wartość każdego zakresu wartości jest włącznie, a maksymalna wartość jest wyłączna.

    Screenshot of creating a new gauge-type widget in 3D Scenes Studio.

    Uwaga

    Jeśli nie możesz wybrać właściwości z listy rozwijanej, ponieważ lista nie odpowiada, może to oznaczać błąd w niektórych modelach w wystąpieniu. Na przykład posiadanie wartości wyliczenia innych niż unikatowe w atrybutach modelu spowoduje przerwanie tej funkcji. Jeśli tak się stanie, przejrzyj definicje modelu i upewnij się, że wszystkie właściwości są prawidłowe.

  • Link: w przypadku dołączania zawartości zewnętrznej za pośrednictwem połączonego adresu URL

    Wprowadź etykietę i docelowy adres URL.

    Screenshot of creating a new link-type widget in 3D Scenes Studio.

    Adresy URL linków mogą również zawierać wyrażenia obliczeniowe z tą składnią: ${<calculation-expression>}. Powyższy zrzut ekranu zawiera wyrażenie służące do uzyskiwania dostępu do właściwości podstawowej reprezentacji bliźniaczej. Wyrażenia będą obliczane i wyświetlane dynamicznie w przeglądarce.

  • Wartość: w przypadku bezpośredniego wyświetlania wartości właściwości bliźniaczej reprezentacji

    Wprowadź nazwę wyświetlaną i wybierz wyrażenie właściwości, które chcesz wyświetlić. Może to być pojedyncza właściwość podstawowej reprezentacji bliźniaczej lub niestandardowe (zaawansowane) wyrażenie właściwości. Wyrażenia niestandardowe powinny być wyrażeniami języka JavaScript używającymi co najmniej jednej właściwości bliźniaczej reprezentacji. Wybierzesz typ wyniku, który zostanie wygenerowany przez wyrażenie. Jeśli wyrażenie właściwości niestandardowej zwraca ciąg, możesz również użyć składni literału szablonu języka JavaScript do uwzględnienia wyrażenia dynamicznego w danych wyjściowych ciągu. Sformatuj wyrażenie dynamiczne przy użyciu następującej składni: ${<calculation-expression>}. Następnie zawijaj całe dane wyjściowe ciągu za pomocą backticks (`). Aby uzyskać więcej informacji na temat pisania wyrażeń niestandardowych, zobacz Używanie wyrażeń niestandardowych (zaawansowanych).

    Screenshot of creating a new value-type widget in 3D Scenes Studio.

    Uwaga

    Jeśli nie możesz wybrać właściwości z listy rozwijanej, ponieważ lista nie odpowiada, może to oznaczać błąd w niektórych modelach w wystąpieniu. Na przykład posiadanie wartości wyliczenia innych niż unikatowe w atrybutach modelu spowoduje przerwanie tej funkcji. Jeśli tak się stanie, przejrzyj definicje modelu i upewnij się, że wszystkie właściwości są prawidłowe.

    Poniżej znajduje się przykład widżetu wartości, który sprawdza, czy InFlow wartość głównej reprezentacji bliźniaczej przekracza 99. Jeśli tak, zwraca ciąg z wyrażeniem zawierającym reprezentację bliźniaczą $dtId. W przeciwnym razie w danych wyjściowych nie będzie żadnych wyrażeń, więc nie są wymagane żadne backticksy.

    Oto wyrażenie wartości: PrimaryTwin.InFlow > 99 ? `${PrimaryTwin.$dtId} has an InFlow problem` : 'Everything looks good'. Obliczony wynik wyrażenia () $dtIdzostanie wyświetlony w widżecie w przeglądarce.

    Screenshots showing the notification text being entered on the value widget dialog, and how the widget appears in the Viewer.

  • Historia danych: w przypadku wyświetlania wartości właściwości w czasie. Ten widżet działa z funkcją historii danych usługi Azure Digital Twins, więc jest dostępny tylko wtedy, gdy włączono historię danych dla wystąpienia używanego w tej scenie 3D. Gdy wystąpi połączenie historii danych dla tego wystąpienia, będzie można wyświetlić te dane za pomocą tego widżetu.

    Widżet automatycznie wypełni pole ciągu Połączenie ion, kierując dane do wystąpienia usługi Azure Data Explorer, które jest już połączone z tym wystąpieniem usługi Azure Digital Twins.

    Wprowadź nazwę wyświetlaną i dodaj co najmniej jeden zestaw danych szeregów czasowych na podstawie właściwości podstawowej reprezentacji bliźniaczej. Możesz również dostosować sposób wyświetlania danych szeregów czasowych na wykresie widżetu.

    Screenshot of creating a new data history widget in 3D Scenes Studio.

    Uwaga

    Jeśli nie możesz wybrać właściwości z listy rozwijanej, ponieważ lista nie odpowiada, może to oznaczać błąd w niektórych modelach w wystąpieniu. Na przykład posiadanie wartości wyliczenia innych niż unikatowe w atrybutach modelu spowoduje przerwanie tej funkcji. Jeśli tak się stanie, przejrzyj definicje modelu i upewnij się, że wszystkie właściwości są prawidłowe.

Używanie wyrażeń niestandardowych (zaawansowanych)

Podczas definiowania reguł wizualizacji i widżetów w zachowaniach możesz użyć wyrażeń niestandardowych do zdefiniowania warunku właściwości.

Screenshot of defining a custom expression in 3D Scenes Studio.

Te wyrażenia używają języka JavaScript i umożliwiają definiowanie logiki niestandardowej za pomocą co najmniej jednej właściwości skojarzonych reprezentacji bliźniaczych. Wynik wyrażenia musi być zgodny z typem wyniku określonym w polu Typ .

Poniższy wykres wskazuje, które operatory języka JavaScript są obsługiwane w wyrażeniach niestandardowych programu 3D Scenes Studio.

Typ operatora Obsługiwane?
Operatory przypisania Nie.
Operatory porównania Tak
Operatory arytmetyczne Tak
Operatory bitowe Tak
Operatory logiczne Tak
Operatory ciągów Tak
Operator warunkowy (ternary) Tak
Operator poleceń Nie.
Operatory jednoargumentowe Nie.
Operatory relacyjne Nie.

Zarządzanie warstwami

Warstwy w scenie można tworzyć, aby ułatwić organizowanie zachowań. Warstwy działają jak tagi dotyczące zachowań, umożliwiając zdefiniowanie, które zachowania muszą być widoczne razem, tworząc w ten sposób niestandardowe widoki sceny dla różnych ról lub zadań.

Jednym ze sposobów tworzenia warstw jest użycie przycisku Warstwy sceny w widoku Kompilacja dla sceny.

Screenshot of 3D Scenes Studio builder for a scene. The Scene layers button is highlighted.

Wybranie pozycji Nowa warstwa spowoduje wyświetlenie monitu o wprowadzenie nazwy nowej warstwy, którą chcesz utworzyć.

Możesz też tworzyć warstwy podczas tworzenia lub modyfikowania zachowania. Okienko zachowania to również miejsce, w którym można dodać zachowanie do utworzonej już warstwy.

Screenshot of the Modify Behavior options in 3D Scenes Studio. A Scene layer is being selected.

Podczas przeglądania sceny w przeglądarce możesz użyć przycisku Wybierz warstwy , aby wybrać warstwy wyświetlane w wizualizacji. Zachowania, które nie są częścią żadnej warstwy, są grupowane w obszarze Warstwa domyślna.

Screenshot of 3D Scenes Studio in View mode. The layer selection is highlighted.

Konfigurowanie minimalnej częstotliwości odświeżania

Możesz ręcznie skonfigurować minimalną częstotliwość odświeżania dla podglądu sceny 3D, aby przejąć pewną kontrolę nad częstotliwością ściągania danych i wynikowym wpływem na wydajność. Minimalną częstotliwość odświeżania można skonfigurować tak, aby wynosiła od 10 sekund do jednej godziny.

W konstruktorze sceny wybierz przycisk Konfiguracja sceny.

Screenshot of 3D Scenes Studio in Build mode. The scene configuration option is highlighted.

Użyj listy rozwijanej, aby wybrać opcję częstotliwość odświeżania.

Podczas przeglądania sceny w przeglądarce możesz umieścić wskaźnik myszy na przycisku Odśwież , aby wyświetlić ustawienie częstotliwości odświeżania i czas ostatniego odświeżenia. Możesz również wybrać ją, aby ręcznie odświeżyć scenę.

Screenshot of 3D Scenes Studio in View mode. The refresh button highlighted.

Modyfikowanie motywu

W konstruktorze lub podglądzie sceny wybierz ikonę Motyw , aby zmienić styl, kolory obiektów i kolor tła ekranu.

Screenshot of 3D Scenes Studio builder for a scene. The Theme button is highlighted.

Udostępnianie środowiska

Środowisko 3D Scenes Studio jest tworzone na podstawie unikatowego parowania wystąpienia usługi Azure Digital Twins i kontenera usługi Azure Storage. Możesz udostępnić całe środowisko komuś, w tym wszystkie sceny, lub udostępnić określoną scenę.

Aby udostępnić swoje środowisko innej osobie, zacznij od nadania im następujących uprawnień do zasobów:

  • Dostęp do czytnika danych usługi Azure Digital Twins (lub nowszego) w wystąpieniu usługi Azure Digital Twins
  • Dostęp czytnika danych obiektu blob usługi Storage (lub nowszego) do kontenera magazynu
    • Czytnik danych obiektu blob usługi Storage umożliwia wyświetlanie scen.
    • Właściciel danych obiektu blob usługi Storage lub współautor danych obiektu blob usługi Storage umożliwi im edytowanie scen.

Następnie postępuj zgodnie z instrukcjami w pozostałej części tej sekcji, aby udostępnić całe środowisko lub określoną scenę.

Udostępnianie środowiska ogólnego

Gdy ktoś ma wymagane uprawnienia, istnieją dwa sposoby udzielenia im dostępu do całego środowiska. Możesz wykonać jedną z następujących czynności:

  • Użyj przycisku Udostępnij na stronie głównej programu 3D Scenes Studio, aby skopiować adres URL środowiska 3D Scenes Studio. (Adres URL zawiera adresy URL zarówno wystąpienia usługi Azure Digital Twins, jak i kontenera magazynu). Screenshot of the Share environment button in 3D Scenes Studio.

    Udostępnij go adresatowi, który może wkleić ten adres URL bezpośrednio w przeglądarce, aby nawiązać połączenie ze środowiskiem.

  • Udostępnij adres URL wystąpienia usługi Azure Digital Twins i adres URL kontenera usługi Azure Storage, który został użyty podczas inicjowania środowiska 3D Scenes Studio. Odbiorca może uzyskać dostęp do programu 3D Scenes Studio i zainicjować go przy użyciu tych samych wartości adresu URL w celu nawiązania połączenia z tym samym środowiskiem.

Następnie odbiorca może wyświetlać sceny i wchodzić z nimi w interakcje w studio.

Udostępnianie określonej sceny

Możesz również udostępnić środowisko linkowi bezpośrednio do określonej sceny. Aby udostępnić określoną scenę, otwórz scenę w trybie Wyświetl .

Użyj ikony Udostępnij scenę, aby wygenerować link do sceny. Możesz wybrać, czy chcesz połączyć, aby zachować bieżące opcje warstwy i elementów.

Screenshot of the Share scene button in 3D Scenes Studio.

Gdy adresat wkleja ten adres URL do przeglądarki, określona scena zostanie otwarta w przeglądarce z wybranymi warstwami lub wybranymi elementami.

Uwaga

Gdy scena zostanie udostępniona komuś w ten sposób, odbiorca będzie również mógł opuścić tę scenę i wyświetlić inne sceny w twoim środowisku, jeśli wybierze.

Następne kroki

Wypróbuj program 3D Scenes Studio z przykładowym scenariuszem w artykule Wprowadzenie do programu 3D Scenes Studio.

Możesz też zwizualizować graf usługi Azure Digital Twins w inny sposób przy użyciu eksploratora usługi Azure Digital Twins.