Aracılığıyla paylaş

MRTK ile yeni bir OpenXR projesi ayarlama

  • Makale

Unity projenizi karma gerçeklik için ayarlamanın en kolay yolu Karma Gerçeklik Araç Seti(MRTK) iledir. Unity için MRTK, harika karma gerçeklik uygulamaları oluşturmayı kolaylaştırmak için tasarlanmış açık kaynaklı, platformlar arası bir geliştirme setidir.

Karma Gerçeklik Araç Seti'nin bazı özelliklerini gösteren bilgi grafiği.

MRTK, uzamsal etkileşimler için platformlar arası giriş sistemi, temel bileşenler ve ortak yapı taşları sağlar. Microsoft HoloLens, Windows Karma Gerçeklik çevreleyici (VR) kulaklıklar ve diğer birçok VR/AR cihazı için uygulama geliştirmenizi hızlandırmanıza yardımcı olabilir. Proje, giriş engellerini azaltmayı, herkesin karma gerçeklik uygulamaları oluşturmasını ve hepimiz büyüdükçe topluluğa geri katkıda bulunmasını sağlamayı hedefliyor.

MRTK, aşağıdakiler dahil olmak üzere çok çeşitli platformları destekler:

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Windows Mixed Reality başlıkları

  • OpenVR başlıkları (HTC Vive/Oculus Rift)

  • Ultraleap Hand Tracking

  • Android ve iOS cihazlar

Not

Kısa süre önce, Çeşitli OpenXR uyumlu cihazlar ve yeni bir tasarım dili için daha iyi destekle Unity'nin XR Yönetim sistemi ve XR Etkileşim Araç Seti üzerine inşa edilen Üçüncü Nesil Microsoft Karma Gerçeklik Toolkit olan MRTK3'i kullanıma sunmuştuk. Daha fazla bilgi için MRTK3 belgelerine bakın.

Not

MRTK olmadan yeni bir OpenXR projesi de ayarlayabilirsiniz.

Dikkate alınması gereken OpenXR olmayan diğer yapılandırma seçenekleri

Windows XR: Microsoft, Unity 2020'deki yeni projeler için Windows XR eklentisini kullanmanızı önermez. Bunun yerine, Karma Gerçeklik OpenXR eklentisini kullanmanız gerekir. Ancak Unity 2019 kullanıyorsanız ve ARCore/ARKit cihazlarıyla uyumluluk için AR Foundation 2.0'a ihtiyacınız varsa, bu eklenti bu desteği etkinleştirir.

Eski XR:

Hala Unity 2019 veya önceki bir sürüm kullanıyorsanız Microsoft, Eski Yerleşik XR desteğinin kullanılmasını önerir.

Yeni bir projeye başlıyorsanız, bunun yerine Unity 2020'yi yüklemenizi ve Karma Gerçeklik OpenXR eklentisini kullanmanızı öneririz.

OpenXR kullanmaya başlama: Yeni bir Unity projesi oluşturma

  1. Unity Hub'ı başlatın.

  2. Projeler sekmesinde Yeni Proje'ye tıklayın.

    Projeler sekmesinde Yeni Proje düğmesinin vurgulandığı Unity Hub'ın ekran görüntüsü.

  3. Yeni proje'nin altındaki açılan menüye tıklayın ve istediğiniz Düzenleyici sürümünü seçin.

    Düzenleyici sürümü açılan listesinin görüntülendiği Unity Hub'ın ekran görüntüsü.

  4. Seçilen şablonun 3B Core olduğundan emin olun.

  5. Proje adı kutusuna projeniz için bir ad girin; örneğin, "MRTK Öğreticisi."

  6. Konum kutusunda klasör simgesine tıklayın ve projenizi kaydetmek istediğiniz klasöre gidip seçin. Yeni bir klasör de oluşturabilirsiniz.

    3B, Proje Adı, Konum ve Oluştur seçeneklerinin vurgulandığı Unity Hub’ın ekran görüntüsü.

  7. Proje Oluştur'a tıklayın. Böylece projeniz Unity'de açılır.

    Unity'de açılan projenizin ekran görüntüsü.

Dikkat

Windows’da çalışırken 255 karakterlik MAX_PATH (en fazla yol) sınırı vardır. Unity bu sınırlardan etkilenir ve dosya yollarından biri 255 karakterden uzunsa başarısız olabilir. Bu nedenle Unity projenizi sürücünün köküne olabildiğince yakın bir yerde depolamanızı öneririz.

