يشبه SubspaceModifier أداة تعديل Compose للعناصر القابلة للإنشاء
في 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الذي يمثّل التدوير.
rotateToLookAtUser
تُدوّر أداة التعديل rotateToLookAtUser المحتوى باستمرار
بحيث يكون مواجهًا للمستخدم في جميع الأوقات. يمكنك أيضًا استخدام أداة التعديل هذه لتحقيق تأثير "اللوحة الإعلانية" حيث يتم تدوير المحتوى لمواجهة المستخدم على المحور Y مع البقاء في وضع مستقيم ومحاذيًا للجاذبية. لإجراء ذلك،
ادمِج أداة التعديل rotateToLookAtUser مع
أداة التعديل gravityAligned.
تتطلّب أداة التعديل هذه أن يضبط تطبيقك كائن
الجلسة الحالية على
DeviceTrackingMode.LAST_KNOWN.
تغيير مظهر العناصر القابلة للإنشاء
alpha
تضبط أداة التعديل alpha مستوى عتامة العنصر وعناصره الثانوية،
حيث يمثّل 0f عنصرًا شفافًا تمامًا ويمثّل 1.0f عنصرًا غير شفاف تمامًا.
scale
تُغيّر أداة التعديل scale حجم محتويات العنصر القابل للإنشاء على طول المحاور الأفقية والعمودية ومحور العمق.
الاختبار وإمكانية الوصول
semantics
تضيف أداة التعديل semantics دلالات إلى عقدة التنسيق، لاستخدامها في
الاختبار وإمكانية الوصول. راجِع الدلالات في Jetpack Compose و
SemanticsModifier.
testTag
أداة التعديل testTag هي اختصار لـ
SemanticsPropertyReceiver.testTag، ما يسمح لأُطر الاختبار بالعثور على
العنصر في الاختبارات.