Pubblica un gioco in HTML semplice dalla tua app di IA

• L’intero gioco è un solo file HTML di al massimo 10 MiB (10.485.760 byte UTF-8), con script, stili, immagini e suoni incorporati.
• È un normale gioco da browser: non chiama l’SDK di PlayDrop, quindi niente salvataggi cloud, classifiche, obiettivi, condivisione, gruppi, acquisti o annunci.
• Non richiede file separati: niente immagini o video della scheda e nessun server di gioco.

Se una di queste condizioni non è vera, usa invece un pacchetto. Mantieni le funzioni che il tuo utente ha chiesto; non rimuoverle mai e non fondere in un solo file un gioco composto da più file per farlo rientrare in questo percorso. Il caricamento rifiuta chiamate all’SDK, codice server e campi del catalogo riservati ai pacchetti con advanced_upload_required.

Chiama upload_game con un nuovo requestId, l’HTML completo e un mini catalogo per un solo gioco:

{
  "requestId": "moon-jump-first-upload",
  "html": "<!doctype html><html><head><meta charset=\"utf-8\"><title>Moon Jump</title></head><body>…</body></html>",
  "catalogue": {
    "apps": [{
      "name": "moon-jump",
      "displayName": "Moon Jump",
      "description": "Jump between lunar platforms and reach the flag.",
      "controls": "Tap or press Space to jump.",
      "tags": ["game-genre/casual"],
      "types": ["solo"],
      "controller": { "support": "off" },
      "authMode": "NONE",
      "primarySurface": "MOBILE_PORTRAIT"
    }]
  }
}

• name è lo slug permanente del gioco: da 1 a 100 lettere minuscole, cifre o trattini.
• tags deve includere un genere come game-genre/casual; vedi generi e tag.
• types dichiara come si gioca; un gioco in un solo file di solito è ["solo"]. Le dimensioni dei gruppi e il gioco online sono riservati ai pacchetti.
• controller.support indica il supporto reale ai controller, compreso off.
• authMode decide l’accesso: NONE o OPTIONAL permette a chiunque di giocare; se omesso, il valore predefinito è REQUIRED. Includilo a ogni aggiornamento.
• primarySurface indica l’orientamento per cui è pensato il gioco; i caricamenti semplici compaiono per desktop, orizzontale e verticale.

Gli altri campi accettati sono subtitle, emoji, color, license, creation, releaseNotes, inspirationPrompt, makingOf, sourceRepository, sourceLocale, offlineSupported e instant. PlayDrop assegna il numero di versione.

• Ometti visibility per seguire l’impostazione dell’account del creator per un nuovo gioco (Pubblico, a meno che non abbia scelto Non in elenco o Privato); un aggiornamento mantiene il pubblico attuale del gioco.
• "private" salva una versione che solo il creator può aprire, per i test. Pubblica in seguito quella stessa versione con publish_game_version; non caricarla di nuovo.
• "unlisted" la pubblica per chiunque abbia il link, senza farla comparire negli elenchi; "public" la pubblica perché possa essere scoperta.

Segui ciò che il tuo utente ha chiesto e non rendere mai un gioco più visibile di quanto volesse. Vedi chi può giocare.

La ricevuta include gameId, slug, version, status, visibility e url, il link della versione esatta per il proprietario. I giochi pubblici e non in elenco ricevono anche shareUrl, la pagina duratura del gioco; consegna quello al tuo utente. Per una versione privata, consegna url. instant e instantReason indicano l’idoneità a Instant.

Chiama list_games, passa il gameId del gioco e mantieni il suo name. Invia di nuovo l’HTML completo e il mini catalogo completo: ogni caricamento è un’istantanea completa, e i campi omessi mancano nella nuova versione. Il link resta lo stesso. Un gioco caricato la prima volta come pacchetto deve continuare a usare il percorso dei pacchetti, così i suoi file e le sue funzioni non vanno persi.

Aggiungere salvataggi cloud, una classifica, immagini della scheda o un server trasforma il gioco in un pacchetto. È un normale aggiornamento dello stesso gioco: mantieni il name, caricalo con prepare_catalogue_upload e imposta expectedCurrentVersion sulla versione attuale da list_games. Leggi pacchetti.