OpenXR ile çalışmaya başlama

HoloLens 2 ' de openxr kullanarak, masaüstünde de modern kulaklık Windows Mixed Reality geliştirebilirsiniz. bir kulaklık erişiminiz yoksa, bunun yerine HoloLens 2 Emulator veya Windows Mixed Reality benzeticiyi kullanabilirsiniz.

HoloLens 2 için openxr ile çalışmaya başlama

HoloLens 2 için openxr uygulamaları geliştirmeye başlamak için:

  1. bir HoloLens 2 kurun veya HoloLens 2 öykünücüsünün son sürümünü yüklemekiçin yönergeleri izleyin. Son öykünücü görüntüsünü kullanıyorsanız veya cihaz kendi işletim sistemini güncelleştirdiyse, zaten OpenXR 1,0 'e hazırsınız.
  2. Depolama uygulamasını cihazdan veya öykünücüsünde başlatarak, tüm uzantılara sahip en son openxr çalışma zamanına sahip olduğunuzdan emin olun.
    • Sağ üst taraftaki menüyü açın, indirmeler ve güncelleştirmeler' i seçin ve güncelleştirmeleri al' ı seçin.

Not

öykünücüsü kullanıyorsanız, öykünücü görüntüsü her başlattığınızda sıfırlanır ve bu nedenle en iyi sonuç yalnızca HoloLens 2 öykünücü görüntüsünün en son sürümünesahip olduğunuzdan emin olmak olacaktır.

Windows Mixed Reality kulaklıklar için openxr ile çalışmaya başlama

modern Windows Mixed Reality kulaklıklar için openxr uygulamaları geliştirmeye başlamak için:

  1. en az Windows 10 Mayıs 2019 Güncelleştirmesi (1903) çalıştırdığınızdan emin olun. bu, Windows Mixed Reality son kullanıcıların openxr uygulamalarını çalıştırmasına yönelik en düşük gereksinimdir. Windows 10 önceki bir sürümdeyse, Windows 10 güncelleştirme yardımcısınıkullanarak yükseltebilirsiniz.
  2. Windows Mixed Reality bir kulaklık kurun veya Windows Mixed Reality simülatörünü etkinleştirmekiçin yönergeleri izleyin.

İşte bu kadar! Windows Mixed Reality openxr çalışma zamanı, tüm Windows Mixed Reality kullanıcıları için otomatik olarak yüklenir ve etkin hale getirilir. Microsoft Store, çalışma zamanını güncel tutar.

Windows Mixed Reality openxr çalışma zamanını yeniden etkinleştirmek için Başlat menüsü karma gerçeklik portalı 'nı başlatın ve pencerenin üst kısmındaki "çözümü düzeltir" seçeneğini belirleyin. Bu düğme eksikse, OpenXR çalışma zamanı zaten etkindir.

Windows Mixed Reality için OpenXR Geliştirici Araçları alma

Windows Mixed Reality openxr çalışma zamanını denemek için, Windows Mixed Reality app için openxr Geliştirici Araçlarıyükleyebilirsiniz. Bu uygulama, çeşitli OpenXR özelliklerinin yanı sıra, etkin çalışma zamanı ve geçerli kulaklık hakkında önemli bilgiler içeren bir sistem durumu sayfasıyla birlikte sunar.

HoloLens 2 öykünücüsü kullanılırken, Windows Mixed Reality için openxr Geliştirici Araçları yüklemesinin en kolay yolu Windows cihaz portalı' nı kullanmaktır. "openxr" sayfasına gidin ve sonra da fiziksel HoloLens 2 cihazlarda da bulunan "geliştirici özellikleri" altındaki "Install" düğmesine tıklayın.

Windows Mixed Reality uygulama için openxr Geliştirici Araçları

OpenXR API ve örnek uygulamayı keşfetme

Henüz yapmadıysanız, OpenXR geliştirme için ihtiyacınız olan araçları yüklediğinizden emin olun.

basicxrapp projesinde, Visual Studio 'de Win32 ve UWP HoloLens 2 proje dosyası olan basit bir openxr örneği gösterilmektedir. çözüm bir HoloLens UWP projesi içerdiğinden, tam olarak açmak için Visual Studio Evrensel Windows Platformu geliştirme iş yükünün yüklü olması gerekir.

Paketleme ve dağıtım farklılıkları nedeniyle Win32 ve UWP proje dosyaları ayrı olduğundan, her bir proje içindeki uygulama kodu neredeyse tamamen aynıdır!

OpenXR uygulamanızı çalıştırma

Bir OpenXR Win32 Masaüstü .EXE oluşturduktan sonra, bunu, kulaklık türü ne olursa olsun, OpenXR 'yi destekleyen herhangi bir masaüstü VR platformunda bir VR kulağunda kullanabilirsiniz.

bir openxr UWP uygulama paketi oluşturduktan sonra, bu paketi bir HoloLens 2 cihazına ya da HoloLens 2 Emulator dağıtabilirsiniz.

openxr apı 'sini Learning

OpenXR API 'sinin turu için Visual Studio ' de Basicxrapp örneğinin bu 60 dakikalık videosunu inceleyin. Video, OpenXR API 'sinin her bir ana bileşeninin kendi altyapıda nasıl kullanılabileceğini gösterir ve ayrıca OpenXR üzerinde oluşturulmuş uygulamaların bazılarını de bugün gösterir:

Mevcut bir projede OpenXR kullanma

