Terbitkan game HTML sederhana dari aplikasi AI Anda
Terbitkan satu berkas HTML mandiri hingga 10 MiB dengan upload_game: apa yang muat, katalog mini, visibilitas, pembaruan, dan kapan beralih ke paket.
Jalur sederhana menerbitkan satu game HTML standar, seperti game arkade canvas atau puzzle DOM, dengan satu panggilan upload_game. Jalur ini tidak memerlukan SDK PlayDrop, folder build, atau berkas tambahan, dan menghasilkan tautan yang bisa dibuka siapa saja di ponsel atau komputer.
Kapan jalur sederhana cocok
- Seluruh game adalah satu berkas HTML berukuran maksimal 10 MiB (10.485.760 byte UTF-8), dengan skrip, gaya, gambar, dan suaranya tersemat di dalamnya.
- Game ini adalah game browser biasa: tidak memanggil SDK PlayDrop, jadi tanpa simpanan cloud, papan peringkat, pencapaian, berbagi, grup, pembelian, atau iklan.
- Game tidak memerlukan berkas terpisah: tanpa gambar atau video listingan dan tanpa server game.
Jika salah satu poin ini tidak terpenuhi, gunakan paket. Pertahankan fitur yang diminta pengguna Anda; jangan pernah menghapusnya atau meratakan game multi-berkas agar muat di jalur ini. Unggahan menolak panggilan SDK, kode server, dan field katalog khusus paket dengan advanced_upload_required.
Kirim gamenya
Panggil upload_game dengan requestId baru, HTML lengkap, dan katalog mini untuk satu game:
{
"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"
}]
}
}nameadalah slug permanen game: 1–100 huruf kecil, angka, atau tanda hubung.tagsharus menyertakan genre sepertigame-genre/casual; lihat genre dan tag.typesmenyatakan cara game dimainkan; game satu berkas biasanya["solo"]. Ukuran grup dan permainan online hanya untuk paket.controller.supportmenyatakan dukungan pengontrol yang sebenarnya, termasukoff.authModemenentukan login:NONEatauOPTIONALmemungkinkan siapa saja bermain; jika tidak disertakan, default-nyaREQUIRED. Sertakan di setiap pembaruan.primarySurfacemenyebutkan orientasi yang menjadi rancangan game; unggahan sederhana dicantumkan untuk desktop, lanskap, dan potret.
Field lain yang diterima adalah subtitle, emoji, color, license, creation, releaseNotes, inspirationPrompt, makingOf, sourceRepository, sourceLocale, offlineSupported, dan instant. PlayDrop yang menetapkan nomor versi.
Pilih siapa yang bisa bermain
- Jangan sertakan
visibilityagar game baru mengikuti pengaturan akun kreator (Publik kecuali mereka memilih Tidak publik atau Pribadi); pembaruan mempertahankan audiens game saat ini. "private"menyimpan versi yang hanya bisa dibuka kreator, untuk pengujian. Terbitkan versi yang persis sama itu nanti denganpublish_game_version; jangan mengunggahnya lagi."unlisted"menerbitkannya untuk siapa saja yang punya tautan, tanpa mencantumkannya;"public"menerbitkannya agar bisa ditemukan.
Ikuti permintaan pengguna Anda dan jangan pernah membuat game lebih terlihat daripada yang mereka maksudkan. Lihat siapa yang bisa bermain.
Baca tanda terimanya
Tanda terima berisi gameId, slug, version, status, visibility, dan url, yaitu tautan versi tersebut untuk pemiliknya. Game publik dan tidak publik juga mendapatkan shareUrl, halaman game yang bertahan; berikan tautan itu kepada pengguna Anda. Untuk versi privat, berikan url. instant dan instantReason melaporkan kelayakan Instan.
Perbarui game
Panggil list_games, berikan gameId game, dan pertahankan name-nya. Kirim lagi HTML lengkap dan katalog mini lengkap: setiap unggahan adalah snapshot lengkap, dan field yang tidak disertakan tidak ada di versi baru. Tautannya tetap sama. Game yang pertama kali diunggah sebagai paket harus tetap memakai jalur paket, agar berkas dan fiturnya tidak hilang.
Beralih ke paket nanti
Menambahkan simpanan cloud, papan peringkat, gambar listingan, atau server mengubah game menjadi paket. Itu adalah pembaruan biasa untuk game yang sama: pertahankan name, unggah dengan prepare_catalogue_upload, dan tetapkan expectedCurrentVersion ke versi saat ini dari list_games. Baca pengemasan.