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 utworzyć pakiet dla pojedynczego obiektu, dodaj go najpierw do grupowania Model, aby później móc dodać, usunąć lub skalować dziecięce obiekty w pakiecie bez złamania pakietu.

Aby utworzyć pakiet:

1. W oknie Eksploratora lub w widoku 3D wybierz prawym przyciskiem myszy obiekt, który chcesz przekształcić w pakiet, a następnie w menu kontekstowym 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 "łącza łańcuchowego" w oknie Eksploratora , 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 aktualizowania.

   

Wstaw pakiety

Aby wstawić pakiet, który nie istnieje już w obecnym miejscu, 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 miejsca, pojawia się w menadżerze zasobów i pozostaje tam nawet jeśli później usuniesz wszystkie kopie.

Opublikuj zmiany pakietu

Możesz opublikować każdą zmianę w swoim pakiecie jako nową wersję, udostępniając swoje aktualizacje innym kopiom pakietu w całym miejscu i na wszystkich doświadczeniach.Nie jest wymagane opublikowanie zmodyfikowanego pakietu przed opublikowaniem miejsca, ponieważ zmodyfikowana wersja jest zapisywana razem 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ć wszystkie kopie.

   

3. (Opcjonalnie) Dodaj opis swoich zmian:

   1. Kliknij prawym przyciskiem myszy pakiet i wybierz Szczegóły pakietu .
   2. W oknie Konfiguracja zasobów wybierz Wersje .
   3. Pod twoją najnowszą zmianą wybierz Dodaj .
   4. Opisz swoje zmiany, a następnie kliknij przycisk 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 pakietu.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, kliknięcie prawym przyciskiem myszy i uzyskać 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 miejscem otwartym w doświadczeniu; 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 zaktualizowane , 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.

Aby automatycznie aktualizować kopie pakietu:

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

Możesz przyznać uprawnienie przyjaciołom, doświadczeniom, grupom lub konkretnym rolom użytkowników grupy, aby mogli swobodnie korzystać z twoich pakietów w swoich twórczościach.Po udostępnieniu pakietu wszystkie przyszłe wersje tego pakietu mają te same ograniczenia, nawet jeśli później cofiesz udostępnianie pakietu.Aby uzyskać więcej informacji o dostępie do zasobów, zobacz prywatność zasobów.

Aby udostępnić pakiety innym współpracownikom, pakiet musi zawierać tylko odniesienia do assetIDów, które stworzyłeś lub masz wyraźną zgodę na ich użycie.

Aby zmienić uprawnienia pakietu dla współpracownika, takiego jak przyjaciel lub 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 .

3. Używając paska wyszukiwania, wprowadź i wybierz współpracownika, któremu chcesz przyznać uprawnienie do korzystania z pakietu, a następnie wybierz poziom uprawnień.

   Uprawnienie	Opis
   Użyj i zobacz	Kolaborant może używać i oglądać (ale nie edytować) obecnych i poprzednich wersji pakietu.Gdy dostarczysz współpracownikowi tę zdolność, nie możesz odwołać dostępu do kopii, którą już wstawił do swojego doświadczenia; odwołanie dostępu uniemożliwia ponowne wstawienie lub aktualizację pakietu, ale kopie pakietu w ich modelu danych pozostają nienaruszone.
   Edytuj	Kolaborant może korzystać, oglądać i edytować obecne i poprzednie wersje pakietu, w tym publikować w nim 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 możliwe, 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 instancji, wybierz instancję i zakładkę Właściwości .

   • Aby porównać różnice w kodzie, jeśli to możliwe, 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ą.