Khung tương tác Android XR (AXRIF) cung cấp các lượt tương tác quen thuộc, cấp cao, có ý kiến cho các ứng dụng OpenXR trên Android XR. AXRIF giúp thu hẹp khoảng cách giữa các lượt tương tác ở cấp hệ thống và các lượt tương tác trong ứng dụng, mang đến một cách thức trực quan và nhất quán để xử lý dữ liệu đầu vào của người dùng.
Hãy làm theo hướng dẫn này để thiết lập và bắt đầu sử dụng AXRIF với Unity.
Điều kiện tiên quyết
Trước khi bắt đầu, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:
- Phiên bản Unity: Unity 6 phiên bản 6000.3.12f1 trở lên.
- Thiết lập dự án: Hoàn tất tất cả các bước trong hướng dẫn thiết lập dự án Unity.
Thiết lập và định cấu hình Unity
Trước khi có thể dùng thử cảnh mẫu, bạn cần thiết lập và định cấu hình Unity cho AXRIF. Hãy làm theo các bước trong các phần sau để hoàn tất quy trình này.
Nhập gói AXRIF
Trước tiên, hãy cài đặt gói AXRIF và các phần phụ thuộc của gói đó:
- Chuyển đến Window > Package Manager (Cửa sổ > Trình quản lý gói).
- Mở trình đơn thêm trong thanh công cụ Package Manager (Trình quản lý gói).
- Trong các lựa chọn để thêm gói, hãy nhấp vào + (dấu cộng).
Trong trình đơn thả xuống, hãy chọn Install package from git URL (Cài đặt gói từ URL git).
Nhập URL sau:
https://github.com/android-xr/android-xr-interaction-framework-unity-package.gitNhấp vào Cài đặt.
Kiểm tra phiên bản XR Interaction Toolkit
Gói AXRIF hoạt động cùng với Unity XR Interaction Toolkit (XRIT) và không thay thế gói này. Vì gói AXRIF xác định một phần phụ thuộc vào XRIT, nên Unity sẽ cài đặt XRIT khi bạn cài đặt gói AXRIF trong các bước trước. Tuy nhiên, bạn nên kiểm tra để đảm bảo đã cài đặt phiên bản 3.3.1 trở lên bằng cách chuyển đến Window > Package Manager > Unity Registry > XR Interaction Toolkit (Cửa sổ > Trình quản lý gói > Sổ đăng ký Unity > Bộ công cụ tương tác XR) trong Trình chỉnh sửa Unity.
Chọn hồ sơ bản dựng Android XR
Chọn hồ sơ bản dựng Android XR để bật các Tiện ích OpenXR thích hợp và thiết lập bản dựng cho Android XR:
- Chuyển đến File > Build Profiles (Tệp > Hồ sơ bản dựng).
Nhấp vào Android XR, rồi nhấp vào Switch Platform (Chuyển nền tảng).
Định cấu hình chế độ cài đặt OpenXR
Định cấu hình chế độ cài đặt OpenXR của Unity để Unity có thể truy cập vào dữ liệu OpenXR cần thiết:
- Chuyển đến Edit > Project Settings > XR Plug-in Management > OpenXR (Chỉnh sửa > Cài đặt dự án > Quản lý trình bổ trợ XR > OpenXR).
- Trong thẻ Android, hãy nhấp vào + (dấu cộng) cho phần Enabled Interaction Profiles (Hồ sơ tương tác đã bật).
Thêm bất kỳ hồ sơ nào sau đây, tuỳ thuộc vào nhu cầu của ứng dụng:
- Hồ sơ tương tác bằng ánh mắt
- Hồ sơ tương tác bằng tay
- Hồ sơ bộ điều khiển cảm ứng Oculus
- Hồ sơ tương tác bằng chuột Android XR
Trong danh sách tính năng trong XR Plug-in Management > OpenXR (Quản lý trình bổ trợ XR > OpenXR), hãy bật các tính năng sau:
- Android XR (Tiện ích): Lớp tổng hợp truyền qua
- Android XR (Tiện ích): Quản lý phiên
- Hỗ trợ Android XR
- Android XR: Camera AR
- Android XR: Phiên AR
- Android XR: Dữ liệu lưới tay AR
- Hỗ trợ lớp tổng hợp
- Hệ thống con theo dõi cử chỉ tay
Xác thực dự án
Xác thực dự án để khắc phục mọi lỗi OpenXR trong cấu hình của dự án:
- Chuyển đến Edit > Project Settings > XR Plug-in Management > Project Validation (Chỉnh sửa > Cài đặt dự án > Quản lý trình bổ trợ XR > Xác thực dự án).
Khắc phục mọi cảnh báo hoặc cảnh báo còn tồn đọng để đảm bảo lỗi thời gian chạy không ảnh hưởng đến quá trình biên dịch.
Sử dụng cảnh mẫu
Giờ đây, bạn đã hoàn tất quá trình thiết lập và định cấu hình sơ bộ, bạn có thể sử dụng cảnh mẫu AXRIF. Hãy làm theo các bước trong các phần sau để lấy cảnh mẫu và dùng thử.
Nhập các gói mẫu XRIT và mẫu AXRIF
Cảnh mẫu AXRIF phụ thuộc vào các gói mẫu Tài sản khởi động và Bản minh hoạ tương tác bằng tay của Bộ công cụ tương tác XR (XRIT) của Unity.
Nhập các gói mẫu XRIT
Nhập các gói mẫu XRIT mà mẫu AXRIF phụ thuộc vào:
- Chuyển đến Window > Package Manager (Cửa sổ > Trình quản lý gói).
- Chọn XR Interaction Toolkit (Bộ công cụ tương tác XR) trong danh sách gói.
Trong thẻ Samples (Mẫu), hãy nhấp vào Import (Nhập) bên cạnh cả Starter Assets (Tài sản khởi động) và Hands Interaction Demo (Bản minh hoạ tương tác bằng tay).
Nhập mẫu AXRIF
Nhập mẫu AXRIF để lấy cảnh mẫu:
- Chuyển đến Window > Package Manager (Cửa sổ > Trình quản lý gói).
- Chọn Android XR Interaction Framework (Khung tương tác Android XR) trong danh sách gói.
Trong thẻ Samples (Mẫu), hãy nhấp vào Import (Nhập) bên cạnh Axrif Sample (Mẫu Axrif).
Mở cảnh
Sau khi nhập các gói mẫu bắt buộc, bạn có thể mở cảnh:
- Chuyển đến Assets > Samples > Android XR Interaction Framework > [AXRIF Version Number] > Axrif Sample (Tài sản > Mẫu > Khung tương tác Android XR > [Số phiên bản AXRIF] > Mẫu Axrif).
Mở AxrifDemoScene.
Khám phá các đối tượng tạo sẵn
Cảnh này được định cấu hình sẵn bằng các đối tượng tạo sẵn theo mô-đun nằm trong phần Packages > Android XR Interaction Framework > Prefabs (Gói > Khung tương tác Android XR > Đối tượng tạo sẵn).
Đối tượng tạo sẵn cho trình tương tác
Các đối tượng tạo sẵn cho Trình tương tác Axrif điều khiển cơ chế tương tác XRIT của Unity bằng các phương thức nhập tương ứng trong danh sách sau:
- Tia tay/bộ điều khiển:
- Trình tương tác Axrif bên trái – Sử dụng tia tay trái hoặc bộ điều khiển.
- Trình tương tác Axrif bên phải – Sử dụng tia tay phải hoặc bộ điều khiển.
- Chụm và nhìn:
- Trình tương tác Axrif bên trái Chụm và nhìn – Sử dụng ánh mắt và chuyển động tay trái khi chụm.
- Trình tương tác Axrif bên phải Chụm và nhìn – Sử dụng ánh mắt và chuyển động tay phải khi chụm.
- Trình tương tác Axrif nhìn – Chỉ sử dụng ánh mắt để trỏ.
- Chạm tay:
- Trình tương tác Axrif bên trái Chạm – Sử dụng ngón trỏ bên trái khi chạm vào các đối tượng có thể tương tác.
- Trình tương tác Axrif bên phải Chạm – Sử dụng ngón trỏ bên phải khi chạm vào các đối tượng có thể tương tác.
- Chuột:
- Trình tương tác Axrif chuột – Sử dụng chuột không gian Android XR.
Đối tượng tạo sẵn cho Trình quản lý tương tác Axrif và Nguồn gốc
Trình quản lý tương tác Axrif: Đối tượng tạo sẵn này là trung tâm của AXRIF trong cảnh. Đối tượng tạo sẵn này chứa thành phần Trình quản lý tương tác Axrif, được thiết kế để hoạt động cùng với Trình quản lý tương tác XRIT XR. Đối tượng tạo sẵn này chịu trách nhiệm:
- Khởi chạy và quản lý các hệ thống con AXRIF cốt lõi trong thời gian chạy.
- Xử lý và định tuyến dữ liệu đầu vào từ OpenXR bằng cách sử dụng Bộ chuyển đổi đầu vào của Khung tương tác.
- Quan sát trạng thái giao diện người dùng và bộ va chạm bằng cách sử dụng Trình tích hợp cảnh của Khung tương tác.
Nguồn gốc XR Axrif: Đóng vai trò là nhân vật chính và trình điều khiển camera, đồng thời quản lý các trình trực quan hoá lưới tay.
Định cấu hình hành động đầu vào
Để kết nối dữ liệu thời gian chạy OpenXR với Hành động đầu vào của Unity, hãy đăng ký các liên kết bản đồ trên toàn dự án:
- Chuyển đến Packages > Android XR Interaction Framework > InputActions (Gói > Khung tương tác Android XR > InputActions).
- Tìm AndroidXRInteractionFramework Input Actions (Hành động đầu vào AndroidXRInteractionFramework).
Nhấp vào Assign as the Project-wide Input Actions (Chỉ định làm Hành động đầu vào trên toàn dự án).
Sửa đổi lượt tương tác
Khi sử dụng đối tượng tạo sẵn Trình quản lý tương tác Axrif, bạn có thể bật hoặc tắt các phương thức nhập khác nhau. AXRIF hỗ trợ các phương thức nhập sau:
- Truyền tia bộ điều khiển
- Chụm và nhìn
- Truyền tia tay
- Tay trực tiếp
- Tương tác bằng chuột.
Bạn có thể định cấu hình các phương thức nhập ngay bên trong Trình kiểm tra trong phần Configurations (Cấu hình) của thành phần Interaction Framework Manager (Trình quản lý khung tương tác).
Tạo mẫu
Khi bạn muốn tạo mẫu, hãy nhấp vào Build (Tạo) hoặc Build and Run (Tạo và chạy) trong Trình chỉnh sửa Unity.