Hướng dẫn nhanh về Google Cardboard dành cho Unity

Hướng dẫn này trình bày cách sử dụng Trình bổ trợ Google Cardboard XR cho Unity để tạo trải nghiệm Thực tế ảo (VR) của riêng bạn.

Lưu ý: Hãy nhớ xem lại nguyên tắc sử dụng thương hiệu Cardboard trước khi phân phối ứng dụng của bạn đến nhiều đối tượng hơn.

Bạn có thể sử dụng SDK Cardboard để biến điện thoại di động thành một nền tảng VR. Điện thoại thông minh có thể hiển thị các cảnh 3D bằng tính năng kết xuất âm thanh nổi, theo dõi và phản ứng với các chuyển động của đầu, cũng như tương tác với các ứng dụng bằng cách phát hiện thời điểm người dùng nhấn nút trình xem.

Để bắt đầu, bạn sẽ sử dụng HelloCardboard, một trò chơi minh hoạ các tính năng cốt lõi của SDK Cardboard. Trong trò chơi, người dùng nhìn xung quanh một thế giới ảo để tìm và thu thập các đối tượng. Tài liệu này hướng dẫn bạn cách:

• Thiết lập môi trường phát triển
• Tải xuống và tạo ứng dụng minh hoạ
• Quét mã QR của kính xem Cardboard để lưu các thông số của kính
• Theo dõi chuyển động đầu của người dùng
• Kết xuất hình ảnh nổi bằng cách đặt độ méo chính xác cho mỗi mắt
• Bật và tắt chế độ VR

Thiết lập môi trường phát triển

Yêu cầu về phần mềm:

• Unity 2021.3.44f1 trở lên
  • Hãy nhớ thêm tính năng Hỗ trợ bản dựng Android và iOS trong quá trình cài đặt.
  • Hãy nhớ cài đặt bản vá phiên bản 44f1 trở lên.
• Bạn phải cài đặt Git và tệp thực thi git phải nằm trên biến môi trường PATH. Hãy xem tài liệu về Hỗ trợ git của trình quản lý gói Unity để biết thêm thông tin chi tiết.

Nhập SDK và tạo dự án mới

Hãy làm theo các bước sau để nhập SDK Unity và tạo một dự án mới.

1. Mở Unity và tạo một dự án 3D mới.
2. Trong Unity, hãy chuyển đến Window (Cửa sổ) > Package Manager (Trình quản lý gói).
3. Nhấp vào biểu tượng + rồi chọn Thêm gói từ URL git.
4. Dán https://github.com/googlevr/cardboard-xr-plugin.git vào trường nhập văn bản.
   Bạn nên thêm gói này vào các gói đã cài đặt.
5. Chuyển đến gói Trình bổ trợ Google Cardboard XR cho Unity. Trong phần Mẫu, hãy chọn Nhập vào dự án.
   Các thành phần mẫu sẽ được tải vào Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

Lưu ý: <version> là số phiên bản ngữ nghĩa X.Y.Z của gói đã phát hành (ví dụ: 1.1.0).

Định cấu hình cảnh HelloCardboard

1. Chuyển đến Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, chọn Add Open Scenes (Thêm cảnh mở) rồi chọn HelloCardboard để mở cảnh mẫu.
2. Mở trình đơn Layers (Lớp) rồi chọn Edit Layers... (Chỉnh sửa lớp...).
3. Xác định một lớp mới có tên là "Tương tác".
4. Nhấp vào GameObject Treasure (Kho báu) để mở cửa sổ Inspector (Trình kiểm tra). Đặt lớp thành "Tương tác". Nếu một cửa sổ bật lên xuất hiện hỏi liệu bạn có muốn đặt lớp thành Tương tác cho tất cả đối tượng con hay không, hãy nhấp vào "Yes, change children" (Có, thay đổi đối tượng con).
5. Nhấp vào GameObject Player > Camera > CardboardReticlePointer để mở cửa sổ Inspector (Trình kiểm tra). Trong tập lệnh "Con trỏ đường ngắm Cardboard", hãy chọn "Tương tác" làm Mặt nạ lớp tương tác với đường ngắm.

