Publiser et enkelt HTML-spill fra KI-appen din
Publiser én selvstendig HTML-fil på opptil 10 MiB med upload_game: hva som passer, minikatalogen, synlighet, oppdateringer og når du bør bytte til en pakke.
Den enkle veien publiserer ett vanlig HTML-spill, for eksempel et arkadespill på canvas eller et DOM-puslespill, med ett enkelt upload_game-kall. Den trenger ingen PlayDrop-SDK, ingen build-mappe og ingen ekstra filer, og den returnerer en lenke som hvem som helst kan åpne på telefon eller datamaskin.
Når den enkle veien passer
- Hele spillet er én HTML-fil på høyst 10 MiB (10 485 760 UTF-8-byte), med skript, stiler, bilder og lyder lagt inn i filen.
- Det er et vanlig nettleserspill: det kaller ikke PlayDrop-SDK-en, så ingen skylagring, topplister, prestasjoner, deling, grupper, kjøp eller annonser.
- Det trenger ingen separate filer: ingen oppføringsbilder eller -videoer og ingen spillserver.
Hvis noe av dette ikke stemmer, bruker du en pakke i stedet. Behold funksjonene brukeren din ba om; fjern dem aldri, og slå aldri sammen et spill med flere filer for å få det til å passe denne veien. Opplastingen avviser SDK-kall, serverkode og katalogfelt som bare finnes i pakker, med advanced_upload_required.
Send spillet
Kall upload_game med en ny requestId, hele HTML-koden og en minikatalog for ett spill:
{
"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"
}]
}
}nameer spillets permanente slug: 1–100 små bokstaver, sifre eller bindestreker.tagsmå inneholde en sjanger, somgame-genre/casual; se sjangre og tagger.typesdeklarerer hvordan spillet spilles; et spill i én fil er vanligvis["solo"]. Gruppestørrelser og spill over nett hører til pakker.controller.supportoppgir reell kontrollerstøtte, inkludertoff.authModebestemmer innlogging:NONEellerOPTIONALlar alle spille; hvis feltet utelates, er standardenREQUIRED. Ta det med i hver oppdatering.primarySurfaceangir retningen spillet er laget for; enkle opplastinger oppføres for datamaskin, liggende og stående format.
De andre godtatte feltene er subtitle, emoji, color, license, creation, releaseNotes, inspirationPrompt, makingOf, sourceRepository, sourceLocale, offlineSupported og instant. PlayDrop tildeler versjonsnummeret.
Velg hvem som kan spille
- Utelat
visibilityfor å følge skaperens kontoinnstilling for et nytt spill (Offentlig med mindre skaperen har valgt Ikke oppført eller Privat); en oppdatering beholder spillets nåværende publikum. "private"lagrer en versjon bare skaperen kan åpne, for testing. Publiser akkurat den versjonen senere medpublish_game_version; ikke last den opp på nytt."unlisted"publiserer den for alle med lenken, uten å oppføre den;"public"publiserer den slik at den kan oppdages.
Følg det brukeren din ba om, og gjør aldri et spill mer synlig enn brukeren hadde tenkt. Se hvem som kan spille.
Les kvitteringen
Kvitteringen inneholder gameId, slug, version, status, visibility og url, lenken til akkurat denne versjonen for eieren. Offentlige og ikke oppførte spill får også shareUrl, spillets varige side; gi den til brukeren din. For en privat versjon gir du tilbake url. instant og instantReason rapporterer om spillet kvalifiserer som Instant.
Oppdater spillet
Kall list_games, send med spillets gameId og behold name. Send hele HTML-koden og hele minikatalogen på nytt: hver opplasting er et fullstendig øyeblikksbilde, og felt som utelates, mangler i den nye versjonen. Lenken forblir den samme. Et spill som først ble lastet opp som pakke, må fortsette å bruke pakkeveien, slik at filene og funksjonene ikke går tapt.
Bytt til en pakke senere
Når du legger til skylagring, en toppliste, oppføringsbilder eller en server, blir spillet en pakke. Det er en vanlig oppdatering av det samme spillet: behold name, last det opp med prepare_catalogue_upload og sett expectedCurrentVersion til den nåværende versjonen fra list_games. Les pakking.