Hướng dẫn thêm các tham số màn hình của thiết bị iOS mới vào Cardboard SDK và XR Plugin

Mỗi năm, các thiết bị iOS mới đều được phát hành. Để Cardboard SDK hoặc Cardboard XR Plugin hoạt động với những thiết bị mới này, hãy cập nhật tệp resolutions.csv cho dự án mà bạn đang sử dụng.

Nguồn thông tin

Những thông tin cần được cập nhật

Tuỳ thuộc vào việc bạn đang sử dụng Cardboard SDK hay Cardboard XR Plugin, hãy cập nhật tệp resolutions.csv tương ứng:

Cả hai đều tải các tham số màn hình thiết bị một cách linh động tại thời gian chạy từ resolutions.csv bên trong sdk.bundle.

  • Khi đóng góp các thông số thiết bị mới cho Google Cardboard, hãy gửi yêu cầu kéo đến cả kho lưu trữ Cardboard SDK và Cardboard XR Plugin (các kho lưu trữ này được đồng bộ hoá bằng LINT.IfChange / LINT.ThenChange).
  • Đối với các dự án Unity cục bộ sử dụng các gói UPM bất biến trong Library/PackageCache/, nhà phát triển có thể chỉnh sửa resolutions.csv ngay trong dự án Xcode đã xuất trong Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv.

Định dạng của resolutions.csv

Thêm một dòng mới cho mỗi thiết bị bằng cách sử dụng định dạng phân tách bằng dấu phẩy sau:

identifier,device_name,dpis
  • identifier: Chuỗi mô hình phần cứng lấy từ The Apple Wiki, mọi dấu phẩy đều được thay thế bằng dấu chấm (ví dụ: iPhone17,3 trở thành iPhone17.3).
  • device_name: Tên tiếp thị của thiết bị (ví dụ: iPhone 16). Tên này không được chứa dấu phẩy, vì trình phân tích cú pháp thời gian chạy (stringSplit trong screen_params.mm) sẽ phân tách dấu phẩy thành một mảng gồm 3 phần tử cố định mà không có tính năng hỗ trợ trích dẫn; dấu phẩy được nhúng sẽ thay thế mã thông báo DPI và khiến mã thông báo này đánh giá thành 0.0.
  • dpis: Mật độ pixel màn hình theo DPI/PPI, theo sau là f (ví dụ: 460.0f).

Ví dụ về mục nhập

iPhone17.3,iPhone 16,460.0f
iPhone17.4,iPhone 16 Plus,460.0f
iPhone17.1,iPhone 16 Pro,460.0f
iPhone17.2,iPhone 16 Pro Max,460.0f