Mulai Cepat: Sebarkan sampel C++ WMR asli ke HoloLens

Artikel
03/09/2023

Mulai cepat ini mencakup cara menyebarkan dan menjalankan aplikasi tutorial C++ Windows Mixed Reality (WMR) asli pada HoloLens 2.

Dalam mulai cepat ini, Anda akan mempelajari cara:

Membangun aplikasi tutorial untuk HoloLens.
Ubah kredensial Azure Remote Rendering dalam kode sumber.
Menyebarkan dan menjalankan sampel pada perangkat.

Prasyarat

Untuk mendapatkan akses ke layanan Remote Rendering, Anda harus terlebih dahulu membuat akun.

Perangkat lunak berikut ini harus diinstal:

Windows SDK 10.0.18362.0 atau yang lebih baru.
Versi terbaru Visual Studio 2022.
Alat Visual Studio untuk Mixed Reality. Secara khusus, penginstalan Beban Kerja berikut diperlukan:
- Pengembangan desktop dengan C++
- Pengembangan Universal Windows Platform (UWP)
Git.
Plugin Git LFS

Mengkloning repositori sampel Remote Rendering

Sebagai langkah pertama, kloning repositori Git, yang menampung sampel Azure Remote Rendering global. Ketik cmd menu Mulai Windows untuk membuka jendela prompt perintah. Ubah ke direktori tempat Anda ingin menyimpan proyek sampel ARR.

Jalankan perintah berikut:

mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering

Perintah terakhir membuat folder di folder ARR yang berisi berbagai proyek sampel untuk Azure Remote Rendering.

Tutorial C++ HoloLens dapat ditemukan di folder NativeCpp/HoloLens-Wmr.

Membangun proyek

Buka file solusi HolographicApp.sln yang terletak di folder NativeCpp/HoloLens-Wmr dengan Visual Studio.

Alihkan konfigurasi build ke Debug (atau Rilis) dan ARM64. Pastikan mode debugger diatur ke Perangkat dibandingkan dengan Komputer Jarak Jauh:

Cuplikan layar memperlihatkan area konfigurasi Visual Studio dengan nilai seperti yang dijelaskan.

Karena info masuk akun dibuat hard-coding dalam kode sumber tutorial, ubah info masuk tersebut menjadi info masuk yang valid. Buka file HolographicAppMain.cpp di dalam Visual Studio dan ubah bagian tempat klien dibuat di dalam konstruktor kelas HolographicAppMain:

// 2. Create Client
{
    // Users need to fill out the following with their account data and model
    RR::SessionConfiguration init;
    init.AccountId = "00000000-0000-0000-0000-000000000000";
    init.AccountKey = "<account key>";
    init.RemoteRenderingDomain = "westus2.mixedreality.azure.com"; // <change to the region that the rendering session should be created in>
    init.AccountDomain = "westus2.mixedreality.azure.com"; // <change to the region the account was created in>
    m_modelURI = "builtin://Engine";
    m_sessionOverride = ""; // If there is a valid session ID to re-use, put it here. Otherwise a new one is created
    m_client = RR::ApiHandle(RR::RemoteRenderingClient(init));
}

Secara khusus, ubah nilai berikut:

init.AccountId, init.AccountKey, dan init.AccountDomain untuk menggunakan data akun Anda. Lihat bagian tentang cara mengambil informasi akun.
Tentukan tempat untuk membuat sesi penyajian jarak jauh dengan memodifikasi bagian wilayah dari untai init.RemoteRenderingDomain untuk wilayahwestus2 lain alih-alih , misalnya "westeurope.mixedreality.azure.com".
Selain itu, m_sessionOverride dapat diubah menjadi ID sesi yang ada. Sesi dapat dibuat di luar sampel ini. Untuk informasi selengkapnya, lihat RenderingSession.ps1 atau Menggunakan REST API manajemen sesi secara langsung.

Membuat sesi di luar sampel disarankan ketika sampel harus berjalan beberapa kali. Jika tidak ada sesi yang diteruskan, sampel membuat sesi pada setiap startup, yang mungkin memakan waktu beberapa menit.

Sekarang Anda dapat mengkompilasi aplikasi.

Luncurkan aplikasi tersebut

Sambungkan HoloLens dengan kabel USB ke PC Anda.
Nyalakan HoloLens dan tunggu hingga menu mulai muncul.
Mulai Debugger di Visual Studio (F5). Ini secara otomatis menyebarkan aplikasi ke perangkat.

Aplikasi sampel diluncurkan dan panel teks muncul yang memberi tahu Anda tentang status aplikasi saat ini. Status pada waktu pengaktifan memulai sesi baru atau menyambungkan ke sesi yang sudah ada. Setelah pemuatan model selesai, model mesin bawaan muncul tepat di posisi kepala Anda. Oklusi-bijaksana, model mesin berinteraksi dengan benar dengan kubus berputar yang dirender secara lokal.

Jika Anda ingin meluncurkan sampel lagi nanti, Anda juga dapat menemukannya dari menu mulai HoloLens. Ini mungkin memiliki ID sesi yang kedaluwarsa yang dikompilasi ke dalamnya.

Langkah berikutnya

Mulai Cepat ini didasarkan pada hasil tutorial yang menjelaskan cara mengintegrasikan semua bagian terkait Remote Rendering ke dalam aplikasi Holografik stok. Untuk mempelajari langkah-langkah mana yang diperlukan, ikuti tutorial ini:

Tutorial: Mengintegrasikan Remote Rendering ke Aplikasi Holografik HoloLens

Bagikan melalui