เผยแพร่เกม HTML แบบง่ายจากแอป AI ของคุณ
เผยแพร่ไฟล์ HTML ไฟล์เดียวที่ครบในตัวขนาดไม่เกิน 10 MiB ด้วย upload_game: อะไรใช้ได้ แคตตาล็อกขนาดย่อ การมองเห็น การอัปเดต และเมื่อไรควรเปลี่ยนเป็นแพ็กเกจ
เส้นทางแบบง่ายเผยแพร่เกม HTML มาตรฐานหนึ่งเกม เช่น เกมอาร์เคดบน canvas หรือเกมปริศนาแบบ DOM ด้วยการเรียก upload_game เพียงครั้งเดียว ไม่ต้องใช้ PlayDrop SDK ไม่ต้องมีโฟลเดอร์บิลด์ และไม่ต้องมีไฟล์เพิ่ม แล้วจะได้ลิงก์ที่ใครก็เปิดได้บนโทรศัพท์หรือคอมพิวเตอร์
เมื่อไรที่เส้นทางแบบง่ายเหมาะ
- ทั้งเกมเป็นไฟล์ HTML ไฟล์เดียวขนาดไม่เกิน 10 MiB (10,485,760 ไบต์ UTF-8) โดยมีสคริปต์ สไตล์ ภาพ และเสียงฝังอยู่ในไฟล์
- เป็นเกมบนเบราว์เซอร์ทั่วไป: ไม่เรียก PlayDrop SDK จึงไม่มีการบันทึกบนคลาวด์ ลีดเดอร์บอร์ด ความสำเร็จ การแชร์ ปาร์ตี้ การซื้อ หรือโฆษณา
- ไม่ต้องใช้ไฟล์แยก: ไม่มีภาพหรือวิดีโอของหน้าเกม และไม่มีเซิร์ฟเวอร์เกม
หากข้อใดไม่เป็นจริง ให้ใช้แพ็กเกจแทน คงฟีเจอร์ที่ผู้ใช้ของคุณขอไว้ ห้ามตัดฟีเจอร์ออกหรือยุบเกมหลายไฟล์ให้เป็นไฟล์เดียวเพื่อให้เข้ากับเส้นทางนี้เด็ดขาด การอัปโหลดจะปฏิเสธการเรียก SDK โค้ดเซิร์ฟเวอร์ และฟิลด์แคตตาล็อกที่ใช้ได้เฉพาะแพ็กเกจด้วย advanced_upload_required
ส่งเกม
เรียก upload_game ด้วย requestId ใหม่ HTML ฉบับสมบูรณ์ และแคตตาล็อกขนาดย่อสำหรับเกมหนึ่งเกม:
{
"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คือ slug ถาวรของเกม: ตัวอักษรพิมพ์เล็ก ตัวเลข หรือขีดกลาง 1–100 ตัวtagsต้องมีประเภทเกม เช่นgame-genre/casualดูประเภทเกมและแท็กtypesประกาศวิธีเล่น เกมไฟล์เดียวปกติเป็น["solo"]ขนาดปาร์ตี้และการเล่นออนไลน์ต้องใช้แพ็กเกจcontroller.supportระบุการรองรับคอนโทรลเลอร์ตามจริง รวมถึงoffauthModeกำหนดการเข้าสู่ระบบ:NONEหรือOPTIONALให้ใครก็เล่นได้ หากไม่ใส่จะใช้ค่าเริ่มต้นREQUIREDใส่ไว้ทุกครั้งที่อัปเดตprimarySurfaceระบุแนวหน้าจอที่เกมออกแบบมา การอัปโหลดแบบง่ายจะแสดงสำหรับคอมพิวเตอร์ แนวนอน และแนวตั้ง
ฟิลด์อื่นที่รับได้คือ subtitle, emoji, color, license, creation, releaseNotes, inspirationPrompt, makingOf, sourceRepository, sourceLocale, offlineSupported และ instant PlayDrop เป็นผู้กำหนดหมายเลขเวอร์ชัน
เลือกว่าใครเล่นได้
- ไม่ใส่
visibilityเพื่อใช้การตั้งค่าบัญชีของครีเอเตอร์สำหรับเกมใหม่ (สาธารณะ เว้นแต่ครีเอเตอร์เลือกไม่แสดงในรายการหรือส่วนตัวไว้) การอัปเดตจะคงกลุ่มผู้ชมปัจจุบันของเกมไว้ "private"บันทึกเวอร์ชันที่เฉพาะครีเอเตอร์เปิดได้ เพื่อทดสอบ เผยแพร่เวอร์ชันนั้นภายหลังด้วยpublish_game_versionไม่ต้องอัปโหลดอีกครั้ง"unlisted"เผยแพร่ให้ทุกคนที่มีลิงก์โดยไม่แสดงในรายการ ส่วน"public"เผยแพร่เพื่อให้ค้นพบได้
ทำตามที่ผู้ใช้ของคุณขอ และห้ามทำให้เกมมองเห็นได้กว้างกว่าที่ผู้ใช้ตั้งใจเด็ดขาด ดูใครเล่นได้บ้าง
อ่านใบยืนยัน
ใบยืนยันมี gameId, slug, version, status, visibility และ url ซึ่งเป็นลิงก์ของเวอร์ชันนั้นสำหรับเจ้าของ เกมสาธารณะและเกมที่ไม่แสดงในรายการจะได้ shareUrl ด้วย ซึ่งเป็นหน้าถาวรของเกม ให้ส่งลิงก์นั้นให้ผู้ใช้ของคุณ สำหรับเวอร์ชันส่วนตัว ให้ส่ง url กลับไป instant และ instantReason รายงานสิทธิ์การเป็นเกม Instant
อัปเดตเกม
เรียก list_games ส่ง gameId ของเกม และคง name ไว้ ส่ง HTML ฉบับสมบูรณ์และแคตตาล็อกขนาดย่อฉบับสมบูรณ์อีกครั้ง: การอัปโหลดแต่ละครั้งเป็นสแนปช็อตเต็ม และฟิลด์ที่ไม่ได้ใส่จะไม่มีในเวอร์ชันใหม่ ลิงก์ยังคงเดิม เกมที่อัปโหลดครั้งแรกเป็นแพ็กเกจต้องใช้เส้นทางแพ็กเกจต่อไป เพื่อไม่ให้ไฟล์และฟีเจอร์ของเกมหายไป
เปลี่ยนเป็นแพ็กเกจภายหลัง
การเพิ่มการบันทึกบนคลาวด์ ลีดเดอร์บอร์ด ภาพหน้าเกม หรือเซิร์ฟเวอร์ จะทำให้เกมกลายเป็นแพ็กเกจ นั่นเป็นการอัปเดตเกมเดิมตามปกติ: คง name ไว้ อัปโหลดด้วย prepare_catalogue_upload และตั้ง expectedCurrentVersion เป็นเวอร์ชันปัจจุบันจาก list_games อ่านการจัดแพ็กเกจ