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.
Les transferts de propriété ne sont pas pris en charge par le système d'éléments. Vous devez donc tenir compte du propriétaire lorsque vous créez un paquet.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.
L'objet PackageLink ne doit pas être supprimé ou réapparenté. Cette action sur toute copie de paquet interrompt l'association avec la version publiée et reconvertit la copie en un objet normal.
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.
Actuellement, la seule façon de gérer les valeurs de configuration est d'ajouter des scripts dans le paquet qui lisent et appliquent un comportement en fonction de la configuration à l'exécution.
Si vous souhaitez simplement mettre à jour les valeurs par défaut pour les configurations, vous pouvez modifier ces valeurs d'attribut et republier le paquet (le paquet ne sera pas notifié dans ce cas). Si vous souhaitez publier d'autres modifications sans modifier les valeurs de configuration par défaut, vous devez publier sur un paquet sans modification de valeur, ou rétablir les configurations à leurs valeurs par défaut avant de publier.
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.
Si vous modifiez un paquet imbriqué, le paquet imbriqué et le paquet parent sont considérés comme modifiés. Vous devez publier les modifications apportées à tout paquet imbriqué avant d'être autorisé à publier les modifications apportées à son paquet parent, étant donné que la publication du parent le marquerait comme étant en cours/non modifié et entrerait en conflit avec les modifications du paquet imbriqué.
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.
L'option du menu Obtenir la dernière version de [] est désactivée si l'une des copies du paquet a été modifiée. Si vous travaillez sur une série de modifications non publiées, vous devrez annuler les modifications avant de pouvoir récupérer la dernière version.
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.
La mise à jour des paquets enregistre les emplacements sélectionnés automatiquement mais ne les publie pas. Vous devrez donc les publier séparément pour voir les modifications.
Afin d'empêcher des remplacements involontaires, la mise à jour en masse n'affecte pas les versions modifiées d'un paquet. Cependant, Studio vous informera du nombre de paquets non mis à jour par le processus.
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.
La mise à jour automatique ne s'applique pas aux copies de paquets modifiées. Une fois que vous modifiez une instance de paquet, sa propriété Mise à jour automatique est désactivée et ignorée.
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 modifications apportées à un paquet ne réinitialise pas la configuration à sa version par défaut. Voir Annuler la configuration.
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.
Dans cet exemple de comparaison, la commande print() sur la ligne 1 a été modifiée. La ligne mise en évidence en rouge affiche la ligne 1 telle qu'elle existe dans la copie de script obsolète, tandis que la ligne verte immédiatement après affiche la ligne 1 telle qu'elle existe dans le paquet de script publié. En outre, deux nouvelles lignes ont été ajoutées au paquet de script publié : un saut de ligne vide sur la ligne 2 et une nouvelle commande print() sur la ligne 3.