Định cấu hình chế độ cài đặt dự án Android

Chuyển đến File (Tệp) > Build Settings (Cài đặt bản dựng).

1. Chọn Android rồi chọn Switch Platform (Chuyển nền tảng).
2. Chọn Add Open Scenes (Thêm cảnh mở) rồi chọn HelloCardboard.

Cài đặt trình phát

Độ phân giải và bản trình bày

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Resolution and Presentation (Độ phân giải và bản trình bày).

1. Đặt Hướng mặc định thành Ngang trái hoặc Ngang phải.
2. Tắt tính năng Tối ưu hoá tốc độ khung hình.

Lưu ý: Mặc dù được trình bổ trợ Cardboard XR hỗ trợ, nhưng hướng Chân dung và Chân dung lộn ngược có thể không cung cấp đủ không gian để kết xuất mắt trên thiết bị.

Chế độ cài đặt khác

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Other Settings (Cài đặt khác).

1. Chọn OpenGLES2, OpenGLES3 hoặc Vulkan hoặc bất kỳ tổ hợp nào trong số đó trong API Đồ hoạ.
2. Chọn Android 8.0 'Oreo' (API level 26) trở lên trong Cấp độ API tối thiểu.
3. Chọn API level 33 trở lên trong Target API Level (Cấp độ API mục tiêu).
4. Chọn IL2CPP trong Phần phụ trợ tập lệnh.
5. Chọn cấu trúc mong muốn bằng cách chọn ARMv7, ARM64 hoặc cả hai trong phần Cấu trúc mục tiêu.
6. Chọn Require trong phần Quyền truy cập Internet.
7. Chọn Input System Package (New) trong Active Input Handling (Xử lý phương thức nhập đang hoạt động).
8. Chỉ định miền của công ty trong phần Package Name (Tên gói).
9. Nếu Vulkan được chọn làm API Đồ hoạ:
   • Bỏ đánh dấu hộp Apply display rotation during rendering (Áp dụng chế độ xoay màn hình trong khi kết xuất) trong phần Vulkan Settings (Cài đặt Vulkan).
   • Nếu phiên bản Unity là 2021.2 trở lên, hãy chọn ETC2 trong Định dạng nén kết cấu.
10. Nếu phiên bản Unity là 2023.1 trở lên, hãy chọn Activity và xoá GameActivity trong Application Entry Point (Điểm truy cập ứng dụng).

Lưu ý: Bạn có thể sử dụng cấp độ API tối thiểu thấp hơn bằng cách thay đổi khả năng tương thích của API kết xuất. Để biết thêm thông tin, hãy xem build.gradle của SDK.

Lưu ý: Trong trường hợp bạn gặp vấn đề khi chọn Vulkan làm API đồ hoạ, hãy đánh dấu vào hộp Development Build trong Build Settings và phân tích nhật ký thời gian chạy để tìm lỗi về khả năng tương thích của trình điều khiển.

Lưu ý: OpenGL ES 2.0 không còn được hỗ trợ trong Unity 2023.1 trở lên. Đối với các phiên bản mới hơn, hãy sử dụng OpenGL ES 3.0 hoặc Vulkan. Để biết thêm thông tin, hãy xem trang Yêu cầu và khả năng tương thích với Android trong hướng dẫn sử dụng Unity.

Chế độ cài đặt xuất bản

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Publishing Settings (Cài đặt phát hành).

1. Trong phần Build (Tạo), hãy chọn Custom Main Gradle Template và Custom Gradle Properties Template.

2. Thêm các dòng sau vào phần phần phụ thuộc của Assets/Plugins/Android/mainTemplate.gradle:

     implementation 'androidx.appcompat:appcompat:1.6.1'
     implementation 'com.google.android.gms:play-services-vision:20.1.3'
     implementation 'com.google.android.material:material:1.12.0'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. Thêm các dòng sau vào Assets/Plugins/Android/gradleTemplate.properties:

     android.enableJetifier=true
     android.useAndroidX=true
   

