Đưa ứng dụng Android của bạn vào 3D bằng XR

Các thiết bị XR được hỗ trợ
Hướng dẫn này giúp bạn xây dựng các trải nghiệm cho những loại thiết bị XR sau.
Thiết bị đeo đầu XR
Kính thông minh XR có dây

Theo mặc định, ứng dụng Android 2D dành cho thiết bị di động hoặc màn hình lớn sẽ hoạt động trong Android XR, hiển thị dưới dạng bảng điều khiển 2D trong không gian 3D. Bạn có thể thêm các tính năng XR sống động để cải thiện ứng dụng Android 2D hiện có, chuyển đổi ứng dụng từ trải nghiệm màn hình phẳng sang môi trường 3D sống động.

Hãy cân nhắc những nguyên tắc quan trọng sau đây khi đưa ứng dụng Android vào XR.

  • Khả năng không gian: Android XR cung cấp nhiều tính năng không gian cho ứng dụng của bạn, nhưng bạn không cần phải triển khai mọi tính năng. Hãy triển khai một cách có chiến lược những thành phần bổ sung cho hệ phân cấp hình ảnh, bố cục và hành trình của người dùng trong ứng dụng. Hãy cân nhắc việc kết hợp môi trường tuỳ chỉnh và nhiều bảng điều khiển để tạo ra trải nghiệm thực sự sống động. Tham khảo hướng dẫn thiết kế giao diện người dùng không gian để xác định cách tích hợp tối ưu các thành phần không gian.
  • Giao diện người dùng thích ứng: XR mang đến cho bạn sự linh hoạt để thiết kế một giao diện người dùng rộng rãi, thích ứng liền mạch với một khung vẽ vô hạn và các cửa sổ có thể đổi kích thước tuỳ ý. Một trong những điểm quan trọng nhất cần lưu ý là sử dụng hướng dẫn thiết kế cho màn hình lớn của chúng tôi để tối ưu hoá bố cục của ứng dụng cho môi trường mở rộng này. Ngay cả khi ứng dụng của bạn hiện chỉ dành cho thiết bị di động, bạn vẫn có thể sử dụng môi trường hấp dẫn để nâng cao trải nghiệm người dùng, nhưng giao diện người dùng được tối ưu hoá cho màn hình lớn là một trong những cách tốt nhất để tối ưu hoá ứng dụng cho Android XR.
  • Khung giao diện người dùng: Bạn nên tạo giao diện người dùng bằng Jetpack Compose cho XR. Nếu ứng dụng của bạn dựa vào Khung hiển thị, hãy xem bài viết làm việc với Khung hiển thị trong XR để tìm hiểu thêm về cách tận dụng khả năng tương tác của Compose khi làm việc với Khung hiển thị hoặc đánh giá việc làm việc trực tiếp với thư viện Jetpack SceneCore.
  • Xuất bản trên Cửa hàng Play: Để xác minh rằng ứng dụng tăng cường XR của bạn có thể được tìm thấy trên Cửa hàng Play, hãy làm như sau:

Chuyển đổi các thành phần giao diện người dùng 2D sang 3D

Việc làm theo các mẹo này có thể tạo ra sự khác biệt lớn trong việc giúp ứng dụng của bạn mang lại cảm giác như đã được tối ưu hoá cho XR.

  • Ưu tiên khả năng tương thích với màn hình lớn: Đảm bảo giao diện người dùng của ứng dụng tuân thủ các nguyên tắc thiết kế cho màn hình lớn để đảm bảo văn bản và nội dung dễ đọc nhất trong môi trường XR mở rộng.
  • Sử dụng các tính năng không gian một cách có chiến lược: Xác định những khoảnh khắc quan trọng trong hành trình của người dùng trong ứng dụng, nơi việc kết hợp các tính năng không gian sẽ nâng cao trải nghiệm và tận dụng các chức năng độc đáo của nền tảng.
  • Đặt bảng điều khiển không gian sao cho người dùng cảm thấy thoải mái: Khi thiết kế bố cục bằng bảng điều khiển không gian, hãy đặt bảng điều khiển ở khoảng cách thoải mái với người dùng để tránh gây cảm giác choáng ngợp hoặc quá gần.
  • Sử dụng giao diện người dùng thích ứng cho bố cục không gian: Sử dụng các khái niệm về giao diện người dùng thích ứng như ngăn và hiển thị dần để phân tách bố cục thành nhiều bảng điều khiển không gian một cách hiệu quả, tối ưu hoá việc trình bày thông tin.
  • Sử dụng bảng điều khiển cho các thành phần và mẫu cố định: Dành riêng bảng điều khiển cho các thành phần trải nghiệm người dùng cố định và theo bối cảnh, chẳng hạn như thành phần điều hướng và điều khiển. Hạn chế sử dụng các thành phần phụ để duy trì sự rõ ràng và tránh lộn xộn.
  • Sử dụng độ cao một cách hợp lý: Áp dụng độ cao không gian cho các thành phần tạm thời vẫn đứng yên và không cuộn theo nội dung. Tránh nâng cao các khu vực lớn để tránh gây khó chịu về mặt thị giác và duy trì hệ phân cấp hình ảnh cân bằng.

