Pakiety

Aby zachować zorganizowane i ponowne wykorzystanie zasobów w Twoim zespole lub w wielu projektach, skup grupy swoich instancji i przekształć je w ponownie używalne pakiety .Pakiety sprawiają, że ogólny proces budowania światów jest szybszy i bardziej ergonomiczny, ale pomagają również w kwestii spójności, deifikacji, współpracy i wersjonowania:

• Łatwo aktualizuj wszystkie kopie pakietu do najnowszej wersji (lub tylko aktualizuj konkretne kopie).
• Ustaw pakiety na automatyczne aktualizowanie za każdym razem, gdy pojawi się nowa wersja.
• Daj współpracownikom Edytuj lub Użyj uprawnień do treści pakietu.
• Zobacz pełną historię wersji dla pakietu, porównaj wersje i przywróć stare wersje.

Najbardziej wydajnym przepływem pracy jest stworzenie pakietu, udzielenie go w zamian za współpracowników i ustawienie go na automatyczne aktualizowanie.I nie musisz czekać, aż model zostanie "zrobiony", zanim użyjesz go w pakiecie.Nawet jeśli pakiet jest miejscem na szczycie prostego kształtu, możesz go użyć do szarej skrzynki swojego środowiska i następnie mieć kopie placeholder automatycznie aktualizować, gdy publikujesz bardziej szczegółowe wersje.

Twórz pakiety

Możesz utworzyć pakiet z dowolnego pojedynczego obiektu lub pojedynczej gałęzi rodziców i dzieci obiektów.Jeśli chcesz stworzyć pakiet dla pojedynczego obiektu, zalecamy najpierw dodać go do grupy Model, aby później móc dodawać, usuwać, wyjmowaćlub skalować instancję w pakiecie bez złamania pakietu.

1. W oknie Eksploratora lub w widoku 3D wybierz prawym przyciskiem myszy żądany obiekt i wybierz Przekształć do pakietu .

2. W nowym oknie wypełnij szczegóły pakietu.W szczególności, jeśli pracujesz w grupie grupowej, ustaw własność do odpowiedniej grupy, w której masz uprawnienie do tworzenia/edytowania doświadczeń grupowych.

   Przeniesienia własności nie są wspierane przez system zasobów, więc uważnie rozważ właściciela przy tworzeniu pakietu.

3. Kliknij Potwierdź .

4. Po zakończeniu konwersji obiekt otrzymuje symbol "łączyćłańcuchowego" w oknie przeglądarki, aby zidentyfikować go jako pakiet.Ponadto możesz zobaczyć nowy obiekt Pakietowy Link powiązany z obiektem.

   

5. (Opcjonalnie) Wybierz obiekt Pakietowy link i włącz AutoUpdate w oknie Właściwości .Zauważ, jak ikona zmienia się, aby wskazać, że pakiet jest ustawiony do automatycznego aktualizacja.

   

Wstaw pakiety

Aby wstawić pakiet, który nie istnieje już w obecnym miejsce, musisz najpierw wstawić go z Toolbox:

• Od Ekwipunku ⟩ Moje pakiety dla pakietów, które opublikowałeś w sklepie twórców lub uzyskałeś z sklepu twórców , a także pakietów, które przyjaciel posiada i dał ci uprawnienia do korzystania.
• Od tworów ⟩ pakietów grupowych dla pakietów opublikowanych przez członków twojej grupy (w tym siebie).

>

>

Po wstawieniu pakietu do modelu danych opublikowanego miejsce, pojawia się w menadżerze zasobów i pozostaje tam nawet jeśli później usuniesz wszystkie kopie.

Opublikuj zmiany pakietu

Możesz opublikować wszelkie zmiany, które wprowadzasz do pakietu jako nową wersję, aby udostępnić je innym kopiom pakietu w całym miejscu i na wszystkich doświadczeniach.Zauważ, że nie jest wymagane opublikowanie zmodyfikowanego pakietu przed opublikowaniem miejsca (zmodyfikowana wersja jest zapisywana wraz z miejscem na przyszłą iterację).

Aby opublikować zmiany w pakiecie:

1. W oknie Eksploratora lub w widoku 3D wybierz prawym przyciskiem zmodyfikowaną kopię i wybierz Opublikuj w pakiecie .

