winzik/docs/portail.md

38 lines
2.2 KiB
Markdown

# Les portails de jeux et le playground
**Le playground JumPHP** ([jumphp.net](https://jumphp.net), code : https://git.jumphp.net/jumphp/jumphp-playground) est un portail complet : annuaire
par catégorie, une page par jeu (son site `games/<id>/site/`), les jeux joués en mode distant
([remote.md](remote.md) : le moteur partagé téléchargé une fois, les fichiers du jeu un par un), les sources
navigables, un éditeur en ligne (brouillons, aperçu, push Git, fork). On s'y connecte avec Git ; un
projet est un dépôt Git public de l'utilisateur, publié à chaque push. Son serveur MCP laisse le Claude
local de l'utilisateur créer et publier un jeu (AGENTS.md §14).
Un portail plus simple peut aussi regrouper des builds classiques, comme ci-dessous.
Chaque build navigateur est un dossier statique autonome (`games/<jeu>/dist/web/`) avec un manifeste
`game.json` pour qu'un site puisse regrouper les jeux :
```json
{
"id": "pong", "title": "PONG", "version": "1.0.0", "description": "...",
"width": 320, "height": 180, "online": true, "lang": "en",
"net_url": "ws://localhost:8090/ws", "touch": {"a": "Return", "b": "Escape", "start": "Return"},
"thumbnail": "thumbnail.png", "controls": "Player 1: W / S...",
"engine": {"name": "JumPHP", "php": "8.3", "network": "<commit>"}, "built": "2026-10-27T16:34:00+00:00"
}
```
`thumbnail.png` / `icon.png` viennent de `assets/` du jeu s'ils existent.
## Intégration
- **Hébergement** : `bin/jumphp deploy <jeu>` vers `<racine>/<id>/` ; le portail lit `<id>/game.json`.
- **iframe** : `<iframe src="/jeux/pong/?net=wss://domaine/ws&lang=fr&back=https://portail/">`.
Paramètres d'URL : `net`, `room` (rejoindre une salle), `lang`, `debug`, `back` (où va « quitter »).
- **Messages vers le parent** (`window.parent.postMessage`) : `{type: 'jumphp:ready', game}` (le jeu
tourne), `{type: 'jumphp:quit', game}`, `{type: 'jumphp:bridge', game, message}` (messages personnalisés
du jeu : `$engine->bridge->send('score', ['value' => 1200])`).
- Le moteur (`php-web.wasm`) est identique pour tous les jeux : un portail peut le servir une fois, avec
un cache long (son empreinte est dans `version.json`).
- Salons en ligne : le relais expose `GET /health?rooms` (salles publiques) pour afficher « qui joue ».