String Nama
XR_ANDROID_mouse_interaction
Jenis Ekstensi
Ekstensi instance
Registered Extension Number
705
Revisi
1
Dependensi Ekstensi dan Versi
Tanggal Terakhir Diubah
2024-09-06
Status IP
Tidak ada klaim IP yang diketahui.
Kontributor
Sharayu Shenoy, Google
Chiara Coetzee, Google
Levana Chen, Google
Spencer Quin, Google
Ringkasan
Ekstensi ini menyediakan XrPath untuk mendapatkan input mouse dan menentukan satu
pose tindakan yang umum digunakan untuk profil mouse pengguna, termasuk perangkat mouse
dan perangkat trackpad.
Ekstensi ini juga memperkenalkan profil interaksi baru yang dirancang khusus untuk perangkat mouse untuk memasukkan input melalui sistem tindakan OpenXR.
Pose tindakan untuk interaksi mouse
Pose tindakan berikut (yaitu "aim") memungkinkan sinar pointer 3D, baik input pelacakan disediakan oleh perangkat mouse atau perangkat trackpad.
Subjalur tindakan …/input/aim/pose akan didukung di semua profil interaksi yang valid untuk jalur pengguna /user/mouse, termasuk profil interaksi yang diaktifkan melalui ekstensi.
Pose bidik
…/input/aim/pose dirancang untuk berinteraksi dengan objek melalui kursor mouse di ruang 3D. Misalnya, menggunakan pointer laser virtual untuk membidik tombol virtual di dinding adalah interaksi yang sesuai dengan pose "bidik".
Ini adalah pose "aim" yang sama dengan yang ditentukan dalam ID pose standar. Setiap profil pengontrol yang dilacak sudah mendukung pose ini.
Posisi
Posisi pose "bidik" biasanya adalah kepala pengguna, yaitu posisi kepala yang sama saat gerakan mouse terdeteksi. Pose bidik untuk mouse dihitung saat ada gerakan mouse. Posisi bidik terakhir yang diketahui akan disimpan hingga gerakan mouse berikutnya.
Orientasi
Orientasi pose "aim" dapat digunakan untuk merender sinar pointer 3D guna berinteraksi dengan objek virtual, misalnya, mengklik tombol menu di dinding.
Pose bidik untuk mouse dihitung saat ada gerakan mouse. Orientasi tujuan terakhir yang diketahui akan disimpan hingga gerakan mouse berikutnya.
Arah -Z adalah arah maju dari gestur bidik, yaitu, tempat sinar bidik mengarah.
Gerakan X,Y relatif mouse digunakan untuk menghitung gerakan relatif mouse di sepanjang bola di sekitar kepala pengguna.
Gerakan kedalaman akan didukung menggunakan klik dan scroll utama. Saat tindakan untuk bergerak dalam kedalaman sedang dalam proses, posisi akan dioffset dari posisi kepala dalam arah Z positif atau negatif di sepanjang sinar, bergantung pada nilai scroll positif atau negatif. Sistem akan menstabilkan gerakan kedalaman dalam bola di sekitar kepala pengguna.
Profil interaksi untuk perangkat mouse
Profil interaksi mouse dirancang untuk runtime yang menyediakan input mouse menggunakan perangkat mouse atau perangkat trackpad dengan tombol dan scroll. Hal ini memungkinkan perangkat mouse dan perangkat trackpad memberikan klik, scroll, dan pose tindakan yang biasa digunakan ke sistem tindakan OpenXR.
Jalur profil interaksi:
- /interaction_profiles/android/mouse_interaction
Berlaku untuk jalur pengguna tingkat teratas:
- /pengguna/mouse
Jalur komponen yang didukung:
- …/input/aim/pose
- …/input/select/click
- …/input/secondary/click
- …/input/tertiary/click
- …/input/scroll/value
Profil interaksi ini mendukung pose tindakan yang dijelaskan di bagian ini, serta dua grup input tindakan berikut.
Tindakan klik
Profil interaksi ini mendukung tindakan …/input/select/click, …/input/secondary/click, dan /input/tertiary/click.
…/input/select/click adalah input boolean, dengan nilai XR_TRUE
menunjukkan bahwa tombol utama pada mouse atau trackpad ditekan.
…/input/secondary/click adalah input boolean, dengan nilai XR_TRUE
menunjukkan bahwa tombol sekunder pada mouse atau trackpad ditekan.
…/input/tertiary/click adalah input boolean, dengan nilai XR_TRUE
menunjukkan bahwa scroll mouse atau tombol tersier ditekan.
Tindakan scroll
Profil interaksi ini mendukung tindakan …/input/scroll/value.
…/input/scroll/value adalah komponen input 2D yang bervariasi dari -1 hingga 1 untuk memetakan scroll ke bawah dan scroll ke atas.
Jenis Objek Baru
Jenis Tanda Baru
Konstanta Enum Baru
Enum Baru
Struktur Baru
Fungsi Baru
Masalah
Histori Versi
- Revisi 1, 29-08-2024 (Levana Chen)
- Deskripsi ekstensi awal