Paquets

Pour garder les ressources organisées et réutilisables au sein de votre équipe ou à travers plusieurs projets, regroupez vos instances et convertissez-les en packages réutilisables . .Les packages rendent le processus global de construction de mondes plus rapide et plus ergonomique, mais ils aident également à la cohérence, à la déduplication, à la collaboration et à la version :

• Mise à jour facile de toutes les copies d'un paquet à la dernière version (ou seulement mise à jour de copies spécifiques ).
• Définir les packages pour mettre à jour automatiquement chaque fois qu'il y a une nouvelle version.
• Donnez aux collaborateurs modifier ou utiliser les permissions aux contenus d'un paquet.
• Afficher l'historique complet de la version d'un paquet, comparer les versions et restaurer les anciennes versions.

Le flux de travail le plus efficace est de créer un package , le partager avec tous les collaborateurs, et le mettre à jour automatiquement.Et vous n'avez pas à attendre qu'un modèle soit « terminé » avant de l'utiliser dans un paquet.Même si le paquet est un placeholder au-dessus d'une forme simple, vous pouvez l'utiliser pour graver votre environnement et ensuite faire en sorte que les copies du placeholder se mettent à jour automatiquement lorsque vous publiez des versions plus détaillées.

Créer des packages

Vous pouvez créer un paquet à partir de n'importe quel objet unique ou de n'importe quelle branche parent-enfant d'objets.Si vous voulez créer un paquet pour un seul objet, nous vous recommandons d'ajouter d'abord le groupe à un Model groupement afin que vous puissiez ajouter, retirerou écheler l'instance dans le paquet plus tard sans briser le paquet.

1. Dans la fenêtre Explorateur ou la fenêtre de jeu3D, faites un clic droit sur l'objet souhaité et sélectionnez Convertir en package .

2. Dans la nouvelle fenêtre, remplissez les détails du paquet.En particulier, si vous travaillez dans un groupe, définissez la propriété à l'égard du groupe approprié auquel vous avez la permission de créer/modifier des expériences de groupe.

   Les transferts de propriété ne sont pas pas pris en charge par le système de ressources, alors réfléchissez soigneusement au propriétaire lors de la création d'un paquet.

3. Cliquez sur Soumettre .

4. Après la conversion terminée, l'objet reçoit un symbole de "lierde chaîne" dans la fenêtre Explorateur pour l'identifier comme un paquet.En outre, vous pouvez voir un nouvel objet PackageLink parenté à l'objet.

   

5. (Facultatif) Sélectionnez l'objet PackageLink et activez AutoUpdate dans la fenêtre Propriétés .Notez comment l'icône change pour indiquer que le paquet est configuré pour se mettre à jour automatiquement.

   

Insérer des packages

Pour insérer un package qui n'existe pas déjà à l'emplacementactuel, vous devez initialement l'insérer à partir de la boîte à outils :

• À partir de Inventaire ⟩ Mes packages pour les packages que vous avez publiés ou obtenus auprès du magasin des créateurs, ainsi que des packages que possède et vous a donné des permissions d'utilisation un ami.
• À partir de créations ⟩ packages de groupe pour les packages publiés par les membres de votre groupe (y compris vous-même).

>

>

Une fois que vous avez inséré un paquet dans le modèlisationde données d'un emplacementpublié, il apparaît dans le gestionnaire des ressources et reste là même si vous supprimez ultérieurement toutes les copies de celui-ci.

Publier les modifications de paquet

Vous pouvez publier toutes les modifications que vous apportez à un package en tant que nouvelle version pour les rendre disponibles à d'autres copies du paquet dans tout l'endroit et à travers toutes les expériences.Notez que ce n'est pas pas nécessaire de publier un paquet modifié avant de publier un lieu (la version modifiée est sauvegardée avec le lieu pour une prochaine itération).

Pour publier des modifications dans un package :

1. Dans la fenêtre Explorateur ou la fenêtre de jeu3D, faites un clic droit sur la copie modifiée et sélectionnez Publier dans le paquet .

