Dokumentation zum Mixed Reality Spatial Data Packager

  • Artikel

Hinweis

VERALTET

Ab dem 1.8.2020 ist dieses Tool veraltet und funktioniert nicht mehr auf jeder Plattform. Es wird empfohlen, stattdessen das Karten-Manager-Tool im Geräteportal zu verwenden.

Dieses Tool und sein Betrieb werden wie vorhanden angeboten. Sie kann ohne Vorankündigung geändert werden und ist möglicherweise nicht mit zukünftigen Windows- oder Windows Mixed Reality HMD-Versionen kompatibel.

Herunterladen

Laden Sie MixedRealitySpatialDataPackager hier herunter

Geräteunterstützung

Feature HoloLens (1. Generation) HoloLens 2 Immersive Headsets
Mixed Reality Spatial Data Packager ❌ ❌ ✔️

Schnellstart

Das Mixed Reality Spatial Data Packager-Tool kopiert die räumlichen Daten einer Ziel-App über einen zweistufigen Export- und Importprozess von einem PC auf einen anderen. Das Tool muss mit Administratorrechten ausgeführt werden und löscht die vorhandenen räumlichen Daten beim Import. Beim Export bleiben die vorhandenen räumlichen Daten intakt.

Wichtige Anforderungen und Einschränkungen:

  1. Tool muss mit Administratorrechten ausgeführt werden
  2. Möglicherweise müssen Sie den PC neu starten, wenn Mixed Reality Portal nach dem Ausführen des Tools instabil ist.
  3. Das Tool wird nicht ausgeführt, wenn räumliche Datenversionskonflikte oder Inkompatibilitäten auftreten.
  4. Das Tool löscht vorhandene räumliche Daten beim Import.
  5. Wenn beim Importvorgang ein Fehler auftritt, können frühere Daten nicht wiederhergestellt werden, es sei denn, sie wurden zuvor durch Den Export gesichert.
  6. Qualität der Importfunktionalität abhängig vom "Schreibgeschützten" Modus für räumliche Kartendaten

Bewährte Methoden für die Zuordnung

  1. Löschen vorhandener Karten aus dem Systemsteuerung (Einstellungen –> Mixed Reality –> Umgebung –> Löschen von Umgebungsdaten)
  2. Stellen Sie eine ausreichende Beleuchtung für eine gute Nachverfolgung sicher, und versuchen Sie bei Ausführung des gesperrten Kartenmodus, die gleiche Beleuchtung beizubehalten
  3. Wenn möglich, halten Sie den Lichtdynamikbereich niedrig, indem Sie Bereiche mit hoher Beleuchtung neben dunklen, schattenden Bereichen vermeiden
  4. Minimieren sie leere, texturlose Oberflächen, z. B. platzieren Sie eine Reihe verschiedener Poster auf weißen Wänden
  5. Zuordnen des Raums ohne dynamische Objekte in der Szene, z. B. Verschieben von Personen
  6. Karte beim Importieren sperren (über Insider Preview verfügbar)
  7. Entsperren Sie die Karte, und scannen Sie die Umgebung erneut, wenn die Qualitätseinbußen nachverfolgt werden und/oder änderungen in der Umgebung (Beleuchtung oder Änderungen im Objektlayout) vorgenommen werden.

Ausführen Mixed Reality Spatial Data Packager mit Begleitskript

Wir haben MRSpatialPackagerHelperScript.ps1 bereitgestellt, mit dem der Kartenpaketierer die Tools ausführt.

Die Skriptparameter sind unten definiert:

-AppName <String>
    On export: The spatial anchors from the app of interest
    On import: The target app that spatial anchors should be imported for
    Returns a list of apps containing the input string if a unique app is not found

-UserName <String>
    Target username, will return a list of users if a unique match is not found

-Mode <String>
    import or export

-MapxPath <String>
    On export: Directory to export your mapx files
    On import: Directory where import mapx are stored

-LockMap <Int32>
    0 to unlock map
    1 to lock map

-BinPath <String>
    Path to MixedRealitySpatialDataPackager.exe, default value is current directory

PowerShell-Skriptbeispiel für Nutzung und Ausgabe

.\MRSpatialPackagerHelperScript.ps1 -AppName holoshell -UserName Administrator -Mode export -MapxPath D:\temp\ -LockMap 0

Package Family Name for holoshell: HoloShell_cw5n1h2txyewy
User SID for Administrator: S-1-5-21-1279937937-3984375698-1043392598-499
Lock map value successfully set to 0

