Mendukung kemampuan mengubah ukuran layar besar

Perluasan dari ponsel ke berbagai faktor bentuk perangkat layar besar memperkenalkan pertimbangan tentang cara game Anda menangani pengelolaan jendela. Di ChromeOS dan Google Play Game di PC, game Anda dapat berjalan dalam mode jendela melalui antarmuka desktop utama. Di tablet dan perangkat foldable Android baru yang menjalankan Android 12L (level API 32) atau yang lebih baru dengan lebar layar > Dengan ukuran 600 dp, game Anda dapat berjalan berdampingan dalam mode layar terpisah dengan aplikasi lain, diubah ukurannya, dan bahkan dipindahkan antara layar dalam dan luar pada perangkat foldable yang menghasilkan perubahan konfigurasi untuk ukuran jendela dan, pada beberapa perangkat, orientasi.

Kemampuan mengubah ukuran dengan game Unity

Konfigurasi dasar untuk layar besar

Menyatakan apakah game Anda dapat menangani kemampuan mengubah ukuran:

<android:resizeableActivity="true" or "false" />

Jika tidak dapat mendukung kemampuan mengubah ukuran, pastikan manifes game secara eksplisit menentukan rasio aspek minimum dan maksimum yang didukung:

<!-- Render full screen between 3:2 and 21:9 aspect ratio -->
<!-- Let the platform letterbox otherwise -->
<activity android:minAspectRatio="1.5">
<activity android:maxAspectRatio="2.33">

Google Play Game di PC

Untuk Google Play Game di PC, platform menangani perubahan ukuran jendela dengan tetap mengikuti rasio aspek yang ditentukan. Ukuran jendela dikunci ke dimensi yang optimal secara otomatis. Anda harus mendukung rasio aspek minimal 16:9 jika orientasi utama adalah lanskap dan rasio aspek 9:16 jika game Anda dalam mode potret. Untuk mendapatkan pengalaman terbaik, dukung rasio aspek 21:9, 16:10, dan 3:2 untuk game lanskap secara eksplisit. Kemampuan mengubah ukuran jendela tidak diperlukan di sini, tetapi masih bagus untuk kompatibilitas faktor bentuk lainnya.

Untuk mengetahui informasi selengkapnya dan praktik terbaik, lihat Mengonfigurasi grafis untuk Google Play Game di PC.

Layar besar ChromeOS dan Android

Guna memaksimalkan area yang dapat dilihat untuk game Anda dalam layar penuh di ChromeOS dan perangkat Android layar besar, dukung mode imersif layar penuh dan sembunyikan kolom sistem dengan menyetel tanda di decorView, visibilitas UI sistem, atau melalui WindowInsetsCompat API. Anda juga perlu menangani rotasi dan perubahan ukuran peristiwa konfigurasi dengan baik atau mencegahnya terjadi di perangkat ChromeOS.

Perhatikan bahwa di perangkat Android layar besar, game Anda dapat berjalan dalam konfigurasi yang mungkin belum Anda tangani. Jika game tidak mendukung semua ukuran jendela dan konfigurasi orientasi, game akan dijadikan tampilan lebar platform dalam mode kompatibilitas dan, jika perlu, meminta pemain sebelum beralih ke konfigurasi yang tidak didukung.

Gambar 1. Dialog kompatibilitas konfigurasi.

Di beberapa perangkat, saat pemain beralih ke konfigurasi yang tidak didukung, mereka mungkin diminta dengan opsi untuk memuat ulang game dan membuat ulang aktivitas agar sesuai dengan tata letak jendela baru, yang akan mengganggu pengalaman bermain. Uji game Anda dalam berbagai konfigurasi mode multi-aplikasi (ukuran jendela 2/3, 1/2, 1/3) dan pastikan tidak ada elemen gameplay atau UI yang terpotong atau tidak dapat diakses. Selain itu, uji bagaimana game Anda merespons kontinuitas perangkat foldable saat bergerak antara layar dalam dan luar pada perangkat foldable. Jika Anda melihat masalah, tangani peristiwa konfigurasi ini secara eksplisit dan tambahkan dukungan kemampuan mengubah ukuran perangkat layar besar lanjutan.

Kemampuan untuk mengubah ukuran layar besar tingkat lanjut

