Karma gerçeklik girişinde 3B modellerin yerleştirilmesini etkinleştirme

Makale
07/12/2023

Not

Bu özellik, Windows 10 Nisan 2018 Güncelleştirmesi kapsamında eklenmiştir. Windows'un eski sürümleri bu özellikle uyumlu değildir.

Windows Mixed Reality giriş sayfası, kullanıcıların uygulamaları başlatmadan önce indiği başlangıç noktasıdır. Bazı senaryolarda, 2B uygulamalar (Hologramlar uygulaması gibi) 3B modellerin dekorasyon olarak doğrudan karma gerçeklik girişine yerleştirilmesini veya tam 3B olarak daha fazla denetime olanak tanır. Model ekleme protokolü, web sitenizden veya uygulamanızdan doğrudan Windows Mixed Reality girişine bir 3B model göndermenize olanak tanır ve burada 3B uygulama başlatıcılar, 2B uygulamalar ve hologramlar gibi kalıcı olur.

Örneğin, bir alan tasarlamak için 3B mobilya kataloğunu ortaya çıkartan bir uygulama geliştiriyorsanız, kullanıcıların bu 3B mobilya modellerini katalogdan yerleştirmesine izin vermek için model ekleme protokolunu kullanın. Dünyaya yerleştirilen kullanıcılar, bu 3B modelleri aynı evdeki diğer hologramlar gibi taşıyabilir, yeniden boyutlandırabilir ve kaldırabilir. Bu makalede, kullanıcıların kendi dünyalarını uygulamanızdan veya web'den 3B nesnelerle donatmasını sağlamak için model ekleme protokolünün uygulanmasına genel bir bakış sağlanır.

Cihaz desteği

Özellik	HoloLens	Çevreleyici kulaklıklar
Model protokolü ekleme	✔️	✔️

Temel bilgiler

3B modellerin Windows Mixed Reality girişine yerleştirilmesini etkinleştirmenin iki adımı vardır:

3B modelinizin Windows Mixed Reality giriş sayfasıyla uyumlu olduğundan emin olun.
Uygulamanıza veya web sayfanıza model protokol ekleme işlemini uygulayın (bu makale).

Model ekleme protokolunu uygulama

Uyumlu bir 3B modeliniz olduğunda, herhangi bir web sayfasından veya uygulamadan aşağıdaki URI'yi etkinleştirerek model ekleme protokollerini uygulayabilirsiniz:

ms-mixedreality:addmodel?uri=<Path to a .glb 3D model either local or remote>

URI uzak bir kaynağa işaret ederse otomatik olarak indirilir ve girişe yerleştirilir. Yerel kaynaklar, girişe yerleştirilmeden önce karma gerçeklik giriş sayfasının uygulama verileri klasörüne kopyalanır. Kullanıcının düğmeyi gizleyerek veya mümkünse devre dışı bırakarak bu özelliği desteklemeyen eski bir Windows sürümünü çalıştırabileceği senaryoları dikkate almak için deneyiminizi tasarlamanızı öneririz.

bir Evrensel Windows Platformu uygulamasından model protokolü ekleme çağırma:

private async void launchURI_Click(object sender, RoutedEventArgs e)
{
   // Define the add model URI
   var uriAddModel = new Uri(@"ms-mixedreality:addModel?uri=sample.glb");

   // Launch the URI to invoke the placement
   var success = await Windows.System.Launcher.LaunchUriAsync(uriAddModel);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

Bir web sayfasından model protokolü ekleme çağrılır:

<a class="btn btn-default" href="ms-mixedreality:addModel?uri=sample.glb"> Place 3D Model </a>

Çevreleyici (VR) mikrofonlu kulaklıklar için dikkat edilmesi gerekenler

Modern (VR) mikrofonlu kulaklıklar için Karma Gerçeklik Portalı'nın model ekleme protokolunu çağırmadan önce çalışıyor olması gerekmez. Bu durumda, model ekleme protokolü Karma Gerçeklik Portal'ı başlatır ve karma gerçeklik giriş listesine ulaştığınızda nesneyi doğrudan mikrofonlu kulaklığın aradığı yere yerleştirir.
Karma Gerçeklik Portalı zaten çalışır durumdayken masaüstünden model ekleme protokollerini çağırdığınızda mikrofonlu kulaklığın "uyanık" olduğundan emin olun. Aksi takdirde yerleştirme başarılı olmaz.

Aracılığıyla paylaş