پیاده‌سازی کردن Material Design برای واسط کاربر فضایی

دستگاه‌های XR واجدشرایط
این راهنمایی به شما کمک می‌کند برای این نوع دستگاه‌های واقعیت گسترده تجربه بسازید.
هدست‌های واقعیت گسترده
عینک واقعیت گسترده سیمی

«طراحی مواد» مؤلفه‌ها و چیدمان‌هایی برای واقعیت گسترده ارائه می‌دهد. بااستفاده از کتابخانه Material 3، چیدمان‌های تطبیقی، و کتابخانه XR Compose Material 3، می‌توانید رفتارهای واسط کاربر فضایی را در برنامه Compose خود بسازید.

کتابخانه XR Compose Material 3 را به وابستگی‌های برنامه‌تان اضافه کنید تا از Material 3 برای مؤلفه‌های XR استفاده کنید، یا مؤلفه‌های استاندارد Material 3 را مستقیماً در Jetpack Compose برای محفظه‌های XR مثل Orbiter، SpatialDialog، و SpatialPanel قرار دهید.

استفاده کردن از Material 3 برای مؤلفه‌های XR

کتابخانه androidx.xr.compose.material3 مؤلفه‌های Material 3 برای XR را برای الگوهای واسط کاربر فضایی رایج ارائه می‌دهد—ازجمله ریل‌ها و نوارهای پیمایش، نوارهای برنامه بالا، نوارهای ابزار شناور، کادرهای گفتگو، چیدمان‌های فهرست-جزئیات، و دکمه مبدل برای جابه‌جایی بین «فضای صفحه اصلی» و «فضای کامل». Spatial* فضایی‌شده ترکیب‌پذیرها در این کتابخانه آزمایشی هستند و نیاز به موافقت با @OptIn(ExperimentalMaterial3XrApi::class) دارند.

LocalSpatialCapabilities.current.isSpatialUiEnabled را بررسی کنید تا «Material 3 برای XR» را وقتی میانای کاربر فضایی فعال است و مؤلفه‌های استاندارد Material 3 را وقتی میانای کاربر فضایی فعال نیست رندر کنید. برای اطلاعات بیشتر، به بررسی قابلیت‌های فضایی مراجعه کنید.

از SpatialNavigationRail یا SpatialWideNavigationRail برای نمایش ریل ناوبری Material 3 در Orbiter تراز شروع هنگام فعال بودن واسط کاربر فضایی استفاده کنید. برای اطلاعات بیشتر، رهنمودهای Material Design را ببینید.

ریل پیمایش غیرفضایی‌شده

ریل پیمایش غیرفضایی

نرده‌ای پیمایش فضایی‌شده (سازگار با واقعیت گسترده)

نرده‌ای پیمایش فضایی‌شده (سازگارشده با واقعیت گسترده)

از SpatialNavigationBar یا SpatialShortNavigationBar برای نمایش نوار پیمایش Material 3 در Orbiter تراز پایین هنگام فعال بودن رابط کاربری فضایی استفاده کنید. برای اطلاعات بیشتر، رهنمودهای Material Design را ببینید.

نوار پیمایش
غیرفضایی‌شده

نوار پیمایش غیرفضایی

نوار پیمایش فضایی‌شده (سازگار با واقعیت گسترده)

نوار پیمایش فضایی (سازگار با واقعیت گسترده)

کادرهای گفتگو

از SpatialBasicAlertDialog برای نمایش کادر گفتگوی هشدار پایه در SpatialDialog با ارتفاع فضایی استفاده کنید، یا محتوای کادر گفتگوی استاندارد Material 3 را مستقیماً در SpatialDialog قرار دهید.

برای اطلاعات بیشتر، کادرهای گفتگو و رهنمودهای طراحی تطبیقی را ببینید.

مکالمه
غیرفضایی

کادر گفتگوی غیرفضایی‌شده

کادر گفتگوی فضایی‌شده (سازگارشده با واقعیت گسترده)

کادر گفتگوی فضایی‌شده (سازگارشده با واقعیت گسترده)

نوار برنامه بالا

از SpatialTopAppBar یا SpatialTwoRowsTopAppBar برای نمایش نوار برنامه بالایی Material 3 در داخل Orbiter ترازبالا هنگام فعال بودن واسط کاربر فضایی استفاده کنید.

برای اطلاعات بیشتر، نوار برنامه بالا و رهنمودهای طراحی تطبیقی را ببینید.

نوار برنامه برتر
غیرفضایی‌شده

نوار برنامه بالا غیرفضایی‌شده

نوار برنامه بالایی فضایی‌شده (سازگارشده با واقعیت گسترده)

نوار برنامه بالایی فضایی‌شده (سازگارشده با واقعیت گسترده)

چیدمان تفصیلی-فهرستی برای واقعیت گسترده

وقتی واسط کاربری فضایی فعال است، از SpatialListDetailPaneScaffold برای نمایش چیدمان فهرست-جزئیات تطبیقی Material 3 استفاده کنید که در آن هر قاب در SpatialPanel خودش قرار می‌گیرد. وقتی واسط کاربر فضایی فعال نیست، از ListDetailPaneScaffold استفاده کنید. برای اطلاعات بیشتر، چیدمان فهرست-جزئیات و رهنمودهای طراحی تطبیقی را ببینید.

Non-spatialized
ListDetailPaneScaffold

ListDetailPaneScaffold غیرفضایی‌شده

فضایی‌شده (سازگار با واقعیت گسترده)
ListDetailPaneScaffold

ListDetailPaneScaffold فضایی‌شده (سازگارشده با واقعیت گسترده)

پشتیبانی از چیدمان قاب برای واقعیت گسترده

وقتی واسط کاربر فضایی فعال است، قاب اصلی و قاب پشتیبانی را در محفظه‌های SpatialPanel جداگانه در SpatialRow در Subspace قرار دهید. وقتی واسط کاربر فضایی فعال نیست، از SupportingPaneScaffold استفاده کنید. برای اطلاعات بیشتر، پانل پشتیبانی و رهنمودهای طراحی تطبیقی را ببینید.

Non-spatialized
SupportingPaneScaffold

SupportingPaneScaffold غیرفضایی‌شده

Spatialized (XR-adapted)
SupportingPaneScaffold

SupportingPaneScaffold فضایی‌شده (سازگار با واقعیت گسترده)

شروع طراحی با Material 3 Design Kit برای Figma

کلاژ عناصر از Material 3 Design Kit

برای شروع، «کیت طراحی Material 3» را بارگیری کنید

همچنین مراجعه کنید به