Gambar 2. UI yang berbeda di desktop dan perangkat foldable dalam postur mode di atas meja.

Untuk keluar dari mode kompatibilitas dan menghindari pembuatan ulang aktivitas, lakukan hal berikut:

1. Deklarasikan aktivitas utama Anda sebagai dapat diubah ukurannya:

   <android:resizeableActivity="true" />
   

2. Mendeklarasikan dukungan eksplisit untuk "Orientation", "screenSize", "smallestScreenSize", "screenLayout", dan "kepadatan" di atribut android:configChanges dari elemen <activity> manifes game Anda untuk menerima semua peristiwa konfigurasi perangkat layar besar:

   <android:configChanges="screenSize | smallestScreenSize | screenLayout | orientation | keyboard |
                           keyboardHidden | density" />
   

3. Ganti onConfigurationChanged() dan tangani peristiwa konfigurasi, termasuk orientasi, ukuran jendela, lebar, dan tinggi saat ini:

   Kotlin

   override fun onConfigurationChanged(newConfig: Configuration) {
      super.onConfigurationChanged(newConfig)
      val density: Float = resources.displayMetrics.density
      val newScreenWidthPixels =
   (newConfig.screenWidthDp * density).toInt()
      val newScreenHeightPixels =
   (newConfig.screenHeightDp * density).toInt()
   
      // Configuration.ORIENTATION_PORTRAIT or ORIENTATION_LANDSCAPE
      val newScreenOrientation: Int = newConfig.orientation
   
      // ROTATION_0, ROTATION_90, ROTATION_180, or ROTATION_270
      val newScreenRotation: Int =
   windowManager.defaultDisplay.rotation
   }
   

   Java

   @Override
   public void onConfigurationChanged(Configuration newConfig) {
      super.onConfigurationChanged(newConfig);
      float density = getResources().getDisplayMetrics().density;
      int newScreenWidthPixels = (int) (newConfig.screenWidthDp * density);
      int newScreenHeightPixels = (int) (newConfig.screenHeightDp * density);
   
      // Configuration.ORIENTATION_PORTRAIT or ORIENTATION_LANDSCAPE
      int newScreenOrientation = newConfig.orientation;
   
      // ROTATION_0, ROTATION_90, ROTATION_180, or ROTATION_270
      int newScreenRotation = getWindowManager().getDefaultDisplay()
              .getRotation();
   }
   

Anda juga dapat membuat kueri WindowManager untuk memeriksa rotasi perangkat saat ini. Menggunakan metadata ini, periksa dimensi jendela baru dan render ke ukuran jendela penuh. Cara ini mungkin tidak berfungsi pada semua kasus karena perbedaan rasio aspek. Jadi, tempatkan UI game Anda ke ukuran jendela yang baru dan buat tampilan lebar konten gameplay inti Anda. Jika ada batasan teknis atau desain yang mencegah kedua pendekatan tersebut, buat tampilan lebar dalam mesin Anda sendiri untuk mempertahankan rasio aspek, dan skalakan ke dimensi terbaik saat mendeklarasikan resizeableActivity = false dan menghindari mode konfigurasi.

Terlepas dari pendekatan yang Anda ambil, uji game Anda dalam berbagai konfigurasi (lipat dan bentangkan, perubahan rotasi yang berbeda, mode layar terpisah) dan pastikan tidak ada elemen UI dalam game yang terpotong atau tumpang tindih, masalah aksesibilitas target sentuh, atau masalah rasio aspek yang menyebabkan game menjadi melebar, terbebani, atau terdistorsi.

Selain itu, layar yang lebih besar biasanya berarti piksel yang lebih besar, karena Anda memiliki jumlah piksel yang sama untuk area yang jauh lebih besar. Hal ini dapat menyebabkan pikselasi buffer render yang diperkecil atau aset resolusi yang lebih rendah. Gunakan aset berkualitas tertinggi di perangkat layar besar dan profil performa game Anda untuk memastikan tidak ada masalah. Jika game Anda mendukung beberapa tingkat kualitas, pastikan game diperhitungkan untuk perangkat layar besar.

Mode multi-aplikasi

Mode multi-aplikasi memungkinkan beberapa aplikasi berbagi layar yang sama secara bersamaan. Mode multi-aplikasi tidak mengubah siklus proses aktivitas; Namun, status aplikasi yang dilanjutkan di beberapa jendela berbeda di berbagai versi Android (lihat Siklus proses aktivitas dalam mode multi-aplikasi di Mendukung mode multi-aplikasi).

