Pakiet SDK YouTube Playables to pakiet SDK internetowy do łączenia gier internetowych z platformą YouTube. Pakiet SDK zawiera rozbudowany interfejs API, który umożliwia obsługę gier na różne sposoby, aby zapewnić doskonałe wrażenia z gry w YouTube.
Dodawanie do gry pakietu SDK Playables
Gra powinna mieć plik index.html w katalogu głównym. Zaimportuj pakiet SDK YouTube Playables, dodając ten wiersz przed kodem gry:
<script src="https://www.youtube.com/game_api/v1"></script>
Pakiet SDK działa jako nieaktywny, gdy gra jest dostarczana lokalnie. Aby sprawdzić poprawność integracji pakietu SDK, skorzystaj z przewodnika po pakiecie 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, z naciskiem na wymagania dotyczące 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 możesz też korzystać z kilku innych funkcji, aby tworzyć bardzo angażujące treści. Przykłady:
ytgame.system.getLanguage()– służy do pobierania bieżącego ustawienia języka użytkownika. Nie używaj innych funkcji ani nie przechowuj języka w chmurze, ponieważ może się on zmienić w dowolnym momencie.ytgame.engagement.sendScore({ value: newScore })– wysyłanie najlepszego wyniku do YouTube w celu wyświetlenia.ytgame.engagement.openYTContent({ id: videoID })– otwórz film w YouTube.ytgame.health.logError()iytgame.health.logWarning()– zgłaszaj problemy w YouTube.
Aby uzyskać szczegółowe informacje o wdrożeniu i dodatkowych funkcjach, zapoznaj się z dokumentacją Playables SDK.
Definicje typów TypeScript
W przypadku gier korzystających z TypeScript pobierz definicje typów.
Sample games
Dostępne są przykłady, które pokazują, jak integrować się z pakietem Playables SDK w YouTube, m.in. z czystym JavaScriptem, Flutter Web, Godot i Unity.
Testowanie gry za pomocą pakietu testów
Gdy wszystko będzie gotowe, możesz zweryfikować integrację za pomocą zestawu testów. Aby dowiedzieć się, jak to zrobić, zapoznaj się z przewodnikiem po zestawie testów.