Derleme hedefinizi ayarlama

  1. Menü çubuğunda Dosya>Derleme Ayarları... öğesini seçin.

    Windows Karma Gerçeklik için uygulama oluşturmak için bir derleme hedefi seçmeniz gerekir. Evrensel Windows Platformu (UWP) için derleme ayarları, HP Reverb G2 gibi çevreleyici kulaklıklar da dahil olmak üzere tüm cihazları hedefler. HoloLens 2 için oluşturuyorsanız bu en iyi seçenektir; ancak masaüstü VR'yi hedeflediyseniz PC, Mac ve Linux Tek Başına platformunu kullanmanızı öneririz.

  2. Aşağıdakilerden birini yapın:

    Masaüstü VR'yi hedeflediyseniz:

    • Yeni bir Unity projesinde varsayılan olarak seçilen PC, Mac ve Linux Tek Başına platformunu koruyun:

    PC, Mac ve Tek başına platform vurgulanmış olarak unity düzenleyicisinde açılan Derleme Ayarları penceresinin ekran görüntüsü

    HoloLens 2'yi hedeflediyseniz:

    • Platform'un altında Evrensel Windows Platformu'ı seçin. Aşağıdaki ayarların etkin olduğundan emin olun:

    Derleme Türü: D3D Projesi

    Hedef SDK Sürümü: En Son Yüklenen

    En Düşük Platform Sürümü: 10.0.10240.0

    Visual Studio Sürümü: En son yüklenen

    Birim düzenleyicisinde Evrensel Windows Platformu vurgulanmış şekilde açılan Derleme Ayarları penceresinin ekran görüntüsü.

  3. Platform Değiştir düğmesine tıklayın. Unity, platformları değiştirirken bir ilerleme çubuğu görüntüler.

  4. Platform değiştirme işlemi tamamlandıktan sonra Derleme Ayarları penceresini kapatın.

Karma Gerçeklik Özellik Aracı'nı indirme ve yükleme

Karma Gerçeklik OpenXR Eklentisi Unity için bir paket biçiminde gelir. Özellik paketlerini bulmanın, güncelleştirmenin ve içeri aktarmanın en iyi yolu Karma Gerçeklik Özellik Aracı'dır. İçeri aktarmadan önce paketleri ada veya kategoriye göre arayabilir, bağımlılıklarını görebilir ve projenizin bildirim dosyasında önerilen değişiklikleri görüntüleyebilirsiniz.

  1. Microsoft İndirme Merkezi'nden Karma Gerçeklik Özellik Aracı'nın en son sürümünü indirin.

  2. İndirme işlemi tamamlandıktan sonra MixedRealityFeatureTool.exe yürütülebilir dosyaya gidin ve Karma Gerçeklik Özellik Aracı'nı başlatmak için bu dosyayı kullanın.

    MixedRealityFeatureTool'un Açılmasının ekran görüntüsü.

Karma Gerçeklik Toolkit ve OpenXR paketlerini içeri aktarma

  1. Karma Gerçeklik Özellik Aracı'nda Başlat'ı seçin.

    Karma Gerçeklik Özellik Aracı açılış ekranının ekran görüntüsü.

  2. Gözat düğmesini (aşağıdaki resimde "üç nokta" düğmesidir) seçin, ardından projenize gidin ve açın.

    Projenizi açma

    Not

    Araçtaki Proje Yolu kutusu bir değer içermelidir, bu nedenle varsayılan olarak ters eğik çizgi ("_") ekler.

    Siz bir klasör seçtikten sonra Araç, klasörün geçerli bir Unity proje klasörü olduğundan emin olmak için denetler.

    Karma Gerçeklik özelliği Araç Proje Yolu ekranının ekran görüntüsü.

  3. Özellikleri Keşfet'i seçin.

    Not: Araç akışlardan paketleri yenilerken birkaç saniye beklemeniz gerekebilir.

  4. Özellikleri Bul sayfasında, altı paket grubunun listesi olduğunu unutmayın.

    Karma Gerçeklik Özellik Aracı'ndaki ana paket grupları

  5. Karma Gerçeklik Araç Seti'nin (0 /10) sol tarafındaki "+" düğmesine tıklayın ve Karma Gerçeklik Toolkit Foundation'ın en son sürümünü seçin.

    Not

    Karma Gerçeklik Toolkit Foundation paketi, MRTK'yi projenizle birlikte kullanmak için içeri aktarılması ve yapılandırılması gereken tek pakettir. Bu paket, karma gerçeklik uygulaması oluşturmak için gereken temel bileşenleri içerir.

  6. Platform Desteği'nin (0 /5) sol tarafındaki "+" düğmesine tıklayın ve ardından Karma Gerçeklik OpenXR Eklentisi'nin en son sürümünü seçin.

    Karma Gerçeklik Özellik Aracı'ndaki paket seçimlerinin ekran görüntüsü.

  7. Seçimlerinizi yaptıktan sonra Özellikleri Al'a tıklayın.

  8. Seçtiğiniz paketleri doğrulamak için Doğrula'yı seçin. Doğrulama sorunu algılanmadı ifadesini içeren bir iletişim kutusu görmeniz gerekir. Bunu yaptığınızda Tamam'a tıklayın.

  9. Özellikleri İçeri Aktar sayfasında, sol taraftaki Özellikler sütunu az önce seçtiğiniz paketleri görüntüler. Sağ taraftaki Gerekli bağımlılıklar sütunu tüm bağımlılıkları görüntüler. Bu öğeler hakkında daha fazla bilgi edinmek için bu öğelerden herhangi birinin Ayrıntılar bağlantısına tıklayabilirsiniz.

  10. Devam etmeye hazır olduğunuzda İçeri Aktar'ı seçin . Gözden Geçir ve Onayla sayfasında paketler hakkındaki bilgileri gözden geçirebilirsiniz.

  11. Onayla'yı seçme.

  12. Unity Düzenleyicisi'ne dönün ve kullanıcı arabiriminde boş bir alana tıklayın. Paketlerinizin içeri aktarıldığını gösteren bir ilerleme çubuğu görürsünüz.

