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, ajoutez-le d'abord à un groupe Model de regroupement afin que vous puissiez ajouter, supprimer ou échelonner des objets enfants dans le paquet plus tard sans briser le paquet.

Pour créer un paquet :

1. Dans la fenêtre Explorateur ou dans la fenêtre 3D, faites un clic droit sur l'objet que vous voulez transformer en package, puis dans le menu contextuel, 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 "lien de 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'endroit actuel, 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èle de données d'un lieu publié, 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 toute modification de votre package en tant que nouvelle version, rendant vos mises à jour disponibles pour d'autres copies de paquet dans tout l'endroit et à travers toutes les expériences.Il n'est pas nécessaire de publier un paquet modifié avant de publier un lieu car la version modifiée est sauvegardée avec le lieu pour une éventuelle itération future.

Pour publier des modifications dans un package :

1. Dans la fenêtre Explorateur ou la fenêtre 3D, 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 toutes les copies.

   

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 configuration des ressources , sélectionnez versions .
   3. Sous votre dernière modification, sélectionnez Ajouter .
   4. Décris tes modifications, puis clique sur le bouton 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 3D, 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é) Fermer 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 3D, 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.

Pour mettre automatiquement à jour les copies de paquet :

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

Vous pouvez accorder la permission aux amis, aux expériences, aux groupes ou aux rôles d'utilisateur de groupe spécifiques afin qu'ils puissent utiliser librement vos packages dans leurs créations.Une fois que vous partagez un paquet, toutes les versions futures de ce paquet ont les mêmes restrictions, même si vous annulez plus tard le partage de paquet.Pour plus d'informations sur l'accès aux ressources, voir confidentialité des ressources.

Pour partager des packages avec d'autres collaborateurs, le paquet ne doit contenir que des références à des assetIDs que vous avez créés ou à des permissions explicites d'utiliser.

Pour modifier les permissions de paquet pour un collaborateur, comme un ami ou un 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 .

3. En utilisant la barre de recherche, saisissez et sélectionnez un collaborateur auquel vous voulez donner la permission d'utiliser votre package, puis choisissez un niveau de permission.

   Permission	Avertissement
   Utiliser et afficher	Le collaborateur peut utiliser et afficher (mais pas modifier) les versions de paquet actuelles et précédentes.Une fois que vous avez fourni cette capacité à un collaborateur, 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 paquet, mais les copies de paquet dans leur modèle de données restent intactes.
   Modifier	Le collaborateur peut utiliser, afficher et 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 de détruire 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 3D, 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 viewport, 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, indépendamment du fait que le script soit l'objet racine ou non.

  

Pour comparer les versions de paquet :

1. Dans la fenêtre Explorateur 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èle racine, 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.