子空间修饰符

SubspaceModifier 类似于 Subspace 中可组合项的 Compose 修饰符。借助 SubspaceModifier，您可以在 3D 空间中操纵可组合项，从而帮助您定位、旋转和向 3D 布局节点添加行为。

布局

默认情况下，Subspace 受建议的应用观看空间的限制。在测量子空间组件的布局时，系统会使用这些边界，这与 2D Compose 布局中的边界类似。

填充边界

修饰符 fillMaxSize、fillMaxWidth、fillMaxHeight 和 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 轴的旋转，
使用 axisAngle（表示旋转轴的 Vector3）以及应围绕该轴旋转的度数，
使用表示旋转的 Quaternion。

更改可组合项的外观

`alpha`

alpha 修饰符用于设置元素及其子级的不透明度，其中 0f 表示完全透明，1.0f 表示完全不透明。

`scale`

scale 修饰符沿水平轴、垂直轴和深度轴缩放可组合项的内容。

为可组合项添加行为

`resizable`

启用 resizable 修饰符后，系统会显示可拖动的界面控件，以便用户调整元素大小。这类似于在 Entity 上使用 ResizableComponent。

`movable`

启用 movable 修饰符后，系统会向组件添加界面控件，以便用户在 3D 空间中移动元素。这类似于在 Entity 上使用 MovableComponent。

movable 布局节点可以选择指定在移动时应锚定的平面类型。例如，如需创建可贴靠到表格的 SpatialPanel，请执行以下操作：

SpatialPanel(
  modifier.movable(anchorPlaneSemantics = setOf(PlaneSemantic.TABLE))
) {
  // This panel snaps to available planes that are detected as a TABLE.
}

贴靠到平面需要向您的应用授予 android.permission.SCENE_UNDERSTANDING_COARSE 运行时权限。

测试和无障碍功能

`semantics`

semantics 修饰符会向布局节点添加语义，以便用于测试和无障碍功能。请参阅 Jetpack Compose 中的语义和 SemanticsModifier。

`testTag`

testTag 修饰符是 SemanticsPropertyReceiver.testTag 的简写形式，可让测试框架在测试中找到相应元素。