Giriş Arka Uç ayarlarını yapılandırma

  1. Unity paketi içeri aktardıktan sonra düzenleyiciyi yeniden başlatarak arka uçları etkinleştirmek isteyip istemediğinizi soran bir uyarı görüntülenir. Evet'i seçin.

    Unity Yeniden Başlatma Seçeneğinin ekran görüntüsü.

Proje Doğrulaması aracılığıyla HoloLens 2 için projeyi yapılandırma (MR OpenXR 1.6+)

Masaüstü VR için geliştiriyorsanız bu bölümü atlayın ve Projeyi masaüstü VR için yapılandırma bölümüne gidin.

  1. Menü çubuğunda, HoloLens 2 için doğrulama kurallarını etkinleştirmek üzere Proje Doğrulama Ayarları > HoloLens 2 Uygulaması (UWP) Karma Gerçeklik tıklayın. > 1.9 sürümünden önceki MR OpenXR eklentileri için kullanılabilir menü öğesi HoloLens > 2 için Önerilen proje ayarlarını uygula Karma Gerçeklik>.
  2. Açılan proje doğrulama penceresinde UWP platform sekmesinde (Windows logosuyla gösterilir) olduğunuzdan emin olun ve doğrulama sorunlarını çözmek için Tümünü düzelt'e tıklayın. Tümünü düzelt'e tıkladıktan sonra kalan sorunlar olabileceğini unutmayın. Bu durumda Tümünü düzelt'e yeniden tıklamayı deneyin, "görünüme özgü" (varsa) olarak işaretlenmiş sorunları yoksayın ve yapmak istediğiniz önerilen değişiklikler olup olmadığını görmek için geri kalan sorunları (varsa) gözden geçirin.
  3. Proje bu noktada HoloLens 2 dağıtımı için neredeyse hazır. Sonraki adım için Player ayarlarını yapılandırma bölümüne geçin.

HoloLens 2 için projeyi el ile yapılandırma

Masaüstü VR için geliştiriyorsanız bu bölümü atlayın ve Projeyi masaüstü VR için yapılandırma bölümüne gidin.

  1. Proje Ayarları penceresinin açık olduğundan emin olun. Aksi takdirde, menü çubuğunda Proje Ayarlarını Düzenle'yi>seçin.

  2. Proje Ayarları penceresinde XR Eklenti Yönetimi sayfasında ve Evrensel Windows Platformu sekmesinde olduğunuzdan emin olun.

    XR Eklentisi Yönetim Sayfası ve Evrensel Windows Platformu sekmesine açılan Proje Ayarları Penceresinin ekran görüntüsü.

  3. Başlangıçta XR'yi Başlat'ın seçili olduğundan emin olun ve Eklenti Sağlayıcıları'nın altında OpenXR'ye tıklayın.

    Evrensel Windows Platformu içinde Başlangıçta XR'yi Başlat'ın seçili ve OpenXR Eklentisinin vurgulandığı Proje Ayarları Penceresinin ekran görüntüsü.

  4. OpenXR Eklentisi yüklenir ve ardından OpenXR'nin altında birden çok öğe görünür. Microsoft HoloLens özellik grubunu seçin.

    OpenXR eklentisinin ve Microsoft HoloLens Özellik Grubunun vurgulandığı Proje Ayarları Penceresinin ekran görüntüsü.

