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

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

Lưu ý: Hãy nhớ xem lại cách xây dựng thương hiệu Cardboard trước khi phân phối ứng dụng phù hợp với nhiều khán giả hơn.

Bạn có thể sử dụng Cardboard SDK để biến điện thoại di động thành nền tảng thực tế ảo. Đáp điện thoại thông minh có thể hiển thị cảnh 3D bằng kết xuất lập thể, theo dõi và phản ứng với cử động đầu và tương tác với ứng dụng bằng cách phát hiện thời điểm người dùng nhấn nút xem.

Để bắt đầu, bạn sẽ sử dụng HelloCardboard, một trò chơi minh hoạ minh hoạ các tính năng cốt lõi của Cardboard SDK. Trong trò chơi, người dùng nhìn xung quanh để tìm và thu thập các vật thể. Hướng dẫ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 thiết bị xem Cardboard để lưu các tham số của thiết bị này
• Theo dõi cử động đầu của người dùng
• Kết xuất hình ảnh lập thể bằng cách đặt độ méo chính xác cho mỗi mắt
• Bật rồi tắt chế độ Thực tế ảo (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.32f1 trở lên
  • Hãy nhớ bao gồm dịch vụ Hỗ trợ bản dựng Android và iOS trong quá trình cài đặt.
• Bạn phải cài đặt Git và tệp thực thi git phải được cài đặt nằm trên biến môi trường PATH. Xem git trình quản lý gói của Unity hỗ trợ tài liệu để 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 dấu + rồi chọn Add package from git URL (Thêm gói từ git URL).
4. Dán https://github.com/googlevr/cardboard-xr-plugin.git vào văn bản trường nhập dữ liệu.
   Gói này phải được thêm vào các gói đã cài đặt.
5. Chuyển đến gói Trình bổ trợ Google Cardboard XR dành cho Unity. Trong Phần Mẫu, chọn Nhập vào dự án.
   Tài sản mẫu cần đượ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 tới 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ở menu Lớp và chọn 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 Kho vật {/3} để mở cửa sổ Inspector (Trình kiểm tra). Thiế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 xem bạn có muốn đặt lớp thành Tương tác cho tất cả các đối tượng con, nhấp vào "Có, thay đổi trẻ em".
5. Nhấp vào Trình phát > Máy ảnh > CardboardReticlePointer PWA cho đến mở cửa sổ Trình kiểm tra. Trong mục "Con trỏ kẻ ô trên ô tô" tập lệnh, chọn "Tương tác" làm Mặt nạ lớp tương tác Reticle.

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

Chuyển đến Tệp > 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 (HelloCardboard).

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

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

Chuyển đến phần Cài đặt dự án > Trình phát > Độ phân giải và cách trình bày.

1. Đặt Hướng mặc định thành Ngang Bên trái hoặc Ngang Phải.
2. Tắt tuỳ chọn Optimized Frame Pacing (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 tính năng Portrait (Chân dung) và Hướng Dọc Lộn ngược ra có thể không có đủ chỗ nhìn cho mắt kết xuất trên thiết bị.

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

Chuyển đến phần Cài đặt dự án > Trình phát > Chế độ cài đặt khác.

1. Chọn OpenGLES2, OpenGLES3 hoặc Vulkan hoặc kết hợp các cách kết hợp đó với nhau Graphics API (API Đồ hoạ).
2. Chọn Android 8.0 'Oreo' (API level 26) trở lên trong Minimum API (API tối thiểu) Cấp độ.
3. Chọn API level 33 trở lên trong Cấp độ API mục tiêu.
4. Chọn IL2CPP trong Scripting Backend (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 Cấu trúc mục tiêu.
6. Chọn Require trong phần Internet Access (Truy cập Internet).
7. Chỉ định miền công ty của bạn trong Package Name (Tên gói).
8. Nếu bạn chọn Vulkan làm Graphics API (API Đồ hoạ):
   • Bỏ đánh dấu hộp đánh dấu Áp dụng chế độ xoay màn hình trong khi kết xuất trong Vulkan Cài đặt.
   • Nếu phiên bản Unity là 2021.2 trở lên, hãy chọn ETC2 trong Texture định dạng nén.
9. Nếu phiên bản Unity là 2023.1 trở lên, hãy chọn Activity rồi xoá GameActivity trong Điểm truy cập đơn đăng ký.

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 API kết xuất khả năng tương thích. Để biết thêm thông tin, hãy xem phần build.gradle.

Lưu ý: Trong trường hợp bạn gặp vấn đề khi chọn Vulkan làm đồ hoạ API, đá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 với 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 nữa. Đối với phiên bản mới hơn các phiên bản sẽ sử dụng OpenGL ES 3.0 hoặc Vulkan. Để biết thêm thông tin, hãy xem Yêu cầu và khả năng tương thích với Android trong hướng dẫn sử dụng Unity.

Cài đặt xuất bản

Chuyển đến phần Cài đặt dự án > Trình phát > Cài đặt xuất bản.

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ụ 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.6.1'
     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 gần đây nhất, hãy xem lịch sử của phần phụ thuộc trong sdk/build.gradle của kho lưu trữ SDK cho Cardboard.

Cài đặt quản lý trình cắm XR

Chuyển đến phần Cài đặt dự án > Quản lý plugin XR.

1. Chọn Cardboard XR Plugin trong phần Plugin Nhà cung cấp.

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

Chuyển đến Tệp > 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 Tệp > 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 (HelloCardboard).

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

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

Chuyển đến phần Cài đặt dự án > Trình phát > Độ phân giải và cách trình bày.

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

Lưu ý: Mặc dù được trình bổ trợ Cardboard XR hỗ trợ, nhưng tính năng Portrait (Chân dung) và Hướng Dọc Lộn ngược ra có thể không có đủ chỗ nhìn cho mắt kết xuất trên thiết bị.

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

Chuyển đến phần Cài đặt dự án > Trình phát > Chế độ cài đặt khác.

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

Lưu ý: Nếu sử dụng iPhone X, hãy chọn phương án Ẩn nút màn hình chính trên iPhone X.

Cài đặt quản lý trình cắm XR

Chuyển đến phần Cài đặt dự án > Quản lý plugin XR.

1. Chọn Cardboard XR Plugin trong phần Plugin Nhà cung cấp.

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

Chuyển đến Tệp > 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

Cardboard SDK cho phép bạn căn giữa thiết bị theo dõi chuyển động của đầu bằng cách sử dụng Recenter().

Hãy làm theo các bước sau để dùng thử 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 lại (sử dụng như giao diện mới tư thế đầu về phía trước).
2. Giữ nút kích hoạt của thiết bị Cardboard ở trạng thái hoạt động trong ít nhất ba giây.
3. Nhả trình kích hoạt.
4. Tư thế ban đầu hiện theo hướng máy ảnh đang hướng.

Bật và tắt chế độ Thực tế ảo (VR)

Quản lý trình bổ trợ Unity XR API cho phép bạn bật Bật hoặc tắt chế độ thực tế ảo cho Trình bổ trợ Google Cardboard XR cho Unity. Tài liệu của người dùng cuối và ví dụ về cách sử dụng có trong tệp 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ói trên. Trong cảnh này, bạn có thể nhấn vào thoát để tắt chế độ thực tế ảo (VR) và có thể được bật lại chỉ bằng cách nhấn vào vị trí bất kỳ trên màn hình. Séc VrModeController.cs để biết chi tiết về cách thực hiện.

Các bước tiếp theo

• Xem lại Nguyên tắc sử dụng thương hiệu của Cardboard.