Pakiety

Aby utrzymać zasoby w porządku i ponownie wykorzystywać je w zespole lub w różnych projektach, możesz grupować swoje instancje i przekształcać je w pakiety. Pakiety przyspieszają cały proces budowania światów oraz czynią go bardziej ergonomicznym, ale pomagają również w zapewnieniu spójności, eliminacji duplikatów, współpracy i wersjonowaniu:

• Łatwo aktualizuj wszystkie kopie pakietu do najnowszej wersji lub tylko aktualizuj konkretne kopie.
• Ustaw pakiety na automatyczną aktualizację za każdym razem, gdy pojawi się nowa wersja.
• Przyznaj współpracownikom uprawnienia Edytuj lub Użyj do zawartości pakietu.
• Wyświetl pełną historię wersji dla pakietu, porównaj wersje i przywróć starsze wersje.

Najbardziej wydajny przepływ pracy to utworzenie pakietu, udzielenie dostępu współpracownikom oraz ustawienie go na automatyczną aktualizację. Nie musisz również czekać, aż model będzie „zakończony”, zanim zacznie on być używany w pakiecie. Nawet jeśli pakiet jest tylko miejscem na prostym kształcie, możesz go używać do szarej budowy swojego otoczenia, a następnie mieć automatycznie aktualizowane kopie zastępcze, gdy publikujesz bardziej szczegółowe wersje.

Tworzenie pakietów

Możesz utworzyć pakiet z dowolnego pojedynczego obiektu lub dowolnej pojedynczej gałęzi rodzica i dzieci obiektów. Jeśli chcesz utworzyć pakiet dla pojedynczego obiektu, najpierw dodaj go do grupowania Model, aby móc później dodawać, usuwać lub skalować obiekty podrzędne w pakiecie, nie łamiąc jego struktury.

Aby utworzyć pakiet:

1. W oknie Explorer lub w widoku 3D kliknij prawym przyciskiem myszy obiekt(y), które chcesz przekształcić w pakiet, a w menu kontekstowym wybierz Konwertuj na Pakiet.

2. W nowym oknie wypełnij szczegóły pakietu. W szczególności, jeśli pracujesz w grupie, ustaw Własność na odpowiednią grupę, w której masz zezwolenie na tworzenie/edycję doświadczeń grupowych.

   Transfery własności nie są obsługiwane przez system zasobów, więc dokładnie przemyśl właściciela, gdy tworzysz pakiet.

3. Kliknij Prześlij.

4. Po zakończeniu konwersji obiekt otrzyma symbol "Łańcucha" w oknie Explorer, aby zidentyfikować go jako pakiet. Dodatkowo zobaczysz nowy obiekt PackageLink połączony z obiektem.

   

5. OPCJONALNE

   Wybierz obiekt PackageLink i włącz AutoUpdate w oknie Właściwości. Zauważ, jak ikona zmienia się, aby wskazać, że pakiet jest ustawiony na automatyczną aktualizację.

Wstawianie pakietów

Aby wstawić pakiet, który jeszcze nie istnieje w aktualnym miejscu, musisz początkowo wstawić go z Toolbox:

• Z Inwentarza ⟩ Moje Pakiety dla pakietów, które opublikowałeś lub uzyskałeś z Sklepu Twórcy, a także dla pakietów, których właścicielem jest przyjaciel i który udzielił ci uprawnień do ich używania.
• Z Tworzenia ⟩ Pakiety Grupowe dla pakietów opublikowanych przez członków twojej grupy (w tym ciebie samego).

Gdy wstawisz pakiet do modelu danych opublikowanego miejsca, pojawi się on w Menedżerze Zasobów i pozostanie tam, nawet jeśli później usuniesz wszystkie kopie.

Modyfikowanie pakietów

Możesz edytować pakiety i ich dzieci tak jak inne obiekty. Modyfikowanie pakiety wyłącza automatyczną aktualizację do momentu, gdy opublikujesz lub cofniesz zmiany.

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

• Zmiana nazy korzenia.
• Zmiana pozycji lub rotacji węzła głównego pakietu, który jest BasePart, Model lub GuiObject.
• Zmiana właściwości Enabled w węźle głównym GuiObject, takim jak ScreenGui, SurfaceGui lub BillboardGui.
• Zmiana odniesienia do części w Weld wewnątrz pakietu, które odnosi się do instancji poza pakietem.

Gdy pakiety są zmodyfikowane, zdobywają ikonę zmodyfikowaną w oknie Explorer:

Dodaj lub zaktualizuj konfiguracje

Możesz dołączyć atrybuty instancji na poziomie głównym pakietu, aby dostosować jego działanie. Gdy publikujesz pakiet, bieżący zestaw atrybutów/wartości stanie się domyślnymi konfiguracjami pakietu. W dowolnej danej kopii pakietu te wartości atrybutów mogą być zmieniane na poziomie instancji, a te zmiany są notowane przez pogrubione kursywy. Gdy kopie pakietów są aktualizowane, zmodyfikowane wartości konfiguracyjne będą zachowane, podczas gdy inne atrybuty zostaną zaktualizowane do najnowszej wartości domyślnej.