OpenXR'nin yanında sarı bir uyarı üçgeni olduğunu unutmayın. Bu, çözülmesi gereken uyumsuz ayarlara sahip olduğunuzu gösterir. Bunun nasıl ele alınıp alınmadığını öğrenmek için VR için yapılandırmayla ilgili sonraki bölümü atlayın ve uyumsuz ayarları çözümleme başlıklı aşağıdaki bölümle devam edin.

Projeyi Proje Doğrulama aracılığıyla masaüstü VR için yapılandırma (MR OpenXR 1.9+)

  1. Menü çubuğunda, bir masaüstü XR uygulaması için doğrulama kurallarını etkinleştirmek için Karma Gerçeklik > Proje Doğrulama Ayarları > Win32 Uygulaması'na (Tek Başına) tıklayın.
  2. Açılan proje doğrulama penceresinde Tek başına platform sekmesinde olduğunuzdan emin olun ve doğrulama sorunlarını çözmek için Tümünü düzelt'e tıklayın. Tümünü düzelt'e tıkladıktan sonra kalan sorunlar olabileceğini unutmayın. Bu durumda Tümünü düzelt'e yeniden tıklamayı deneyin, "görünüme özgü" (varsa) olarak işaretlenmiş sorunları yoksayın ve yapmak istediğiniz önerilen değişiklikler olup olmadığını görmek için geri kalan sorunları (varsa) gözden geçirin.

Projeyi masaüstü VR için el ile yapılandırma

  1. Proje Ayarları penceresinin açık olduğundan emin olun. Aksi takdirde, menü çubuğuna gidin ve Proje Ayarlarını Düzenle'yi>seçin.

  2. Proje Ayarları penceresinde XR Eklenti Yönetimi sayfasında ve PC, Mac ve Linux Tek Başına sekmesinde olduğunuzdan emin olun.

    XR Eklenti Yönetimi Sayfası ve PC, Mac ve Linux Tek Başına sekmesine açılan Proje Ayarları Penceresinin ekran görüntüsü.

  3. Başlangıçta XR'yi Başlat'ın seçili olduğundan emin olun ve Eklenti Sağlayıcıları'nın altında OpenXR'ye tıklayın.

    Pc, Mac ve Linux Tek Başına sekmesinin içinde, Başlangıçta XR'yi Başlat'ın seçili ve OpenXR Eklentisinin vurgulandığı Proje Ayarları Penceresinin ekran görüntüsü.

  4. OpenXR Eklentisi yüklenir ve OpenXR altında iki öğe görünür. İlki olan Windows Karma Gerçeklik özellik grubunu seçin.

    OpenXR Eklentisi ve Windows Karma Gerçeklik özellik grubunun vurgulandığı Proje Ayarları Penceresi'nin ekran görüntüsü.

Artık OpenXR'nin yanında sarı bir uyarı üçgeni olduğunu unutmayın. Bu, çözülmesi gereken uyumsuz ayarlara sahip olduğunuzu gösterir. Bu sorunu nasıl çözeceklerini öğrenmek için uyumsuz ayarları çözümleme başlıklı sonraki bölüme geçin.

Uyumsuz ayarları çözümleme

Önemli

