SubspaceModifier는 Subspace의 컴포저블
을 위한 Compose 수정자와 비슷합니다. SubspaceModifier를 사용하면 3D 공간에서 컴포저블을 조작하여 3D 레이아웃 노드의 위치를 지정하고 회전하며 동작을 추가할 수 있습니다.
레이아웃
기본적으로 Subspace는 앱을 볼 때 권장되는 공간으로 제한됩니다. 이러한 경계는 2D Compose 레이아웃의 경계와 마찬가지로 하위 공간
구성요소의 레이아웃을 측정할 때 사용됩니다.
경계 채우기
fillMaxSize, fillMaxWidth, fillMaxHeight, and
fillMaxDepth 수정자는 콘텐츠가 상위 요소의 경계를 (부분적으로) 채우도록 합니다.
채우기 수정자를 사용하면 XR 기기의 디스플레이 특성과 독립적인 앱 레이아웃 콘텐츠를 만들 수 있습니다.
크기 및 필수 크기 설정
`size`, `width`, `height`, `depth
` 수정자는 콘텐츠의 기본 크기를 선언합니다. 콘텐츠의 정확한 크기를 선언하려면 requiredSize, requiredWidth,
requiredHeight, 및 requiredDepth를 사용하세요. 이러한 단위는
dp로 지정해야 합니다. 미터를 dp로 변환하려면 Meter.toDp()를 사용하세요.
컴포저블 위치 지정
offset
offset 수정자는 x, y,
및 z 축을 따라 3D 공간에서 컴포저블을 이동합니다. 이러한 단위는 dp로 지정해야 합니다. 미터를
dp로 변환하려면 Meter.toDp()를 사용하세요.
rotate
rotate 수정자는 공간에서 지정된 컴포저블을 회전합니다. 다음과 같은 다양한 방법으로 회전 방향과 회전량을 지정할 수 있습니다.
- 피치, 요, 롤을 사용하여 각각
x,y,z축을 중심으로 회전을 지정합니다. - 회전축을 나타내는
Vector3인axisAngle과 회전해야 하는 각도 수를 사용합니다. - 회전을 나타내는
Quaternion을 사용합니다.
rotateToLookAtUser
rotateToLookAtUser 수정자는 콘텐츠가 항상 사용자를 향하도록 지속적으로 회전합니다. 이 수정자를 사용하여 콘텐츠가 Y축에서 사용자를 향하도록 회전하면서도 여전히 똑바로 서 있고 중력에 맞춰 정렬되는 '빌보드' 효과를 얻을 수도 있습니다. 이렇게 하려면
rotateToLookAtUser 수정자를
gravityAligned 수정자와 결합하세요.
DeviceTrackingMode.SPATIAL_LAST_KNOWN
컴포저블로 이동 및 크기 조절
사용자가 3D 공간에서 객체의 위치와 크기를 직접 조작할 수 있도록 합니다. 이러한 수정자를 개별 구성요소 (SpatialPanel 등), 하위 공간, 공간 레이아웃 구성요소 (SpatialRow 또는 SpatialColumn 등)에 추가할 수 있습니다.
요소 이동
movable 수정자가 있고 사용 설정된 경우 사용자가 3D 공간에서 요소를 이동할 수 있는 드래그 가능한 UI
컨트롤이 표시됩니다. 이 이동의 구체적인 동작은 제공된 movePolicy에 의해 정의됩니다.
MovePolicy.default: 시스템에서 이동을 완전히 처리하고 사용자 입력을 기반으로 새 포즈와 크기를 자동으로 계산하고 적용합니다.MovePolicy.custom: 시스템에서 입력을 기반으로 타겟 포즈를 계산하지만 연결된 요소에 자동으로 적용하지는 않습니다. 이는 앱에서 이동을 제한하거나 맞춤 이동을 만드는 데 유용합니다.
요소 크기 조절
resizable() 수정자가 있고 사용 설정된 경우 사용자가 3D 공간에서 요소의 크기를 조절할 수 있는 UI 컨트롤
이 표시됩니다. 크기 조절의 구체적인 동작은 제공된 resizePolicy에 의해 정의됩니다.
ResizePolicy.default(): 시스템에서 크기 조절 동작을 자동으로 처리하고 새 측정기준을 콘텐츠에 적용합니다.ResizePolicy.custom(): 시스템에서SpatialResizeEvent를 제공하며 크기 조절 결과를 연결된 요소에 자동으로 적용하지는 않습니다.
컴포저블의 디자인 변경
alpha
alpha 수정자는 요소와 하위 요소의 불투명도를 설정합니다.
여기서 0f는 완전히 투명함을 나타내고 1.0f는 완전히 불투명함을 나타냅니다.
scale
scale 수정자는
가로, 세로, 깊이 축을 따라 컴포저블의 콘텐츠를 조정합니다.
테스트 및 접근성
semantics
semantics 수정자는 테스트 및 접근성에 사용할 수 있도록 레이아웃 노드에 시맨틱을 추가합니다. Jetpack Compose의 시맨틱 및
SemanticsModifier를 참고하세요.
testTag
testTag 수정자는 테스트 프레임워크에서 테스트의 요소를 찾을 수 있도록 하는
SemanticsPropertyReceiver.testTag의 약식입니다.