Udostępnij za pośrednictwem


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.

    Zrzut ekranu przedstawiający program 3D Scenes Studio z wyróżnioną ikoną edytowania środowiska, która wygląda jak ołówek.

    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.

    Zrzut ekranu przedstawiający program 3D Scenes Studio z wyróżnionym przyciskiem Zapisz dla środowiska.

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 wyświetlić i pobrać przykładowy plik 3D z tego linku: 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

    Zrzut ekranu przedstawiający program 3D Scenes Studio, okno dialogowe Tworzenie nowej sceny.

  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.

Zrzut ekranu przedstawiający program 3D Scenes Studio z wyróżnionymi akcjami dla sceny.

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.

Zrzut ekranu przedstawiający program 3D Scenes Studio, Globe jest wyróżniony na ekranie głównym.

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

Zrzut ekranu przedstawiający program 3D Scenes Studio przedstawiający sceny w widoku Globus.

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.

Zrzut ekranu przedstawiający program 3D Scenes Studio przedstawiający scenę w konstruktorze.

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

Zrzut ekranu programu 3D Scenes Studio przedstawiający scenę w przeglądarce.

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.

Zrzut ekranu przedstawiający program 3D Scenes Studio z ikoną otwierania eksploratora historii danych.

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.

Zrzut ekranu przedstawiający eksploratora historii danych dla programu 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:

Zrzut ekranu przedstawiający program 3D Scenes Studio w widoku osadzonym.

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.

Zrzut ekranu przedstawiający program 3D Scenes Studio w konstruktorze sceny. Przycisk Nowy element został wyróżniony.

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

Zrzut ekranu przedstawiający program 3D Scenes Studio w konstruktorze sceny. Siatka zbiornika jest wyróżniona i istnieje opcja Utwórz nowy element.

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

Zrzut ekranu przedstawiający opcje Nowego elementu w programie 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.

Zrzut ekranu przedstawiający opcje Nowy element w programie 3D Scenes Studio. Lista rozwijana Podstawowej reprezentacji bliźniaczej jest wyróżniona.

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.

Zrzut ekranu przedstawiający opcje Nowy element w programie 3D Scenes Studio. Karta Siatki jest wyróżniona.

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.

Zrzut ekranu przedstawiający opcje Nowy element w programie 3D Scenes Studio. Karta Zachowania jest wyróżniona.

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.

Zrzut ekranu przedstawiający opcje Nowy element w programie 3D Scenes Studio. Karta Inne reprezentacje bliźniacze jest wyróżniona.

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.

Zrzut ekranu przedstawiający program 3D Scenes Studio w konstruktorze sceny. Przycisk Nowe zachowanie jest wyróżniony.

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.

Zrzut ekranu przedstawiający nowe opcje zachowania w programie 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.

Zrzut ekranu przedstawiający opcje Nowego zachowania w programie 3D Scenes Studio. Karta Elementy jest wyróżniona.

Bliźnięta

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

Zrzut ekranu przedstawiający opcje Nowego zachowania w programie 3D Scenes Studio. Karta Bliźniacze reprezentacje jest wyróżniona.

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.

Zrzut ekranu przedstawiający panel Nowa reprezentacja bliźniacza w programie 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łę.

Zrzut ekranu przedstawiający opcje Nowego zachowania w programie 3D Scenes Studio. Karta Reguły wizualizacji jest wyróżniona.

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.

Zrzut ekranu przedstawiający opcje nowej reguły wizualizacji w programie 3D Scenes Studio. Opisane pola są wyróżnione.

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.

Zrzut ekranu przedstawiający opcje nowej reguły wizualizacji w programie 3D Scenes Studio. Opcje Dodaj warunek są wyróżnione.

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.

Zrzut ekranu przedstawiający opcje Nowego zachowania w programie 3D Scenes Studio. Karta Widżety jest wyróżniona, a biblioteka widżetów jest widoczna.

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.

    Zrzut ekranu przedstawiający tworzenie nowego widżetu typu miernika w programie 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.

    Zrzut ekranu przedstawiający tworzenie nowego widżetu typu linku w programie 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).

    Zrzut ekranu przedstawiający tworzenie nowego widżetu typu wartości w programie 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.

    Zrzuty ekranu przedstawiające tekst powiadomienia wprowadzony w oknie dialogowym widżetu wartości oraz sposób wyświetlania widżetu w przeglądarce.

  • 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 Parametry połączenia, 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.

    Zrzut ekranu przedstawiający tworzenie nowego widżetu historii danych w programie 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.

Zrzut ekranu przedstawiający definiowanie wyrażenia niestandardowego w programie 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.

Zrzut ekranu przedstawiający konstruktora 3D Scenes Studio dla sceny. Przycisk Warstwy sceny jest wyróżniony.

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.

Zrzut ekranu przedstawiający opcje Modyfikowanie zachowania w programie 3D Scenes Studio. Wybierana jest warstwa sceny.

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.

Zrzut ekranu przedstawiający program 3D Scenes Studio w trybie wyświetlania. Zaznaczenie warstwy jest wyróżnione.

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.

Zrzut ekranu przedstawiający program 3D Scenes Studio w trybie kompilacji. Opcja konfiguracji sceny jest wyróżniona.

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

Zrzut ekranu przedstawiający program 3D Scenes Studio w trybie wyświetlania. Wyróżniony przycisk odświeżania.

Modyfikowanie motywu

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

Zrzut ekranu przedstawiający konstruktora 3D Scenes Studio dla sceny. Przycisk Motyw jest wyróżniony.

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). Zrzut ekranu przedstawiający przycisk Udostępnij środowisko w programie 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.

Zrzut ekranu przedstawiający przycisk Udostępnij scenę w programie 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.