Entegrasyon şartları

Bu bölümde, hazır oyun ile YouTube Hazır Oyunlar SDK'sı arasındaki entegrasyon ele alınmaktadır.

1 Hazır Oyunlar SDK'sını yükleyin

2 Oyuna hazır bildirimi

  • Oyun, yükleme işleminin devam ettiğini kullanıcıya açıkça bildiren bir yükleme ekranı veya başlangıç ekranı oluşturduğunda firstFrameReady işlevini KESİNLİKLE çağırmalıdır.
  • Oyun, kullanıcı etkileşimine hazır olduğunda (örneğin, ana menü veya oyun oynanmaya hazır olduğunda) MUTLAKA gameReady işlevini çağırmalı ve MUTLAKA yalnızca gameReady işlevini çağırmalıdır.
  • Kullanıcıya etkileşimli olmayan öğeler gösterilirken (örneğin, başlangıç ekranları veya yükleme ekranları) oyun gameReady işlevini KESİNLİKLE çağırmamalıdır.

YouTube, bu API çağrılana kadar "yükleme çarkını" kaldırmaz.

3. Kullanıcı puanları

  • Oyun, kullanıcının puanını göndermek için MAY sendScore kullanabilir.
  • Oyun, puan göndermek için sendScore kullanıyorsa MUTLAKA sendScore spesifikasyonuna uymalı ve gönderilen en iyi puanın, oyun kaydındaki en iyi puanla eşleştiğinden EMİN OLMALIDIR.

4 buluta kaydetme

  • Oyun, kullanıcılar önemli bir ilerleme kaydettiğinde (ör. seviye değişikliği) ilerlemeyi kaydetmek için MUTLAKA saveData işlevini çağırmalıdır. Bu durumda oyun mekanikleri, kullanıcının ilerlemesinin kaydedildiğine inanmasına neden olur.
  • Oyun, kullanıcı ilerlemesini kaydetmek için başka bir mekanizma KULLANMAMALIDIR. Bu özellik, oyuncuların oyuna daha sonra devam etmelerini sağlar.
  • Oyuncu, saveData'ı aramadan önce loadData'ı BEKLEMELİDİR. saveData, loadData başarıyla tamamlanmadan önce çağrılırsa istek reddedilir. Bu sayede oyun, daha önce kaydedilen verilerin üzerine yazmaz.
  • Oyun, önceki sürümlerin bulut kayıt verilerini hata veya kilitlenme olmadan kullanabilmelidir.
  • Oyun, kullanıcının verilerinin kullanılmasını beklediği tüm oyun sürümlerinde kullanıcı ilerlemesini korumak için buluta kayıtlı verileri KULLANMALIDIR.
  • Oyunlar, veri kaybını önlemek için önemli oyun aşamalarında kullanıcı ilerlemesini otomatik olarak KAYDETMELİDİR. Son bir temizleme işlemi, kullanıcı oyundan çıktığında gerçekleştirilir ancak bu işlem en iyi çabayı gösterir ve yalnızca 64 KiB'ye kadar içerik uzunluğunu kaydedebilir.

5 Sesi açma/kapatma düğmesi

  • Oyun, sistemin ses ayarına ve mikrofonu kapatma düğmesine UYMALIDIR.
  • Oyun, isAudioEnabled ve onAudioEnabledChange kullanarak YouTube'un ses ayarına ve mikrofonu kapatma düğmesine UYMALIDIR.
  • Oyun, cihazdaki ses kontrolüne UYGUN olmalıdır.
  • Oyun sesi BEKLENMEDİK ŞEKİLDE çalmamalıdır.
  • YouTube'da sessize alma ayarı etkinleştirildiğinde ses çıkışı YAPILMAMALI ve oyun sesi kontrolleri ses çıkışını ETKİLEMEMELİDİR.
  • YouTube'da sesi kapatma ayarlanmadığında oyun sesi denetimleri, ses çıkışını ETKİLEYEBİLİR.
  • Oyunda, oyunun kendi içinde genel bir sessize alma düğmesi GÖSTERİLMEMELİDİR. Kullanıcıların bu işlem için YouTube düzeyindeki özelliklerden yararlanmasına izin verilmelidir.
  • Oyunlarda müzik ve ses efektleri gibi ayrıntılı ses kontrolleri OLABİLİR ancak diğer tüm ses kontrolü şartlarına UYULMALIDIR.

Arka plan, ses efektleri ve diyaloglar için farklı ses ayarları

6. Duraklatma ve devam ettirme

Playables SDK'sı, platformlar arası duraklatma ve devam ettirme özellikleri için geri çağırma işlevleri sağlar.

  • Oyun, onPause çağrıldıktan sonra tüm yürütmeyi DURAKLATMALI ve yürütmeye yalnızca onResume çağrıldığında DEVAM ETMELİDİR. Yürütme, oyun döngüsü, müzik, etkileşimler, ağ çağrıları ve oluşturma gibi tüm oynanabilir özelliklerini içerir.
  • Oyun, web Page Visibility API'sini veya benzer web API'lerini KULLANMAMALI ve yalnızca Playables SDK'sını onPause ve onResume KULLANMALIDIR.
  • Oyun, onPause gerçekleştiğinde kullanıcı ilerlemesini KAYDETMELİDİR.