Aracılığıyla paylaş

Karma Gerçeklik Uzamsal Veri Paketleyici Belgeleri

  • Makale

Not

KALDIRIL -MIŞ

01.08.2020 itibarıyla bu araç artık kullanım dışıdır ve artık herhangi bir platformda çalışmaz. Bunun yerine Cihaz Portalı'nda Harita Yöneticisi aracını kullanmanızı öneririz.

Bu araç ve çalışması olduğu gibi sunulur. Bildirimde bulunmaksızın değiştirilebilir ve gelecekteki Windows veya Windows Mixed Reality HMD sürümleriyle uyumlu olmayabilir.

İndir

MixedRealitySpatialDataPackager'ı buradan indirin

Cihaz desteği

Özellik HoloLens (1. nesil) HoloLens 2 Çevreleyici kulaklıklar
uzamsal veri paketleyici Karma Gerçeklik ❌ ❌ ✔️

Hızlı Başlangıç

Karma Gerçeklik Uzamsal Veri Paketleyici aracı, iki aşamalı dışarı aktarma ve içeri aktarma işlemi aracılığıyla hedef uygulamanın uzamsal verilerini bir bilgisayardan diğerine kopyalar. Araç yönetici ayrıcalıklarıyla çalıştırılmalıdır ve içeri aktarma işleminde mevcut uzamsal verileri siler. Dışarı aktarma işlemi mevcut uzamsal verileri olduğu gibi bırakır.

Önemli gereksinimler ve sınırlamalar:

  1. Araç yönetici ayrıcalıklarıyla çalıştırılmalıdır
  2. Aracı çalıştırdıktan sonra Karma Gerçeklik Portal kararsızsa bilgisayarı yeniden başlatmanız gerekebilir
  3. Uzamsal veri sürümü uyuşmazlıkları veya uyumsuzluklarıyla karşılaşıldığında araç çalışmaz
  4. Araç, içeri aktarma işleminde mevcut uzamsal verileri siler
  5. İçeri aktarma işlemi başarısız olursa önceki veriler daha önce dışarı aktarılarak yedeklenmediği sürece geri yüklenemez
  6. Uzamsal harita verileri için "Salt Okunur" modda bir araya gelen içeri aktarma işlevselliğinin kalitesi

En İyi Eşleme Yöntemleri

  1. mevcut haritaları Denetim Masası temizleme (Ayarlar -> Karma Gerçeklik - Ortam ->> Ortam verilerini temizle)
  2. İyi izleme için yeterli ışık olduğundan emin olun ve kilitli harita modu çalıştırılıyorsa aynı aydınlatmayı korumaya çalışın
  3. Karanlık, gölgeli alanların yanında yüksek aydınlatmalı alanlardan kaçınarak aydınlatma dinamik aralığını mümkün olduğunda düşük tutun
  4. Beyaz duvarlara farklı posterler yerleştirmek gibi boş, dokusuz yüzeyleri en aza indirin
  5. Sahnedeki kişileri taşıma gibi dinamik nesneler olmadan alanı eşleme
  6. Haritayı içeri aktarmada kilitleme (Insider Preview aracılığıyla kullanılabilir)
  7. Haritanın kilidini açın ve izleme kalitesi düşerken ve/veya ortamda değişiklikler olduğunda (aydınlatma veya nesne düzenindeki değişiklikler) ortamı yeniden tarayın

Yardımcı Betik ile Karma Gerçeklik Uzamsal Veri Paketleyici çalıştırma

Harita paketleyicisini araçları çalıştıran MRSpatialPackagerHelperScript.ps1 sağladık.

Betik parametreleri aşağıda tanımlanmıştır:

-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 Betik Örneği Kullanımı ve Çıkışı

.\MRSpatialPackagerHelperScript.ps1 -AppName holoshell -UserName Yöneticisi -Mode dışarı aktarma -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

MixedRealitySpatialDataPackager.exe kullanarak dışarı aktarma

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

Haritaların cihazdan dışarı aktarılması iki mapx dosyası oluşturur: het.mapx ve sa.mapx. Dışarı aktarma işlemi sırasında, belirtilen uygulama ve kullanıcı tarafından oluşturulan sınır (varsa) dışında tüm uzamsal tutturucular kaldırılır. Kaynak paket aile adı mevcut yüklü bir uygulamayla eşleşmelidir, aksi takdirde exe başarısız olur.

MixedRealitySpatialDataPackager.exe kullanarak içeri aktarma

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

İçeri aktarma, mevcut uzamsal verileri siler ve belirtilen dizindeki verilerle değiştirir. Uygulama adı girişi, uzamsal tutturucuların içeri aktarılması gereken hedef uygulamanın paket adını belirtir ve hedef kullanıcı SID'i içeri aktarılan uzamsal tutturuculara erişimi olması gereken kullanıcıyı belirtir. Hedef paket aile adı ve kullanıcı SID'leri bilgisayarda var olan değerlerle eşleşmelidir, aksi takdirde exe başarısız olur.

Hata İletileri

Ayrıca aşağıdaki hata iletilerine bir HRESULT da eşlik edecektir

Geçersiz bir hata bağımsız değişkenleri varsa

Invalid command line parameters

Yürütülebilir dosya yönetici modunda çalıştırılmadıysa

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

Sürücüyü etkinleştirirken veya devre dışı bırakırken bir hata oluştuysa

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

Uzamsal veritabanı sürümü doğrulanırken bir hata oluştuysa

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.

Hedef içeri/dışarı aktarma uygulaması için sağlanan paket ailesi adı doğrulanırken bir hata oluştuysa

The package family name does not correspond to an installed app

Kullanıcı SID'sini doğrularken bir hata oluştuysa

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>