SpatialStageFrameOfReference Classe

  • Référence

Définition

Espace de noms:
Windows.Perception.Spatial
Modifier

Représente une étape spatiale, définie par l’utilisateur pour établir l’espace physique dans lequel il a l’intention d’utiliser un casque Mixed Reality.

public ref class SpatialStageFrameOfReference sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialStageFrameOfReference final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialStageFrameOfReference
Public NotInheritable Class SpatialStageFrameOfReference
Héritage
Object Platform::Object IInspectable SpatialStageFrameOfReference
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v4.0)

Remarques

Une étape spatiale se compose au minimum d’un système de coordonnées au niveau du sol dont l’origine est choisie par l’utilisateur, représentant le centre logique de la zone dans laquelle il a l’intention d’utiliser son casque Mixed Reality. Ce système de coordonnées au niveau de l’étage permet aux applications de présenter des expériences à l’échelle permanente.

Si vous le souhaitez, l’utilisateur peut également définir une limite de mouvement, représentant la zone ouverte dans laquelle il a l’intention de marcher tout en utilisant le casque. Cette limite de mouvement permet aux applications de présenter des expériences à l’échelle de la salle.

Si l’utilisateur n’a pas défini d’étape spatiale, une application peut appeler la méthode RequestNewStageAsync pour guider l’utilisateur dans l’interface utilisateur système qui lui permettra d’en définir une.

Sur HoloLens, une application peut également créer des expériences à l’échelle permanente ou à l’échelle de la salle à l’aide du mappage spatial. Le mappage spatial permet au développeur d’analyser l’environnement de l’utilisateur et de déterminer l’emplacement des murs et des étages de l’utilisateur à l’aide du type SpatialSurfaceObserver , même si l’utilisateur n’a pas défini de phase manuellement. Examinez la propriété SpatialSurfaceObserver.IsSupported pour déterminer si l’appareil actuel prend en charge le mappage spatial.

Les systèmes de coordonnées retournés par la phase sont droitiers, avec +y vers le haut, +x à droite et -z vers l’avant.

Propriétés

CoordinateSystem

Obtient un système de coordonnées au niveau du sol situé à l’origine de l’étape définie par l’utilisateur.
Current

Obtient l’étape spatiale actuelle, si elle a été définie par l’utilisateur.
LookDirectionRange

Obtient l’étendue dans laquelle l’utilisateur peut regarder autour de lui avec son casque.
MovementRange

Obtient la mesure dans laquelle l’utilisateur peut se déplacer tout en portant son casque.

Méthodes

GetCoordinateSystemAtCurrentLocation(SpatialLocator)

Obtient un système de coordonnées au niveau du sol à la position et à l’orientation actuelles de l’utilisateur.
RequestNewStageAsync()

Affiche l’interface utilisateur système pour guider l’utilisateur dans la définition d’une nouvelle étape pour remplacer l’étape actuelle.
TryGetMovementBounds(SpatialCoordinateSystem)

Obtient les sommets de limite de la zone ouverte définie par l’utilisateur où il a l’intention de se déplacer lors de l’utilisation de son casque.

Événements

CurrentChanged

Se produit lorsque l’utilisateur modifie ou redéfinit l’étape spatiale actuelle.

S’applique à

Voir aussi