2. Si une copie de paquet a mise à jour automatique activée, elle récupère immédiatement la version mise à jour lorsque vous ouvrez l'endroit qui les contient.D'autres copies reçoivent un point blanc sur l'icône de paquet indiquant qu'une mise à jour est disponible.Vous pouvez mettre à jour individuellement ou mettre à jour en masse comme nécessaire.

   

3. (Facultatif) Ajoutez une description de vos modifications :

   1. Faites un clic droit sur le paquet et sélectionnez Détails du paquet .
   2. Dans la fenêtre de configuration des ressources, sélectionnez versions .
   3. Sous votre dernière modification, sélectionnez Ajouter .
   4. Décris tes modifications et clique sur Soumettre .

Mettre à jour les copies obsolètes

Vous pouvez mettre à jour les copies de paquet obsolètes à la dernière version, ou vous pouvez continuer à utiliser l'ancienne version.

Pour mettre à jour une ou plusieurs copies de paquet à la dernière version :

1. Dans la fenêtre Explorateur , localisez les copies obsolètes par le point blanc sur l'icône du paquet.Vous pouvez également sélectionner la copie obsolète dans la fenêtre de jeu3D, mais il peut être plus difficile de trouver de cette façon.

   

2. Faites un clic droit sur la copie obsolète et sélectionnez Obtenir le dernier package .Vous pouvez également sélectionner plusieurs packages, faire un clic droit, et Obtenir le dernier pour les packages sélectionnés .

Mises à jour de masse

Une utilisation extensive des packages peut entraîner de nombreuses copies de paquet dans plusieurs endroits dans une expérience.En plus de la synchronisation individuelle et de mises à jour automatiques, vous pouvez mettre à jour toutes les copies d'un paquet via mise à jour en masse .

1. (Recommandé) Fermez d'autres instances de Studio avec l'un des lieux de l'expérience ouverts ; cela empêche une autre instance non enregistrée d'un lieu de potentiellement écraser vos mises à jour.

2. Dans la fenêtre Explorateur ou la fenêtre de jeu3D, faites un clic droit sur le paquet souhaité et sélectionnez Mettre à jour tout .

3. Choisissez tous les endroits dans l'expérience ou une sous-partie d'endroits et cliquez sur mettre à jour .

   

   Pour empêcher les écrasements non intentionnels, la mise à jour en masse n'affecte pas les versions modifiées de package.Une fois la mise à jour de masse terminée, Studio affiche un avertissement avec le nombre de packages qu'il n'a pas mis à jour non , s'il y a lieu.

Mises à jour automatiques

Pour rendre la synchronisation plus facile, vous pouvez définir une copie de paquet pour se mettre à jour automatiquement chaque fois qu'une nouvelle version est publiée.La mise à jour automatique des copies de paquet aura lieu lorsqu'un emplacement sera ouvert dans Studio.

1. Dans la fenêtre Explorateur , étendez l'arbre hiérarchique du paquet et sélectionnez son objet Lien de paquet .

   

2. Dans la fenêtre propriétés , activez la propriété mise à jour automatique .Si vous avez des packages imbriqués, cette propriété ne s'applique qu'au paquet parent de plus haut niveau, ce qui signifie que les mises à jour automatiques ne se produisent que lorsque le paquet parent est mis à jour.

Niveaux de partage et d'accès

Si vous le souhaitez, vous pouvez partager des packages avec des amis ou accorder l'accès à des rôles d'utilisateur spécifiques au sein de votre groupe.

1. Dans la fenêtre Explorateur , boîte à outils , ou gestionnaire de ressources , faites un clic droit sur le paquet souhaité et sélectionnez détails du paquet .

