FAQ Sertifikasi

Jika Anda memiliki pertanyaan yang tidak ditemukan di halaman ini, hubungi kami menggunakan informasi kontak di halaman kontak dukungan.

Halaman ini mungkin akan diperbarui dengan pertanyaan umum (FAQ) seiring pertanyaan tersebut diterima.

Umum

Bagian ini mencakup pertanyaan yang tidak termasuk dalam kategori tertentu.

Dapatkah saya menguji game di lingkungan YouTube?

Ya - gunakan Portal Developer dan ikuti petunjuk pengujian.

Game saya tidak dirender di Android atau suite pengujian SDK, apa yang harus saya lakukan?

Jika game tidak dirender secara eksklusif di Android atau suite pengujian SDK, hal ini sering kali disebabkan oleh cara game dimuat di WebView. Untuk alasan performa, game awalnya dimuat di WebView yang tidak ditampilkan kepada pengguna, sehingga ukuran area pandang WebView menjadi nol. Untuk mengatasi masalah ini, sebaiknya lakukan solusi berikut:

(1) Pastikan kode game Anda dijalankan terlepas dari ukuran area tampilan.

(2) Pastikan kode game Anda menangani pengubahan ukuran area pandang dan kode game tidak menunggu atau gagal saat ukuran area pandang nol.

Sebaiknya dengarkan peristiwa jendela resize dan tetapkan tinggi game hanya jika window.innerHeight bukan nol.

Persyaratan Teknis

Bagian ini berisi pertanyaan terkait persyaratan teknis Ruang Game YouTube.

Dapatkah saya menerima pengecualian untuk batas ukuran file individual?

Tidak. Ukuran file satuan adalah batas mutlak.

Bagaimana cara mengukur ukuran paket awal?

Ukuran paket awal diukur sebagai jumlah total byte yang didownload oleh Game yang Dapat Dimainkan hingga peristiwa gameReady dipanggil.

Playable menggunakan kompresi HTTP jika memungkinkan, yang berarti ukuran paket awal mungkin lebih kecil daripada total ukuran mentah aset. Saat menguji ukuran paket awal di SDK Test Suite, jika host lokal Anda tidak mengompresi aset, ukuran paket mungkin akan lebih besar daripada ukuran setelah Game yang Dapat Dimainkan dipublikasikan. Untuk melihat ukuran paket awal sebenarnya yang ditayangkan untuk Game yang Dapat Dimainkan, gunakan SDK Test Suite yang mengarah ke file index.html dari build yang diupload atau ubah setelan server lokal Anda untuk mengaktifkan kompresi gzip.

Saya telah mencapai atau melebihi batas ukuran file individual atau total paket, apa yang harus saya lakukan?

Untuk mengoptimalkan game dan meningkatkan performa, lihat artikel berikut:

Bagaimana jika saya tidak dapat memenuhi batas ukuran total paket?

Pengguna mungkin harus mendownload aset dari game Anda setiap kali mereka memainkan game Anda. Untuk mencegah waktu pemuatan yang lama dan penggunaan data dalam jumlah besar, sebaiknya total ukuran paket game sekecil mungkin.

Sebaiknya game menggunakan pemuatan lambat atau jenis pemuatan aset inkremental lainnya selama setiap sesi bermain seiring progres pengguna, atau memecah aset per level agar aset dapat didownload dalam jumlah kecil yang tersebar selama sesi yang panjang. Dalam situasi seperti ini, memiliki ukuran total paket yang lebih besar mungkin tidak akan menurunkan pengalaman pengguna, dan bahkan dapat menciptakan pengalaman pengguna yang lebih baik dengan mengaktifkan lebih banyak konten dalam game Anda dengan jejak per pengguna yang lebih rendah. Jika Anda merasa game Anda berfungsi dengan cara ini dan memerlukan ukuran total paket yang lebih besar, hubungi kami menggunakan halaman kontak dukungan untuk mendiskusikan kasus penggunaan Anda.

Dapatkah analisis internal saya dikecualikan dari persyaratan panggilan eksternal?

