SubspaceModifier דומה ל-Compose modifier עבור קומפוזבלים ב-Subspace. SubspaceModifier מאפשרת לכם לשנות רכיבים שניתנים להרכבה במרחב תלת-ממדי, ולעזור לכם למקם, לסובב ולהוסיף התנהגויות לצמתי פריסה תלת-ממדיים.
פריסה
כברירת מחדל, Subspace מוגבל על ידי המרחב המומלץ לצפייה באפליקציה. המגבלות האלה משמשות למדידת הפריסה של רכיבי המרחב המשני, בדומה למגבלות בפריסות דו-ממדיות של Compose.
מילוי גבולות
המשנים fillMaxSize, fillMaxWidth, fillMaxHeight ו-fillMaxDepth גורמים לתוכן למלא (באופן חלקי) את הגבולות של רכיב האב שלו.
שימוש במאפייני מילוי עוזר לאפליקציה לפרוס תוכן שלא תלוי במאפייני התצוגה של מכשיר ה-XR.
הגדרת הגודל בפועל והגודל הנדרש
המשנים size, width, height ו-depth
מגדירים את הגודל המועדף של התוכן. כדי להצהיר על הגודל המדויק של התוכן, משתמשים בתגי requiredSize, requiredWidth, requiredHeight ו-requiredDepth. צריך לציין את היחידות האלה במאפיין dp. כדי להמיר מטרים ל-dp, משתמשים ב-Meter.toDp().
מיקום הרכיבים הקומפוזביליים
offset
המשנה offset מזיז את הרכיב הניתן להרכבה במרחב תלת-ממדי לאורך הצירים x, y ו-z. צריך לציין את היחידות האלה ב-dp. כדי להמיר מטרים ל-dp, צריך להשתמש ב-Meter.toDp().
rotate
המשנה rotate מסובב את הרכיב הניתן להרכבה שצוין במרחב. אפשר לציין את כיוון הסיבוב ואת זווית הסיבוב בכמה דרכים:
- באמצעות גובה הצליל, הסבסוב והגלגול, שמציינים את הסיבוב סביב הצירים
x,yו-zבהתאמה, - באמצעות
axisAngle, שהואVector3שמייצג את ציר הסיבוב, ואת מספר המעלות שצריך לסובב סביבו, - שימוש ב-
Quaternionשמייצג את הסבב.
lookAtUser
המשנה lookAtUser מסובב באופן רציף את הרכיב הניתן להרכבה שצוין במרחב, כך שהוא נראה כאילו הוא פונה אל הצופה. משנה דומה, billboard, מסובב את התוכן כך שהוא פונה אל הצופה, אבל התוכן עצמו נשאר זקוף.
כדי להשתמש במגדירי ההתנהגות האלה, צריך להעניק לאפליקציה את ההרשאה android.permission.HEAD_TRACKING. בנוסף, צריך להגדיר את הסשן הנוכחי כדי להגדיר את HeadTrackingMode.LAST_KNOWN.
שינוי המראה של הרכיבים הקומפוזביליים
alpha
המשנה alpha מגדיר את האטימות של הרכיב ושל רכיבי הצאצא שלו,
כאשר 0f מייצג שקיפות מלאה ו-1.0f מייצג אטימות מלאה.
scale
המשנה scale משנה את קנה המידה של התוכן של הרכיב שניתן להרכבה לאורך הצירים האופקי, האנכי והעומק.
בדיקות ונגישות
semantics
העיבוד semantics מוסיף סמנטיקה לצומת הפריסה, לשימוש בבדיקות ובנגישות. מידע נוסף זמין במאמרים בנושא סמנטיקה ב-Jetpack פיתוח נייטיב ובנושא SemanticsModifier.
testTag
המשנה testTag הוא קיצור של SemanticsPropertyReceiver.testTag, שמאפשר למסגרות בדיקה למצוא את הרכיב בבדיקות.