Jetpack Compose cho XR giới thiệu các thành phần mới quản lý các tính năng nâng cao của XR để bạn không cần phải làm việc này. Ví dụ: bạn có thể sử dụng SpatialPopup và SpatialDialog để thay thế các thành phần 2D tương ứng. Các thành phần này xuất hiện dưới dạng giao diện người dùng 2D thông thường khi không có giao diện người dùng không gian và hiển thị giao diện người dùng không gian của ứng dụng khi có thể. Cách sử dụng các thành phần này cũng đơn giản như việc thay đổi một dòng để thay thế thành phần giao diện người dùng 2D tương ứng.

Chuyển đổi hộp thoại thành SpatialDialog

// Previous approach
Dialog(
    onDismissRequest = onDismissRequest
) {
    MyDialogContent()
}

// New XR differentiated approach
SpatialDialog(
    onDismissRequest = onDismissRequest
) {
    MyDialogContent()
}

Chuyển đổi cửa sổ bật lên thành SpatialPopup

// Previous approach
Popup(onDismissRequest = onDismissRequest) {
    MyPopupContent()
}

// New XR differentiated approach
SpatialPopup(onDismissRequest = onDismissRequest) {
    MyPopupContent()
}

Nâng cao các phần tử trên giao diện người dùng 2D

Khi bạn muốn nâng cao giao diện người dùng bằng chế độ kiểm soát chi tiết hơn, chúng tôi sẽ cung cấp SpatialElevation để cho phép bạn nâng bất kỳ composable nào trong ứng dụng lên một cấp cao hơn bảng điều khiển không gian trên trục Z mà bạn đặt bằng SpatialElevationLevel. Điều này giúp thu hút sự chú ý của người dùng, tạo hệ phân cấp tốt hơn và cải thiện mức độ dễ đọc, như trong ví dụ sau.

// Elevate an otherwise 2D Composable (signified here by ComposableThatShouldElevateInXr).
SpatialElevation(elevation = SpatialElevationLevel.Level4) {
    ComposableThatShouldElevateInXr()
}

Các điểm chính về mã

  • Đừng tạo không gian hoặc nâng cao các khu vực và mặt phẳng lớn, chẳng hạn như bảng dưới cùng và bảng điều khiển bên.
  • Đừng nâng các phần tử trên giao diện người dùng có thể cuộn cùng với nội dung.

Di chuyển các thành phần 2D sang quỹ đạo

Orbiter là các phần tử nổi thường chứa các chế độ điều khiển mà người dùng có thể tương tác. Orbiter có thể được liên kết với bảng điều khiển không gian hoặc các thực thể khác như bố cục không gian. Orbiter giúp nội dung có thêm không gian và cho phép người dùng nhanh chóng truy cập vào các tính năng mà không làm ảnh hưởng đến nội dung chính.

Dải điều hướng không có không gian

Dải điều hướng không có hiệu ứng không gian

Dải điều hướng không gian (phù hợp với XR)

Dải điều hướng không gian (phù hợp với XR)

Đoạn mã ví dụ sau đây cho thấy cách bạn có thể di chuyển một thành phần giao diện người dùng 2D sang một orbiter.

// Previous approach
NavigationRail()

// New XR differentiated approach
Orbiter(
    position = OrbiterPosition.TopStart(
        horizontalEdgeAlignment = OrbiterPosition.EdgeAlignment.Outside,
        offset = DpVolumeOffset(x = dimensionResource(R.dimen.start_orbiter_padding))
    )
) {
    NavigationRail()
}