Tidak. Playable tidak boleh melakukan panggilan eksternal saat ini. Beri tahu partner manager Anda tentang jenis analisis yang Anda minati agar fitur mendatang di ruang ini dapat diprioritaskan.

Game ini mengambil data dan level dari database jarak jauh, apakah ini dapat diterima?

Saat ini tidak, tetapi kami sedang menguji coba akses data jarak jauh dengan judul tertentu. Saat ini, semua data game harus disertakan sebagai bagian dari paket game. Jika Anda ingin memperbarui atau me-refresh aset atau konten game, hubungi kami menggunakan informasi kontak di halaman kontak dukungan untuk mengirimkan paket game yang telah di-refresh atau hubungi kami untuk bertanya lebih lanjut jika Anda ingin dipertimbangkan untuk program uji coba kami.

Saya melihat error tentang pelanggaran "Kebijakan Keamanan Konten" karena menjalankan skrip inline

Hal ini terjadi saat Anda menggunakan JavaScript untuk membuat dan menambahkan tag <script> ke halaman Anda. Untuk keamanan, YouTube menggunakan Kebijakan Keamanan Konten (CSP) yang mengharuskan skrip memiliki kode keamanan khusus yang disebut "nonce". YouTube otomatis menambahkan kode ini ke skrip dalam file HTML Anda, tetapi Anda harus menambahkannya secara manual ke skrip apa pun yang Anda buat dengan kode.

Saat membuat tag skrip secara terprogram menggunakan JavaScript, Anda harus menemukan nonce dari halaman dan menerapkannya ke elemen skrip baru.

Contoh:

const script = document.createElement('script');
script.src = '...';
// Find the nonce from the main page and apply it
script.nonce = document.querySelector('script[nonce]')?.nonce;
document.head.appendChild(script);

Anda dapat menguji konfigurasi offline menggunakan panduan yang ditentukan dalam petunjuk suite pengujian.

Integrasi SDK

Bagian ini mencakup pertanyaan yang terkait dengan Playables SDK API.

Sertifikasi saya gagal karena masalah integrasi audio, apa yang perlu saya perbaiki?

Masalah audio yang paling umum terjadi adalah game yang mengharapkan interaksi pengguna sebelum memulai pemutaran. Namun, Ruang Game YouTube dapat diberi fokus secara otomatis, sehingga game harus menangani kasus ini.

Untuk contoh penyiapan audio, lihat contoh.

Unity

Bagian ini mencakup pertanyaan terkait integrasi game Unity yang ada dengan YouTube Playables SDK. Untuk contoh cara menggunakan SDK dan Wrapper Unity, lihat dokumentasi Wrapper Unity Ruang Game YouTube.

Dapatkah saya menggunakan prakompresi Unity?

Sebaiknya jangan mengompresi aset Anda terlebih dahulu. Persyaratan ukuran paket awal menggunakan ukuran pasca-kompresi dan file yang diupload akan dikompresi setelah penyerapan. Jika masih perlu mengompresi file terlebih dahulu, lihat bagian selanjutnya atau hubungi tim dukungan di halaman kontak dukungan kami untuk membahas opsi terbaik untuk game Anda.

Beberapa game perlu menggunakan prakompresi untuk file .wasm atau .data Unity. Hanya gunakan prakompresi dalam kondisi berikut karena dapat menyebabkan waktu pemuatan yang jauh lebih lambat:

Persyaratan tambahan ini berasal dari batasan arsitektur penayangan. Saat ini, dukungan untuk header HTTP tambahan atau kompresi Brotli tidak tersedia.

Bagaimana cara mengelola update frame saat game berjalan di latar belakang?

Anda dapat menggunakan setTimeout untuk mengelola update frame saat game berjalan di latar belakang. Hal ini membantu mengontrol perilaku seperti menjeda audio. Anda dapat memverifikasi pengelolaan frame latar belakang dengan mengaktifkan opsi "Run in Background" di setelan pemutar.

Batasan memori untuk game Unity

Beberapa game di Unity akan menggunakan memori dalam jumlah besar yang dapat menyebabkan pelanggaran batasan penggunaan memori untuk game yang dapat dimainkan. Sebaiknya ikuti dokumentasi developer untuk Memori di Unity WebGL.