Lưu ý: Các phần phụ thuộc cần thiết có thể thay đổi giữa các phiên bản. Nếu bạn muốn sử dụng một phiên bản khác với bản phát hành mới nhất, hãy xem nhật ký của phần phần phụ thuộc trong sdk/build.gradle của kho lưu trữ SDK Cardboard.

Cài đặt quản lý trình bổ trợ XR

Chuyển đến Project Settings (Cài đặt dự án) > XR Plug-in Management (Quản lý trình bổ trợ XR).

1. Chọn Cardboard XR Plugin trong phần Nhà cung cấp trình bổ trợ.

Xây dựng dự án của bạn

Chuyển đến File (Tệp) > Build Settings (Cài đặt bản dựng).

1. Chọn Build (Tạo) hoặc chọn một thiết bị rồi chọn Build and Run (Tạo và chạy).

Định cấu hình chế độ cài đặt dự án iOS

Chuyển đến File (Tệp) > Build Settings (Cài đặt bản dựng).

1. Chọn iOS rồi chọn Switch Platform (Chuyển nền tảng).
2. Chọn Add Open Scenes (Thêm cảnh mở) rồi chọn HelloCardboard.

Cài đặt trình phát

Độ phân giải và bản trình bày

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Resolution and Presentation (Độ phân giải và bản trình bày).

1. Đặt Hướng mặc định thành Ngang trái hoặc Ngang phải.

Lưu ý: Mặc dù được trình bổ trợ Cardboard XR hỗ trợ, nhưng hướng Chân dung và Chân dung lộn ngược có thể không cung cấp đủ không gian để kết xuất mắt trên thiết bị.

Chế độ cài đặt khác

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Other Settings (Cài đặt khác).

1. Trong phần Mô tả việc sử dụng máy ảnh, hãy viết Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. Trong mục Target minimum iOS Version (Phiên bản iOS tối thiểu mục tiêu), hãy viết 12.0.
3. Chỉ định miền của công ty trong phần Package Name (Tên gói).

Lưu ý: Nếu bạn đang sử dụng iPhone X, hãy chọn tuỳ chọn Ẩn nút màn hình chính trên iPhone X.

Cài đặt quản lý trình bổ trợ XR

Chuyển đến Project Settings (Cài đặt dự án) > XR Plug-in Management (Quản lý trình bổ trợ XR).

1. Chọn Cardboard XR Plugin trong phần Nhà cung cấp trình bổ trợ.

Xây dựng dự án của bạn

Chuyển đến File (Tệp) > Build Settings (Cài đặt bản dựng).

1. Chọn Build (Tạo) hoặc Build and Run (Tạo và chạy).

Căn giữa lại

Cardboard SDK cho phép bạn đặt lại tâm của trình theo dõi đầu bằng cách sử dụng Recenter().

Hãy làm theo các bước sau để thử tính năng này bằng ứng dụng mẫu:

1. Di chuyển thiết bị đến vị trí bạn muốn căn giữa (sử dụng làm tư thế đầu nhìn về phía trước mới).
2. Giữ cò của thiết bị Cardboard trong ít nhất 3 giây.
3. Nhả điều kiện kích hoạt.
4. Tư thế ban đầu hiện ở hướng máy ảnh đang hướng đến.

Bật và tắt chế độ VR

API quản lý trình bổ trợ Unity XR cho phép bạn bật hoặc tắt chế độ VR cho Trình bổ trợ Google Cardboard XR cho Unity. Bạn có thể xem tài liệu dành cho người dùng cuối và ví dụ về cách sử dụng trong Tài liệu dành cho người dùng cuối của Unity.

Cảnh VrMode trong mẫu HelloCardboard cho thấy cách sử dụng cơ bản của API nêu trên. Trong cảnh này, bạn có thể tắt chế độ VR bằng cách nhấn vào biểu tượng exit (thoát) và bật lại bằng cách nhấn vào vị trí bất kỳ trên màn hình. Hãy kiểm tra VrModeController.cs để biết thông tin chi tiết về cách thực hiện việc này.

Các bước tiếp theo

• Xem nguyên tắc sử dụng thương hiệu Cardboard.