Packages

Pour garder les actifs organisés et réutilisables au sein de votre équipe ou à travers plusieurs projets, vous pouvez regrouper vos instances et les convertir 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 gestion des versions :

• Mettez facilement à jour toutes les copies d'un package vers la dernière version, ou mettez simplement à jour certaines copies.
• Configurez les packages pour se mettre à jour automatiquement chaque fois qu'une nouvelle version est disponible.
• Donnez aux collaborateurs des permissions Modifier ou Utiliser pour les contenus d'un package.
• Consultez l'historique complet des versions d'un package, comparez les versions et restaurez les anciennes versions.

Le flux de travail le plus efficace consiste à créer un package, à le partager avec des collaborateurs, et à le configurer pour une mise à jour automatique. Et vous n'avez pas besoin d'attendre qu'un modèle soit "terminé" avant de l'utiliser dans un package. Même si le package est un espace réservé au-dessus d'une forme simple, vous pouvez l'utiliser pour grisuer votre environnement et ensuite faire en sorte que les copies d'espace réservé se mettent à jour automatiquement au fur et à mesure que vous publiez des versions plus détaillées.

Créer des packages

Vous pouvez créer un package à partir de n'importe quel objet unique ou de n'importe quelle branche de parent et d'enfants d'objets. Si vous souhaitez créer un package pour un objet unique, ajoutez-le d'abord à un regroupement Model afin de pouvoir ajouter, supprimer ou agrandir des objets enfants dans le package plus tard sans casser le package.

Pour créer un package :

1. Dans la fenêtre Explorateur ou dans la vue 3D, cliquez avec le bouton droit sur l'objet ou les objets que vous souhaitez transformer en package, puis, dans le menu contextuel, sélectionnez Convertir en Package.

2. Dans la nouvelle fenêtre, remplissez les détails du package. En particulier, si vous travaillez dans un groupe, définissez la Propriété sur le groupe approprié dans lequel vous avez l'autorisation de créer/éditer des jeux de groupe.

   Les transferts de propriété ne sont pas pris en charge par le système d'actifs, donc considérez soigneusement le propriétaire lors de la création d'un package.

3. Cliquez sur Soumettre.

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

   

5. OPTIONNEL

   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 package est configuré pour se mettre à jour automatiquement.

Insérer des packages

Pour insérer un package qui n'existe pas déjà dans le lieu 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 depuis le Store du Créateur, ainsi que les packages qu'un ami possède et à qui vous avez donné autorisations pour les utiliser.
• À partir de Créations ⟩ Packages de Groupe pour les packages publiés par des membres de votre groupe (y compris vous-même).

Une fois que vous avez inséré un package dans le modèle de données d'un lieu publié, il apparaît dans le Gestionnaire d'actifs et y demeure même si vous supprimez plus tard toutes ses copies.

Modifier des packages

Vous pouvez éditer des packages et leurs enfants tout comme d'autres objets. Modifier des packages désactive l'auto-mise à jour jusqu'à ce que vous publiiez ou reveniez sur les changements.

La plupart des modifications signalent le package comme modifié, bien que les changements suivants ne soient pas considérés comme des modifications de package :

• Changer le nom du nœud racine.
• Changer la position ou la rotation du nœud racine d'un package qui est un BasePart, Model, ou GuiObject.
• Changer la propriété Enabled d'un nœud racine GuiObject tel qu'un ScreenGui, SurfaceGui, ou BillboardGui.
• Changer une référence de pièce d'un Weld à l'intérieur du package qui référence une instance en dehors du package.

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

Ajouter ou mettre à jour des configurations

Vous pouvez inclure des attributs d'instance à la racine d'un package pour personnaliser son comportement. Lorsque vous publiez un package, l'ensemble actuel d'attributs/valeurs deviendra les configurations par défaut du package. Pour toute copie d'un package donnée, ces valeurs d'attribut peuvent être changées sur une base par instance, et ces changements sont notés par des italiques en gras. Lorsque des copies de package sont mises à jour, les valeurs de configuration modifiées seront conservées, tandis que d'autres attributs seront mis à jour avec la dernière valeur par défaut.

Packages imbriqués

Vous pouvez imbriquer des packages à l'intérieur d'autres packages pour maintenir et collaborer sur des hiérarchies complexes, comme une série de mécanismes de véhicule qui peuvent être modifiés indépendamment du package parent du véhicule.

