Wymagania dotyczące integracji

W tej sekcji opisujemy integrację Pokoju gier z pakietem SDK Pokoju gier w YouTube.

1. Wczytaj pakiet SDK Pokoju gier

2 Powiadomienie o gotowości do gry

  • Gra MUSI wywoływać funkcję firstFrameReady, gdy renderuje ekran wczytywania lub ekran powitalny, który wyraźnie informuje użytkownika, że proces wczytywania jest w toku.
  • Gra MUSI wywoływać funkcję gameReady i MUSI wywoływać funkcję gameReady tylko wtedy, gdy jest gotowa na interakcję z użytkownikiem (np. gdy wyświetla się menu główne lub gra jest gotowa do rozpoczęcia).
  • Gra NIE MOŻE wywoływać funkcji gameReady, gdy użytkownikowi wyświetlają się jeszcze elementy, z którymi nie można wejść w interakcję (np. ekrany powitalne lub ekrany wczytywania).

YouTube nie usuwa „spinnera ładowania”, dopóki nie zostanie wywołany ten interfejs API.

3 Wyniki użytkowników

  • Gra MOŻE używać sendScore do wysyłania wyniku użytkownika.
  • Jeśli gra używa sendScore do wysyłania wyników, MUSI być zgodna ze specyfikacją sendScore i MUSI dbać o to, aby najlepszy wysłany wynik był zgodny z najlepszym wynikiem zapisanym w grze.

4 zapisy w chmurze

  • Gra MUSI wywoływać funkcję saveData, aby zapisywać postępy, gdy użytkownicy osiągną znaczące postępy w grze (np. zmienią poziom), a mechanika gry sugeruje, że postępy są zapisywane.
  • Gra NIE MOŻE używać żadnego innego mechanizmu do zapisywania postępów użytkownika. Ta funkcja umożliwia graczom wznowienie gry w późniejszym czasie.
  • Gra MUSI poczekać loadData przed wywołaniem funkcji saveData. Jeśli wywołasz funkcję saveData przed pomyślnym zakończeniem działania funkcji loadData, żądanie zostanie odrzucone. Zapobiega to nadpisaniu przez grę wcześniej zapisanych danych.
  • Gra MUSI umożliwiać korzystanie z danych zapisu w chmurze z poprzednich wersji bez błędów i awarii.
  • Gra POWINNA używać danych zapisanych w chmurze, aby zachować postępy użytkownika we wszystkich wersjach gry, w których użytkownik oczekuje użycia swoich danych.
  • Gry POWINNY automatycznie zapisywać postępy użytkownika w ważnych momentach rozgrywki, aby zapobiec utracie danych. Ostatnie zapisanie danych następuje, gdy użytkownik opuści grę, ale jest to działanie podejmowane w miarę możliwości i może zapisać tylko 64 KiB treści.

5 Przełącznik wyciszenia

  • Gra MUSI uwzględniać ustawienia dźwięku systemowego i przycisk wyciszania.
  • Gra MUSI uwzględniać ustawienia dźwięku w YouTube i przycisk wyciszania, korzystając z funkcji isAudioEnabled i onAudioEnabledChange.
  • Gra MUSI respektować sterowanie głośnością na urządzeniu.
  • Dźwięk z gry NIE MOŻE odtwarzać się nieoczekiwanie.
  • Gdy wyciszenie w YouTube jest włączone, dźwięk NIE MOŻE być odtwarzany, a sterowanie dźwiękiem w grze NIE MOŻE wpływać na wyjście audio.
  • Jeśli wyciszenie YouTube nie jest ustawione, elementy sterujące dźwiękiem w grze MOGĄ wpływać na wyjście audio.
  • Gra NIE POWINNA zawierać ogólnego przycisku wyciszania; użytkownicy powinni korzystać z funkcji YouTube.
  • Gra MOŻE mieć osobne, szczegółowe elementy sterujące dźwiękiem, np. muzyką i efektami dźwiękowymi, ale MUSI spełniać wszystkie inne wymagania dotyczące sterowania dźwiękiem.

Różne ustawienia dźwięku dla tła, efektów i dialogów

6. Wstrzymywanie i wznawianie

Pakiet Playables SDK udostępnia wywołania zwrotne umożliwiające wstrzymywanie i wznawianie na wielu platformach.

  • Gra MUSI wstrzymać wszystkie działania po wywołaniu funkcji onPause i MUSI wznowić je dopiero po wywołaniu funkcji onResume. Wykonanie obejmuje wszystkie funkcje reklamy interaktywnej, takie jak pętla gry, muzyka, interakcje, wywołania sieciowe i renderowanie.
  • Gra NIE MOŻE korzystać z internetowego interfejsu Page Visibility API ani podobnych interfejsów API, a MUSI korzystać wyłącznie z pakietu SDK reklam interaktywnych onPause i onResume.
  • Gra POWINNA zapisywać postępy użytkownika, gdy wystąpi zdarzenie onPause.