Điểm chính về tàu quỹ đạo

  • Orbiter là các thành phần được thiết kế để đính kèm các phần tử trên giao diện người dùng hiện có vào một bảng điều khiển không gian
  • Hãy xem hướng dẫn thiết kế ứng dụng Android XR của chúng tôi để xác minh những phần tử cần di chuyển cho quỹ đạo và các mẫu cần tránh.
  • Bạn chỉ nên điều chỉnh một vài thành phần điều hướng như thanh điều hướng dọc, thanh ứng dụng trên cùng hoặc thanh ứng dụng dưới cùng.
  • Orbiter không xuất hiện khi giao diện người dùng không gian không được bật. Ví dụ: các ảnh này sẽ không xuất hiện trong Không gian chính hoặc trên các thiết bị như điện thoại, máy tính bảng và thiết bị có thể gập lại.

Di chuyển các thành phần 2D sang bảng điều khiển không gian

Bảng điều khiển không gian là thành phần cơ bản trong giao diện người dùng của ứng dụng Android XR.

Bảng điều khiển đóng vai trò là vùng chứa cho các phần tử trên giao diện người dùng, thành phần tương tác và nội dung sống động. Khi thiết kế, bạn có thể thêm các thành phần như orbiter cho các thành phần điều khiển của người dùng và nâng cao các phần tử trên giao diện người dùng theo không gian để thu hút sự chú ý đến các hoạt động tương tác cụ thể.

Các điểm chính về mã

  • Hãy xem Hướng dẫn thiết kế ứng dụng Android XR để xác minh những phần tử cần di chuyển sang bảng điều khiển và những mẫu cần tránh.
  • Làm theo các phương pháp hay nhất để đặt bảng điều khiển không gian:
    • Bảng điều khiển phải xuất hiện ở giữa, cách mắt người dùng 1,5 m.
    • Nội dung phải xuất hiện ở chính giữa 41° trong trường nhìn của người dùng.
  • Bảng điều khiển vẫn giữ nguyên vị trí khi người dùng di chuyển. Tính năng neo chỉ dùng được cho chế độ truyền qua.
  • Sử dụng góc bo tròn 32 dp theo đề xuất của hệ thống cho các bảng điều khiển.
  • Đích chạm phải có kích thước 56 dp và không nhỏ hơn 48 dp.
  • Duy trì tỷ lệ tương phản để dễ đọc, đặc biệt là khi bạn sử dụng nền trong suốt.
  • Tuân theo Nguyên tắc về màu sắc trong thiết kế Android và sử dụng hệ thống màu sắc Material Design để triển khai giao diện tối và sáng cho ứng dụng của bạn.
  • Sử dụng API bảng điều khiển không gian với các phần tử trên giao diện người dùng hiện có.

Di chuyển giao diện người dùng 2D sang một bảng điều khiển không gian

Theo mặc định, ứng dụng của bạn sẽ xuất hiện với một bảng điều khiển duy nhất trong Không gian chính. Tìm hiểu cách chuyển đổi giữa Không gian chính và Toàn bộ không gian. Để đưa nội dung đó vào Toàn bộ không gian, bạn có thể sử dụng SpatialPanel.

Sau đây là một ví dụ về cách thực hiện việc này.

if (LocalSpatialCapabilities.current.isSpatialUiEnabled) {
    Subspace {
        SpatialPanel(
            modifier = SubspaceModifier.movable().resizable(),
        ) {
            AppContent()
        }
    }
} else {
    AppContent()
}

Di chuyển giao diện người dùng 2D sang nhiều bảng điều khiển không gian

