Pour optimiser la gestion des éléments dans l'ensemble de votre équipe ou sur plusieurs projets, vous pouvez transformer des éléments simples ou des hiérarchies d'éléments en paquets et les réutiliser dans plusieurs expériences. Lorsqu'un paquet est mis à jour, vous ou les membres de votre équipe pouvez mettre à jour des copies spécifiques avec la version la plus récente, mettre à jour toutes les copies d'une expérience ou définir la mise à jour automatique de copies spécifiques. Les paquets comprennent également un mécanisme de configuration qui permet aux créateurs et aux éditeurs de paquets d'inclure des options pour personnaliser le comportement d'un paquet.
Créer des paquets
Il est possible de créer un paquet à partir d'un seul nœud ou d'un nœud racine de la sous-arborescence dans le modèle de données.
Dans la fenêtre Explorateur, cliquez droit sur l'objet/nœud souhaité et sélectionnez Convertir en paquet dans le menu contextuel.
Dans la fenêtre de dialogue, saisissez les détails demandés. Pour être plus précis, si vous travaillez dans un groupe, définissez Propriétaire sur le groupe auquel vous souhaitez donner l'autorisation de créer/modifier des expériences de groupe.
Cliquez sur le bouton Envoyer.
Une fois terminé, le symbole de « lien de chaîne » situé sur l'icône de l'objet l'identifie comme un paquet. En outre, vous verrez un nouvel objet PackageLink parenté à l'objet.
Insérer des paquets
Pour insérer un paquet qui n'existe pas encore à l'emplacement actuel, vous devez initialement l'insérer à partir de la boîte à outils en suivant les instructions suivantes :
- À partir de l'Inventaire → Mes paquets pour les paquets que vous avez publiés ou obtenus à partir du Marketplace du créateur.
- À partir de Créations → Paquets de groupe pour les paquets publiés par les membres de votre groupe (vous compris).
Une fois que vous avez inséré un paquet dans le modèle de données d'un emplacement, il apparaît dans le dossier Paquets du Gestionnaire de contenus et y reste, même si vous supprimez ensuite toutes les copies de celui-ci. Cependant, lorsque vous publiez l'emplacement, le dossier se mettra à jour pour refléter uniquement les paquets utilisés dans l'emplacement.
Modifier les paquets
Vous pouvez modifier les paquets et leurs enfants de la même manière qu'avec les autres objets. Sur la première modification qui change une instance de paquet, une boîte de dialogue d'alerte apparaît, pour avertir qu'un paquet modifié ne peut pas être mis à jour de quelconque manière et doit être rétabli pour annuler une série de modifications.
La plupart des modifications indiqueront que le paquet est modifié, bien que les modifications suivantes ne soient pas prises en compte dans les modifications du paquet :
Modifier | Modifie le paquet |
---|---|
Modification du nom du nœud racine. | non |
Modification de la position ou de la rotation du nœud racine d'un paquet qui est un BasePart, Model ou GuiObject. | non |
Modification de la propriété Activé d'un nœud racine GuiObject, comme un ScreenGui, SurfaceGui ou BillboardGui. | non |
Modification d'une référence d'un élément d'un Weld à l'intérieur du paquet qui fait référence une instance en dehors du paquet. | non |
Une fois modifiés, les paquets associés à des modifications non publiées sont marqués d'un point jaune dans la hiérarchie de l'Explorateur.
Ajouter ou mettre à jour des configurations
Vous pouvez inclure des attributs d'instance à la racine d'un paquet pour personnaliser son comportement, par exemple la vitesse maximale d'un véhicule mis en paquet ou le temps de déclenchement pour un bouton mis en paquet.
Lorsque vous publiez un paquet, l'ensemble actuel d'attributs/valeurs deviendra les configurations par défaut du paquet. Sur toute copie donnée d'un paquet, les configurations sont affichées en gras italique et ces valeurs d'attribut peuvent être modifiées par instance. Lorsque les copies de paquet sont mises à jour, les valeurs de configuration modifiées seront préservées, tandis que les autres attributs seront mis à jour avec la dernière valeur par défaut.
Paquets imbriqués
Vous pouvez imbriquer des paquets à l'intérieur d'autres paquets pour maintenir des hiérarchies complexes et y collaborer, comme pour modifier une série de pièces mécaniques d'un véhicule indépendamment du paquet parent du véhicule.
Scripts de paquet
Chaque script qui se trouve au sein d'un paquet non modifié est en lecture seule et affiche une notification en haut avec un hyperlien qui permet de déverrouiller le script.
Un clic sur le lien hypertexte :
- Signale le paquet comme étant modifié, que vous modifiiez ou non le script.
- Supprime la notification/hyperlien des autres scripts au sein du paquet.
Une fois que le paquet est publié et placé en état non modifié, les scripts sous celui-ci passent en lecture seule avec un hyperlien pour le modifier.
Publier des modifications de paquet
Vous pouvez publier un paquet modifié (indiqué par un point jaune) pour mettre ces modifications à la disposition d'autres copies du paquet dans l'ensemble de l'emplacement et de toutes les expériences. Notez qu'il n'est pas nécessaire de publier un paquet modifié avant de publier un emplacement (la version modifiée sera enregistrée avec l'emplacement pour toute itération future).
Pour publier des modifications dans un paquet :
Dans la fenêtre Explorateur, cliquez droit sur la copie modifiée (indiquée par un point jaune) et sélectionnez Publier dans le package.
Pour les copies de paquet définies sur une mise à jour automatique, Studio récupérera immédiatement la version mise à jour. Les autres copies seront marquées d'une icône de synchronisation verte à côté du nom. Vous pouvez également les mettre à jour individuellement ou les mettre à jour en masse au besoin.
Mettre à jour les copies obsolètes
Vous pouvez mettre à jour les copies de paquet obsolètes avec la version la plus récente ou utiliser l'ancienne.
Pour mettre à jour une ou plusieurs copies de paquet dans la dernière version :
Dans la fenêtre Explorateur, localisez les copies obsolètes en utilisant l'icône de synchronisation verte à côté de leur nom.
Cliquez droit sur une copie obsolète et sélectionnez Obtenir le dernier paquet dans le menu contextuel, ou sélectionnez plusieurs copies (dont au moins l'une d'elles a été modifiée), cliquez droit et sélectionnez Obtenir le dernier paquet pour les paquets sélectionnés.
Mises à jour en masse
Une utilisation intensive de paquets peut donner lieu à la présence de nombreuses copies de paquets dans plusieurs emplacements d'une expérience. En plus de la synchronisation individuelle et des mises à jour automatiques, vous pouvez mettre à jour toutes les copies d'un même paquet avec une mise à jour en masse.
(Recommandé) Fermez les autres instances de Studio dans lesquelles l'un des emplacements de l'expérience est ouvert. Cela empêche toute autre instance non enregistrée d'un emplacement de potentiellement écraser vos mises à jour.
Dans la fenêtre Explorateur, cliquez droit sur le paquet souhaité et sélectionnez Tout mettre à jour dans le menu contextuel.
Dans la fenêtre contextuelle, sous les détails de la version/de la date, cochez Tout pour sélectionner tous les emplacements de l'expérience ou sélectionnez uniquement les emplacements spécifiques auxquels vous souhaitez appliquer la mise à jour en masse.
Cliquez sur le bouton Mettre à jour.
Mises à jour automatiques
Pour faciliter la synchronisation, vous pouvez activer la mise à jour automatique d'une copie de paquet à chaque fois qu'une version plus récente est publiée et lorsqu'elle existe dans une session ouverte de Studio.
Dans la fenêtre Explorateur, développez l'arborescence de la hiérarchie du paquet et sélectionnez son objet PackageLink.
Dans la fenêtre Propriétés, activez la propriété Mise à jour automatique. Cette propriété s'applique uniquement au paquet parent situé au niveau le plus élevé dans une hiérarchie de paquets imbriqués. Cela signifie que les mises à jour automatiques ne se produiront que lorsque le paquet parent sera mis à jour.
Niveaux de partage et d'accès
Si vous le souhaitez, vous pouvez partager des paquets avec vos amis ou accorder l'accès à des rôles d'utilisateur spécifiques de votre groupe.
Dans l'Explorateur, la boîte à outils ou le gestionnaire de contenus, cliquez droit sur le paquet souhaité et sélectionnez Détails du paquet dans le menu contextuel.
Dans la fenêtre contextuelle, sélectionnez Autorisations dans la colonne de gauche pour révéler les options de partage/accès des paquets appartenant à un groupe ou appartenant à un utilisateur.
Pour un paquet appartenant à un groupe, développez l'arborescence des rôles en cliquant sur la › située à côté de l'icône du groupe, puis sélectionnez un niveau d'autorisation pour chaque rôle. Les cases de sélection qui sont estompées/désactivées indiquent que l'autorisation est déjà paramétrée pour ce rôle et qu'elle ne peut pas être modifiée à partir de cette fenêtre.
Permission Description Modifier Les membres du rôle pourront utiliser, voir et modifier la version actuelle et la version ancienne du paquet, notamment en publiant des modifications. L'octroi d'un accès à un rôle à partir de cette fenêtre confère uniquement un accès au paquet spécifique. Pas d'accès Les membres du rôle n'auront pas accès aux nouvelles versions du paquet, bien qu'ils aient toujours accès aux versions actuelles et précédentes. Pour un paquet appartenant à un utilisateur, recherchez un ami dans le champ de recherche, cliquez sur son avatar/nom d'utilisateur et sélectionnez un niveau d'autorisation.
Permission Description Utiliser et voir L'utilisateur pourra utiliser et voir (mais pas modifier) les versions actuelles et précédentes du paquet. Une fois que vous donnez cette 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êchera toute réinsertion ou mise à jour du paquet, mais les copies de paquet dans son modèle de données resteront intactes. Modifier L'utilisateur pourra utiliser, voir et modifier les versions actuelles et précédentes du paquet, y compris en publiant des modifications.
Annuler les modifications de 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 en une action, restaurer un paquet à une version précédente, ou revenir à des configurations spécifiques.
Annuler les modifications non publiées
Pour annuler une série de modifications non publiées :
Dans la fenêtre Explorateur, localisez les copies modifiées à l'aide du point jaune situé à côté de leur nom.
Cliquez droit sur une seule copie modifiée et sélectionnez Annuler les modifications dans le paquet dans le menu contextuel, ou sélectionnez plusieurs copies (au moins l'une de celles qui ont été modifiés), cliquez droit et sélectionnez Annuler les modifications dans les paquets sélectionnés.
Restaurer la Version précédente
Pour restaurer un paquet à une version précédemment publiée :
Dans l'Explorateur, la boîte à outils ou le gestionnaire de contenus, cliquez droit sur le paquet souhaité et sélectionnez Détails du paquet dans le menu contextuel.
Dans la fenêtre contextuelle, sélectionnez Versions dans la colonne de gauche. La version actuellement publiée et les versions précédemment publiées apparaissent (V1, V2, …) avec la date/heure de leur publication.
Cliquez sur la coche située à côté de la version que vous souhaitez restaurer et cliquez sur Envoyer.
Annuler les configurations
Pour rétablir un attribut de configuration à sa version par défaut, sélectionnez l'option Réinitialiser dans le menu avec l'engrenage dans la section Attributs de la fenêtre Propriétés.
Comparer les modifications de script
Lorsqu'un objet de paquet contient des scripts, ou que le script lui-même est un paquet, l'outil de différenciation intégré vous permet de comparer les différences ligne par ligne. Cela peut vous aider à décider si vous souhaitez mettre à jour et explorer les éventuelles modifications dans l'expérience pour rendre la mise à jour compatible.
Pour comparer les modifications de script :
Dans la fenêtre Explorateur, cliquez droit sur un paquet modifié ou obsolète. N'oubliez pas que le paquet doit être un script ou contenir des scripts.
Sélectionnez Afficher les modifications du script à partir du menu contextuel.
Dans l'onglet Résultat de diff qui s'ouvre, comparez toutes les modifications entre la copie actuelle du paquet et la dernière version publiée ou locale, comme avec les applications de commande source.