Configuration des observateurs de maillage pour l’appareil — MRTK2
Ce guide décrit la configuration de l’observateur de maillage spatial prête à l’emploi dans MRTK qui prend en charge la plateforme Windows Mixed Reality (par exemple, HoloLens). L’implémentation par défaut fournie par Mixed Reality Toolkit est la classe WindowsMixedRealitySpatialMeshObserver. La plupart des propriétés de cet article s’appliquent toutefois à d’autres implémentations d’Observer personnalisées.
Paramètres du profil
Les deux éléments suivants doivent être définis en premier lors de la configuration d’un profil Spatial Mesh Observer pour le système de reconnaissance spatiale.
- Implémentation du type observateur concret
- liste des plateformes prises en charge pour exécuter cet observateur
Notes
Tous les observateurs doivent étendre l’interface IMixedRealitySpatialAwarenessObserver .
Paramètres généraux :
Comportement de démarrage
Le comportement de démarrage spécifie si l’observateur commence à s’exécuter lors de la première instanciation. Les deux options sont les suivantes :
- Démarrage automatique : valeur par défaut par laquelle l’observateur commence l’opération après l’initialisation
- Démarrage manuel : l’observateur attend d’être dirigé pour démarrer
Si vous utilisez le démarrage manuel, vous devez les reprendre et les suspendre au moment de l’exécution via du code.
Intervalle de mise à jour
Durée, en secondes, entre les demandes adressées à la plateforme pour mettre à jour les données de maillage spatial. Les valeurs classiques sont comprises entre 0,1 et 5,0 secondes.
Est Stationary Observer
Indique si l’observateur doit rester stationnaire ou se déplacer et mettre à jour avec l’utilisateur. Si la valeur est true, la forme d’observateur avec le volume défini par étendues d’observation reste à l’origine au démarrage. Si la valeur est false, l’espace Observer suit la tête de l’utilisateur comme origine de la forme.
Aucune donnée de maillage n’est calculée pour une zone physique en dehors de l’espace Observer, comme défini par les propriétés suivantes : Is Stationary Observer, Observer Shape* et Observation Extents.
Forme de l’observateur
La forme d’observateur définit le type de volume que l’observateur de maillage utilisera lors de l’observation des maillages. Les options prises en charge sont les suivantes :
- Cube aligné sur l’axe : forme rectangulaire qui reste alignée sur les axes du système de coordonnées mondial, tel que déterminé au démarrage de l’application.
- Cube aligné par l’utilisateur : forme rectangulaire qui pivote pour s’aligner sur le système de coordonnées local des utilisateurs.
- Sphere : volume sphérique avec un centre à l’origine de l’espace mondial. La valeur X de la propriété Étendues d’observation est utilisée comme rayon de la sphère.
Étendues d’observation
Les étendues d’observation définissent la distance par rapport au point d’observation où les maillages seront observés.
Paramètres physiques
Couche physique
Couche physique sur laquelle les objets de maillage spatial seront placés afin d’interagir avec les systèmes Unity Physics et RayCast.
Notes
Mixed Reality Toolkit réserve la couche 31 par défaut pour une utilisation par les observateurs de spatial Awareness.
Recalculer les normales
Spécifie si l’observateur de maillage recalcule ou non les normales du maillage après l’observation. Ce paramètre est disponible pour s’assurer que les applications reçoivent des maillages qui contiennent des données normales valides sur des plateformes qui ne les retournent pas avec des maillages.
Paramètres de niveau de détail
Niveau de détail
Spécifie le niveau de détail (LOD) des données de maillage spatial. Les valeurs actuellement définies sont Grossière, Fine et Personnalisée.
Grossière : a un impact moindre sur les performances de l’application et constitue un excellent choix pour la navigation et la recherche d’un plan.
Moyenne - Paramètre équilibré souvent utile pour les expériences qui analysent continuellement l’environnement à la fois des grandes caractéristiques, des planchers et des murs, ainsi que des détails d’occlusion.
Fine : a généralement un impact plus élevé sur les performances de l’application et constitue une excellente option pour les maillages d’occlusion.
Personnalisé : nécessite que l’application spécifie la propriété Triangles/Compteur cube et permet aux applications d’ajuster la précision et l’impact sur les performances de l’observateur de maillage spatial.
Notes
Il n’est pas garanti que toutes les valeurs triangles/mètres cubes soient respectées par toutes les plateformes. L’expérimentation et le profilage sont fortement recommandés lors de l’utilisation d’un LOD personnalisé.
Triangles par mètre cube
Valide lors de l’utilisation du paramètre Personnalisé pour la propriété Level of Detail et spécifie la densité de triangle pour le maillage spatial.
Paramètres d'affichage
Option d’affichage
Spécifie comment les maillages spatiaux doivent être affichés par l’observateur. Les valeurs prises en charge sont les suivantes :
- Aucun : l’observateur ne restitue pas le maillage
- Visible : les données de maillage seront visibles à l’aide du matériau visible
- Occlusion : les données de maillage seront des éléments occlus dans la scène à l’aide du matériau d’occlusion
Les observateurs spatiaux peuvent être repris/suspendus au moment de l’exécution via du code.
Avertissement
La définition de l’option d’affichage sur Aucun n’empêche PAS l’observateur de s’exécuter. Si vous souhaitez arrêter tous les observateurs, les demandes devront suspendre tous les observateurs via CoreServices.SpatialAwareness.SuspendObservers()
Matériel visible
Indique le matériau à utiliser lors de la visualisation du maillage spatial.
Matériau d’occlusion
Indique le matériau à utiliser pour que le maillage spatial obstrue les hologrammes.