מחרוזת שם
XR_ANDROID_mouse_interaction
סוג התוסף
תוסף למכונה
מספר תוסף רשום
705
גרסה
1
תלות בתוספים ובגרסאות
תאריך השינוי האחרון
2024-09-06
סטטוס כתובת ה-IP
לא ידוע על תלונות על הפרת זכויות יוצרים בנושא כתובת IP.
שותפים ביצירת התוכן
Sharayu Shenoy, Google
Chiara Coetzee, Google
לבנה צ'ן, Google
ספנסר קווין (Spencer Quin), Google
סקירה כללית
התוסף הזה מספק XrPath לקבלת קלט מהעכבר, ומגדיר תנוחת פעולה נפוצה אחת לפרופילים של עכבר של משתמשים, כולל מכשירים עם עכבר ומכשירים עם משטח מגע.
התוסף הזה כולל גם פרופיל אינטראקציה חדש שתוכנן במיוחד למכשירי עכבר, כדי להזין אותו דרך מערכת הפעולות של OpenXR.
תנוחת פעולה לאינטראקציות עם העכבר
תנוחת הפעולה הבאה (כלומר 'כוונת') מאפשרת להציג קרן של סמן תלת-ממדי, בין שהקלט למעקב מסופק על ידי מכשיר עכבר או מכשיר משטח מגע.
נתיב המשנה של הפעולה …/input/aim/pose יהיה נתמך בכל פרופילי האינטראקציה התקפים לנתיב המשתמש /user/mouse, כולל פרופילי האינטראקציה שמופעלים באמצעות תוספים.
תנוחת כוונון
ה-…/input/aim/pose מיועד לאינטראקציה עם אובייקטים באמצעות סמן העכבר במרחב תלת-ממדי. לדוגמה, שימוש במד מהירות לייזר וירטואלי כדי לכוון ללחצן וירטואלי על הקיר הוא אינטראקציה שמתאימה לתנוחה 'כוונת'.
זוהי אותה תנוחת 'כוונת' שמוגדרת במזהי תנוחות רגילות. כל פרופיל של בקר במעקב כבר תומך בתנוחה הזו.
מיקום
המיקום של תנוחת 'הכוונה' הוא בדרך כלל הראש של המשתמש, כלומר אותו מיקום של הראש כאשר מזוהה תנועת עכבר. תנוחת המטרה של העכבר מחושבת כשיש תנועה של העכבר. מיקום הכוונת הידוע האחרון יישמר עד לתנועת העכבר הבאה.
כיוון
יכול להיות שהמערכת תשתמש בכיוון של תנוחת 'הכוונה' כדי ליצור קרן של מצביע תלת-ממדי, כדי ליצור אינטראקציה עם אובייקט וירטואלי. לדוגמה, לחיצה על לחצן תפריט על הקיר.
תנוחת המטרה של העכבר מחושבת כשיש תנועה של העכבר. כיוון הכוונת הידוע האחרון יישמר עד לתנועת העכבר הבאה.
הכיוון -Z הוא הכיוון קדימה של תנועת הכיוון, כלומר המקום שאליו מצביע קרן הכיוון.
התנועה היחסית של העכבר בכיוון X ו-Y משמשת לחישוב התנועה היחסית של העכבר לאורך כדור סביב ראש המשתמש.
תהיה תמיכה בתנועה לעומק באמצעות לחיצה ראשית וגלילה. כשמתבצעת פעולה של תנועה לעומק, המיקום מושפע ממיקום הראש בכיוון Z חיובי או שלילי לאורך הקרן, בהתאם לערך הגלילה החיובי או השלילי. המערכת תעשה יציבות לתנועת העומק בתוך הספירה סביב הראש של המשתמש.
פרופיל האינטראקציה של מכשירי עכבר
פרופיל האינטראקציה עם העכבר מיועד לסביבות זמן ריצה שמספקות קלט מהעכבר באמצעות מכשירי עכבר או מכשירי משטח מגע עם לחצנים וגלילה. כך מכשירים עם עכבר ומכשירים עם משטח מגע יכולים לספק למערכת הפעולות של OpenXR קליקים, גלילה ותנוחות פעולה נפוצות.
נתיב פרופיל האינטראקציה:
- /interaction_profiles/android/mouse_interaction
תקף לנתיב משתמש ברמה העליונה:
- /user/mouse
נתיבי רכיבים נתמכים:
- …/input/aim/pose
- …/input/select/click
- …/input/secondary/click
- …/input/tertiary/click
- …/input/scroll/value
פרופיל האינטראקציה הזה תומך בתנוחת הפעולה שמתוארת בקטע הזה, וגם בשתי הקבוצות הבאות של קלט פעולות.
פעולת קליק
פרופיל האינטראקציה הזה תומך בפעולות …/input/select/click, …/input/secondary/click ו- /input/tertiary/click.
האירוע …/input/select/click הוא קלט בוליאני, שבו הערך XR_TRUE מציין שלחצו על הלחצן הראשי בעכבר או במשטח המגע.
האירוע …/input/secondary/click הוא קלט בוליאני, שבו הערך XR_TRUE מציין שלחצו על הלחצן המשני בעכבר או במשטח המגע.
האירוע …/input/tertiary/click הוא קלט בוליאני, שבו הערך XR_TRUE מציין שהלחצן השלישי או גלילה בעכבר הולחצו.
פעולת גלילה
פרופיל האינטראקציה הזה תומך בפעולות …/input/scroll/value.
…/input/scroll/value הוא רכיב קלט דו-מימדי שמשתנה מ--1 ל-1 כדי למפות לגלילה למטה ולגלילה למעלה.
סוגי אובייקטים חדשים
סוגי דגלים חדשים
קבועים חדשים של Enum
משתני Enum חדשים
מבנים חדשים
פונקציות חדשות
בעיות
היסטוריית הגרסאות
- גרסה 1, 29 באוגוסט 2024 (Levana Chen)
- תיאור ראשוני של התוסף