Pacchetti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.


Per mantenere le risorse organizzate e riutilizzabili in tutta la tua azienda o in più progetti, raggruppa le tue istanze e converti le in pacchetti riutilizzabili. I pacchetti rendono il processo di costruzione di mondi più veloce e più ergonomico, ma aiutano anche con la coerenza, la duplicazione, la collaborazione e la versionizzazione:

  • Facilmente aggiorna tutte le copie di un pacchetto alla versione più recente (o solo aggiorna copie specifiche).
  • Imposta i pacchetti su aggiornamento automatico ogni volta che c'è una nuova versione.
  • Dai ai collaboratori Modifica o Usa autorizzazioni per i contenuti di un pacchetto.
  • Visualizza la cronologia delle versioni complete per un pacchetto, paragonare le versioni e ripristinare le versioni precedenti.

Il flusso di lavoro più efficiente è creare un pacchetto , condividerlo con qualsiasi collaboratore e impostarlo per l'aggiornamento automatico . E non devi aspettarti che un modello sia "fatto" prima di utilizzarlo in un pacchetto. Anche se il pacchetto è un placeholder sopra una forma semplice, puoi us

Creazione di pacchetti

Puoi creare un pacchetto da qualsiasi singolo oggetto o da qualsiasi singolo padre e figlio ramo di oggetti. Se vuoi creare un pacchetto per un singolo oggetto, consigliamo di aggiungerlo a un Model gruppoing prima in modo che tu possa aggiungere or Inserire, Rimuovereo scalare l'istanza all'interno del pacchetto in seguito senza rompere il pacchetto.

  1. Nella finestra Explorer o nella vista 3D, fai clic con il pulsante destro del mouse sull'oggetto desiderato e seleziona Converter in Package .

    The context menu that display when you right-click an object in the Explorer window. The Convert to Package menu item is highlighted.
  2. Nella nuova finestra, compila i dettagli del pacchetto. In particolare, se stai lavorando in un gruppo, imposta Possedimento al gruppo corrispondente in cui hai il permesso di creare/modificare esperienze di gruppo.

  3. Click Submit .

  4. Dopo la conversione completata, l'oggetto riceve un simbolo "chain Callegare" nella finestra Explorer per identificarlo come un pacchetto. Inoltre, puoi vedere un nuovo oggetto PackageLink associato all'oggetto.

    A maple tree model in the Explorer window with the package icon next to it.
  5. (Facoltativo) Seleziona l'oggetto PackageLink e abilita AutoUpdate nella finestra Proprietà . Nota come l'icona cambia per indicare che il pacchetto è impostato per l'Aggiornarmentoautomatico.

    A maple tree model in the Explorer window with the auto-update package icon next to it.

Inserimento delle pacchette

Per inserire un pacchetto che non esiste già nel Postoattuale, devi prima inserirlo dalla Toolbox :

  • Da InventarioI miei pacchetti per i pacchetti che hai pubblicato o ottenuto dal Creator Store , nonché pacchetti che un amico possiede e ti ha dato 1> autorizzazioni1> per usare.
  • Da CreazioniPacchetti di gruppo per i pacchetti pubblicati da membri del tuo gruppo (incluso te stesso).
A close up view of the Toolbox with both the Inventory tab and the assets dropdown menu highlighted.
Toolbox → Inventory → I miei pacchetti
A close up view of the Toolbox with the Creations tab highlighted.
Toolbox → Creazioni → Group Packages

Una volta inserito un pacchetto nel modello di dati di un Posto, appare nella cartella Pacchetti del Gestore risorse e rimane lì anche se in seguito elimini tutte le copie di esso. Tuttavia, quando pubblichi il Posto, la cartella sarà aggiornata per riflettere solo i pacchetti utilizzati all'interno del Posto.

The Asset Manager window with a few example packages.
Pacchetti nel gestore risorse

Pubblicare le modifiche del pacchetto