2. Dans la fenêtre configuration des ressources , sélectionnez autorisations .

   • Pour un paquet appartenant à un groupe, étendez l'arbre des rôles .Choisissez ensuite un niveau d'autorisation pour chaque rôle.Les boîtes de sélection désactivées indiquent que l'autorisation est déjà configurée pour ce rôle et ne peut pas être modifiée à partir de cette fenêtre.

     

     Permission	Avertissement
     Modifier	Les membres du rôle peuvent utiliser, voiret modifier les versions actuelles et précédentes du paquet, y compris publier des modifications dessus.Accorder l'accès d'édition à un rôle à partir de cette fenêtre ne donne accès qu'au paquet spécifique .
     Pas d'accès	Les membres du rôle n'ont pas accès à de nouvelles versions du paquet, bien qu'ils conservent l'accès à la version actuelle insérée dans l'emplacement.

   • Pour un paquet appartenant à l'utilisateur , recherchez des amis dans le champ de recherche, cliquez sur leur nom d'utilisateur et choisissez un niveau d'autorisation.

     Permission	Avertissement
     Utiliser et afficher	L'utilisateur peut utiliser et afficher (mais pas modifier) les versions de paquet actuelles et précédentes.Une fois que vous avez fourni une capacité à un utilisateur, vous ne pouvez pas révoquer l'accès à une copie qu'il a déjà insérée dans son expérience ; la révocation de l'accès empêche la réinsertion ou les mises à jour de package, mais les copies de package dans son modèle de données restent intactes.
     Modifier	L'utilisateur peut utiliser, voiret modifier les versions actuelles et précédentes du paquet, y compris publier des modifications dessus.

Modifier les packages

Vous pouvez modifier des packages et leurs enfants comme d'autres objets. Le modifier des packages désactive la mise à jour automatique jusqu'à ce que vous publiiez ou annuliez les modifications.

La plupart des modifications marquent le paquet comme modifié, bien que les modifications suivantes ne soient pas pas considérées comme des modifications de paquet :

• Changer le nom du nœud racine .
• Changer la position ou la rotation de la racine d'un paquet qui est un , ou .
• Changer la propriété activée d'un nœud racine GuiObject comme un ScreenGui , SurfaceGui ou BillboardGui .
• Changer une référence de partie d'un Weld à l'intérieur du paquet qui fait référence à une instance en dehors du paquet.

Une fois modifié, les packages avec des modifications non publiées obtiennent une icône modifiée dans la fenêtre Explorateur :

Ajouter ou mettre à jour les configurations

Vous pouvez inclure les attributs d'instance à la racine d'un paquet pour personnaliser son comportement, par exemple la vitesse maximale d'un véhicule emballé ou le temps de débounce d'un bouton emballé.

Lorsque vous publiez un paquet, l'ensemble actuel d'attributs/valeurs deviendra les configurations par défaut du paquet .Sur n'importe quelle copie d'un paquet, les configurations sont affichées en caractères gras et ces valeurs d'attribut peuvent être modifiées sur une base par instance.Lorsque les copies de paquet sont mises à jour , les valeurs de configuration modifiées seront conservées, tandis que d'autres attributs seront mis à jour vers la dernière valeur par défaut.

Packages hérités

Vous pouvez imbriquer des packages dans d'autres packages pour maintenir et collaborer sur des hiérarchies complexes, telles qu'une série de mécaniques de véhicules qui peuvent être modifiées indépendamment du package parent du véhicule.Cet exemple montre un paquet de voiture contenant quatre copies du même paquet de roues :

Scripts de paquet

Chaque script dans un paquet non modifié est lu seul et montre une notification en haut avec un hyperlien pour déverrouiller le script.

Cliquez sur le lien hypertexte :

• Marque le paquet comme modifié indépendamment de si vous modifiez le script.
• Supprime la notification/le lien hypertexte de autres scripts dans le paquet.

Une fois le paquet publié et déplacé vers un état non modifié non modifié , les scripts qui s'y trouvent deviennent lisibles avec un hyperlien à modifier.

Revenir aux modifications du paquet

Au lieu d'annuler une série entière de modifications de paquet une par une, vous pouvez annuler les modifications non publiées dans une action, restaurer un paquet à une version précédente ou restaurer les modifications à des configurations spécifiques .

Revenir aux modifications non publiées

Pour annuler une série entière de modifications non publiées :

1. Dans la fenêtre Explorateur , localisez les copies modifiées par le point d'exclamation à côté de leurs noms.Vous pouvez également sélectionner des copies modifiées dans la fenêtre de jeu3D, ce qui peut être plus facile.

