El SDK de Sala de juegos de YouTube es un SDK web para conectar juegos web con el entorno de YouTube. El SDK incluye una API sólida para admitir juegos de diversas maneras y crear una excelente experiencia de juego en YouTube.
Agrega el SDK de Playables a tu juego
Un juego debe tener un archivo index.html en el directorio raíz. Importa el SDK de Sala de juegos de YouTube agregando esta línea antes de cualquier código de tu juego:
<script src="https://www.youtube.com/game_api/v1"></script>
El SDK se ejecuta como una operación nula cuando tu juego se publica de forma local. Para verificar la corrección de la integración del SDK, usa la guía del paquete de pruebas.
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 generales, con un enfoque en 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 obligatorias, hay varias otras funciones disponibles para crear una experiencia muy atractiva. Los siguientes son algunos ejemplos:
ytgame.system.getLanguage(): Usa este parámetro para recuperar la configuración regional actual del usuario. No uses otras funciones ni almacenes el idioma en el guardado en la nube, ya que puede cambiar en cualquier momento.ytgame.engagement.sendScore({ value: newScore }): Envía la mejor puntuación a YouTube para que se 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 implementación y funciones adicionales.
Definiciones de tipos de TypeScript
En el caso de los juegos que usan TypeScript, descarga las definiciones de tipos.
Juegos de muestra
Hay muestras disponibles que demuestran cómo realizar la integración con el SDK de YouTube Playables, incluidos JavaScript simple, Flutter Web, Godot y Unity.
Cómo probar tu juego con el paquete de pruebas
Cuando tengas todo listo, puedes validar tu integración con el paquete de pruebas. Para obtener más información, consulta la guía del paquete de pruebas.