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 dành cho Unity dành 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 của Cardboard trước khi phân phối ứng dụng cho 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 nền tảng thực tế ảo. Điện thoại thông minh có thể hiển thị cảnh 3D bằng tính năng kết xuất hình nổi, theo dõi và phản ứng với chuyển động của đầu, đồng thời 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ạ minh hoạ các tính năng cốt lõi của SDK Cardboard. Trong trò chơi, người dùng sẽ khám phá thế giới ảo để tìm và thu thập các đối tượng. Hướng dẫn này chỉ cho 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 thiết bị xem Cardboard để lưu thông số
• 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ế độ Thực tế ảo (VR)

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

Yêu cầu đối với phần mềm:

• Unity 2021.3.32f1 trở lên
  • Đừng quên bao gồm dịch vụ Hỗ trợ bản dựng dành cho 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 trên biến môi trường PATH. Hãy xem các tài liệu hỗ trợ git trong trình quản lý gói của 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 rồi tạo một dự án 3D mới.
2. Trong Unity, hãy chuyển đến Window > Package Manager (Cửa sổ > 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ừ URL git).
4. Dán https://github.com/googlevr/cardboard-xr-plugin.git vào trường nhập văn bản.
   Gói này phải được thêm vào các gói đã cài đặt.
5. Di chuyển đến gói Trình bổ trợ Google Cardboard XR dành cho Unity. Trong phần Samples (Mẫu), hãy chọn Import vào Project (Nhập vào dự án).
   Bạn cần tải nội dung mẫu 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ở 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à "Interactive" (Tương tác).
4. Nhấp vào Treasure EIDR để mở cửa sổ Inspector (Trình kiểm tra). Đặt lớp của thư viện thành "Tương tác". Nếu cửa sổ bật lên xuất hiện và hỏi 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 "Có, thay đổi thành phần con".
5. Nhấp vào Player > Camera > CardboardReticlePointer EIDR để mở cửa sổ Inspector (Trình kiểm tra). Trong tập lệnh "Carboard reticle con trỏ", hãy chọn "Interactive" (Tương tác) làm Reticle Interaction Layer Mask (Mặt nạ lớp tương tác ô vuông).

Định cấu hình các 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à cách trình bày

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Resolution and CPMation (Độ 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 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 hướng Chân dung và hướng Chân dung lộn ngược có thể không có đủ khoảng trống để hiển thị theo mắt trên thiết bị.

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

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

1. Chọn OpenGLES2, OpenGLES3 hoặc Vulkan hoặc bất kỳ kết hợp nào trong số đó trong Graphics API (API Đồ hoạ).
2. Chọn Android 8.0 'Oreo' (API level 26) trở lên ở phần Minimum API Level (Cấp API tối thiểu).
3. Chọn API level 33 trở lên trong phần Target API Level (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 phần Target Architectures (Kiến trúc mục tiêu).
6. Chọn Require trong Internet Access (Quyền 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 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 quá trình 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 Texture nén format (Định dạng nén kết cấu).
9. 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 nhậ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 mới không còn được hỗ trợ trong Unity 2023.1 trở lên. Phiên bản 3.0 trở lên. Để biết thêm thông tin, hãy xem trang Các yêu cầu và khả năng tương thích với Android trong tài liệu hướng dẫn của 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ần phụ thuộc trong sdk/build.gradle của kho lưu trữ SDK của Cardboard.

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

Chuyển đến phần Project Settings (Cài đặt dự án) > XR plugin Management (Quản lý trình bổ trợ 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 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à cách trình bày

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Resolution and CPMation (Độ 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à hướng Chân dung lộn ngược có thể không có đủ khoảng trống để hiển thị theo mắt trên thiết bị.

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

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

1. Trong phần Camera Usage Description (Mô tả sử dụng máy ảnh), hãy ghi Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. Trong phần Nhắm mục tiêu phiên bản iOS tối thiểu, hãy ghi 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 bạn 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 phần Project Settings (Cài đặt dự án) > XR plugin Management (Quản lý trình bổ trợ 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 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).

Đang căn giữa

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

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

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

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

Các bước tiếp theo

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