Bagikan melalui

Membuat aplikasi HoloLens Unreal pertama Anda

  • Artikel

Panduan ini akan memandu Anda dalam menjalankan aplikasi Mixed Reality pertama Anda di HoloLens di Unreal Engine. Dalam tradisi "Halo Dunia", Anda akan membuat aplikasi sederhana yang menampilkan kubus di layar. Untuk membuatnya lebih berguna, Anda juga akan membuat gerakan pertama Anda untuk memutar kubus dan keluar dari aplikasi.

Tujuan

  • Memulai Proyek HoloLens
  • Aktifkan plugin yang benar
  • Membuat Aset Data ARSessionConfig
  • Menyiapkan input gerakan
  • Membangun tingkat dasar
  • Menerapkan gerakan mencubit

Membuat produk baru

Hal pertama yang Anda butuhkan adalah proyek untuk dikerjakan. Jika Anda adalah pengembang Unreal pertama kali, Anda harus mengunduh file pendukung dari Epic Launcher.

  1. Luncurkan Mesin Unreal
  2. Di Kategori Proyek Baru, pilih Game dan klik Berikutnya:

Jendela proyek terbaru terbuka dengan Game disorot

  1. Pilih templat Kosong dan klik Berikutnya:

Jendela browser proyek tidak nyata dengan templat Kosong disorot

  1. Di Pengaturan Proyek, atur C++, 3D atau 2D yang Dapat Diskalakan, Seluler/Tablet, dan Tanpa Konten Pemula, lalu pilih lokasi penyimpanan dan klik Buat Proyek

Catatan

Anda menggunakan C++ daripada proyek Blueprint agar siap menggunakan plugin OpenXR nanti. Mulai Cepat ini menggunakan plugin OpenXR default yang dilengkapi dengan Unreal Engine. Namun, mengunduh dan menggunakan plugin Resmi Microsoft OpenXR disarankan. Itu mengharuskan proyek menjadi proyek C++.

Jendela pengaturan proyek dengan pilihan proyek, performa, platform target, dan konten pemula disorot

Proyek baru Anda harus terbuka secara otomatis di editor Unreal, yang berarti Anda siap untuk bagian berikutnya.

Mengaktifkan plugin yang diperlukan

Anda harus mengaktifkan dua plugin sebelum dapat mulai menambahkan objek ke adegan.

  1. Buka Edit > Plugin dan pilih Augmented Reality dari daftar opsi bawaan.
  • Gulir ke bawah ke HoloLens dan centang Diaktifkan

Jendela plugin dengan bagian realitas tertambung terbuka dan HoloLens disorot

  1. Ketik OpenXR di kotak pencarian di kanan atas dan aktifkan plugin OpenXR dan OpenXRMsftHandInteraction :

Jendela plugin dengan OpenXR diaktifkan

Jendela Plugin dengan Open XR Msft Hand Interaction diaktifkan

  1. Mulai ulang editor Anda

Catatan

Tutorial ini menggunakan OpenXR, tetapi dua plugin yang telah Anda instal di atas saat ini tidak menyediakan set fitur lengkap untuk pengembangan HoloLens. Plugin HandInteraction akan cukup untuk gerakan "Pinch" yang akan Anda gunakan nanti, tetapi jika Anda ingin melampaui dasar-dasar, Anda harus mengunduh plugin Microsoft OpenXR.

Dengan plugin diaktifkan, Anda dapat fokus mengisinya dengan konten.

Membuat tingkat

Tugas Anda berikutnya adalah membuat penyiapan pemutar dengan titik awal dan kubus untuk referensi dan skala.

  1. Pilih Tingkat Baru File > dan pilih Tingkat Kosong. Adegan default di viewport sekarang harus kosong
  2. Dari tab Mode , pilih Dasar dan seret PemutarMulai ke dalam adegan
  • Di tab Detail , atur Lokasi ke X = 0, Y = 0, dan Z = 0 untuk menempatkan pengguna di tengah adegan saat aplikasi dimulai

Adegan editor tidak nyata dengan lokasi dan pemutar mulai ditambahkan

  1. Dari tab Dasar , seret Kubus ke dalam adegan
  • Atur Lokasi kubus ke X = 50, Y = 0, dan Z = 0 untuk memposisikan kubus 50 cm dari pemutar pada awal
  • Ubah Skala kubus menjadi X = 0,2, Y = 0,2, dan Z = 0,2

Anda tidak dapat melihat kubus kecuali Anda menambahkan cahaya ke adegan Anda, yang merupakan tugas terakhir Anda sebelum menguji adegan.

  1. Di panel Mode , beralihlah ke tab Lampu dan seret Cahaya Arah ke dalam adegan
  • Posisikan cahaya di atas PlayerStart sehingga Anda dapat melihatnya