2. Jeśli kopia pakietu ma włączoną aktualizację automatyczną, natychmiast pobiera aktualną wersję, gdy otwierasz miejsce, które je zawiera.Inne kopie otrzymują biały punkt na ikonie pakietu, który wskazuje, że dostępna jest aktualizacja.Możesz pojedynczo aktualizować lub masowo aktualizować je w razie potrzeby.

   

3. (Opcjonalnie) Dodaj opis swoich zmian:

   1. Kliknij prawym przyciskiem myszy pakiet i wybierz Szczegóły pakietu .
   2. W oknie konfiguracji zasobów wybierz Wersje .
   3. Pod twoją najnowszą zmianą wybierz Dodaj .
   4. Opisz swoje zmiany i kliknij Potwierdź .

Aktualizuj przestarzałe kopie

Możesz aktualizować przestarzałe kopie pakietu do najnowszej wersji, lub możesz nadal używać starszej wersji.

Aby zaktualizować jedną lub więcej kopii pakietu do najnowszej wersji:

1. W oknie Eksploratora , znajdź przestarzałe kopie za pomocą białej kropki na ikonie ikona.Możesz również wybrać przestarzałą kopię w widoku 3D, ale może być trudniej ją znaleźć w ten sposób.

   

2. Kliknij prawym przyciskiem myszy przestarzałą kopię i wybierz Otrzymaj najnowszy pakiet .Możesz także wybrać wiele pakietów, kliknij prawym przyciskiem myszy i uzyskaj najnowsze dla wybranych pakietów .

Masowe aktualizacje

Rozległe wykorzystanie pakietów może skutkować wieloma kopiami pakietu w wielu miejscach w doświadczeniu.Oprócz pojedynczego synchronizowania i aktualizacji automatycznych, możesz aktualizować wszystkie kopie pakietu za pomocą masowej aktualizacji .

1. (Zalecane) Zamknij inne instancje Studio z dowolnym z otwartych miejscami doświadczenia; uniemożliwia to potencjalne zastąpienie kolejnej niew zapisanej instancji miejsca przez twoje aktualizacje.

2. W oknie Eksploratora lub w widoku 3D wybierz prawym przyciskiem myszy wybrany pakiet i wybierz Aktualizuj wszystko .

3. Wybierz wszystkie miejsca w doświadczeniu lub niektóre podzespoły miejsc i kliknij Aktualizuj .

   

   Aby zapobiec niezamierzonym nadpisom, masowe aktualizowanie nie wpływa na zmodyfikowane wersje pakietu.Po zakończeniu masowej aktualizacji Studio wyświetla ostrzeżenie z liczbą pakietów, które nie zostały aktualizacja, jeśli takie wystąpią.

Automatyczne aktualizacje

Aby ułatwić synchronizację, możesz ustawić kopię pakietu do automatycznego aktualizowania za każdym razem, gdy publikowana jest nowsza wersja.Automatyczne aktualizowanie kopii pakietu nastąpi, gdy otworzono miejsce w Studio.

1. W oknie Eksploratora rozszerz drzewo hierarchii pakietu i wybierz jego obiekt PakietLink .

   

2. W oknie Właściwości , włącz właściwość Aktualizacja automatyczna .Jeśli masz pakiety z gniazda, ta właściwość dotyczy wyłącznie najwyższego poziomu pakietu rodzica, co oznacza, że aktualizacje automatyczne wystąpią tylko wtedy, gdy pakiet rodzic zostanie zaktualizowany.

Poziomy udostępniania i dostępu

Jeśli chcesz, możesz dzielić się pakietami z przyjaciółmi lub przyznawać dostęp do konkretnych ról użytkownika w twojej grupa.

1. W oknie Eksploratora , Pudełko z narzędziami , lub Menadżer zasobów , kliknij prawym przyciskiem myszy na wybrany pakiet i wybierz szczegóły pakietu .

