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.
Sin código
Sección titulada «Sin código»Casi todo lo que pide un portal lo hace Gobu solo (Project Settings > Services > Automatic, todo activado):
| Ajuste | Qué pasa |
|---|---|
| Game Events | El 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 Ads | El bus principal se silencia mientras se ve un anuncio. |
| Disable Input During Ads | El juego no hace caso del input mientras se ve un anuncio. |
| Pause During Ads | El 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).

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).
Qué hay
Sección titulada «Qué hay»| Llamada | Da | Función |
|---|---|---|
await Services.commercial_break() | bool: se mostró un anuncio | FEATURE_ADS |
await Services.rewarded_break() | bool: dar la recompensa | FEATURE_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ámetros | FEATURE_SHARE |
Services.get_url_param("level") | String: un parámetro del enlace con el que se abrió el juego | FEATURE_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 servicio | FEATURE_ANALYTICS |
Services.get_player_name(), get_player_avatar_url(), is_player_signed_in() | El jugador que inició sesión | FEATURE_PLAYER |
Services.unlock_achievement(id) | Desbloquea un logro de la tienda | FEATURE_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 primero | FEATURE_LEADERBOARDS |
Services.set_stat(name, value), get_stat(name) | Las estadísticas del jugador | FEATURE_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)}Qué servicio
Sección titulada «Qué servicio»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.

Para quien hace plugins
Sección titulada «Para quien hace plugins»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.