Wymagania dotyczące integracji

Ta sekcja obejmuje integrację między Pokojem gier a YouTube Pakiet SDK Pokoju gier.

1 Wczytaj pakiet SDK Pokoju gier

2 Powiadomienie o gotowości do gry

  • Gra MUSI wywołać firstFrameReady, gdy renderuje ekran wczytywania lub ekran powitalny z wyraźną informacją dla użytkownika że trwa proces wczytywania.
  • Gra MUSI zadzwonić do gameReady, a MUSI dzwonić tylko do gameReady, gdy: gra jest gotowa do interakcji z użytkownikiem (np. menu główne lub gra jest gotowa aby zagrać).
  • Gra NIE MOŻE wywoływać gameReady, gdy nadal nie można nawiązać kontaktu elementów wyświetlanych użytkownikowi (np. ekrany powitalne i wczytywanie się) ekranów).

YouTube nie usuwa wskaźnika postępu ładowania do czasu wywołania tego interfejsu API.

3 wyniki użytkowników

  • Gra MOŻE użyć sendScore do przesłania wyniku użytkownika.
  • Jeśli gra używa sendScore do przesyłania wyników, MUSI spełniać wymagania. zgodnie ze specyfikacją sendScore oraz MUSZĄ zapewnić przesłanie najlepszego wyniku wskazuje najlepszy wynik w zapisanych ustawieniach gry.

4 zapisy zmian w chmurze

  • Gra MUSI zadzwonić do saveData, by zapisać postępy użytkowników. postępy w grze (np. zmiana poziomu), w którym sprawia, że użytkownik uważa, że postęp został zapisany.
  • Gra NIE MOŻE używać żadnych innych mechanizmów do zapisywania postępów użytkownika. Ten umożliwia graczom wznowienie gry w późniejszym czasie.
  • Gra MUSI zaczekać loadData, zanim zadzwoni pod numer saveData. Jeśli Funkcja saveData jest wywoływana przed zakończeniem działania loadData, zostanie odrzucone. Dzięki temu gra nie będzie zastępować zapisane wcześniej dane.
  • Gra MUSI korzystać z danych zapisanych w chmurze z poprzednich wersji bez błędów i awarii.
  • Gra POWINNO korzystać z danych zapisanych w chmurze, aby utrzymywać postępy użytkownika we wszystkich usługach w wersji gier, w których użytkownik spodziewałby się używać swoich danych.
  • Gry MUSZĄ automatycznie zapisywać postępy użytkownika w ważnej grze kamienie milowe, aby zapobiec utracie danych. Ostateczny zapis czyszczenia pamięci ma miejsce, gdy użytkownik wyłącza grę, ale w miarę naszych możliwości może zaoszczędzić w treści do 64 KiB. długość.

5 Przełącznik wyciszenia

  • Gra MUSI respektować systemowe ustawienia dźwięku i przycisk wyciszania.
  • Gra MUSI przestrzegać ustawień dźwięku YouTube oraz przycisku wyciszania w przypadku isAudioEnabled i onAudioEnabledChange.
  • Gra MUSI regulować głośność na urządzeniu.
  • Dźwięk gry NIE MOŻE odtwarzać się nieoczekiwanie.
  • Gdy ustawione jest wyciszenie w YouTube, dźwięk NIE MOŻE być odtwarzany ani odtwarzany jako dźwięk z gry. elementy sterujące NIE MOGĄ wpływać na wyjście audio.
  • Jeśli wyciszenie w YouTube nie jest ustawione, elementy sterujące dźwiękiem w grze MOŻE wpływać na dźwięk. dane wyjściowe.
  • Gra NIE POWINNO wyświetlać ogólnego przycisku wyciszenia w samej grze. Pozwól użytkownikom korzystać w tym celu z funkcji na poziomie YouTube.
  • Gra MOŻE mieć oddzielne, szczegółowe elementy sterujące dźwiękiem w grze, takie jak: muzykę i efekty dźwiękowe, ale MUSZĄ one następować po wszystkich elementach sterujących dźwiękiem. .

Różne ustawienia dźwięku dla tła, Sfx, okna

6 Wstrzymaj i wznów

Pakiet SDK Pokoju gier zapewnia wywołania zwrotne, które umożliwiają wstrzymywanie na wielu platformach możliwości wznowienia.

  • Gra MUSI wstrzymać wykonywanie całego kodu po wywołaniu funkcji onPause i MUSI wznów wykonanie tylko po wywołaniu funkcji onResume. Wykonanie obejmuje wszystkie Funkcje gry, takie jak pętla w grze, muzyka, interakcje, sieć połączeń i renderowania.
  • Gra NIE MOŻE korzystać z internetowego interfejsu API do sprawdzania widoczności strony ani z podobnych interfejsów API. TRZEBA używać tylko pakietów SDK Pokoju gier onPause i onResume.
  • Gra POWINNO zapisywać postępy użytkownika, gdy wystąpi onPause.