2. W oknie Konfiguracja zasobów wybierz Uprawnienia .

   • Dla pakietu własności grupy rozszerz drzewo roli.Następnie wybierz poziom uprawnień dla każdej roli.Pudełka wyboru, które są wyłączone, wskazują, że uprawnienie jest już skonfigurowane dla tej roli i nie można go zmienić z tego okna.

     

     Uprawnienie	Opis
     Edytuj	Członkowie roli mogą korzystać, oglądać i edytować obecne i poprzednie wersje pakietów, w tym publikować w nich zmiany.Udzielenie dostępu do edycji roli z tego okna zapewnia dostęp tylko do określonego pakietu .
     Brak dostępu	Członkowie roli nie mają dostępu do żadnych nowych wersji pakietu, chociaż zachowują dostęp do obecnej wersji wstawionej do miejsce.

   • Dla pakietu własności użytkownika wyszukaj znajomych za pomocą pola wyszukiwania, kliknij ich nazwa użytkownikai wybierz poziom uprawnień.

     Uprawnienie	Opis
     Użyj i zobacz	Użytkownik może korzystać i wyświetlać (ale nie edytować) obecne i poprzednie wersje pakietu.Po zapewnieniu użytkownikowi tej zdolności nie możesz cofnąć dostępu do kopii, którą już wstawił do swojego doświadczenia; cofanie dostępu uniemożliwia ponowne wstawienie lub aktualizację pakietu, ale kopie pakietu w ich modelu danych pozostają nienaruszone.
     Edytuj	Użytkownik może korzystać, oglądać i edytować obecne i poprzednie wersje pakietów, w tym publikować w nich zmiany.

Modyfikuj pakiety

Możesz edytować pakiety i ich dzieci tak jak inne obiekty. Edytowanie pakietów wyłącza automatyczne aktualizowanie, dopóki nie opublikujesz lub nie odwrócisz zmian.

Większość edycji oznacza pakiet jako zmieniony, choć następujące zmiany nie są uważane za zmiany pakietu:

• Zmiana nazwy korzenia węzła głównego.
• Zmiana pozycji lub rotacji korzenia węzła pakietu, który jest , lub .
• Zmiana właściwości Włączone węzła korzennego GuiObject takiego jak ScreenGui , SurfaceGui lub BillboardGui.
• Zmiana odniesienia części w pakiecie, który odnosi się do instancji poza pakietem Weld

Po zmianie pakiety z nieopublikowanymi zmianami otrzymują zmienioną ikonę w oknie Eksploratora:

Dodaj lub zaktualizuj konfiguracje

Możesz dodać cechy instancji na korzeniu pakietu, aby dostosować jego zachowanie, na przykład maksymalną prędkość zapakowanego pojazdu lub czas odładowania pakietowanego przycisku.

Gdy opublikujesz pakiet, obecny zestaw atrybutów/wartości stanie się domyślną konfiguracją pakietu . Na dowolnej kopii pakietu konfiguracje są pokazane w pogrubionej kursywie i wartości tych atrybutów mogą być zmieniane na podstawie instancji.Gdy kopie pakietu są aktualizowane, zostaną zachowane zmodyfikowane wartości konfiguracyjne, podczas gdy inne atrybuty zostaną zaktualizowane do najnowszej domyślnej wartości.

Pakiety zagniezione

Możesz wstawiać pakiety w ramach innych pakietów, aby utrzymywać i współpracować z złożonymi hierarchiami, takimi jak seria mechaniki pojazdów, które można modyfikować niezależnie od pakietu rodzica pojazdu.Ten przykład pokazuje pakiet samochodowy, który zawiera cztery kopie tego samego pakietu kołów:

Skrypty pakietowe

Każdy skrypt w pakiecie niezmienionym jest odczytywany tylko i pokazuje powiadomienie na górze z hiperłączem do odblokowania skryptu.

Kliknięcie hiperłącza:

• Oznacza pakiet jako zmieniony niezależnie od tego, czy edytujesz skrypt.
• Usuwa powiadomienie/hiperłącze z innych skryptów w pakiecie.

Gdy pakiet zostanie opublikowany i przeniesiony do stanu niezmienionego , skrypty pod nim stają się odczytywalne z hiperłączem do modyfikacji.

Przywróć zmiany pakietu

Zamiast odwracać całą serię zmian pakietu jeden po drugim, możesz odwrócić nieopublikowane zmiany w jednej akcji, przywrócić pakiet do poprzedniej wersji lub odwrócić zmiany do konkretnych konfiguracji .

Przywróć nieopublikowane zmiany

Aby cofnąć całą serię nieopublikowanych zmian :

1. W oknie Eksploratora znajdź zmodyfikowane kopie za pomocą znaku wykrzyknienia obok ich nazw.Możesz również wybrać zmodyfikowane kopie w widoku 3D, co może być łatwiejsze.

