Petunjuk untuk menambahkan parameter layar perangkat iOS baru ke Cardboard SDK dan XR Plugin

Setiap tahun, perangkat iOS baru dirilis. Agar Cardboard SDK atau Cardboard XR Plugin dapat berfungsi dengan perangkat baru ini, perbarui file resolutions.csv untuk project yang Anda gunakan.

Sumber informasi

Yang perlu diperbarui

Bergantung pada apakah Anda menggunakan Cardboard SDK atau Cardboard XR Plugin, perbarui file resolutions.csv yang sesuai:

Keduanya memuat parameter layar perangkat secara dinamis saat runtime dari resolutions.csv di dalam sdk.bundle.

  • Saat memberikan kontribusi parameter perangkat baru ke Google Cardboard, kirimkan permintaan pull ke repositori Cardboard SDK dan Cardboard XR Plugin (keduanya tetap disinkronkan menggunakan LINT.IfChange / LINT.ThenChange).
  • Untuk project Unity lokal yang menggunakan paket UPM yang tidak dapat diubah di Library/PackageCache/, developer dapat mengedit resolutions.csv langsung di dalam project Xcode yang diekspor di bagian Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv.

Format resolutions.csv

Tambahkan baris baru untuk setiap perangkat menggunakan format yang dipisahkan koma berikut:

identifier,device_name,dpis
  • identifier: String model hardware yang diperoleh dari The Apple Wiki, dengan koma diganti dengan titik (misalnya, iPhone17,3 menjadi iPhone17.3).
  • device_name: Nama marketing perangkat (misalnya, iPhone 16). Nama ini tidak boleh berisi koma, karena parser runtime (stringSplit di screen_params.mm) membagi koma menjadi array 3 elemen tetap tanpa dukungan kutipan; koma yang disematkan akan menggantikan token DPI dan menyebabkannya dievaluasi menjadi 0.0.
  • dpis: Kepadatan piksel layar dalam DPI/PPI diikuti dengan f (misalnya, 460.0f).

Contoh entri

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