Zagnieżdżone pakiety

Możesz zagnieżdżać pakiety w innych pakietach, aby utrzymać i współpracować nad złożonymi hierarchiami, takimi jak seria mechanik pojazdów, które mogą być modyfikowane niezależnie od rodzica pojazdu.

Jeśli zmodyfikujesz zagnieżdżony pakiet, zarówno zagnieżdżony pakiet jak i pakiet rodzica będą uważane za zmodyfikowane. Musisz opublikować zmiany do jakiegokolwiek zagnieżdżonego pakietu, zanim będziesz mógł opublikować zmiany w jego pakiecie rodzica, ponieważ publikacja rodzica oznaczałaby go jako aktualny/niezmodyfikowany i koliduje z modyfikacjami zagnieżdżonego pakietu.

Skrypty pakietu

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

Kliknięcie hiperłącza:

• Oznacza pakiet jako zmodyfikowany, 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 niezmodyfikowanego, skrypty w jego obrębie stają się tylko do odczytu z hiperłączem do modyfikacji.

Publikacja zmian w pakiecie

Możesz opublikować każdą zmianę w pakiecie jako nową wersję, udostępniając swoje aktualizacje innym kopiom pakietu w danym miejscu i we wszystkich doświadczeniach. Nie jest wymagane opublikowanie zmodyfikowanego pakietu przed opublikowaniem miejsca, ponieważ zmodyfikowana wersja jest zapisywana razem z miejscem do przyszłej iteracji.

Aby opublikować zmiany w pakiecie:

1. W oknie Explorer lub w widoku 3D kliknij prawym przyciskiem myszy zmodyfikowaną kopię i wybierz Opublikuj do Pakietu.

2. Jeśli kopia pakietu ma włączoną automatyczną aktualizację, natychmiast pobiera zaktualizowaną wersję, gdy otwierasz miejsce, które ją zawiera. Inne kopie otrzymują symbol „pobierania”, który wskazuje, że aktualizacja jest dostępna. Możesz indywidualnie zaktualizować lub masowo zaktualizować wszystkie kopie.

   

3. OPCJONALNE

   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 swoim najnowszym zmianą wybierz Dodaj.
   4. Opisz swoje zmiany, a następnie kliknij przycisk Prześlij.

Aktualizowanie nieaktualnych kopii

Możesz zaktualizować nieaktualne kopie pakietu do najnowszej wersji lub możesz nadal korzystać ze starszej wersji.

1. W oknie Explorer zlokalizuj nieaktualne kopie według symbolu „pobierania”. Możesz także wybrać nieaktualną kopię w widoku 3D.

   

2. Kliknij prawym przyciskiem myszy nieaktualną kopię i wybierz Pobierz najnowszy pakiet. Możesz również wybrać wiele pakietów, kliknąć prawym przyciskiem myszy i wybrać Pobierz najnowszy dla wybranych pakietów.

Masowe aktualizacje

Rozległe użycie pakietów może skutkować wieloma kopiami pakietów w różnych miejscach w jednym doświadczeniu. Oprócz indywidualnej synchronizacji i automatycznych aktualizacji możesz zaktualizować wszystkie kopie pakietu przez masowe aktualizacje.

1. ZALECANE

   Zamknij inne instancje Studio z otwartymi miejscami tego samego doświadczenia; to zapobiegnie ewentualnemu nadpisaniu twoich aktualizacji przez inną niezapisaną instancję miejsca.
2. W oknie Explorer lub w widoku 3D kliknij prawym przyciskiem myszy żądany pakiet i wybierz Zaktualizuj wszystko.
3. Wybierz wszystkie miejsca w doświadczeniu lub pewien podzbiór miejsc i kliknij Zaktualizuj.

Automatyczne aktualizacje

Aby ułatwić synchronizację, możesz ustawić, aby kopia pakietu aktualizowała się automatycznie za każdym razem, gdy nowa wersja jest publikowana. Automatyczna aktualizacja kopii pakietów następuje, gdy miejsce jest otwierane w Studio.

1. W oknie Explorer rozwiń hierarchię pakietu i wybierz obiekt PackageLink.

   

2. W oknie Właściwości włącz właściwość AutoUpdate. Jeśli masz zagnieżdżone pakiety, ta właściwość dotyczy tylko najwyższego pakietu rodzica, co oznacza, że automatyczne aktualizacje występują tylko wtedy, gdy pakiet rodzica jest aktualizowany.

Udzielanie dostępu i poziomy

Możesz przyznać uprawnienia przyjaciołom, doświadczeniom, grupom lub określonym rolom użytkowników grupy, aby mogli swobodnie używać twoich pakietów w swoich tworach. Więcej informacji na temat dostępu do zasobów znajdziesz w rozdziale Prywatność zasobów.

Aby zmienić uprawnienia pakietu dla współpracownika, takiego jak przyjaciel lub grupa:

1. W oknie Explorer, Toolbox lub Menedżerze Zasobów kliknij prawym przyciskiem myszy żądany pakiet i wybierz Opcje pakietu ⟩ Szczegóły pakietu.

