OpenXR ile çalışmaya başlama
OpenXR'yi HoloLens 2 kullanarak geliştirebilir veya masaüstünde çevreleyici başlık Windows Mixed Reality. Mikrofonlu kulaklığa erişiminiz yoksa bunun yerine HoloLens 2 Öykünücüsü'ne veya Windows Mixed Reality Simülatörü'ne erişebilirsiniz.
HoloLens 2 için OpenXR kullanmaya başlama
HoloLens 2 için OpenXR uygulamaları geliştirmeye başlamak için:
İşte bu kadar! OpenXR API çalışma zamanı HoloLens 2 cihazlara önceden yüklenmiştir ve Mağaza üzerinden otomatik güncelleştirmeler alırsınız.
Tüm uzantıların bulunduğu en son OpenXR çalışma zamanına sahip olduğunuzdan emin olmak için HoloLens cihazından veya öykünücüden Mağaza uygulamasını başlatabilirsiniz. Mağaza uygulamasının sağ üst köşesindeki menüyü açın, İndirmeler ve güncelleştirmeler'i seçin ve Güncelleştirmeleri al'ı seçin.
Not
Öykünücüyü kullanıyorsanız öykünücü görüntüsü her başlattığınızda sıfırlanır ve bu nedenle en iyi seçeneğiniz HoloLens 2 öykünücü görüntüsünün en son sürümüne sahip olduğunuzdan emin olmaktır.
Windows Mixed Reality kulaklıklar için OpenXR kullanmaya başlama
Çevreleyici Windows Mixed Reality kulaklıklar için OpenXR uygulamaları geliştirmeye başlamak için:
- Windows Mixed Reality son kullanıcıların OpenXR uygulamalarını çalıştırması için desteklenen en düşük işletim sistemi sürümü olan Windows 10 Ekim 2020 Güncelleştirmesini (20H2) çalıştırdığınızdan emin olun. Windows 10 önceki sürümleri OpenXR ile çalışmaya devam etmelidir, ancak ideal performansa veya kaliteye sahip olmayabilir. Windows 10'nin önceki bir sürümündeyseniz, Windows 10 Güncelleştirme Yardımcısı'nı kullanarak yükseltme yapabilirsiniz.
- Windows Mixed Reality kulaklık ayarlayın veya Windows Mixed Reality simülatörünü etkinleştirin.
İşte bu kadar! Windows Mixed Reality OpenXR çalışma zamanı yüklenir ve tüm Windows Mixed Reality kullanıcılar için otomatik olarak etkin hale getirilir. Ardından Microsoft Store çalışma zamanını güncel tutar.
Bilgisayarınızda birden çok VR başlığı kullanıyorsanız etkin OpenXR çalışma zamanının başka bir satıcının sistem yazılımı tarafından değiştirilebileceğini unutmayın. Windows Mixed Reality OpenXR Çalışma Zamanı'nı yeniden etkinleştirmek için Başlat menüsünde "Karma Gerçeklik Portalı" başlatın ve pencerenin üst kısmındaki "Düzelt"i seçin. Bu düğme eksikse OpenXR çalışma zamanı zaten etkindir.
Windows Mixed Reality için OpenXR Araçlarını Alma
HoloLens 2 veya PC VR için OpenXR uygulamaları geliştiriyorsanız bu Windows Mixed Reality için OpenXR Araçları uygulamasını yararlı bulabilirsiniz. Çeşitli OpenXR özelliklerinin tanıtımını ve etkin çalışma zamanı ve geçerli kulaklık hakkında önemli bilgileri içeren bir OpenXR Çalışma Zamanı sayfası sağlar.
OpenXR Araçları uygulamasını bulmak ve yüklemek için HoloLens 2 Mağaza uygulamasına gidin ve "OpenXR" araması yapın.
HoloLens 2 öykünücüsü kullanılırken, Windows Mixed Reality için OpenXR Araçları'nı yüklemenin en kolay yolu Windows Cihaz Portalı'dır. Portalda "OpenXR" sayfasına gidin ve Geliştirici Özellikleri'nin altında Yükle düğmesini seçin. Bu, fiziksel HoloLens 2 cihazlarda da çalışır.
OpenXR API'sini ve örnek uygulamayı keşfetme
Henüz yüklemediyseniz OpenXR geliştirmesi için ihtiyacınız olan araçları yüklediğinizden emin olun.
BasicXrApp projesi, Visual Studio'da Win32 ve UWP HoloLens 2 proje dosyalarıyla basit bir OpenXR örneği gösterir. Çözüm bir HoloLens UWP projesi içerdiğinden, tamamen açmak için Visual Studio'da Evrensel Windows Platformu geliştirme iş yükünün yüklü olması gerekir.
Win32 ve UWP proje dosyaları paketleme ve dağıtım farklılıkları nedeniyle ayrı olsa da, her projenin içindeki uygulama kodu neredeyse tamamen aynıdır!
OpenXR API turu için Visual Studio'da BasicXrApp örneğinin bu 60 dakikalık videosunu gözden geçirin. Videoda, OpenXR API'sinin ana bileşenlerinin her birinin kendi altyapınızda nasıl kullanılabileceğini ve ayrıca bugün OpenXR üzerinde oluşturulan bazı uygulamaların nasıl kullanılacağı gösterilmektedir:
OpenXR uygulamanızı çalıştırma
OpenXR Win32 masaüstü .EXE derledikten sonra, kulaklık türü ne olursa olsun OpenXR'yi destekleyen herhangi bir masaüstü VR platformunda vr başlığı ile kullanabilirsiniz.
OpenXR UWP uygulama paketi derledikten sonra bu paketi bir HoloLens 2 cihaza veya HoloLens 2 Öykünücüsü'ne dağıtabilirsiniz.
Mevcut projede OpenXR kullanma
Mevcut bir projede OpenXR'yi kullanmaya başlamak için OpenXR yükleyicisini ekleyeceksiniz. Yükleyici, cihazdaki etkin OpenXR çalışma zamanını bulur ve uyguladığı temel işlevlere ve uzantı işlevlerine erişim sağlar.
Resmi OpenXR NuGet paketine Visual Studio projenizden başvurabilir veya Khronos GitHub deposundaki resmi OpenXR yükleyici kaynağını ekleyebilirsiniz . Her iki yaklaşım da OpenXR 1.0 temel özelliklerine, ayrıca yayımlanmış KHRve EXTMSFT uzantılara erişmenizi sağlar.
Uzantılarla MSFT_preview da denemeler yapmak istiyorsanız, Karma Gerçeklik GitHub deposundan OpenXR üst bilgilerini önizlemede kopyalayabilirsiniz.
Resmi OpenXR NuGet paketine başvurun
OpenXR.Loader NuGet paketi, Visual Studio C++ çözümünüzde önceden oluşturulmuş bir OpenXR yükleyicisine .DLL başvurmanın en kolay yoludur. Bu, OpenXR 1.0 temel özelliklerine, ayrıca yayımlanmış KHRve EXTMSFT uzantılarına erişmenizi sağlar.
Visual Studio C++ çözümünüze OpenXR.Loader NuGet paketi başvurusu eklemek için:
- Çözüm Gezgini'da, OpenXR kullanacak projeye sağ tıklayın ve NuGet Paketlerini Yönet...'i seçin.
- Gözat sekmesine geçin ve OpenXR.Loader'ı arayın.
- OpenXR.Loader paketini seçin ve sağdaki ayrıntılar bölmesinde Yükle'yi seçin.
- Projenizdeki değişiklikleri kabul etmek için Tamam'ı seçin.
- OpenXR API'sini kullanmaya başlamak için kaynak dosyaya ekleyin
#include <openxr/openxr.h>.
OpenXR API'sinin nasıl çalıştığını görmek için BasicXrApp örnek uygulamasını gözden geçirin.
Resmi OpenXR yükleyici kaynağını dahil et
Yükleyiciyi kendiniz oluşturmak istiyorsanız, örneğin ek yükleyici .DLL önlemek için resmi Khronos OpenXR yükleyici kaynaklarını projenize çekebilirsiniz. Bu, OpenXR 1.0 temel özelliklerine, ayrıca yayımlanmış KHRve EXTMSFT uzantılarına erişmenizi sağlar.
Buradan başlamak için GitHub'daki Khronos OpenXR-SDK deposundaki yönergeleri izleyin. Proje CMake ile derlanacak şekilde ayarlanmıştır. MSBuild kullanıyorsanız, kodu kendi projenize kopyalamanız gerekir.
Önizleme uzantılarını kullanma
Uzantı MSFT_previewyol haritasında 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ı geldiğinde kaldırılır.
Kullanılabilir MSFT_preview uzantıları denemek istiyorsanız projenizi güncelleştirmek için aşağıdaki adımları izleyin:
- OpenXR yükleyicisini projenizle tümleştirmek için yukarıdaki yaklaşımlardan birini izleyin.
- Projenizdeki standart OpenXR üst bilgilerini GitHub'daki Karma Gerçeklik OpenXR deposundaki önizleme üst bilgileriyle değiştirin.
Ardından hedef HoloLens 2 veya masaüstü bilgisayarınızda önizleme uzantısı desteğini etkinleştirmek için:
- Tüm uzantıların bulunduğu en son OpenXR çalışma zamanına sahip olduğunuzdan emin olmak için Store uygulamasını hedef cihaz veya öykünücü içinden başlatın, sağ üstteki menüyü açın, İndirmeler ve güncelleştirmeler'i seçin ve Güncelleştirmeleri al'ı seçin.
- Microsoft Store'dan Windows Mixed Reality için OpenXR Araçları'nı hedef cihaza yükleyin ve çalıştırın.
- Ayarlar sekmesine gidin ve En son önizleme OpenXR çalışma zamanını kullan'ı etkinleştirin. Bu, önizleme uzantılarının etkinleştirildiği cihazınızda önizleme çalışma zamanını etkinleştirir.
- Windows Mixed Reality için OpenXR Araçları'nın OpenXRÇalışma Zamanı sekmesinde gösterilen Çalışma Zamanı sürümünün, denemeyi 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.
Bu önizleme uzantılarının belgeleri ve bunların nasıl kullanılacağına ilişkin örnekler için Karma Gerçeklik OpenXR deposuna bakın.
Sorun giderme
OpenXR geliştirmesi ile çalışmaya başlama konusunda sorun yaşıyorsanız sorun giderme ipuçlarımıza göz atın.