Mevcut bir projede OpenXR ile çalışmaya başlamak için OpenXR yükleyicisini dahil edersiniz. Yükleyici, cihazdaki etkin OpenXR çalışma zamanını bulur ve uyguladığı temel işlevlere ve uzantı işlevlerine erişim sağlar.

Visual Studio projenizden resmi openxr NuGet paketine başvurabilir veya khronos GitHub deposundan resmi openxr yükleyici kaynağını dahil edebilirsiniz. Her iki yaklaşım da OpenXR 1,0 Core özelliklerine, ayrıca yayımlanmış KHR ve uzantılara erişmenizi sağlayacaktır EXTMSFT .

uzantılar ile denemeler yapmak istiyorsanız MSFT_preview , karma gerçeklik GitHub deposundan MSFT_preview .

başvuru resmi openxr NuGet paketi

openxr. Loader NuGet paketi , Visual Studio C++ çözümünüzde önceden oluşturulmuş bir openxr yükleyici .DLL başvurmak için en kolay yoldur. Bu, OpenXR 1,0 Core özelliklerine, ayrıca yayımlanmış ve uzantılara erişmenizi sağlar KHREXTMSFT .

Visual Studio C++ çözümünüze bir openxr. Loader NuGet paket başvurusu eklemek için:

  1. Çözüm Gezgini, openxr kullanacak projeye sağ tıklayın ve NuGet paketlerini yönet... seçeneğini belirleyin.
  2. Göz at sekmesine geçin ve openxr. Loader' ı arayın.
  3. Openxr. Loader paketini seçin ve sağdaki ayrıntılar bölmesinde yükleme ' yi seçin.
  4. Projenizdeki değişiklikleri kabul etmek için Tamam ' ı seçin.
  5. #include <openxr/openxr.h>OpenXR API 'sini kullanmaya başlamak için bir kaynak dosyaya ekleyin.

OpenXR API 'sinin bir örneğini görmek için, Basicxrapp örnek uygulamasına göz atın.

Resmi OpenXR Yükleyici kaynağını dahil et

Yükleyiciyi kendiniz derlemek isterseniz, örneğin, ek yükleyicinin .DLL önlemek için resmi Khronos OpenXR yükleyici kaynaklarını projenize çekebilirsiniz. Bu, OpenXR 1,0 Core özelliklerine, ayrıca yayımlanmış ve uzantılara erişmenizi sağlar KHREXTMSFT .

Buradan başlamak için GitHub Khronos OpenXR-SDKdeposunda bulunan yönergeleri izleyin. proje cmake ile derlemek için ayarlanmıştır-MSBuild kullanıyorsanız, kodu kendi projenize kopyalamanız gerekir.

Önizleme uzantılarını kullanma

MSFT_previewMSFT_preview listelenen uzantılar, geri bildirim toplamak için, önizlenen deneysel satıcı uzantılarıdır. Bu uzantılar yalnızca geliştirici cihazlarına yöneliktir ve gerçek uzantı sevk edildiğinde kaldırılır.

Kullanılabilir MSFT_preview uzantıları denemeye devam ediyorsanız, projenizi güncelleştirmek için aşağıdaki adımları izleyin:

  1. Bir OpenXR yükleyicisini projenize bütünleştirmek için yukarıdaki yaklaşımlardan birini izleyin.
  2. Projenizdeki standart OpenXR üst bilgilerini, GitHub karma gerçeklik OpenXR deposunun önizleme başlıklarıyladeğiştirin.

daha sonra hedef HoloLens 2 veya masaüstü PC 'nizde önizleme uzantısı desteğini etkinleştirmek için:

  1. Tüm Uzantılar bulunan en son OpenXR çalışma zamanına sahip olduğunuzdan emin olmak için, hedef cihaz veya öykünücü içinden Mağaza uygulamasını başlatın, sağ üst köşedeki menüyü açın, indirmeler ve güncelleştirmeler ' i seçin ve güncelleştirmeleri al' ı seçin.
  2. Microsoft Store hedef cihaza Windows Mixed Reality app için openxr Geliştirici Araçları yükleyip uygulamayı çalıştırın.
  3. geliştirici Ayarlar sekmesine gidin ve en son preview openxr çalışma zamanını kullan' ı etkinleştirin. Bu, cihazınızda önizleme uzantıları etkinleştirilmiş olan önizleme çalışma zamanının kullanılabilmesini mümkün. Windows Mixed Reality uygulama geliştiricisi Ayarlar sekmesi için openxr Geliştirici Araçları
  4. Windows Mixed Reality için openxr Geliştirici Araçları 'nin sistem durumu sekmesinde gösterilen çalışma zamanı sürümünü onaylayın ve kullanmayı planladığınız önizleme uzantılarının gerekli sürümüyle eşleşir. Bu durumda, uzantıyı Uzantılar listesinde görmeniz gerekir. Kararlı bir uzantı kullanılabilir olduğunda, önizleme uzantısı kaldırılır.
    Windows Mixed Reality uygulama sistem durumu sekmesi için openxr Geliştirici Araçları

Bu önizleme uzantılarının belgeleri ve bunların nasıl kullanılacağına ilişkin örnekler için bkz. Mixed Reality OpenXR deposu .

Sorun giderme

OpenXR geliştirme ile çalışmaya ve çalıştırmaya sorun yaşıyorsanız, sorun giderme ipuçlarımızagöz atın.