Adegan editor tidak nyata dengan kubus dan lampu arah ditambahkan

  1. Buka Simpan File > Saat Ini, beri nama tingkat Utama Anda, dan pilih Simpan

Dengan set adegan, tekan Putar di toolbar untuk melihat kubus Anda beraksi! Setelah selesai mengagumi pekerjaan Anda, tekan Esc untuk menghentikan aplikasi.

Adegan dalam mode putar dengan kubus di tengah layar

Sekarang setelah adegan disiapkan, mari kita siapkan untuk beberapa interaksi dasar di AR. Pertama, Anda perlu membuat Sesi AR dan dapat menambahkan cetak biru untuk mengaktifkan interaksi tangan.

Menambahkan aset sesi

Sesi AR di Unreal tidak terjadi sendiri. Untuk menggunakan sesi, Anda memerlukan aset data ARSessionConfig untuk dikerjakan, yang merupakan tugas Anda berikutnya:

  1. Di Browser Konten, pilih Tambahkan Aset Data Lain-lain > Baru > dan pastikan Anda berada di tingkat folder Konten akar
  2. Pilih ARSessionConfig, klik Pilih, dan beri nama aset ARSessionConfig:

Pilih jendela kelas aset data yang terbuka dengan aset konfigurasi sesi AR disorot

  1. Klik dua kali ARSessionConfig untuk membukanya, Simpan dengan semua pengaturan default, dan kembali ke jendela Utama:

Jendela detail aset konfigurasi sesi AR

Dengan itu, langkah Anda selanjutnya adalah memastikan sesi AR dimulai dan berhenti saat level dimuat dan berakhir. Untungnya, Unreal memiliki cetak biru khusus yang disebut Level Blueprint yang bertindak sebagai grafik peristiwa global di seluruh tingkat. Menyambungkan aset ARSessionConfig di Level Blueprint menjamin sesi AR akan diaktifkan tepat ketika game mulai bermain.

  1. Dari toolbar editor, pilih Blueprints > Open Level Blueprint:

Menu cetak biru terbuka dengan opsi cetak biru tingkat terbuka disorot

  1. Seret simpul eksekusi (ikon panah menghadap ke kiri) dari Event BeginPlay dan rilis
  • Cari simpul Mulai Sesi AR dan tekan enter
  • Klik menu dropdown Pilih Aset di bawah Konfigurasi Sesi dan pilih aset ARSessionConfig

Grafik cetak biru dengan peristiwa mulai diputar yang terhubung ke fungsi sesi start ar

  1. Klik kanan di mana saja di EventGraph dan buat simpul Event EndPlay baru.
  • Seret pin dan rilis eksekusi, lalu cari simpul Hentikan Sesi AR dan tekan enter
  • Tekan Kompilasi, lalu Simpan dan kembali ke jendela Utama

Penting

Jika sesi AR masih berjalan saat tingkat berakhir, fitur tertentu mungkin berhenti berfungsi jika Anda memulai ulang aplikasi saat streaming ke headset.

Simpul pemutaran akhir peristiwa yang dilampirkan ke fungsi sesi stop ar

Menyiapkan input

  1. Pilih Edit > Pengaturan Proyek dan buka Input Mesin >
  2. Pilih ikon di + samping Pemetaan Tindakan dan buat tindakan RightPinch dan LeftPinch :

Pengaturan input pengikatan dengan pemetaan tindakan pinch kanan dan kiri disorot

  1. Petakan tindakan RightPinch dan LeftPinch ke tindakan Interaksi Tangan OpenXR Msft masing-masing:

Pemetaan tindakan dengan opsi interaksi Open XR Msft Hand disorot

Menyiapkan gerakan

Sekarang setelah kita menyiapkan input, kita bisa mendapatkan bagian yang menarik: Menambahkan gerakan! Mari putar kubus di cubit kanan dan keluar dari aplikasi di cubit kiri.

  1. Buka Cetak Biru Tingkat dan tambahkan InputAction RightPinch dan InputAction LeftPinch
  • Sambungkan peristiwa pinch kanan ke AddActorLocalRotation dengan Kubus Anda sebagai target dan Rotasi Delta diatur ke X = 0, Y = 0, dan Z = 20. Kubus sekarang akan berputar sebesar 20 derajat setiap kali Anda mencubit
  • Menyambungkan peristiwa pinch kiri ke Keluar dari Permainan

Tingkat bluprint terbuka dengan tindakan input untuk peristiwa pinch kanan dan kiri

  1. Dalam pengaturan Transformasi kubus, atur Mobilitas ke Movable sehingga dapat bergerak secara dinamis:

Pengaturan tranform dengan properti mobilitas disorot

Pada titik ini, Anda siap untuk menyebarkan dan menguji aplikasi!