Si vous modifiez un package imbriqué, le package imbriqué et le package parent sont considérés comme modifiés. Vous devez publier les changements de tout package imbriqué avant d'être autorisé à publier des changements sur son package parent, car publier le parent le marquerait comme actuel/non modifié et entrerait en conflit avec les modifications du package imbriqué.

Scripts de package

Chaque script à l'intérieur d'un package non modifié est en lecture seule et affiche une notification en haut avec un lien hypertexte pour déverrouiller le script.

Cliquer sur le lien hypertexte :

• Signale le package comme modifié, peu importe si vous editez le script.
• Supprime la notification/lien hypertexte des autres scripts à l'intérieur du package.

Une fois que le package est publié et déplacé vers un état non modifié, les scripts qui se trouvent sous lui deviennent en lecture seule avec un lien hypertexte pour modifier.

Publier des changements de package

Vous pouvez publier tout changement fait à un package comme une nouvelle version, rendant vos mises à jour disponibles pour d'autres copies de package dans le lieu et à travers tous les jeux. Il n'est pas nécessaire de publier un package modifié avant de publier un lieu car la version modifiée est sauvegardée avec le lieu pour de futures itérations.

Pour publier des changements sur un package :

1. Dans la fenêtre Explorateur ou dans la vue 3D, cliquez avec le bouton droit sur la copie modifiée et sélectionnez Publier vers Package.

2. Si une copie de package a l'auto-mise à jour activée, elle intègre immédiatement la version mise à jour lorsque vous ouvrez le lieu qui les contient. Les autres copies obtiennent un symbole de "téléchargement" qui indique qu'une mise à jour est disponible. Vous pouvez mettre à jour individuellement ou mettre à jour en masse toutes les copies.

   

3. OPTIONNEL

   Ajoutez une description de vos changements :

   1. Cliquez avec le bouton droit sur le package et sélectionnez Détails du package.
   2. Dans la fenêtre Configuration de l'actif, sélectionnez Versions.
   3. Sous votre dernier changement, sélectionnez Ajouter.
   4. Décrivez vos changements, puis cliquez sur le bouton Soumettre.

Mettre à jour les copies obsolètes

Vous pouvez mettre à jour les copies de package obsolètes vers la version la plus récente, ou vous pouvez continuer à utiliser la version plus ancienne.

1. Dans la fenêtre Explorateur, repérez les copies obsolètes grâce au symbole de "téléchargement". Vous pouvez également sélectionner la copie obsolète dans la vue 3D.

   

2. Cliquez avec le bouton droit sur une copie obsolète et sélectionnez Obtenir le package le plus récent. Vous pouvez également sélectionner plusieurs packages, faire un clic droit et sélectionner Obtenir le dernier pour les packages sélectionnés.

Mises à jour en masse

Une utilisation extensive des packages peut entraîner de nombreuses copies de package à travers plusieurs lieux dans un jeu. En plus de la synchronisation individuelle et des mises à jour automatiques, vous pouvez mettre à jour toutes les copies d'un package par le biais de la mise à jour en masse.

1. RECOMMANDÉ

   Fermez d'autres instances de Studio avec n'importe lequel des lieux du jeu ouverts ; cela empêche une autre instance non sauvegardée d'un lieu d'éventuellement écraser vos mises à jour.
2. Dans la fenêtre Explorateur ou dans la vue 3D, cliquez avec le bouton droit sur le package désiré et sélectionnez Mettre à jour tout.
3. Choisissez tous les lieux dans le jeu ou un sous-ensemble de lieux et cliquez sur Mettre à jour.

Mises à jour automatiques

Pour faciliter la synchronisation, vous pouvez configurer une copie de package pour se mettre à jour automatiquement chaque fois qu'une version plus récente est publiée. La mise à jour automatique des copies de package aura lieu lorsque le lieu sera ouvert dans Studio.

1. Dans la fenêtre Explorateur, développez l'arbre hiérarchique du package et sélectionnez son objet PackageLink.

   

2. Dans la fenêtre Propriétés, activez la propriété AutoUpdate. Si vous avez des packages imbriqués, cette propriété ne s'applique qu'au package parent de plus haut niveau, ce qui signifie que les mises à jour automatiques n'ont lieu que lorsque le package parent est mis à jour.

Partager et niveaux d'accès

Vous pouvez accorder la permission à des amis, des jeux, des groupes ou des rôles d'utilisateur de groupe spécifiques afin qu'ils puissent utiliser librement vos packages dans leurs créations. Pour plus d'informations sur l'accès aux actifs, consultez Confidentialité des actifs.

