공간 UI에 Material Design 구현

적용 가능한 XR 기기
이 가이드는 이러한 유형의 XR 기기를 위한 환경을 빌드하는 데 도움이 됩니다.
XR 헤드셋
유선 XR 글라스

Material Design은 XR용 구성요소와 레이아웃을 제공합니다. Material 3 라이브러리, 적응형 레이아웃, XR Compose Material 3 라이브러리를 사용하여 Compose 앱에 공간 UI 동작을 빌드할 수 있습니다.

앱의 종속 항목에 XR Compose Material 3 라이브러리를 추가하여 XR용 Material 3 구성요소를 사용하거나 표준 Material 3 구성요소를 XR용 Jetpack Compose 컨테이너(예: Orbiter, SpatialDialog, SpatialPanel) 내에 직접 배치합니다.

XR용 Material 3 구성요소 사용

androidx.xr.compose.material3 라이브러리는 탐색 레일 및 바, 상단 앱 바, 플로팅 툴바, 대화상자, 목록-세부정보 레이아웃, 홈 공간과 전체 공간 간에 전환하는 전환 버튼 등 일반적인 공간 UI 패턴을 위한 XR용 Material 3 구성요소를 제공합니다. 이 라이브러리의 공간화된 Spatial* 컴포저블은 실험용이며 @OptIn(ExperimentalMaterial3XrApi::class)를 사용하여 선택해야 합니다.

LocalSpatialCapabilities.current.isSpatialUiEnabled를 확인하여 공간 UI가 사용 설정된 경우 XR용 Material 3 구성요소를 렌더링하고 공간 UI가 사용 설정되지 않은 경우 표준 Material 3 구성요소를 렌더링합니다. 자세한 내용은 공간 기능 확인을 참고하세요.

공간 UI가 사용 설정된 경우 SpatialNavigationRail 또는 SpatialWideNavigationRail를 사용하여 시작 정렬된 Orbiter에 Material 3 탐색 레일을 표시합니다. 자세한 내용은 Material Design 가이드라인을 참고하세요.

공간화되지 않은 탐색 레일

공간화되지 않은 탐색 레일

공간화된 (XR에 맞게 조정된) 탐색 레일

공간화된 (XR에 맞게 조정된) 탐색 레일

공간 UI가 사용 설정된 경우 SpatialNavigationBar 또는 SpatialShortNavigationBar를 사용하여 하단 정렬된 Orbiter에 Material 3 탐색 메뉴를 표시합니다. 자세한 내용은 Material Design 가이드라인을 참고하세요.

공간화되지 않은 탐색 메뉴

공간화되지 않은 탐색 메뉴

공간화된(XR에 맞게 조정된) 탐색 메뉴

공간화된(XR에 맞게 조정된) 탐색 메뉴

대화상자

SpatialBasicAlertDialog를 사용하여 공간 고도가 있는 SpatialDialog 내에 기본 알림 대화상자를 표시하거나 표준 Material 3 대화상자 콘텐츠를 SpatialDialog에 직접 래핑합니다.

자세한 내용은 대화상자 및 적응형 디자인 가이드라인을 참고하세요.

공간화되지 않은 대화

공간 음향이 적용되지 않은 대화

공간화된(XR에 맞게 조정된) 대화상자

공간화된(XR에 맞게 조정된) 대화상자

상단 앱 바

공간 UI가 사용 설정된 경우 SpatialTopAppBar 또는 SpatialTwoRowsTopAppBar를 사용하여 상단 정렬된 Orbiter 내에 Material 3 상단 앱 바를 표시합니다.

자세한 내용은 상단 앱 바 및 적응형 디자인 가이드라인을 참고하세요.

공간화되지 않은 상단 앱 바

공간화되지 않은 상단 앱 바

공간화된(XR에 맞게 조정된) 상단 앱 바

공간화된(XR에 맞게 조정된) 상단 앱 바

XR용 목록-세부정보 레이아웃

공간 UI가 사용 설정된 경우 SpatialListDetailPaneScaffold를 사용하여 각 창이 자체 SpatialPanel 내에 배치되는 Material 3 적응형 목록-세부정보 레이아웃을 표시합니다. 공간 UI가 사용 설정되지 않은 경우 ListDetailPaneScaffold를 사용합니다. 자세한 내용은 목록-세부정보 레이아웃 및 적응형 디자인 가이드라인을 참고하세요.

공간화되지 않은 ListDetailPaneScaffold

공간화되지 않은 ListDetailPaneScaffold

공간화된(XR에 맞게 조정된) ListDetailPaneScaffold

공간화된(XR에 맞게 조정된) ListDetailPaneScaffold

XR용 지원 창 레이아웃

공간 UI가 사용 설정된 경우 기본 창과 지원 창을 Subspace 내의 SpatialRow 안에 있는 별도의 SpatialPanel 컨테이너에 배치합니다. 공간 UI가 사용 설정되지 않은 경우 SupportingPaneScaffold를 사용합니다. 자세한 내용은 보조 창 및 적응형 디자인 가이드라인을 참고하세요.

공간화되지 않은 SupportingPaneScaffold

공간화되지 않은 SupportingPaneScaffold

공간화된(XR에 맞게 조정된) SupportingPaneScaffold

공간화된(XR에 맞게 조정된) SupportingPaneScaffold

Figma용 Material 3 디자인 키트로 디자인 시작하기

Material 3 Design Kit의 요소 콜라주

Material 3 Design Kit를 다운로드하여 시작하기

참고 항목