Puoi pubblicare qualsiasi cambiamento che apporti a un pacchetto come nuova versione per renderlo disponibile per le altre copie del pacchetto in tutto il luogo e in tutte le esperienze. Nota che non è richiesto non pubblicare un pacchetto modificato prima di pubblicare un luogo (la versione modificata viene salvata insieme al luogo per un'iterazione futura).

Per pubblicare le modifiche a un pacchetto:

  1. Nella finestra Explorer o nella vista 3D, fai clic con il pulsante destro del mouse sulla copia modificata e seleziona Pubblica in Package .

    The context menu that display when you right-click an object in the Explorer window. The Publish to Package menu item is highlighted.
  2. Se un pacchetto ha aggiornamento automatico attivato, si aggiorna automaticamente la versione quando si apre il luogo che contiene. Le altre copie ottengono un punto bianco sull'icona del pacchetto che indica un aggiornamento disponibile. Puoi aggiornare individualmente o aggiornare in massa loro come necessario.

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (Opzionale) Aggiungi una descrizione delle tue modifiche:

    1. Fai clic con il pulsante destro del mouse sul pacchetto e seleziona Dettagli del pacchetto .
    2. Nella finestra di configurazione delle risorse, seleziona Versioni .
    3. Sotto la tua ultima modifica, seleziona Aggiungi .
    4. Descrivi le tue modifiche e fai clic su Invia .

Aggiornamento delle copie obsolete

Puoi aggiornare le copie degli pacchetti obsolete alla versione più recente, oppure puoi continuare ad utilizzare la versione precedente.

Per aggiornare una o più copie del pacchetto alla versione più recente:

  1. Nella finestra Explorer, individua le copie non aggiornate dal punto bianco sull'Iconadel pacchetto. Puoi anche selezionare la copia non aggiornata nella vista 3D, ma potrebbe essere più difficile trovarla in questo modo.

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. Fai clic con il pulsante destro del mouse sulla copia non aggiornata e seleziona ottenere l'ultimo pacchetto . Puoi anche selezionare più pacchetti, fai clic con il pulsante destro del mouse e ottenere l'ultimo per i pacchetti selezionati .

Aggiornamenti di massa

L'uso esteso di pacchetti può comportare molte copie di pacchetti in più luoghi in un'esperienza. Oltre a sincronizzazione individuale e aggiornamenti automatici, puoi aggiornare tutte le copie di un pacchetto attraverso aggiornamento di massa .

  1. (Raccomandato) Chiudi le altre istanze di Studio con uno qualsiasi dei luoghi aperti dall'esperienza; questo impedisce che un'altra istanza non salvata di un luogo possa sovrascrivere potenzialmente le tue aggiornamenti.

  2. Nella finestra Explorer o nella vista 3D, fai clic con il pulsante destro del mouse sull'interpallo desiderato e seleziona Aggiorna tutti .

  3. Scegli tutti i luoghi nell'esperienza o in un sottoset di luoghi e fai clic su Aggiorna .

    A view of the mass update window, showing two places.

    Per prevenire gli sovrascritti non intenzionali, l'aggiornamento di massa non influisce su versioni modifiche di un pacchetto. Dopo che l'aggiornamento di massa è completato, Studio visualizza un avviso con il numero di pacchetti che non ha non Aggiornarmento, se applicabile.

Aggiornamenti automatici

Per rendere il sincronizzazione più facile, puoi impostare una copia del pacchetto per aggiornare automaticamente quando una nuova versione viene pubblicata. L'aggiornamento automatico delle copie del pacchetto avverrà quando viene aperto un luogo in Studio.

  1. Nella Explorer finestra, espandi l'albero della gerarchia del pacchetto e seleziona il suo oggetto PackageLink .

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. Nella finestra Proprietà, abilita la proprietà Aggiornamento automatico. Se hai pacchetti annidati, questa proprietà si applica solo al pacchetto di livello più alto, il che significa che gli aggiornamenti automatici avvengono solo quando il 2>genitore2> pacchetto è aggiornato.

Livelli di condivisione e accesso

Se lo desideri, puoi condividere pacchetti con amici o concedere l'accesso a ruoli utente specifici nel tuo Gruppo.

  1. Nell'Explorer, Toolbox, o Manager risorse, fai clic con il pulsante destro del mouse sulla casella di pacchetto desiderata e seleziona Dettagli del pacchetto .

  2. Nella finestra di configurazione delle risorse, seleziona Permessi .

    • Per un pacchetto di proprietà del gruppo , espandi l'albero dei ruoli. Quindi scegli un livello di autorizzazione per ciascun ruolo. Le casse di selezione che sono disabilitate indicano che l'autorizzazione è già configurata per quel ruolo e non può essere modificata da questa finestra.

      A close up view of some settings in the pop-up window. The arrow icon next to the group icon and the member Edit dropdown menu are highlighted.
      PermessoDescrizione
      Modifica I membri del ruolo possono utilizzare, vistae modificare le versioni attuale e precedente del pacchetto, tra cui la pubblicazione di modifiche a esso. L'autorizzazione all'edizione a un ruolo da questa finestra consente l'accesso solo alla versione attuale del pacchetto .
      Nessun accesso I membri del ruolo non hanno accesso a nessuna nuova versione del pacchetto, anche se mantengono l'accesso alla versione attuale inserita nel Posto.
    • Per un pacchetto di proprietà dell'utente , cerca gli amici attraverso il campo di ricerca, fai clic sul loro Nome utentee scegli un Livellodi autorizzazione.

      PermessoDescrizione
      Utilizza e visualizza L'utente può utilizzare e visualizzare (ma non Modificare) le versioni attuale e precedente del pacchetto. Una volta fornito un'abilità all'utente, non puoi revocare l'accesso a una copia che hanno già inserito nella loro esperienza; revocare l'accesso non impedisce la ri-inserzione o gli aggiornamenti del pacchetto, ma le copie del pacchetto nel loro modello di dati rimangono intatte.
      Modifica L'utente può utilizzare, vistae modificare le versioni attuale e precedente del pacchetto, tra cui la pubblicazione di cambiamenti in esso.

Modifica dei pacchetti

Puoi modificare pacchetti e i loro figli come altri oggetti. La modifica dei pacchetti disabilita l'aggiornamento automatico fino a quando non pubblichi o non ripristini le modifiche.

The pop-up notice that you cannot update a modified package until you publish or revert your changes.

La maggior parte delle modifiche contrassegna il pacchetto come modificato, anche se i seguenti cambiamenti non sono considerati modifiche del pacchetto:

  • Cambiare il nome del nodo di root.
  • Cambiare la posizione o la rotazione del nodo di radice di un pacchetto che è un Class.BasePart , 1> Class.Model1> o 4> Class.GuiObject4> .
  • Cambiare la proprietà Abilitata di un nodo di radice GuiObject come un ScreenGui, 1> Class.SurfaceGui1> o 4> Class.BillboardGui4> .
  • Cambiare il riferimento di una parte di un Weld all'interno del pacchetto che fa riferimento a un istanza al di fuori del pacchetto.

Una volta modificato, i pacchetti con cambiamenti non pubblicati ottengono un'icona modificata nella finestra Explorer :

The Explorer window with an icon that identifies unpublished package changes.

Aggiungere o aggiornare le configurazioni

Puoi includere attributi dell'istanza alla radice di un pacchetto per personalizzare il suo comportamento, ad esempio la velocità massima di un veicolo confezionato o il tempo di rimbalzo per un pulsante confezionato.

Quando pubblichi un pacchetto, l'attuale insieme di attributi/valori diventerà la Configurazione predefinita del pacchetto. In qualsiasi copia del pacchetto, le configurazioni sono visualizzate in caratteri in grassetto e questi valori di attrributo possono essere modificati su base per istanza. Quando le copie del pacchetto vengono aggiornate, le configurazioni modificati vengono preservate, mentre le altre att

The Attributes section of the Properties window. Two properties are highlighted as having their default values while two other italicized properties are highlighted to show they have been configured.

Pacchetti annidati

Puoi annidare pacchetti all'interno di altri pacchetti per mantenere e collaborare su gerarchie complesse, come una serie di meccanismi di veicolo che possono essere modificati indipendentemente dal pacchetto padre del veicolo. Questo esempio mostra un pacchetto di auto che contiene quattro copie dello stesso pacchetto ruota:

An expanded hierarchy in the Explorer window showing how packages can contain packages.

Script del pacchetto

Ogni script all'interno di un pacchetto non modificato è leggibile solo e mostra una notifica nella parte superiore con un link Hyper per sbloccare lo script.

A script tab with a yellow notification that you can click to modifiy the script that's within an unmodified package.

Cliccando il link hipertestuale:

  • Consegna il pacchetto come modificato indipendentemente dal fatto che tu modifichi lo script.
  • Rimuove la notifica/iperlegame da altri script nel pacchetto.

Una volta pubblicato il pacchetto e spostato in uno stato non modificato, gli script sotto di esso diventano read-only con un link Hypertext per modificare.

Ripristinare le modifiche del pacchetto

Invece di annullare una serie di cambiamenti di pacchetto uno per uno, puoi ripristinare le modifiche non pubblicate in un'azione, ripristinare un pacchetto a una versione precedente versione o ripristinare le modifiche a una configurazione specifica Configurazioni .

Ripristinare le modifiche non pubblicate

Per annullare una serie intera di non pubblicati cambiamenti:

  1. Nella finestra Explorer, individua le copie modifiche all'esclamazione punto accanto ai loro nomi. Puoi anche selezionare le copie modifiche nella vista 3D, che potrebbe essere più semplice.

  2. Fai clic con il pulsante destro del mouse su una singola copia modificata e seleziona Annulla modifiche ai pacchetti , o seleziona più copie (almeno una di loro modificata), fai clic con il pulsante destro del mouse e seleziona Annulla modifiche ai pacchetti selezionati .

Ripristino alla versione

Per ripristinare un pacchetto a una versione precedentemente pubblicata :

  1. Nella finestra Explorer, 3D viewport, Toolbox, o Manager risorse, fai clic con il pulsante destro del mouse sul pacchetto desiderato e seleziona Dettagli del pacchetto .

  2. Nella finestra Configurazione delle risorse, seleziona Versioni . La finestra visualizza i dettagli per ciascuna versione pubblicata, tra cui la data e l'ora di pubblicazione, nonché qualsiasi descrizione delle modifiche.

  3. Fai clic sul checkmark accanto alla versione che vuoi ripristinare e fai clic su Invia .

    The pop-up window for a chandelier asset. It displays multiple versions.

Ripristinare le configurazioni

Per tornare qualsiasi 属性 di configurazione alla sua impostazione predefinita, seleziona l'opzione Reset dal menu degli attrezzi nella sezione Attributi della finestra 2>Proprietà2>.

The Attributes section of the Properties window. The gear menu is expanded and the Reset menu item is highlighted.

Confronto delle versioni della pacchetto

Quando un pacchetto ha più versioni, puoi confrontare le modifiche tra le versioni usando il visualizzatore delle differenze, che è utile per rivedere gli aggiornamenti del pacchetto, confrontare le tue modifiche locali contro l'ultima versione e controllare il contenuto delle versioni precedenti prima di ripristinare.

Lo strumento ha un menu di livello della pacchetto che indica tutte le istanze aggiunte, rimosso o modificato tra le versioni utilizzando gli icon corrispondenti, con le seguenti schede disponibili:

  • Visual Overview mostra le differenze visive della rendering 3D sotto diverse posizioni della fotocamera. È la vista predefinita per i pacchetti con un oggetto 3D (modelli, parti) come oggetto radice, e è attualmente disponibile solo per il solo oggetto radice.

    An example of the Visual Overview tab in the diff viewer. One version of a building displays on the left-hand side, and another on the right-hand side.
  • Property mostra le modifiche delle proprietà e degli attributi. È la vista predefinita per i pacchetti con un oggetto non 3D (scritto, luci, oggetti 2D) come oggetto di base, e è disponibile per tutte le istanze in un pacchetto.

    An example of the Properties tab in the diff viewer. Modified properties in different versions are highlighted.
  • Script mostra le differenze di script linea per linea. È disponibile per i pacchetti che contengono gli script, indipendentemente dal fatto che lo script sia l'oggetto root o no.

    An example of the Script tab in the diff viewer. Modified script lines in different versions are highlighted.

Per confrontare le versioni del pacchetto:

  1. Nella finestra Explorer o nella vista 3D, fai clic con il pulsante destro del mouse sulla cartella target e seleziona Confronta le versioni del pacchetto .

  2. Per impostazione predefinita, la finestra confronta le modifiche tra la tua copia locale e l'ultima versione. Usa i due menu a discesa per confrontare le diverse versioni.

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. Dopo aver selezionato le versioni:

    • Per confrontare le rappresentazioni visive del modello di base, se Applicabile, seleziona la scheda Visual Overview e regola il controllo della fotocamera per il tuo angolo desiderato. I controlli vengono sincronizzati tra le visualizzazioni:

      • Panorama la fotocamera utilizzando i clic del mouse sinistro.
      • Ruota la fotocamera utilizzando i clic del mouse destro.
      • Zoota in e out della fotocamera con la rotella del mouse.
      • Ricorsa usando la scorciatoia di tastiera -F .
    • Per confrontare le proprietà e gli attributi di un'esempio, seleziona l'istanza e la scheda Proprietà .

    • Per confrontare le differenze dello script, se Applicabile, seleziona qualsiasi script per aprire la Script scheda per le modifiche linea per linea tra le tue versioni selezionate, simile alle applicazioni di controllo delle linee.

In alternativa, puoi aprire lo strumento di differenza dello script direttamente:

  1. Nella finestra Explorer o nella vista 3D, fai clic con il pulsante destro del mouse sulla pacchetto target, che deve essere uno script o contenere uno script, e seleziona Visualizza modifiche dello script .
  2. Nella scheda diff che si apre, paragli tutte le modifiche dello script selezionato tra la copia attuale del pacchetto e la versione pubblicata o locale più recente.