Documentación del empaquetador de datos espaciales de Mixed Reality

  • Artículo

Nota

EN DESUSO

A partir del 1/8/2020, esta herramienta ya está en desuso y ya no funciona en ninguna plataforma. Se recomienda usar la herramienta Administrador de mapas en Device Portal en su lugar.

Esta herramienta y su funcionamiento se ofrecen tal cual. Está sujeto a cambios sin previo aviso y puede no ser compatible con futuras versiones de Windows o Windows Mixed Reality HMD.

Descargar

Descargue MixedRealitySpatialDataPackager aquí

Compatibilidad con dispositivos

Característica HoloLens (1.ª generación) HoloLens 2 Cascos envolventes
Mixed Reality Spatial Data Packager ❌ ❌ ✔️

Inicio rápido

La herramienta Mixed Reality Spatial Data Packager copia los datos espaciales de una aplicación de destino de un equipo a otro a través de un proceso de importación y exportación de dos pasos. La herramienta debe ejecutarse con privilegios de administrador y eliminar los datos espaciales existentes en la importación. La exportación deja intactos los datos espaciales existentes.

Requisitos y limitaciones clave:

  1. La herramienta debe ejecutarse con privilegios de administrador
  2. Es posible que tenga que reiniciar el equipo si Mixed Reality Portal es inestable después de ejecutar la herramienta
  3. La herramienta no se ejecutará al encontrar discrepancias de versiones de datos espaciales o incompatibilidades
  4. La herramienta borrará los datos espaciales existentes en la importación
  5. Si se produce un error en el proceso de importación, los datos anteriores no se pueden restaurar a menos que se haya realizado una copia de seguridad mediante la exportación anterior.
  6. La calidad de la funcionalidad de importación depende del modo de "solo lectura" para los datos de mapa espacial

Procedimientos recomendados de asignación

  1. Borrar los mapas existentes de la Panel de control (Configuración -> Mixed Reality -> Entorno -> Borrar datos del entorno)
  2. Garantizar una iluminación suficiente para un buen seguimiento y si la ejecución del modo de mapa bloqueado intenta mantener la misma iluminación
  3. Cuando sea posible, mantenga el rango dinámico de iluminación bajo evitando áreas de alta iluminación junto a áreas oscuras y sombreadas
  4. Minimice las superficies en blanco y sin textura, por ejemplo, coloque un rango de diferentes pósteres en paredes blancas.
  5. Asignar el espacio sin objetos dinámicos en la escena, como mover personas
  6. Bloquear el mapa en la importación (disponible a través de Insider Preview)
  7. Desbloquee el mapa y vuelva a examinar el entorno cuando el seguimiento de la calidad se degrada o haya cambios en el entorno (iluminación o cambios en el diseño de objetos)

Ejecución de Mixed Reality empaquetador de datos espaciales con script complementario

Hemos proporcionado MRSpatialPackagerHelperScript.ps1 que ejecuta el empaquetador de mapas de las herramientas.

Los parámetros de script se definen a continuación:

-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

Uso y salida de ejemplo de script de PowerShell

.\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

Cómo exportar mediante MixedRealitySpatialDataPackager.exe

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

La exportación de mapas fuera del dispositivo genera dos archivos mapx, het.mapx y sa.mapx. Durante el proceso de exportación, se quitan todos los delimitadores espaciales, excepto para la aplicación especificada y el límite creado por el usuario (si existe). El nombre de familia del paquete de origen debe coincidir con una aplicación instalada existente o se producirá un error en el exe.

Cómo importar mediante MixedRealitySpatialDataPackager.exe

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

Import elimina los datos espaciales existentes y los reemplaza por los datos del directorio especificado. La entrada del nombre de la aplicación especifica el nombre del paquete de la aplicación de destino que, al igual que los delimitadores espaciales, se deben importar para y el SID de usuario de destino especifica el usuario que debe tener acceso a los anclajes espaciales importados. El nombre de familia del paquete de destino y los SID de usuario deben coincidir con los valores existentes en el equipo o el exe producirá un error.

mensajes de error

Además, los mensajes de error siguientes también se acompañarán con un HRESULT.

Si se produjo un error de argumentos no válidos

Invalid command line parameters

Si el ejecutable no se ejecutó en modo de administrador

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

Si se ha producido un error al habilitar o deshabilitar el controlador

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

Si se ha producido un error al validar la versión de la base de datos espacial

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.

Si se ha producido un error al validar el nombre de familia del paquete proporcionado para la aplicación de importación o exportación de destino

The package family name does not correspond to an installed app

Si se ha producido un error al validar el SID de usuario

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>