El SDK de YouTube Playables es un SDK web para conectar juegos web con el entorno de YouTube. El SDK cuenta con una API sólida para admitir juegos de diferentes maneras y crear una experiencia de juego excelente en YouTube.
Agrega el SDK de Playables a tu juego
Un juego debe tener un archivo index.html en el directorio raíz. Para importar el
SDK de YouTube Playables, agrega esta línea antes de cualquier código de juego:
<script src="https://www.youtube.com/game_api/v1"></script>
El SDK se ejecuta como no-op cuando tu juego se entrega de forma local. Para verificar la exactitud de la integración del SDK, usa la guía del paquete de pruebas.
Cómo realizar la integración con el SDK de Playables
Existen varias integraciones obligatorias y opcionales con el SDK de Playables.
Integraciones requeridas
Revisa los requisitos de publicación en general, con especial atención a los requisitos de integración. Revisa la referencia del SDK de Playables para obtener detalles sobre la implementación.
Los siguientes son algunos ejemplos:
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)
Integraciones recomendadas
Además de las integraciones requeridas, hay varias otras funciones disponibles para crear una experiencia muy atractiva. Los siguientes son algunos ejemplos:
ytgame.system.getLanguage(): Úsalo para recuperar la configuración regional actual del usuario. No uses otras funciones ni almacenes el idioma en la nube, ya que esto puede cambiar en cualquier momento.ytgame.engagement.sendScore({ value: newScore }): Envía la mejor puntuación a YouTube para que la muestre.ytgame.engagement.openYTContent({ id: videoID }): Abre un video de YouTube.ytgame.health.logError()yytgame.health.logWarning(): Registra problemas en YouTube.
Consulta la referencia del SDK de Playables para obtener detalles de la implementación y funciones adicionales.
Definiciones de tipos de TypeScript
Para los juegos que usan TypeScript, descarga las definiciones de tipos.
Juegos de muestra
Hay ejemplos disponibles que demuestran cómo realizar la integración con el SDK de YouTube Playables, incluido JavaScript sin formato, Flutter Web, Godot y Unity.
Prueba tu juego con el paquete de pruebas
Cuando tengas todo listo, puedes validar tu integración con el paquete de pruebas. Para obtener información, consulta la guía del conjunto de pruebas.