SubspaceModifier tương tự như đối tượng sửa đổi Compose cho các thành phần kết hợp trong Subspace. SubspaceModifier cho phép bạn thao tác với các thành phần kết hợp trong không gian 3D, giúp bạn định vị, xoay và thêm hành vi vào các nút bố cục 3D.
Bố cục
Theo mặc định, Subspace bị giới hạn bởi không gian đề xuất để xem ứng dụng. Các giới hạn này được dùng khi đo lường bố cục của các thành phần không gian con, tương tự như các giới hạn trong bố cục Compose 2D.
Giới hạn tô màu
Các đối tượng sửa đổi fillMaxSize, fillMaxWidth, fillMaxHeight và fillMaxDepth giúp nội dung (một phần) lấp đầy giới hạn của thành phần mẹ.
Việc sử dụng đối tượng sửa đổi độ phủ giúp nội dung bố cục ứng dụng của bạn độc lập với các đặc điểm hiển thị của thiết bị XR.
Đặt kích thước và kích thước bắt buộc
Các đối tượng sửa đổi size, width, height và depth khai báo kích thước ưu tiên của nội dung. Để khai báo kích thước chính xác của nội dung, hãy sử dụng requiredSize, requiredWidth, requiredHeight và requiredDepth. Bạn phải chỉ định các đơn vị này trong dp; để chuyển đổi từ mét sang dp, hãy sử dụng Meter.toDp().
Vị trí thành phần kết hợp
offset
Đối tượng sửa đổi offset di chuyển thành phần kết hợp trong không gian 3D dọc theo các trục x, y và z. Bạn phải chỉ định các đơn vị này trong dp; để chuyển đổi từ mét sang dp, hãy sử dụng Meter.toDp().
rotate
Đối tượng sửa đổi rotate xoay thành phần kết hợp đã cho trong không gian. Bạn có thể chỉ định hướng và lượng xoay theo nhiều cách:
- Sử dụng độ dốc, độ nghiêng và độ nghiêng để chỉ định độ xoay xung quanh trục
x,yvàztương ứng, - Sử dụng
axisAngle, là mộtVector3đại diện cho trục xoay và số độ mà trục xoay đó sẽ xoay quanh, - Sử dụng
Quaternionđại diện cho vòng quay.
Thay đổi giao diện của các thành phần kết hợp
alpha
Đối tượng sửa đổi alpha đặt độ mờ của phần tử và các phần tử con, trong đó 0f biểu thị độ trong suốt hoàn toàn và 1.0f biểu thị độ mờ hoàn toàn.
scale
Đối tượng sửa đổi scale điều chỉnh tỷ lệ nội dung của thành phần kết hợp dọc theo trục ngang, trục dọc và trục chiều sâu.
Thêm hành vi vào thành phần kết hợp
resizable
Khi bạn bật đối tượng sửa đổi resizable, các thành phần điều khiển giao diện người dùng có thể kéo sẽ xuất hiện để cho phép người dùng đổi kích thước phần tử. Điều này tương tự như việc sử dụng ResizableComponent trên Entity.
movable
Khi bạn bật đối tượng sửa đổi movable, các thành phần điều khiển giao diện người dùng sẽ được thêm vào thành phần cho phép người dùng di chuyển phần tử trong không gian 3D. Điều này tương tự như việc sử dụng MovableComponent trên Entity.
Kiểm thử và hỗ trợ tiếp cận
semantics
Đối tượng sửa đổi semantics sẽ thêm ngữ nghĩa vào nút bố cục để sử dụng trong kiểm thử và hỗ trợ tiếp cận. Xem phần Ngữ nghĩa trong Jetpack Compose và SemanticsModifier.
testTag
Đối tượng sửa đổi testTag là viết tắt của SemanticsPropertyReceiver.testTag, cho phép các khung kiểm thử tìm thấy phần tử trong kiểm thử.