Mendukung kemampuan mengubah ukuran layar besar

Memperluas dari ponsel ke berbagai faktor bentuk perangkat layar besar akan menghadirkan pertimbangan terkait 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 lebih tinggi dengan lebar layar > 600 dp, game Anda dapat berjalan berdampingan dalam mode layar terpisah dengan aplikasi lain, dapat diubah ukurannya, dan bahkan dipindahkan antara layar dalam dan luar pada perangkat foldable yang menyebabkan perubahan konfigurasi untuk ukuran jendela dan, pada beberapa perangkat, orientasi.

Konfigurasi dasar perangkat layar besar

Deklarasikan apakah game Anda dapat menangani kemampuan perubahan:

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

Jika tidak dapat mendukung perubahan 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 optimal secara otomatis. Anda harus mendukung minimal rasio aspek 16:9 jika orientasi utama Anda adalah lanskap dan rasio aspek 9:16 jika game Anda dalam mode potret. Untuk pengalaman terbaik, dukung rasio aspek 21:9, 16:10, dan 3:2 secara eksplisit untuk game lanskap. Perubahan ukuran jendela tidak diperlukan di sini, tetapi masih baik untuk dimiliki untuk kompatibilitas faktor bentuk lainnya.

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

Perangkat layar besar ChromeOS dan Android

Untuk memaksimalkan area tampilan 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 peristiwa konfigurasi rotasi dan pengubahan ukuran 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 Anda tidak mendukung semua konfigurasi orientasi dan ukuran jendela, tampilan lebar platform akan memberi game Anda dalam mode kompatibilitas dan, jika perlu, akan meminta pemain sebelum mengubah ke konfigurasi yang tidak didukung.

Di beberapa perangkat, saat pemain berpindah 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, sehingga mengganggu pengalaman bermain. Uji game Anda dalam berbagai konfigurasi mode multi-aplikasi (ukuran jendela 2/3, 1/2, 1/3) dan pastikan tidak ada gameplay atau elemen UI yang terpotong atau tidak dapat diakses. Selain itu, uji bagaimana game Anda merespons kontinuitas perangkat foldable saat berpindah antara layar dalam dan luar pada perangkat foldable. Jika Anda melihat masalah, tangani peristiwa konfigurasi ini secara eksplisit dan tambahkan dukungan kemampuan mengubah ukuran layar besar lanjutan.

Kemampuan untuk mengubah ukuran layar besar lanjutan

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. Deklarasikan dukungan eksplisit untuk "orientasi", "screenSize", "smallestScreenSize", "screenLayout", dan "density" di atribut android:configChanges dari elemen <activity> manifes game Anda untuk menerima semua peristiwa konfigurasi 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 mengkueri WindowManager untuk memeriksa rotasi perangkat saat ini. Dengan menggunakan metadata ini, periksa dimensi jendela baru dan render ke ukuran jendela penuh. Opsi ini mungkin tidak berfungsi di semua kasus karena perbedaan rasio aspek. Jadi, sebagai alternatif, tempatkan UI game Anda ke ukuran jendela baru dan berikan tampilan lebar pada konten gameplay inti Anda. Jika ada batasan teknis atau desain yang mencegah kedua pendekatan tersebut, lakukan tampilan lebar dalam mesin Anda sendiri untuk mempertahankan rasio aspek, dan skalakan ke dimensi terbaik saat mendeklarasikan resizeableActivity = false serta 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 dengan aksesibilitas target sentuh, atau masalah rasio aspek yang menyebabkan game menjadi meregang, tertekan, 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 untuk 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 tersebut mempertimbangkan 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 pada versi Android yang berbeda (lihat Siklus proses aktivitas dalam mode multi-aplikasi di Dukungan multi-aplikasi).

Saat pemain mengalihkan aplikasi atau game ke mode multi-aplikasi, sistem akan memberi tahu aktivitas 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 fokus kembali saat dialihkan ke mode multi-aplikasi. Oleh karena itu, jika Anda menggunakan salah satu peristiwa status aplikasi untuk menjeda game, jangan mengandalkan peristiwa mendapatkan fokus (onWindowFocusChanged() dengan nilai fokus sebagai true) untuk melanjutkan game. Sebagai gantinya, gunakan pengendali peristiwa atau pengendali perubahan status lainnya 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 dalam mode layar penuh, dan Anda harus mendeklarasikan ukuran jendela 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 agar pemain tidak mengubah ukuran jendela game ke dimensi yang tidak Anda dukung. Terakhir, ada atribut gravity, yang menentukan di mana di layar jendela akan muncul saat diluncurkan. Berikut adalah contoh tag tata letak yang menggunakan atribut ini:

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

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

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

Dukungan postur perangkat foldable

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

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

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