2. Faites un clic droit sur une seule copie modifiée et sélectionnez Annuler les modifications du paquet , ou sélectionnez plusieurs copies (au moins une d'entre elles modifiée), faites un clic droit et sélectionnez Annuler les modifications des packages sélectionnés .

Restaurer à la version

Pour restaurer un paquet à une version publiée précédemment :

1. Dans la fenêtre Explorateur , 3D fenêtre de jeu, boîte à outils , ou gestionnaire de ressources , faites un clic droit sur le paquet souhaité et sélectionnez détails du paquet .

2. Dans la fenêtre configuration des ressources , sélectionnez versions .La fenêtre affiche les détails de chaque version publiée, y compris la date et l'heure de publication, ainsi que toutes les descriptions des modifications.

3. Cliquez sur la case à cocher à côté de la version que vous souhaitez restaurer et cliquez sur Soumettre .

   

Revenir aux configurations

Pour restaurer n'importe quelle propriété de configuration à sa valeur par défaut, sélectionnez l'option Réinitialiser du menu équipement dans la section Attributs des fenêtres Propriétés .

Comparer les versions de paquet

Lorsqu'un paquet a plusieurs versions, vous pouvez comparer les modifications entre les versions à l'aide du visualiseur de diff, ce qui est utile pour revoir les mises à jour de package, comparer vos modifications locales contre la dernière version et vérifier le contenu des versions précédentes avant de restaurer.

L'outil a un menu de hiérarchie des packages qui indique toutes les instances ajoutées, supprimées ou modifiées entre les versions en utilisant les icônes correspondantes, avec les onglets suivants disponibles :

• Aperçu visuel montre les différences visuelles du rendu 3D sous différentes positions de caméra.C'est la vue par défaut pour les packages avec un objet 3D (modèles, pièces) comme objet racine, et elle n'est actuellement disponible que pour l'objet racine.

  

• Propriétés montre les modifications de propriétés et d'attributs.C'est la vue par défaut pour les packages avec un objet non 3D (scripts, lumières, objets 2D) comme objet racine, et elle est disponible pour toutes les instances dans un package.

  

• Le script montre les différences de script ligne par ligne.Il est disponible pour les packages contenant des scripts, qu'ils soient l'objet racine ou non.

  

Pour comparer les versions de paquet :

1. Dans la fenêtre fenêtre de jeu ou dans la fenêtre 3D, faites un clic droit sur le paquet cible et sélectionnez comparer les versions de paquet .

2. Par défaut, la fenêtre compare les modifications entre votre copie locale et la dernière version. Utilisez les deux menus déroulants pour comparer différentes versions.

   

   Certaines versions plus anciennes peuvent être incompatibles avec l'outil de comparaison de paquet.

3. Après avoir sélectionné les versions :

   • Pour comparer les rendements visuels du modèlisationracine, si applicable, sélectionnez l'onglet vision d'ensemble et ajustez le contrôle de la caméra pour l'angle souhaité.Les contrôles sont synchronisés à travers les vues :

     • Panneau de la caméra en utilisant les clics de souris gauche.
     • Faites pivoter la caméra en utilisant les clics de souris droits.
     • Faites zoomer et dézoomer la caméra avec la molette de la souris.
     • Recentrez-vous en utilisant la raccourci clavier -F.

   • Pour comparer les propriétés et les attributs d'une instance, sélectionnez l'instance et l'onglet propriétés .

   • Pour comparer les différences de script, si cela est applicable, sélectionnez n'importe quel script pour ouvrir l'onglet script pour les modifications ligne par ligne entre vos versions sélectionnées, similaire aux applications de contrôle de source.

     Cet outil ne vous permet de comparer que les modifications de script entre la version actuelle et la dernière version publiée ou locale, sans indiquer les collaborateurs qui ont apporté le changement.

Alternativement, vous pouvez ouvrir l'outil de comparaison de script directement :

1. Dans la fenêtre Explorateur ou la fenêtre 3D, faites un clic droit sur le paquet cible, qui doit être un script ou contenir des scripts, et sélectionnez Afficher les modifications de script .
2. Dans l'onglet diff qui s'ouvre, comparez toutes les modifications du script sélectionné entre la copie du paquet actuelle et la dernière version publiée ou locale.