Ir al contenido
Descargar
Guía de Gobu

Servicios del juego

Un juego que sale en un portal web (Poki, CrazyGames) o en una tienda (Steam, Epic) habla con ese servicio: muestra anuncios, dice cuándo se está jugando, comparte enlaces, sabe quién es el jugador. Services es una sola API para todos. El juego se escribe una vez con Services, y cada servicio llega como un plugin que se conecta a ella: el mismo juego funciona en Poki activando el plugin de Poki, y en otro portal activando el suyo.

async fn on_restart_pressed() {
await Services.commercial_break() # Un anuncio entre dos partidas, si el servicio tiene.
start_level()
}
async fn on_revive_pressed() {
if await Services.rewarded_break() { # true: el jugador vio el anuncio entero.
revive()
}
}

Sin un servicio (un build de escritorio, un build web sin plugin de servicio) no pasa nada: una pausa publicitaria termina enseguida, sin anuncio, y una con recompensa no da recompensa. El juego no necesita dos versiones.

Casi todo lo que pide un portal lo hace Gobu solo (Project Settings > Services > Automatic, todo activado):

AjusteQué pasa
Game EventsEl servicio sabe que el juego terminó de cargar cuando la escena principal está lista, que se empezó a jugar con la primera tecla, clic o toque del jugador, y que se paró y se volvió a empezar en cada pausa del juego.
Mute During AdsEl bus principal se silencia mientras se ve un anuncio.
Disable Input During AdsEl juego no hace caso del input mientras se ve un anuncio.
Pause During AdsEl juego se pausa mientras se ve un anuncio (y no se quita la pausa al terminar si ya estaba pausado).

Disable Input During Ads y Pause During Ads solo se ven con Advanced Settings activado (el interruptor que está arriba en la barra lateral de Project Settings).

Project Settings > Services, con Advanced Settings activado: Provider en General, los cuatro ajustes de Automatic activados y Test Provider en Editor

Los eventos del juego también van en orden solos: nunca se manda dos veces seguidas un inicio, una pausa publicitaria para el juego antes del anuncio y lo vuelve a empezar después, y no se manda nada mientras se ve un anuncio (las reglas de Poki). Un juego que prefiere decirlo él desactiva Game Events y llama a Services.loading_finished(), Services.gameplay_start() y Services.gameplay_stop() donde quiera (al final de su propia pantalla de carga, cuando termina un nivel).

LlamadaDaFunción
await Services.commercial_break()bool: se mostró un anuncioFEATURE_ADS
await Services.rewarded_break()bool: dar la recompensaFEATURE_REWARDED_ADS
Services.loading_finished(), gameplay_start(), gameplay_stop()FEATURE_GAME_EVENTS
await Services.shareable_url({"level": "3"})String: un enlace que abre este juego con esos parámetrosFEATURE_SHARE
Services.get_url_param("level")String: un parámetro del enlace con el que se abrió el juegoFEATURE_SHARE
Services.open_external_link(url)Abre una página como la quiere el servicio (sin uno, en el navegador del sistema)FEATURE_EXTERNAL_LINKS
Services.measure(category, what, action)Cuenta algo en las estadísticas del servicioFEATURE_ANALYTICS
Services.get_player_name(), get_player_avatar_url(), is_player_signed_in()El jugador que inició sesiónFEATURE_PLAYER
Services.unlock_achievement(id)Desbloquea un logro de la tiendaFEATURE_ACHIEVEMENTS
await Services.submit_score(board, score)bool: la tabla lo aceptóFEATURE_LEADERBOARDS
await Services.get_scores(board, 10)Array de {"rank", "name", "score"}, el mejor primeroFEATURE_LEADERBOARDS
Services.set_stat(name, value), get_stat(name)Las estadísticas del jugadorFEATURE_STATS
await Services.cloud_save(name, bytes), await Services.cloud_load(name)bool; los bytes (vacío: no hay nada)FEATURE_CLOUD_SAVES

Services.has(Services.FEATURE_ADS) dice si el servicio que se usa lo tiene (para esconder un botón de “ver un anuncio” donde no hay anuncios), y Services.get_provider_name() cuál es ("" sin ninguno). Services.is_ad_playing() y las señales ad_started, ad_finished(shown) y player_changed son para juegos que muestran algo suyo alrededor de un anuncio.

Cada plugin de servicio tiene además su propia API con lo que solo tiene su servicio: la de Poki es Poki.*, la de CrazyGames CrazyGames.*. El mismo juego va a Poki o a CrazyGames activando un plugin u otro. Iniciar sesión sigue en el plugin Autenticación y el multijugador en Juegos en red: un plugin de servicio se conecta también a ellos.

Los logros, las tablas de puntuación, las estadísticas y las partidas en la nube son de las tiendas (Steam, Epic, Google Play, Game Center): un portal web responde como un servicio que no los tiene. Al jugar desde el editor, el servicio test los guarda en memoria mientras corre el juego y escribe cada uno en el Output.

async fn on_level_won(score: int) {
Services.unlock_achievement("first_win")
await Services.submit_score("best_score", score)
}

Project Settings > Services > General > Provider es automatic: el plugin de servicio activado para la plataforma que se exporta (un build web para Poki lleva el plugin de Poki, uno de escritorio para Steam lleva el de Steam). Un nombre (poki) elige ese; donde su plugin no se compila, no pasa nada.

Al jugar desde el editor sin un plugin de servicio se usa el servicio test (Services > Editor > Test Provider, con Advanced Settings activado): una pausa publicitaria muestra durante un segundo una tarjeta “Ad (test)”, y los eventos del juego y measure() se escriben en el Output, para comprobar el orden antes de llevar el juego a un portal.

La lista Provider abierta en Services > General (None, automatic, test) y Test Provider en Editor

Un plugin registra su servicio con register_services_provider (gobu_plugin.h, api_version 4; 5 para logros, tablas, estadísticas y partidas en la nube): las funciones de lo que tiene su servicio y las funciones (features) que suman. Un servicio que responde más tarde (un anuncio que termina) avisa con los eventos que le da el motor. La clave web_head de su plugin.json añade líneas al <head> de la página web exportada (el script del SDK de un servicio). Ver Plugins.