Saat pemain mengalihkan aplikasi atau game ke mode multi-aplikasi, sistem akan memberi tahu aktivitas tentang perubahan konfigurasi seperti yang ditentukan di bagian Kemampuan mengubah ukuran layar besar lanjutan. Perubahan konfigurasi juga terjadi saat pemain mengubah ukuran game atau mengembalikan game ke mode layar penuh.

Tidak ada jaminan bahwa aplikasi akan mendapatkan kembali fokus saat berada dalam mode multi-aplikasi. Oleh karena itu, jika Anda menggunakan salah satu peristiwa status aplikasi untuk menjeda game, jangan mengandalkan peristiwa fokus akuisisi (onWindowFocusChanged() dengan nilai fokus sebagai true) untuk melanjutkan game. Sebagai gantinya, gunakan pengendali peristiwa atau pengendali perubahan status lain seperti onConfigurationChanged() atau onResume(). Perhatikan bahwa Anda selalu dapat menggunakan metode isInMultiWindowMode() untuk mendeteksi apakah aktivitas saat ini berjalan dalam mode multi-aplikasi.

Dengan mode multi-aplikasi di ChromeOS, dimensi jendela awal menjadi pertimbangan penting. Game tidak harus layar penuh, dan Anda harus mendeklarasikan ukuran jendela yang tepat untuk kasus tersebut. Ada dua cara yang direkomendasikan untuk melakukan pendekatan ini.

Opsi pertama berfungsi dengan menggunakan atribut tertentu pada tag <layout> di manifes Android Anda. Atribut defaultHeight dan defaultWidth mengontrol dimensi awal. Perhatikan juga atribut minHeight dan minWidth untuk mencegah pemain mengubah ukuran jendela game menjadi dimensi yang tidak Anda dukung. Terakhir, ada atribut gravity, yang menentukan di mana jendela muncul di layar saat diluncurkan. Berikut adalah contoh tag tata letak menggunakan atribut tersebut:

<layout android:defaultHeight="500dp"
        android:defaultWidth="600dp"
        android:gravity="top|end"
        android:minHeight="450dp"
        android:minWidth="300dp" />

Opsi kedua untuk menyetel ukuran jendela berfungsi melalui penggunaan batas peluncuran dinamis. Dengan menggunakan setLaunchBounds(Rect)⁠⁠, Anda dapat menentukan dimensi jendela awal. Jika persegi panjang kosong ditetapkan, aktivitas akan dimulai dalam status dimaksimalkan.

Selain itu, jika Anda menggunakan game engine Unity atau Unreal, pastikan Anda menggunakan versi terbaru (Unity 2019.4.40 dan Unreal 5.3 atau yang lebih baru) yang memberikan dukungan yang baik untuk mode multi-aplikasi.

Catatan: Android 12 (API level 31) menjadikan mode multi-aplikasi sebagai perilaku default untuk perangkat dengan lebar terkecil >= 600 dp. Atribut resizeableActivity menunjukkan apakah suatu aktivitas dapat diubah ukurannya. Untuk mengetahui detail selengkapnya, lihat Mendukung mode multi-aplikasi.

Dukungan postur perangkat foldable

Gunakan library tata letak WindowManager Jetpack untuk mendukung postur perangkat foldable, seperti di atas meja, untuk meningkatkan pengalaman bermain dan interaksi pemain:

Gambar 3. Game dalam postur mode di atas meja dengan tampilan utama pada bagian vertikal layar, kontrol pada bagian horizontal.

Kotlin

fun isTableTopPosture(foldFeature : FoldingFeature?) : Boolean {
    contract { returns(true) implies (foldFeature != null) }
    return foldFeature?.state == FoldingFeature.State.HALF_OPENED &&
            foldFeature.orientation == FoldingFeature.Orientation.HORIZONTAL
}

Java

boolean isTableTopPosture(FoldingFeature foldFeature) {
    return (foldFeature != null) &&
           (foldFeature.getState() == FoldingFeature.State.HALF_OPENED) &&
           (foldFeature.getOrientation() == FoldingFeature.Orientation.HORIZONTAL);
}