Bu bölümdeki görüntüler, Evrensel Windows Platformu sekmesindeki seçenekleri gösterir. Ancak yönergeler, not edilen durumlar dışında Masaüstü VR sekmesi için aynıdır.

  1. İmlecinizi OpenXR'nin yanındaki sarı uyarı üçgeninin üzerine getirin, ardından açılan pencerede iletiyi okuyun ve üçgeni seçin.

    Uyumsuz ayarlarla ilgili uyarının ekran görüntüsü.

  2. OpenXR Proje Doğrulama penceresinde listelenen birkaç sorun vardır. Tümünü Düzelt düğmesini seçin. NOT: Bu liste, hangi sekmede bulunduğunuza bağlı olarak farklı görünebilir.

    OpenXR Proje Doğrulama penceresindeki Tümünü Düzelt düğmesinin ekran görüntüsü.

  3. Sorunlardan biri kalır ve en az bir etkileşim profili eklemeniz gerektiğini bildirir. Bunu yapmak için Düzenle'ye tıklayın. Bu işlem sizi Proje Ayarları penceresindeki OpenXR eklentisinin ayarlarına götürür.

    OpenXR ayarlarının görüntülendiği Proje Ayarları penceresinin ekran görüntüsü.

  4. Etkileşim Profilleri'nin altında artı işareti (+) düğmesini not edin.

    Etkileşim Profili Ekle düğmesinin ekran görüntüsü.

  5. Her seferinde farklı bir profil seçerken düğmeye üç kez tıklayın:

    Göz Bakışı Etkileşim Profili

    Microsoft El Etkileşimi Profili

    Microsoft Hareket Denetleyicisi Profili

    Eklenmesi gereken etkileşim profillerinin ekran görüntüsü.

    Göz Bakışı Etkileşim Profili veya başka bir profil yanında sarı üçgenle görünüyorsa üçgeni seçin ve OpenXR Proje Doğrulama penceresinde Düzelt düğmesine tıklayın. İşiniz bittiğinde OpenXR Proje Doğrulama penceresini kapatın.

    Göz Bakışı etkileşim profili için Düzelt düğmesinin ekran görüntüsü.

  6. OpenXR Özellik Grupları altındaki Proje Ayarları penceresinde aşağıdakilerin seçili olduğundan emin olun:

    Masaüstü VR sekmesindeyseniz:

    Windows Karma Gerçeklik

    El İzleme

    Hareket Denetleyicisi Modeli

    Masaüstü VR sekmesi için OpenXR Özellik Grupları'nın ekran görüntüsü.

    Evrensel Windows Platformu sekmesindeyseniz:

    Microsoft HoloLens

    El İzleme

    Hareket Denetleyicisi Modeli

    OpenXR için seçilen özelliklerin ekran görüntüsü.

  7. Derinlik Gönderim Modu açılan menüsünde Derinlik 16 Bit'i seçin.

    Derinlik Gönderim Modu için seçilen Derinlik 16 Bit'in ekran görüntüsü.

    İpucu

    Derinlik Biçimini 16 bit olarak azaltmak isteğe bağlıdır, ancak projenizdeki grafik performansını artırabilir. Daha fazla bilgi edinmek için bkz . Derinlik arabellek paylaşımı (HoloLens).

    Not

    Derinlik Gönderim Modu'nu hemen üzerinde bulunan İşleme Modu ayarı, varsayılan olarak Tek Geçiş Örneği olarak ayarlanır. Karma gerçeklik uygulamalarında sahne iki kez işlenir: her göz için bir kez. Sonuç olarak "stereoskopik görüntü" elde edilir. Bu, gerekli bilgi işlem miktarını ikiye katlar, bu nedenle hem CPU hem de GPU süresinden tasarruf etmek için Unity'deki en verimli işleme yolunu seçmek önemlidir. Tek geçişli örnekli işleme burada en iyi seçenektir; bunu her proje için varsayılan olarak etkinleştirmenizi öneririz. Bu konuda daha fazla bilgi edinmek için Unity belgelerine bakın.

Player ayarlarını yapılandırma

  1. Proje Ayarları penceresinin sol tarafındaki sütunda Yürütücü'leri seçin.

  2. Player penceresinde Ürün Adı kutusunun zaten doldurulmuş olduğunu unutmayın. Bu, proje adınızdan alınır ve HoloLens Başlat menüsü görüntülenen addır.

    Proje Adı kutusu doldurulmuş Unity Yayımlama Ayarları'nın ekran görüntüsü.

    İpucu

    Geliştirme sırasında uygulamanın bulunmasını kolaylaştırmak için adın önüne bir alt çizgi ekleyerek herhangi bir listenin en üstüne sıralayın.

  3. Yayımlama Ayarları açılan menüsüne tıklayın ve Paket adı alanına uygun bir ad girin.

    Paket adı kutusu doldurulmuş Unity Yayımlama Ayarları'nın ekran görüntüsü.

    Not

    Paket adı, uygulamanın benzersiz tanımlayıcısıdır. Uygulamanın önceden yüklenmiş sürümlerinin üzerine aynı ada sahip yazmaktan kaçınmak istiyorsanız, uygulamayı dağıtmadan önce bu tanımlayıcıyı değiştirmeniz gerekir.

  4. Proje Ayarları penceresini kapatın.

Artık Unity'de OpenXR ile geliştirmeye başlamaya hazırsınız!

Unity örnek projeleri

Karma Gerçeklik OpenXR eklentisini kullanarak HoloLens 2 veya Karma Gerçeklik mikrofonlu kulaklıklar için Unity uygulamalarının nasıl derleneceğini gösteren örnek unity projeleri için OpenXR Karma Gerçeklik örnekleri deposuna göz atın.

Ayrıca bkz.