2. Kliknij prawym przyciskiem myszy pojedynczą zmodyfikowaną kopię i wybierz Odwróć zmiany do pakietu , lub wybierz wiele kopii (przynajmniej jedną z nich zmodyfikowano), kliknij prawym przyciskiem myszy i wybierz Odwróć zmiany do wybranych pakietów .

Przywróć do wersji

Aby przywrócić pakiet do wcześniej opublikowanej wersji :

1. W oknie Eksploratora 3D, pudełko z narzędziami lub menadżer zasobów , kliknij prawym przyciskiem myszy na wybrany pakiet i wybierz szczegóły pakietu .

2. W oknie Konfiguracja zasobów wybierz Wersje .Okno wyświetla szczegóły dla każdej opublikowanej wersji, w tym datę i godzinę publikacji, wraz z jakimkolwiek opisem zmian.

3. Kliknij znacznik obok wersji, którą chcesz przywrócić, i kliknij Potwierdź .

   

Przywróć konfiguracje

Aby przywrócić dowolną atrybut konfiguracji do domyślnej wartości, wybierz opcję Zresetuj z menu sprzętu w sekcji Atrybuty okna Właściwości .

Porównaj wersje pakietu

Gdy pakiet ma wiele wersji, możesz porównać zmiany między wersjami za pomocą widoku różnic, który jest pomocny w przeglądaniu aktualizacji pakietu, porównywaniu lokalnych zmian z najnowszą wersją oraz sprawdzaniu zawartości poprzednich wersji przed przywróceniem.

Narzędzie ma menu hierarchii pakietów, które wskazuje wszystkie dodane, usunięte lub zmodyfikowane instancje między wersjami za pomocą odpowiednich ikon, z następującymi zakładkami dostępnymi:

• Przeglad wizualny pokazuje wizualne różnice w renderowaniu 3D w różnych pozycjach kamery.Jest to domyślny widok dla pakietów z obiektem 3D (modelami, częściami) jako obiektem korzeniowym i jest obecnie dostępny tylko dla obiektu korzeniowego.

  

• Właściwości pokazują zmiany właściwości i atrybutów.Jest to domyślny widok dla pakietów z obiektem nie-3D (skryptami, światłami, obiektami 2D) jako głównym obiektem, i jest dostępny dla wszystkich instancji w pakiecie.

  

• Skrypt pokazuje różnice w skrypcie linia po linii.Jest dostępny dla pakietów zawierających skrypty, niezależnie od tego, czy skrypt jest obiektem korzeniowym, czy nie.

  

Aby porównać wersje pakietu:

1. W oknie Eksploratora lub w widoku 3D wybierz pakiet docelowy i wybierz Porównaj wersje pakietu .

2. Domyślnie okno porównuje zmiany między kopią lokalną a najnowszą wersją. Użyj dwóch menu rozwijanych, aby porównać różne wersje.

   

   Niektóre starsze wersje mogą być niezgodne z narzędziem różnicowania pakietu.

3. Po wybraniu wersji:

   • Aby porównać wizualne renderowania modelu korzeniowego, jeśli to mające zastosowanie, wybierz zakładkę Przeglad wizualny i dostosuj kontrolę kamery do pożądanego kąta.Sterowania są synchronizowane między widokami:

     • Obróć kamerę za pomocą lewych kliknięć myszy.
     • Obróć kamerę za pomocą prawych kliknięć myszy.
     • Przybliż i oddal kamerę za pomocą koła myszy.
     • Odśrodź używając skrótu klawiszowego -F .

   • Aby porównać właściwości i atrybuty instancja, wybierz instancję i zakładkę Właściwości .

   • Aby porównać różnice w kodzie, jeśli to mające zastosowanie, wybierz dowolny kod, aby otworzyć zakładkę Skrypt z zmianami linii po linii między wybranymi wersjami, podobnie jak aplikacje do kontroli źródeł.

     To narzędzie pozwala tylko na porównanie zmian w skrypcie między obecną wersją a najnowszą opublikowaną lub lokalną wersją, bez wskazania współpracowników, którzy dokonali zmiany.

Alternatywnie możesz otworzyć narzędzie diff skryptu bezpośrednio:

1. W oknie Eksploratora lub w widoku 3D wybierz pakiet docelowy, który musi być skryptem lub zawierać skrypty, i wybierz Zobacz zmiany w skrypcie .
2. W otwartym tablicy różnic porównaj wszystkie zmiany wybranego skryptu między aktualną kopią pakietu a najnowszą opublikowaną lub lokalną wersją.