Documentación del Empaquetador de datos espaciales de realidad mixtaMixed Reality Spatial Data Packager Documentation

Nota

EN DESUSODEPRECATED

A partir de 8/1/2020, esta herramienta ya está en desuso y ya no funciona en ninguna plataforma.As of 8/1/2020 this tool is now deprecated and no longer functions on any platform. En su lugar, se recomienda usar la herramienta map Manager en el portal de dispositivos.We recommend using the Map Manager tool in the Device Portal instead.

Esta herramienta y su operación se ofrecen tal cual.This tool and its operation are offered as-is. Está sujeto a cambios sin previo aviso y es posible que no sea compatible con las futuras versiones de HMD de Windows o Windows Mixed Reality.It is subject to change without any notice and may not be compatible with future Windows or Windows Mixed Reality HMD releases.

DescargarDownload

Descargar MixedRealitySpatialDataPackager aquíDownload MixedRealitySpatialDataPackager here

Compatibilidad con dispositivosDevice support

CaracterísticaFeature HoloLens (1.ª generación)HoloLens (1st gen) HoloLens 2HoloLens 2 Cascos envolventesImmersive headsets
Empaquetador de datos espaciales de realidad mixtaMixed Reality Spatial Data Packager ✔️✔️

Guía de inicio rápidoQuickstart

La herramienta de empaquetado de datos espaciales de realidad mixta copia los datos espaciales de una aplicación de destino de un equipo a otro a través de un proceso de exportación e importación de dos pasos.The Mixed Reality Spatial Data Packager tool copies the spatial data of a target app from one PC to another through a two step export and import process. La herramienta debe ejecutarse con privilegios de administrador y elimina los datos espaciales existentes al importar.The tool must be run with administrator privileges and deletes the existing spatial data on import. La exportación deja intactos los datos espaciales existentes.Export leaves the existing spatial data intact.

Requisitos y limitaciones clave:Key requirements and limitations:

  1. La herramienta debe ejecutarse con privilegios de administradorTool must be run with administrator privileges
  2. Es posible que tenga que reiniciar el equipo si el portal de realidad mixta es inestable después de ejecutar la herramientaYou may have to restart PC if Mixed Reality Portal is unstable after running the tool
  3. La herramienta no se ejecutará al encontrar incompatibilidades o incompatibilidades de la versión de datos espacialesTool will not run when encountering spatial data version mismatches or incompatibilities
  4. La herramienta borrará los datos espaciales existentes al importarTool will erase existing spatial data on import
  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 la copia de seguridad mediante la exportación anteriorIf import process fails previous data cannot be restored unless it has been backed up by exporting previously
  6. Calidad de la funcionalidad de importación condicionada en el modo de "solo lectura" para los datos de mapa espacialQuality of import functionality contingent on “Read-Only” mode for spatial map data

Procedimientos recomendados de asignaciónMapping Best Practices

  1. Borrar asignaciones existentes en el panel de control (configuración-> entorno mixto de realidad >-> borrar datos de entorno)Clear existing maps from the Control Panel (Settings -> Mixed Reality -> Environment -> Clear environment data)
  2. Asegúrese de que haya suficiente iluminación para un buen seguimiento y si la ejecución del modo de mapa bloqueado intente mantener la misma iluminaciónEnsure sufficient lighting for good tracking and if running locked map mode try to maintain the same lighting
  3. Cuando sea posible, mantenga el intervalo dinámico de iluminación bajo evitando áreas de iluminación alta junto a áreas oscuras y sombreadas.When possible keep the lighting dynamic range low by avoiding areas of high illumination next to dark, shadowed areas
  4. Minimizar las superficies en blanco y sin texturas, por ejemplo, colocar un intervalo de pósters distintos en las paredes blancasMinimize blank, textureless surfaces e.g. place a range of different posters on white walls
  5. Asignar el espacio sin objetos dinámicos en la escena, como mover personasMap the space without dynamic objects in the scene such as moving people
  6. Bloquear el mapa al importar (disponible a través de Insider Preview)Lock the map on import (available via Insider Preview)
  7. Desbloquee el mapa y vuelva a examinar el entorno cuando se realice un seguimiento de la calidad y/o cuando haya cambios en el entorno (iluminación o cambios en el diseño de objetos) * * Unlock the map and rescan the environment when tracking quality degrades and/or there are changes in the environment (lighting or changes in object layout) **

Ejecución de un empaquetador de datos espaciales de realidad mixta con un script complementarioRunning Mixed Reality Spatial Data Packager with Companion Script

Hemos proporcionado MRSpatialPackagerHelperScript.ps1 que ejecutan las herramientas del Empaquetador de mapas.We have provided MRSpatialPackagerHelperScript.ps1 that runs the map packager the tools.

Los parámetros de script se definen a continuación:The script parameters are defined below:

-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

Ejemplo de script de PowerShell uso y salidaPowershell Script Example Usage and Output

.\MRSpatialPackagerHelperScript.ps1-AppName holoshell-nombredeusuario administrador-Mode Export-MapxPath D:\temp-LockMap 0.\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 con MixedRealitySpatialDataPackager.exeHow to Export using 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.Exporting maps off device generates two mapx files, het.mapx and sa.mapx. Durante el proceso de exportación, se quitan todos los delimitadores espaciales, a excepción de la aplicación especificada y el límite creado por el usuario (si existe).During the export process all spatial anchors are removed except for the specified app and the user-created boundary (if it exists). El nombre de familia del paquete de origen debe coincidir con una aplicación instalada existente o se producirá un error en el archivo exe.The source package family name must match an existing installed app or the exe will fail.

Cómo importar mediante MixedRealitySpatialDataPackager.exeHow to Import using MixedRealitySpatialDataPackager.exe

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

La importación elimina los datos espaciales existentes y los reemplaza con los datos del directorio especificado.Import deletes the existing spatial data and replaces it with the data from the specified directory. La entrada del nombre de la aplicación especifica el nombre del paquete de la aplicación de destino que se debe importar para y el SID del usuario de destino especifica el usuario que debe tener acceso a los delimitadores espaciales importados.The app name input specifies the package name of the target app that like the spatial anchors should be imported for and the target user SID specifies the user that should have access to the imported spatial anchors. El nombre de familia y los SID de usuario del paquete de destino deben coincidir con los valores existentes en el equipo o se producirá un error en el archivo exe.The target package family name and user SIDs must match existing values on the PC or the exe will fail.

****

mensajes de errorError Messages

Además, los mensajes de error siguientes también irán acompañados de un valor HRESULT.In addition the error messages below failures will also be accompanied with an HRESULT

Si se produjo un error argumentos no válidosIf there was an error invalid arguments

Invalid command line parameters

Si el ejecutable no se ejecutó en modo de administradorIf the executable was not run in administrator mode

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

Si se produjo un error al habilitar o deshabilitar el controladorIf there was an error enabling or disabling the driver

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 produjo un error al validar la versión de la base de datos espacialIf there was an error validating the spatial database version

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 produjo un error al validar el nombre de familia del paquete proporcionado para la aplicación de importación y exportación de destinoIf there was an error validating the package family name provided for target import/export app

The package family name does not correspond to an installed app

Si se produjo un error al validar el SID del usuarioIf there was an error validating the user SID

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>