2. W oknie Konfiguracja zasobów wybierz Uprawnienia.

3. Za pomocą paska wyszukiwania wprowadź i wybierz współpracownika, któremu chcesz przyznać zezwolenie na użycie swojego pakietu, a następnie wybierz poziom uprawnień.

   Uprawnienia	Opis
   Użyj i Wyświetl	Współpracownik może używać i wyświetlać (ale nie edytować) bieżące i poprzednie wersje pakietu. Gdy tylko przyznasz współpracownikowi tę możliwość, nie możesz cofnąć dostępu do kopii, którą już wprowadził do swojego doświadczenia; cofnięcie dostępu uniemożliwia ponowne wprowadzenie lub aktualizację pakietu, ale kopie pakietu w jego modelu danych pozostają nienaruszone.
   Edytuj	Współpracownik może używać, wyświetlać i edytować aktualne i poprzednie wersje pakietu, w tym publikować zmiany w nim.

Cofnięcie zmian pakietu

Zamiast cofać całą serię zmian w pakiecie jedna po drugiej, możesz jednocześnie cofnąć nieopublikowane zmiany, przywrócić pakiet do poprzedniej wersji lub cofnąć zmiany do określonych konfiguracji.

Cofnięcie nieopublikowanych zmian

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

1. W oknie Explorer zlokalizuj zmodyfikowane kopie po kropce na ich ikonach pakietów. Możesz również wybrać zmodyfikowane kopie w widoku 3D.

   

2. Kliknij prawym przyciskiem myszy jedną zmodyfikowaną kopię i wybierz Cofnij zmiany w pakiecie, lub wybierz wiele kopii (co najmniej jedną zmodyfikowaną), kliknij prawym przyciskiem myszy i wybierz Cofnij zmiany w wybranych pakietach.

Przywróć do wersji opublikowanej

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

1. W oknie Explorer, Toolbox lub Menedżerze Zasobów kliknij prawym przyciskiem myszy żądany pakiet i wybierz Opcje pakietu ⟩ Szczegóły pakietu.
2. W oknie Konfiguracja zasobów wybierz Wersje. Okno wyświetli szczegóły dla każdej opublikowanej wersji, w tym datę i czas publikacji oraz wszelkie opisy zmian.
3. Kliknij znacznik wyboru obok wersji, którą chcesz przywrócić, a następnie kliknij Prześlij.

Cofnięcie konfiguracji

Aby cofnąć jakiekolwiek atrybuty konfiguracji do domyślnych, wybierz Resetuj z menu opcji w sekcji Atrybuty okna Właściwości.

Porównaj wersje pakietu

Gdy pakiet ma wiele wersji, możesz porównać zmiany pomiędzy wersjami, korzystając z narzędzia do przeglądania różnic. Narzędzie ma menu hierarchii pakietów, które wskazuje wszystkie dodane, usunięte lub zmodyfikowane instancje między wersjami, używając odpowiednich ikon, w tym następujących funkcji:

• Widok wizualny pokazuje wizualne różnice w renderowaniu 3D z różnych pozycji kamery. Jest to domyślny widok dla pakietów z obiektem 3D (modele, części) jako obiektem głównym i jest obecnie dostępny tylko dla obiektu głównego.

• Właściwości pokazuje zmiany właściwości i atrybutów. Jest to domyślny widok dla pakietów z obiektem, który nie jest 3D (skrypty, światła, obiekty 2D) jako obiektem głównym, i jest dostępny dla wszystkich instancji w pakiecie.

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

Aby porównać wersje pakietów:

1. W oknie Explorer lub w widoku 3D kliknij prawym przyciskiem myszy docelowy pakiet i wybierz Opcje pakietu ⟩ Porównaj wersje pakietu.

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

   

   Niektóre starsze wersje mogą być niekompatybilne z narzędziem do porównywania różnic pakietów.

3. Po wybraniu wersji:

   1. Aby porównać wizualne renderowania modelu głównego, jeśli dotyczy, wybierz zakładkę Widok wizualny i dostosuj kontrolę kamery do pożądanego kąta. Kontrole są synchronizowane w widokach:

      • Przesuwaj kamerę, używając lewych kliknięć myszy.
      • Rotuj kamerę, używając prawych kliknięć myszy.
      • Powiększaj i pomniejszaj kamerę, używając kółka myszy.
      • Wyśrodkuj za pomocą skrótu klawiaturowego F.

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

   3. Aby porównać różnice w skryptach dla pakietu, który jest skryptem lub zawiera skrypty, użyj zakładki Skrypt.

      To narzędzie umożliwia porównanie zmian w skryptach tylko między bieżącą wersją a najnowszą opublikowaną lub lokalną wersją, bez wskazywania współpracowników, którzy dokonali zmian.

      Alternatywnie możesz bezpośrednio otworzyć narzędzie do porównywania skryptów, klikając prawym przyciskiem myszy docelowy pakiet w oknie Explorer lub widoku 3D i wybierając Wyświetl zmiany w skryptach.