Persyaratan integrasi

Bagian ini membahas integrasi antara Playable dan YouTube Playables SDK.

1 Memuat Playables SDK

2 Notifikasi Game siap

  • Game HARUS memanggil firstFrameReady saat game merender layar pemuatan atau layar pembuka yang secara eksplisit mengomunikasikan kepada pengguna bahwa proses pemuatan sedang berlangsung.
  • Game HARUS memanggil gameReady dan HARUS hanya memanggil gameReady saat game siap untuk interaksi pengguna (contoh: menu utama atau game siap dimainkan).
  • Game TIDAK BOLEH memanggil gameReady saat masih ada elemen yang tidak dapat diinteraksi yang ditampilkan kepada pengguna (contoh: layar pembuka atau layar pemuatan).

YouTube tidak menghapus "spinner pemuatan" hingga API ini dipanggil.

3 Skor pengguna

  • Game DAPAT menggunakan sendScore untuk mengirim skor pengguna.
  • Jika game menggunakan sendScore untuk mengirim skor, game HARUS mematuhi spesifikasi sendScore dan HARUS memastikan bahwa skor terbaik yang dikirim cocok dengan skor terbaik dalam penyimpanan game.

4 Penyimpanan di cloud

  • Game HARUS memanggil saveData untuk menyimpan progres saat pengguna telah membuat progres game yang signifikan (misalnya, perubahan level) yang membuat pengguna percaya bahwa progresnya disimpan.
  • Game TIDAK BOLEH menggunakan mekanisme lain untuk menyimpan progres pengguna. Fitur ini memungkinkan pemain melanjutkan game di lain waktu.
  • Game HARUS menunggu loadData sebelum memanggil saveData. Jika saveData dipanggil sebelum loadData berhasil diselesaikan, permintaan akan ditolak. Hal ini mencegah game menimpa data yang disimpan sebelumnya.
  • Game HARUS dapat menggunakan data penyimpanan cloud dari versi game sebelumnya tanpa error atau mengalami kerusakan.
  • Game HARUS menggunakan data penyimpanan cloud untuk mempertahankan progres pengguna di semua versi game tempat pengguna mengharapkan datanya digunakan.
  • Game HARUS menyimpan progres pengguna secara otomatis di pencapaian penting game untuk mencegah kehilangan data. Penyimpanan flush akhir dilakukan saat pengguna keluar dari game, tetapi merupakan upaya terbaik dan hanya dapat menyimpan konten hingga 64 KiB.

5 Tombol bisukan audio

  • Game HARUS mematuhi setelan audio sistem dan tombol bisukan.
  • Game HARUS mematuhi setelan audio dan tombol bisu YouTube dengan menggunakan isAudioEnabled dan onAudioEnabledChange.
  • Game HARUS mematuhi kontrol volume di perangkat.
  • Suara game TIDAK BOLEH diputar secara tiba-tiba.
  • Saat YouTube disetel ke senyap, audio TIDAK BOLEH dikeluarkan dan kontrol audio game TIDAK BOLEH memengaruhi output audio.
  • Jika setelan senyapkan YouTube tidak diatur, kontrol audio game DAPAT memengaruhi output audio.
  • Game TIDAK BOLEH menampilkan tombol bisu keseluruhan dalam game itu sendiri; izinkan pengguna mengandalkan fitur tingkat YouTube untuk hal ini.
  • Game MUNGKIN memiliki kontrol audio terpisah yang terperinci dalam game, seperti untuk musik dan efek suara, tetapi HARUS mengikuti semua persyaratan kontrol audio lainnya.

Setelan audio yang berbeda untuk latar belakang, SFX, dialog

6 Menjeda dan melanjutkan

Playables SDK menyediakan callback untuk kemampuan jeda dan lanjutkan lintas platform.

  • Game HARUS menjeda semua eksekusi setelah onPause dipanggil dan HARUS melanjutkan eksekusi hanya saat onResume dipanggil. Eksekusi mencakup semua kemampuan yang Dapat Dimainkan, seperti loop game, musik, interaksi, panggilan jaringan, dan rendering.
  • Game TIDAK BOLEH menggunakan Page Visibility API web atau API web serupa dan HANYA BOLEH menggunakan Playables SDK onPause dan onResume.
  • Game HARUS menyimpan progres pengguna saat onPause terjadi.