Défilement de la collection d’objets — MRTK2

La collection d’objets de défilement MRTK est un composant d’expérience utilisateur qui permet de faire défiler du contenu 3D dans une zone visible contenue. Le mouvement de défilement peut être déclenché par une interaction d’entrée proche ou lointaine et par une pagination discrète. Il prend en charge les objets interactifs et non interactifs.

Prise en main de la collection d’objets de défilement

Configuration de la scène

1. Créez une scène Unity.
2. Ajoutez MRTK à la scène en accédant à Mixed Reality Toolkit>Ajouter à la scène et Configurer.

Configuration de l’objet de défilement

1. Créez un objet de jeu vide dans la scène et remplacez sa position par (0, 0, 1).

2. Ajoutez un composant de collection d’objets de défilement à l’objet de jeu.

   Lorsque la collection d’objets de défilement est ajoutée, un collisionneur de boîtes et un composant tactile à interaction proche sont automatiquement attachés à l’objet de jeu racine. Ces composants permettent à l’objet scroll d’écouter des événements d’entrée d’interaction proche et lointain, comme une touche de pointeur ou un clic.

   La collection d’objets de défilement MRTK a deux éléments importants qui sont créés en tant qu’objets de jeu enfants sous la hiérarchie d’objets de défilement racine :

   • Container - Tous les objets de contenu de défilement doivent être des enfants de l’objet de jeu conteneur.
   • Clipping bounds - Si le masquage du contenu de défilement est activé, l’élément de délimitation garantit que seul le contenu pouvant faire défiler à l’intérieur de ses limites est visible. L’objet de jeu des limites de découpage a deux composants : un collider de boîte désactivé et une boîte de découpage.

Ajout de contenu à l’objet de défilement

La collection d’objets de défilement peut être combinée avec une collection d’objets grille pour mettre en page le contenu dans une grille d’éléments alignés qui ont une taille et un espacement uniformes.

1. Créez un objet de jeu vide en tant qu’enfant du conteneur de défilement.
2. Ajoutez un composant de collection d’objets grid à l’objet de jeu.
3. Pour un défilement vertical d’une seule colonne, dans l’onglet inspecteur, configurez la collection d’objets grid comme suit :
   • Nombre de colonnes : 1
   • Disposition : colonne puis ligne
   • Ancre : en haut à gauche
4. Modifiez la largeur et la hauteur des cellules en fonction des dimensions des objets de contenu.
5. Ajoutez les objets de contenu en tant qu’enfants de l’objet grille.
6. Appuyez sur update collection.

Configuration de la zone d’affichage de défilement

1. Pour le défilement vertical à travers une seule colonne d’objets, dans l’onglet inspecteur, configurez la collection d’objets de défilement comme suit :
   • Cellules par niveau : 1
   • Choisir le nombre de niveaux par page en fonction du nombre souhaité de lignes visibles
2. Modifiez la largeur, la hauteur et la profondeur des cellules de page en fonction des dimensions des objets de contenu.

Notez que les objets de contenu situés en dehors de la zone de défilement visible sont désormais désactivés, tandis que les objets qui croisent le wireframe de défilement peuvent être partiellement masqués par la primitive de découpage.

Test de la collection d’objets de défilement dans l’éditeur

1. Appuyez sur Lire et maintenez la barre Espace enfoncée pour afficher une main de simulation d’entrée.
2. Déplacez la main jusqu’à ce que le collider de défilement ou tout contenu interactif de défilement soit mis au point et déclenchez le mouvement de défilement en cliquant et en faisant glisser vers le haut et le bas avec la souris gauche.

Contrôle de l’objet de défilement à partir du code

La collection d’objets de défilement MRTK expose quelques méthodes publiques qui permettent de déplacer le conteneur de défilement en l’alignant sur sa position en fonction de la configuration des pagination propriétés.

Un exemple d’accès à l’interface de pagination de collection d’objets de défilement est disponible sous le MRTK/Examples/Demos/ScrollingObjectCollection/Scripts dossier . L’exemple de script de pagination avec défilement peut être lié à n’importe quelle collection d’objets de défilement existante dans la scène. Le script peut ensuite être référencé par des composants de scène qui exposent des événements Unity (par exemple, le bouton MRTK).

public class ScrollablePagination : MonoBehaviour
{
    [SerializeField]
    private ScrollingObjectCollection scrollView;

    public void ScrollByTier(int amount)
    {
        scrollView.MoveByTiers(amount);
    }
}

Défilement des propriétés de la collection d’objets

Exemple de scène de défilement

L’exemple de scène ScrollingObjectCollection.unity se compose de 3 exemples de défilement, chacun avec une configuration de repli de vitesse différente. L’exemple de scène contient des murs pour montrer le comportement de placement de la surface qui est désactivé par défaut dans la hiérarchie. L’exemple de scène se trouve sous le MRTK/Examples/Demos/ScrollingObjectCollection/Scenes dossier .

Faire défiler des exemples de préfabriqués

Pour plus de commodité, deux préfabriqués de collection d’objets à défilement sont disponibles. Les exemples de préfabriqués se trouvent sous le MRTK/Examples/Demos/ScrollingObjectCollection/Prefabs dossier .

Voir aussi

• Primitive de découpage
• Instance de matériau
• Nuanceur standard
• Collection d’objets