SpatialInteractionManager Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce l'accesso all'input dell'utente da mani, controller del movimento e comandi vocali di sistema.
public ref class SpatialInteractionManager sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialInteractionManager final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialInteractionManagerPublic NotInheritable Class SpatialInteractionManager- Ereditarietà
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)
|
Commenti
I movimenti spaziali sono una forma chiave di input per HoloLens. Instradando le interazioni da SpatialInteractionManager a spatialGestureRecognizer di un ologramma, le app possono rilevare gli eventi Tap, Hold, Manipulation e Navigation in modo uniforme tra le interazioni di mano, voce e controller.
Nota
Le interazioni spaziali non vengono rilevate da game pad, tastiera o dispositivi di input del mouse.
Le interazioni sono per lo più opache, con un evento che si attiva solo all'inizio, in modo che il riconoscitore dei movimenti instradarlo per poter acquisire l'interazione nel suo insieme. Le app possono invece scegliere di usare gli eventi di origine di basso livello o di eseguire il polling usando GetDetectedSourcesAtTimestamp per elaborare manualmente presse, Aggiornamenti e versioni rilevate da una determinata mano o controller.
Cronologia delle versioni
| Versione di Windows | Versione dell'SDK | Valore aggiunto |
|---|---|---|
| 1903 | 18362 | IsSourceKindSupported |
Metodi
| GetDetectedSourcesAtTimestamp(PerceptionTimestamp) |
Ottiene lo stato di tutte le origini di interazione rilevate per il timestamp specificato. |
| GetForCurrentView() |
Ottiene SpatialInteractionManager associato all'oggetto CoreWindow corrente. |
| IsSourceKindSupported(SpatialInteractionSourceKind) |
Ottiene un valore che indica se l'origine di interazione specificata è supportata nel dispositivo. |
Eventi
| InteractionDetected |
Si verifica quando è disponibile una nuova interazione per il routing a spatialGestureRecognizer. |
| SourceDetected |
Si verifica quando è stata rilevata una nuova mano, un controller del movimento o un'origine vocale. |
| SourceLost |
Si verifica quando un'origine della mano, del movimento o del riconoscimento vocale non è più disponibile. |
| SourcePressed |
Si verifica quando un controller di movimento o un'origine vocale ha immesso uno stato premuto. |
| SourceReleased |
Si verifica quando una mano, un controller del movimento o un'origine vocale ha chiuso uno stato premuto. |
| SourceUpdated |
Si verifica quando un controller di movimento o un'origine vocale ha subito una modifica a SpatialInteractionSourceState. |