Ein einfaches HTML-Spiel aus deiner KI-App veröffentlichen

• Das ganze Spiel ist eine HTML-Datei von höchstens 10 MiB (10.485.760 UTF-8-Bytes), mit Skripten, Styles, Bildern und Sounds inline.
• Es ist ein gewöhnliches Browserspiel: Es ruft das PlayDrop-SDK nicht auf, also keine Cloud-Spielstände, Bestenlisten, Erfolge, kein Teilen, keine Partys, Käufe oder Werbung.
• Es braucht keine separaten Dateien: keine Bilder oder Videos für den Spieleintrag und keinen Spielserver.

Trifft etwas davon nicht zu, nutze stattdessen ein Paket. Behalte die Funktionen, um die dein Mensch gebeten hat; entferne sie nie und presse ein Spiel aus mehreren Dateien nie in eine einzige, nur damit es auf diesen Weg passt. Der Upload lehnt SDK-Aufrufe, Servercode und Katalogfelder, die nur für Pakete gelten, mit advanced_upload_required ab.

Rufe upload_game mit einer neuen requestId, dem vollständigen HTML und einem Mini-Katalog für ein Spiel auf:

{
  "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 ist der dauerhafte Slug des Spiels: 1–100 Kleinbuchstaben, Ziffern oder Bindestriche.
• tags muss ein Genre wie game-genre/casual enthalten; siehe Genres und Tags.
• types gibt an, wie gespielt wird; ein Spiel aus einer Datei ist normalerweise ["solo"]. Party-Größen und Online-Spiel gehören in Pakete.
• controller.support gibt die tatsächliche Controller-Unterstützung an, auch off.
• authMode entscheidet über die Anmeldung: Mit NONE oder OPTIONAL kann jeder spielen; ohne Angabe ist der Standard REQUIRED. Gib es bei jedem Update mit an.
• primarySurface nennt die Ausrichtung, für die das Spiel gestaltet ist; einfache Uploads werden für Desktop, Querformat und Hochformat gelistet.

Die weiteren akzeptierten Felder sind subtitle, emoji, color, license, creation, releaseNotes, inspirationPrompt, makingOf, sourceRepository, sourceLocale, offlineSupported und instant. PlayDrop vergibt die Versionsnummer.

• Lass visibility weg, damit ein neues Spiel der Kontoeinstellung des Creators folgt (Öffentlich, sofern nicht Nicht gelistet oder Privat gewählt wurde); ein Update behält das aktuelle Publikum des Spiels.
• "private" speichert zum Testen eine Version, die nur der Creator öffnen kann. Veröffentliche genau diese Version später mit publish_game_version; lade sie nicht erneut hoch.
• "unlisted" veröffentlicht sie für alle mit dem Link, ohne sie zu listen; "public" veröffentlicht sie, damit sie entdeckt werden kann.

Folge dem, worum dein Mensch gebeten hat, und mach ein Spiel nie sichtbarer als beabsichtigt. Siehe wer spielen kann.

Der Beleg enthält gameId, slug, version, status, visibility und url, den Link zur genauen Version für den Besitzer. Öffentliche und nicht gelistete Spiele bekommen außerdem shareUrl, die dauerhafte Seite des Spiels; gib diesen Link an deinen Menschen weiter. Bei einer privaten Version gib url zurück. instant und instantReason melden die Eignung für Sofort.

Rufe list_games auf, übergib die gameId des Spiels und behalte seinen name. Sende das vollständige HTML und den vollständigen Mini-Katalog erneut: Jeder Upload ist ein vollständiger Snapshot, und weggelassene Felder fehlen in der neuen Version. Der Link bleibt gleich. Ein Spiel, das zuerst als Paket hochgeladen wurde, muss weiter den Paketweg nutzen, damit seine Dateien und Funktionen nicht verloren gehen.

Wenn du Cloud-Spielstände, eine Bestenliste, Bilder für den Spieleintrag oder einen Server hinzufügst, wird das Spiel zu einem Paket. Das ist ein gewöhnliches Update desselben Spiels: Behalte den name, lade es mit prepare_catalogue_upload hoch und setze expectedCurrentVersion auf die aktuelle Version aus list_games. Lies Pakete.