Running: C:\bin\MixedRealitySpatialDataPackager.exe export D:\temp\ HoloShell_cw5n1h2txyewy S-1-5-21-1279937937-3984375698-1043392598-499

Attempting to disable Windows MR driver
Driver disabled
Validating spatial data version information...
Device spatial data version OK
External spatial data version OK
Importing spatial anchors for user account phguan
Stopping SPECTRUM
Stopped SPECTRUM
Stopping SHAREDREALITYSVC
Stopped SHAREDREALITYSVC
Space ID is {00000000-4321-0000-0000-000000000000}
SUCCESS: Unpacked Space from D:\temp\map\het.mapx to
C:\ProgramData\WindowsHolographicDevices\SpatialStore\HoloLensSensors\{00000000-4321-0000-0000-000000000000}\
Space ID is {78FA06B5-4416-4815-BB00-B3CB5C983B7D}
SUCCESS: Unpacked Space from D:\temp\map\sa.mapx to
C:\ProgramData\Microsoft\Spectrum\PersistedSpatialAnchors\
Attempting to enable Windows MR driver
Driver enabled
Starting SHAREDREALITYSVC
Started SHAREDREALITYSVC
Starting SPECTRUM
Started SPECTRUM
IMPORT SUCCESS

Exportieren mithilfe von MixedRealitySpatialDataPackager.exe

MixedRealitySpatialDataPackager.exe export <folderpath to mapx files> <source package family name>

Beim Exportieren von Karten vom Gerät werden zwei mapx-Dateien generiert: het.mapx und sa.mapx. Während des Exportvorgangs werden alle Raumanker entfernt, mit Ausnahme der angegebenen App und der vom Benutzer erstellten Grenze (sofern vorhanden). Der Name der Quellpaketfamilie muss mit einer vorhandenen installierten App übereinstimmen, andernfalls schlägt die Exe fehl.

Importieren mit MixedRealitySpatialDataPackager.exe

MixedRealitySpatialDataPackager.exe import <folderpath to mapx files> <target package family name> <user SID>

Import löscht die vorhandenen räumlichen Daten und ersetzt sie durch die Daten aus dem angegebenen Verzeichnis. Die App-Name-Eingabe gibt den Paketnamen der Ziel-App an, für die wie die Raumanker importiert werden sollen, und die Zielbenutzer-SID gibt den Benutzer an, der Zugriff auf die importierten räumlichen Anker haben soll. Der Familienname des Zielpakets und die Benutzer-SIDs müssen mit vorhandenen Werten auf dem PC übereinstimmen, andernfalls tritt ein Fehler auf.

Fehlermeldungen

Darüber hinaus werden die folgenden Fehlermeldungen auch mit einem HRESULT begleitet.

Wenn ein Fehler ungültige Argumente aufgetreten ist

Invalid command line parameters

Wenn die ausführbare Datei nicht im Administratormodus ausgeführt wurde

1. Unable to determine elevation privileges 
2. Please run with administrator privileges

Fehler beim Aktivieren oder Deaktivieren des Treibers

1. Could not find the specified driver with class GUID {d612553d-06b1-49ca-8938-e39ef80eb16f}
2. Could not find the device instance ID for specified driver with class GUID {d612553d-06b1-49ca-8938-e39ef80eb16f}
3. Could not find the specified driver with device instance ID <INSTANCE ID>
4. Failed to enable/disable driver

Wenn ein Fehler beim Überprüfen der Version der räumlichen Datenbank aufgetreten ist

1. Could not read database version
2. This tool is not compatible with the current driver version of Windows Mixed Reality and/or the spatial data provided to replace the existing spatial data is an invalid version.
3. No spatial data is present on the current device please connect your Mixed Reality device to initialize spatial data. If the problem persists please restart your PC.

Wenn ein Fehler beim Überprüfen des Paketfamiliennamens für die Zielimport-/Export-App aufgetreten ist

The package family name does not correspond to an installed app

Wenn ein Fehler beim Überprüfen der Benutzer-SID aufgetreten ist

Failed to find local user for passed in user SID

1. Folder path to space store files doesn't exist 
2. het.mapx or sa.mapx file doesn't exist in <PATH> for import
3. Unable to create directory at <PATH> for export

1. Unable to open service manager <SERVICE>
2. Timed out trying to start/stop <SERVICE>