Pakiet SDK Pokoju gier na YouTube to internetowy pakiet SDK, który umożliwia łączenie gier internetowych ze środowiskiem YouTube. Pakiet SDK zawiera rozbudowany interfejs API, który obsługuje gry na różne sposoby, aby zapewnić doskonałe wrażenia z gry w YouTube.
Dodawanie pakietu Playables SDK do gry
Gra powinna mieć plik index.html w katalogu głównym. Zaimportuj pakiet SDK Pokoju gier na YouTube, dodając ten wiersz przed kodem gry:
<script src="https://www.youtube.com/game_api/v1"></script>
Gdy gra jest hostowana lokalnie, pakiet SDK działa jako no-op. Aby sprawdzić poprawność integracji pakietu SDK, skorzystaj z przewodnika po zestawie testów.
Integracja z pakietem Playables SDK
Istnieje kilka wymaganych i opcjonalnych integracji z pakietem Playables SDK.
Wymagane integracje
Zapoznaj się z wymaganiami dotyczącymi publikowania, ze szczególnym uwzględnieniem wymagań dotyczących integracji. Szczegóły implementacji znajdziesz w dokumentacji pakietu Playables SDK.
Przykłady:
ytgame.game.firstFrameReady()ytgame.game.gameReady()ytgame.IN_PLAYABLES_ENVytgame.system.isAudioEnabled()ytgame.system.onAudioEnabledChange((isAudioEnabled) => {})ytgame.system.onPause(() => {})ytgame.system.onResume(() => {})ytgame.game.loadData()ytgame.game.saveData(data)
Zalecane integracje
Oprócz wymaganych integracji dostępnych jest kilka innych funkcji, które pozwalają tworzyć bardzo angażujące wrażenia. Przykłady:
ytgame.system.getLanguage()– użyj tej funkcji, aby pobrać bieżące ustawienie regionalne użytkownika. Nie używaj innych funkcji ani nie zapisuj języka w zapisie w chmurze, ponieważ może się on zmienić w dowolnym momencie.ytgame.engagement.sendScore({ value: newScore })– wyślij najlepszy wynik do wyświetlenia w YouTube.ytgame.engagement.openYTContent({ id: videoID })– otwórz film na YouTube.ytgame.health.logError()iytgame.health.logWarning()– rejestruj problemy w YouTube.
Szczegóły implementacji i dodatkowe funkcje znajdziesz w dokumentacji pakietu Playables SDK.
Definicje typów TypeScript
W przypadku gier korzystających z TypeScript, pobierz definicje typów.
Przykładowe gry
Dostępne są przykłady, które pokazują, jak zintegrować się z pakietem YouTube Playables SDK, w tym z czystym JavaScript, Flutter web, Godot i Unity.
Testowanie gry za pomocą zestawu testów
Gdy wszystko będzie gotowe, możesz sprawdzić integrację za pomocą zestawu testów. Aby dowiedzieć się, jak to zrobić, zapoznaj się z przewodnikiem po zestawie testów.