Bagikan melalui

Meningkatkan dari HoloToolkit — MRTK2

  • Artikel

Panduan untuk membantu Anda migrasi dari HoloLens Toolkit (HTK) ke Mixed Reality Toolkit (MRTK).

Pengontrol dan input tangan

Penyiapan dan konfigurasi

Metode HTK 2017 MRTK v2
Jenis Peristiwa tertentu untuk tombol, dengan info jenis input jika relevan. Input berbasis Tindakan / Gerakan, diteruskan melalui peristiwa.
Siapkan Tempatkan InputManager di adegan. Aktifkan sistem input di Profil Konfigurasi dan tentukan jenis sistem input konkret.
Konfigurasi Dikonfigurasi di Inspektur, pada setiap skrip individual di adegan. Dikonfigurasi melalui Profil Sistem Input Mixed Reality dan profil terkaitnya, tercantum di bawah ini.

Profil terkait:

  • Profil Pemetaan Pengontrol Mixed Reality
  • Profil Visualisasi Pengontrol Realitas Campuran
  • Profil Gerakan Realitas Campuran
  • Profil Tindakan Input Mixed Reality
  • Profil Aturan Tindakan Input Mixed Reality
  • Profil Mixed Reality Pointer

Pengaturan Penyedia Tatapan dimodifikasi pada objek Kamera Utama di adegan.

Komponen dukungan platform (misalnya, Windows Mixed Reality Device Manager) harus ditambahkan ke penyedia data layanan yang sesuai.

Pemetaan antarmuka dan peristiwa

Beberapa peristiwa tidak lagi memiliki peristiwa unik dan sekarang berisi MixedRealityInputAction. Tindakan ini ditentukan dalam profil Tindakan Input dan dipetakan ke pengontrol dan platform tertentu di profil Pemetaan Pengontrol. Peristiwa seperti OnInputDown sekarang harus memeriksa jenis MixedRealityInputAction.

Sistem input terkait:

HTK 2017 MRTK v2 Pemetaan Tindakan
IControllerInputHandler IMixedRealityInputHandler<Vector2> Dipetakan ke touchpad atau thumbstick
IControllerTouchpadHandler IMixedRealityInputHandler Dipetakan ke touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Dipetakan untuk ditahan di Profil Gerakan
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Dipetakan ke tombol pengontrol atau ketukan tangan
IManipulationHandler IMixedRealityGestureHandler<Vector3> Dipetakan ke manipulasi di Profil Gerakan
INavigationHandler IMixedRealityGestureHandler<Vector3> Dipetakan ke navigasi di Profil Gerakan
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Dipetakan ke posisi pemicu
ISourcePositionHandler IMixedRealityInputHandler<Vector3> atau IMixedRealityInputHandler<MixedRealityPose> Dipetakan ke posisi pointer atau posisi cengkeraman
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> atau IMixedRealityInputHandler<MixedRealityPose> Dipetakan ke posisi pointer atau posisi cengkeraman
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler dan IMixedRealityInputHandler<Vector2> Dipetakan ke berbagai tombol pengontrol dan thumbstick

Kamera

Metode HTK 2017 MRTK v2
Siapkan Hapus MainCamera, tambahkan prefab MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera ke adegan atau gunakan item menu Konfigurasikan > Pengaturan Adegan Mixed Reality > Terapkan. MainCamera induk di bawah MixedRealityPlayspace melalui Mixed Reality Toolkit > Tambahkan ke Adegan dan Konfigurasikan...
Konfigurasi Konfigurasi pengaturan kamera dilakukan pada instans prefab. Pengaturan kamera dikonfigurasi di Profil Kamera Mixed Reality.

Ucapan

Pengenalan kata kunci

Metode HTK 2017 MRTK v2
Siapkan Tambahkan SpeechInputSource ke adegan Anda. Layanan kata kunci (misalnya, Windows Speech Input Manager) harus ditambahkan ke penyedia data sistem input.
Konfigurasi Kata kunci yang dikenali dikonfigurasi di pemeriksa SpeechInputSource. Kata kunci dikonfigurasi di Profil Perintah Ucapan Mixed Reality.
Penangan kejadian ISpeechHandler IMixedRealitySpeechHandler

Pendiktean

Metode HTK 2017 MRTK v2
Siapkan Tambahkan DictationInputManager ke adegan Anda. Dukungan dikte memerlukan layanan (misalnya, Manajer Input Dikte Windows) untuk ditambahkan ke penyedia data Sistem Input.
Penangan kejadian IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Kesadaran/ pemetaan spasial

Jala

Metode HTK 2017 MRTK v2
Siapkan Tambahkan prefab SpatialMapping ke adegan. Aktifkan Sistem Kesadaran Spasial di Profil Konfigurasi dan tambahkan pengamat spasial (misalnya, Pengamat Jala Spasial Windows Mixed Reality) ke penyedia data Sistem Kesadaran Spasial.
Konfigurasi Konfigurasikan instans adegan di inspektur. Konfigurasikan pengaturan pada setiap profil pengamat spasial.

Pesawat

Metode HTK 2017 MRTK v2
Siapkan SurfaceMeshesToPlanes Gunakan skrip. Belum diimplementasikan.

Pemahaman spasial

Metode HTK 2017 MRTK v2
Siapkan Tambahkan prefab SpasialUnderstanding ke adegan. Belum diimplementasikan.
Konfigurasi Konfigurasikan instans adegan di inspektur. Belum diimplementasikan.

Perbatasan

Metode HTK 2017 MRTK v2
Siapkan BoundaryManager Tambahkan skrip ke adegan. Aktifkan Sistem Batas di Profil Konfigurasi.
Konfigurasi Konfigurasikan instans adegan di inspektur. Konfigurasikan pengaturan di profil Visualisasi Batas.

Berbagi

Metode HTK 2017 MRTK v2
Siapkan Layanan berbagi: Tambahkan prefab Berbagi ke adegan. UNet: Gunakan contoh SharingWithUNET. Sedang berlangsung
Konfigurasi Konfigurasikan instans adegan di inspektur. Sedang berlangsung

UX

Metode HTK 2017 MRTK v2
Tombol Objek yang Dapat Berinteraksi Kancing
Dapat berinteraksi Objek yang Dapat Berinteraksi Dapat berinteraksi
Kotak Pembatas Kotak Pembatas Kotak Pembatas
Bilah Aplikasi Bilah Aplikasi Bilah Aplikasi
Manipulasi Satu Tangan (Grb dan Pindah) HandDraggable Handler Manipulasi
Manipulasi Dua Tangan (Ambil/Pindahkan/Putar/Skala) TwoHandManipulatable Handler Manipulasi
Keyboard Prefab keyboard Papan Tombol Sistem
Tipsalat Tipsalat Tipsalat
Koleksi Objek Koleksi Objek Koleksi Objek
Solver Solver Solver

Utilitas

Beberapa Utilitas telah direkonsiliasi sebagai duplikat dengan sistem Solver. Silakan ajukan masalah jika salah satu skrip yang Anda butuhkan hilang.

HTK 2017 MRTK v2
Baliho Billboard
Tagalong RadialView atau Orbital Pemecah
FixedAngularSize ConstantViewSizeSolver
FpsDisplay Sistem Diagnostik (di Profil Konfigurasi)
NearFade Bawaan ke shader Standar Mixed Reality Toolkit