Bạn có thể sử dụng một bảng điều khiển không gian duy nhất cho giao diện người dùng của ứng dụng hoặc di chuyển giao diện người dùng 2D sang nhiều bảng điều khiển không gian. Nếu chọn sử dụng nhiều bảng điều khiển cho giao diện người dùng của ứng dụng, bạn có thể định vị và xoay các bảng điều khiển (tương tự như bố trí giao diện người dùng ở dạng 2D). Bạn sẽ bắt đầu bằng một tầm nhìn thiết kế rõ ràng về những gì bạn muốn đạt được, sau đó bạn có thể sử dụng API bố cục của giao diện người dùng không gian (SpatialBox, SpatialRow, SpatialColumn, SpatialSpacer, SpatialAlignment) và modifier không gian con để định vị và xoay bảng điều khiển. Có một số mẫu chính mà bạn nên tránh khi triển khai nhiều bảng điều khiển.

  • Tránh các bảng điều khiển chồng chéo có thể khiến người dùng không nhìn thấy thông tin quan trọng.
  • Tránh làm người dùng choáng ngợp với các bảng điều khiển.
  • Tránh đặt bảng điều khiển ở những vị trí không thoải mái hoặc không dễ nhận thấy. Ví dụ: người dùng khó nhận thấy các bảng điều khiển được đặt phía sau họ.
  • Để biết thêm thông tin về cách phát triển giao diện người dùng không gian, hãy xem toàn bộ hướng dẫn của chúng tôi.

Nội dung không có
âm thanh không gian

Nội dung không có âm thanh không gian

Các nút điều khiển nội dung nghe nhìn được không gian hoá (phù hợp với XR) trong một bảng điều khiển và nội dung được chia thành nhiều bảng điều khiển không gian

Các nút điều khiển nội dung nghe nhìn theo không gian (được điều chỉnh cho phù hợp với XR) trong một bảng điều khiển phụ và nội dung được chia thành nhiều bảng điều khiển không gian

SpatialRow {
    SpatialPanel(
        SubspaceModifier
            .width(384.dp)
            .height(592.dp)
    ) {
        StartSupportingPanelContent()
    }
    SpatialPanel(
        SubspaceModifier
            .height(824.dp)
            .width(1400.dp)
    ) {
        App()
    }
    SpatialPanel(
        SubspaceModifier
            .width(288.dp)
            .height(480.dp)
    ) {
        EndSupportingPanelContent()
    }
}

Thêm chức năng không gian

Sau khi lên ý tưởng và bắt đầu chuyển đổi các thành phần giao diện người dùng 2D sang 3D, bạn cũng có thể bắt đầu xem xét các chức năng không gian khác mà bạn có thể thêm vào ứng dụng để tạo ra trải nghiệm khác biệt hơn cho Android XR.

Kiểm tra các chức năng không gian

Khi quyết định có hiển thị một phần tử giao diện người dùng cụ thể hay không, hãy tránh kiểm tra các thiết bị hoặc chế độ XR cụ thể. Việc kiểm tra thiết bị hoặc chế độ thay vì chức năng có thể gây ra sự cố khi chức năng trên một thiết bị nhất định thay đổi theo thời gian. Thay vào đó, hãy sử dụng LocalSpatialCapabilities.current.isSpatialUiEnabled để trực tiếp kiểm tra các chức năng âm thanh không gian cần thiết như trong ví dụ sau. Phương pháp này đảm bảo ứng dụng của bạn thích ứng chính xác với nhiều trải nghiệm XR mà không cần cập nhật mỗi khi có thiết bị mới hoặc thay đổi về chức năng.

if (LocalSpatialCapabilities.current.isSpatialUiEnabled) {
    SupportingInfoPanel()
} else {
    ButtonToPresentInfoModal()
}

// Similar check for audio
val spatialAudioEnabled = LocalSpatialCapabilities.current.isSpatialAudioEnabled

Sử dụng môi trường để thay đổi không gian xung quanh người dùng

Khi muốn tạo cảm giác đắm chìm trong ứng dụng bằng cách thay đổi môi trường xung quanh của người dùng, bạn có thể thực hiện việc này bằng môi trường. Việc thêm môi trường trong mã là một thay đổi đơn giản mà bạn có thể thực hiện mà không ảnh hưởng đáng kể đến giao diện người dùng hiện có của ứng dụng. Để biết thêm thông tin về cách thiết lập môi trường, hãy nhớ xem toàn bộ hướng dẫn của chúng tôi.

Thêm nội dung 3D

Nội dung 3D như mô hình 3D và video không gian có thể giúp tạo ra trải nghiệm sống động hơn và tăng cường khả năng hiểu biết về không gian. Ứng dụng của bạn chỉ có thể hiển thị nội dung 3D khi có các chức năng không gian, vì vậy, trước tiên, bạn nên kiểm tra xem có các chức năng không gian hay không.

Tham khảo hướng dẫn thích hợp để thêm mô hình 3D, video không gian hoặc âm thanh không gian.