Pour changer les autorisations d'un package pour un collaborateur, tel qu'un ami ou un groupe :

1. Dans la fenêtre Explorateur, Boîte à Outils, ou Gestionnaire d'Actifs, cliquez avec le bouton droit sur le package désiré et sélectionnez Options du package ⟩ Détails du package.

2. Dans la fenêtre Configuration de l'actif, sélectionnez Permissions.

3. À l'aide de la barre de recherche, saisissez et sélectionnez un collaborateur à qui vous souhaitez accorder la permission d'utiliser votre package, puis choisissez un niveau de permission.

   Permission	Description
   Utiliser & Voir	Le collaborateur peut utiliser et voir (mais pas éditer) les versions actuelles et précédentes du package. Une fois que vous avez donné à un collaborateur cette capacité, vous ne pouvez pas révoquer l'accès à une copie qu'il a déjà insérée dans son jeu ; révoquer l'accès empêche la réinsertion ou les mises à jour du package, mais les copies de package dans son modèle de données restent intactes.
   Modifier	Le collaborateur peut utiliser, voir et modifier les versions actuelles et précédentes du package, y compris publier des changements à celui-ci.

Revenir sur les changements de package

Au lieu d'annuler une série entière de changements de package un par un, vous pouvez revenir sur les changements non publiés en une seule action, restaurer un package à une version précédente, ou revenir sur des changements spécifiques aux configurations.

Revenir sur les changements non publiés

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

1. Dans la fenêtre Explorateur, repérez les copies modifiées par le point sur leurs icônes de package. Vous pouvez également sélectionner des copies modifiées dans la vue 3D.

   

2. Cliquez avec le bouton droit sur une seule copie modifiée et sélectionnez Annuler les changements au package, ou sélectionnez plusieurs copies (au moins une d'entre elles étant modifiée), cliquez avec le bouton droit et sélectionnez Annuler les changements des packages sélectionnés.

Restaurer à une version publiée

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

1. Dans la fenêtre Explorateur, Boîte à Outils, ou Gestionnaire d'Actifs, cliquez avec le bouton droit sur le package désiré et sélectionnez Options du package ⟩ Détails du package.
2. Dans la fenêtre Configuration de l'actif, 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 toute description des changements.
3. Cliquez sur la coche à côté de la version que vous souhaitez restaurer et cliquez sur Soumettre.

Revenir sur les configurations

Pour revenir sur un attribut des configurations à sa valeur par défaut, sélectionnez Réinitialiser dans son menu d'options dans la section Attributs de la fenêtre Propriétés.

Comparer les versions de package

Lorsqu'un package a plusieurs versions, vous pouvez comparer les changements entre les versions à l'aide de l'outil de comparaison. L'outil a un menu hiérarchique de package qui indique toutes les instances ajoutées, supprimées ou modifiées entre les versions en utilisant des icônes correspondantes, y compris les fonctionnalités suivantes :

• Vue Visuelle montre les différences visuelles du rendu 3D sous différents angles 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 est actuellement disponible uniquement pour l'objet racine.

• Propriétés montre les changements 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 d'un package.

• Script montre les différences de script ligne par ligne. Elle est disponible pour les packages contenant des scripts, peu importe si le script est l'objet racine ou non.

Pour comparer les versions de package :

1. Dans la fenêtre Explorateur ou dans la vue 3D, cliquez avec le bouton droit sur le package cible et sélectionnez Options du package ⟩ Comparer les versions de package.

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

   

   Certaines versions anciennes pourraient être incompatibles avec l'outil de différence de package.

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

   1. Pour comparer les rendus visuels du modèle racine, le cas échéant, sélectionnez l'onglet Vue Visuelle et ajustez le contrôle de la caméra pour votre angle désiré. Les contrôles sont synchronisés à travers les vues :

      • Déplacez la caméra en utilisant des clics gauche de la souris.
      • Faites pivoter la caméra en utilisant des clics droit de la souris.
      • Effectuez un zoom avant et arrière de la caméra avec la molette de la souris.
      • Recentrez en utilisant le raccourci clavier F.

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

   3. Pour comparer les différences de script pour un package qui est un script ou contient des scripts, utilisez l'onglet Script.

      Cet outil ne vous permet de comparer les changements de script qu'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 directement l'outil de différence de script en cliquant avec le bouton droit sur le package cible dans la fenêtre Explorateur ou dans la vue 3D et en sélectionnant Voir les changements de script.