เอกสารอ้างอิง

ข้อผิดพลาดในการอัปโหลดผ่าน MCP ของ PlayDrop และวิธีกู้คืน

รูปแบบข้อผิดพลาดที่เครื่องมือ MCP ของ PlayDrop ส่งคืน เมื่อไรควรลองใหม่ด้วย requestId เดิม และวิธีแก้รหัสข้อผิดพลาดที่พบบ่อย

ข้อผิดพลาดทุกรายการจากเครื่องมือ MCP ของ PlayDrop จะคงรหัส error ที่ไม่เปลี่ยนแปลงและรายละเอียดต่างๆ เช่น path, field, name หรือ expected ไว้ และเพิ่ม:

message: อะไรผิดพลาด เป็นภาษาที่เข้าใจง่าย
retryable: เป็น true เฉพาะเมื่อการเรียกแบบเดิมทุกประการอาจสำเร็จในภายหลัง
nextAction: วิธีแก้ไขที่ชัดเจน
docsUrl และ documentationTopic: คู่มือที่ควรอ่าน ซึ่งเปิดได้ด้วย get_documentation เช่นกัน

ลองใหม่หรือแก้ไข

ข้อผิดพลาดที่ลองใหม่ได้ (ความล้มเหลวชั่วคราว การจำกัดอัตรา ขั้นตอนทำการอัปโหลดให้เสร็จที่ถูกขัดจังหวะ): รอสักครู่แล้วลองเรียกแบบเดิมทุกประการด้วย requestId เดิม อย่าสร้างเวอร์ชันใหม่
ไม่ได้รับคำตอบ: คุณไม่รู้ว่าสำเร็จหรือไม่ จึงให้ลองส่งเนื้อหาเดิมทุกประการด้วย requestId เดิม PlayDrop จะส่งคืนผลลัพธ์เดิมแทนที่จะเผยแพร่ซ้ำสองครั้ง
ข้อมูลถูกปฏิเสธ: แก้ฟิลด์หรือไฟล์ที่ระบุก่อน เนื้อหาที่เปลี่ยนแล้วต้องใช้ requestId ใหม่ การลองใหม่ด้วยข้อมูลที่ไม่เปลี่ยนจะล้มเหลวอีก
ผลลัพธ์ของแพ็กเกจที่สำเร็จบางส่วน: รายการที่เสร็จแล้วยังคงเผยแพร่อยู่ คำขอที่แก้ไขแล้วควรมีเฉพาะงานที่ยังไม่เสร็จ
send_feedback ไม่มีคีย์สำหรับลองใหม่ หลังความล้มเหลวที่ไม่ชัดเจน อย่าส่งซ้ำโดยอัตโนมัติ: ข้อความแรกอาจส่งถึงแล้ว

ข้อผิดพลาดที่พบบ่อย

รหัส	สิ่งที่ต้องทำ
`advanced_upload_required`	เกมใช้ SDK เซิร์ฟเวอร์ ไฟล์แยก หรือฟิลด์ที่ใช้ได้เฉพาะแพ็กเกจ คงฟีเจอร์เหล่านั้นไว้และอัปโหลดเป็นแพ็กเกจด้วย `requestId` ใหม่
`invalid_html_file`	HTML ว่างเปล่าหรือใหญ่กว่า 10 MiB ใช้แพ็กเกจสำหรับเกมที่ใหญ่กว่านี้
`visibility_required`	แอปในแพ็กเกจไม่มีการมองเห็น ตั้ง `visibility` ในคำขอหรือในแอป: `public`, `unlisted` หรือ `private`
`invalid_visibility`	ใช้ `public`, `unlisted` หรือ `private`
`visibility_conflict`	คำขอและรายการแอปขอการมองเห็นต่างกัน ระบุเพียงค่าเดียว เพื่อไม่ให้กลุ่มผู้ชมถูกเปลี่ยนโดยไม่รู้ตัว
`expected_current_version_required`	เพิ่มชื่อของทุกแอปลงใน `expectedCurrentVersion`: `null` สำหรับเกมใหม่ หรือเวอร์ชันปัจจุบันจาก `list_games`
`current_version_changed`	มีคนเผยแพร่เวอร์ชันที่ใหม่กว่าแล้ว เรียก `list_games` ยืนยันเกมเป้าหมายกับผู้ใช้ของคุณ แล้วอัปโหลดด้วยเวอร์ชันปัจจุบันและ `requestId` ใหม่
`game_exists_use_id`, `game_not_found`	เรียก `list_games` ใช้ `gameId` หรือชื่อที่ถูกต้อง และคงชื่อเดิมของเกมไว้
`request_id_content_conflict`	`requestId` นี้เป็นของเนื้อหาอื่นแล้ว ใช้ ID ใหม่ หรือส่งเนื้อหาเดิมซ้ำโดยไม่เปลี่ยนแปลง
`catalogue_file_missing_or_invalid`	มีไฟล์ที่ยังไม่ได้อัปโหลดหรือไบต์ไม่ตรงกัน เรียก `prepare_catalogue_upload` อีกครั้งด้วยข้อมูลเดิมทุกประการและ `requestId` เดิม PUT ไฟล์ที่ขาด แล้วเรียกขั้นตอนทำให้เสร็จอีกครั้ง
`catalogue_files_unclaimed`	มีไฟล์ที่ไม่ได้ใช้ในรายการแคตตาล็อกใดเลย ให้อ้างอิงไฟล์เหล่านั้น กำหนด `role: "LISTING"` และ `app` ให้ไฟล์ของหน้าเกม หรือลบออก
`entry_point_missing`	`apps[].file` ระบุไฟล์ที่ไม่ได้อัปโหลด หากไม่มี `file` รายการจะใช้ค่าเริ่มต้นเป็น `<name>.html`
`archive_catalogue_required`	วาง catalogue.json ไว้ที่รากของ ZIP ไม่ใช่ในโฟลเดอร์
`archive_too_large`	หากใหญ่กว่า 20 MiB เมื่อบีบอัด: แตกไฟล์แล้วอัปโหลดเป็นโฟลเดอร์ทีละไฟล์ผ่าน URL แบบมีลายเซ็น ซึ่งรองรับได้สูงสุด 50 MiB ต่อไฟล์ หากใหญ่กว่า 200 MiB เมื่อแตกไฟล์: ตัวเกมใหญ่เกินไปสำหรับหนึ่งเวอร์ชัน ให้บีบอัดหรือลบแอสเซ็ตออก
`procedural_module_validation_unavailable`	โมเดล 3D แบบโพรซีเจอรัลหรือแบบรูปแบบที่กำหนดเองที่รันโค้ดได้ อัปโหลดผ่าน MCP ไม่ได้ ให้แปลงเป็นไฟล์สำเร็จรูปหรืออ้างอิงแอสเซ็ตที่เผยแพร่แล้ว
`upload_expired`, `upload_cancelled`	เตรียมการอัปโหลดอีกครั้งด้วย `requestId` ใหม่ และทำให้เสร็จภายใน 30 นาที
`invalid_token`, `insufficient_scope`	เชื่อมต่อบัญชี PlayDrop ในแอป AI ของคุณอีกครั้งและอนุญาตการเผยแพร่

ข้อผิดพลาดของฟิลด์ในแคตตาล็อก เช่น แท็กไม่ถูกต้อง การประกาศคอนโทรลเลอร์ หรือโหมดผู้เล่น จะชี้ไปที่เอกสารอ้างอิง catalogue.json

การเชื่อมต่อและไฟล์แนบ

การเชื่อมต่อหมดอายุ: การเชื่อมต่อที่ใช้งานอยู่จะต่ออายุเองระหว่างใช้งาน การเชื่อมต่อที่ไม่ได้ใช้ 30 วัน หรือที่หมดอายุไปก่อนมีกฎนี้ ต้องเชื่อมต่อใหม่
ไฟล์แนบถูกปฏิเสธ: PlayDrop ดาวน์โหลดไฟล์เฉพาะจากบริการไฟล์แนบของโฮสต์เองเท่านั้น นี่เป็นข้อจำกัดของผู้ให้บริการไฟล์ ไม่ใช่ข้อจำกัดตามประเทศ ส่งไฟล์แนบที่โฮสต์ระบุไว้ หรืออัปโหลดไฟล์ด้วย URL แบบมีลายเซ็น ห้ามแต่ง download_url หรือ file_id ขึ้นเองเด็ดขาด

รายงานปัญหา

หากข้อผิดพลาดดูไม่ถูกต้อง หรือขั้นตอนถัดไปที่แนะนำใช้ไม่ได้ ให้เรียก send_feedback หนึ่งครั้ง พร้อมชื่อเครื่องมือ รหัสข้อผิดพลาด สิ่งที่คุณส่ง (ไม่รวมโทเค็นหรือ URL แบบมีลายเซ็น) และสิ่งที่คุณคาดไว้

เอกสารอ้างอิง

ข้อผิดพลาดในการอัปโหลดผ่าน MCP ของ PlayDrop และวิธีกู้คืน

message: อะไรผิดพลาด เป็นภาษาที่เข้าใจง่าย
retryable: เป็น true เฉพาะเมื่อการเรียกแบบเดิมทุกประการอาจสำเร็จในภายหลัง
nextAction: วิธีแก้ไขที่ชัดเจน
docsUrl และ documentationTopic: คู่มือที่ควรอ่าน ซึ่งเปิดได้ด้วย get_documentation เช่นกัน

ลองใหม่หรือแก้ไข

ข้อผิดพลาดที่ลองใหม่ได้ (ความล้มเหลวชั่วคราว การจำกัดอัตรา ขั้นตอนทำการอัปโหลดให้เสร็จที่ถูกขัดจังหวะ): รอสักครู่แล้วลองเรียกแบบเดิมทุกประการด้วย requestId เดิม อย่าสร้างเวอร์ชันใหม่
ไม่ได้รับคำตอบ: คุณไม่รู้ว่าสำเร็จหรือไม่ จึงให้ลองส่งเนื้อหาเดิมทุกประการด้วย requestId เดิม PlayDrop จะส่งคืนผลลัพธ์เดิมแทนที่จะเผยแพร่ซ้ำสองครั้ง
ข้อมูลถูกปฏิเสธ: แก้ฟิลด์หรือไฟล์ที่ระบุก่อน เนื้อหาที่เปลี่ยนแล้วต้องใช้ requestId ใหม่ การลองใหม่ด้วยข้อมูลที่ไม่เปลี่ยนจะล้มเหลวอีก
ผลลัพธ์ของแพ็กเกจที่สำเร็จบางส่วน: รายการที่เสร็จแล้วยังคงเผยแพร่อยู่ คำขอที่แก้ไขแล้วควรมีเฉพาะงานที่ยังไม่เสร็จ
send_feedback ไม่มีคีย์สำหรับลองใหม่ หลังความล้มเหลวที่ไม่ชัดเจน อย่าส่งซ้ำโดยอัตโนมัติ: ข้อความแรกอาจส่งถึงแล้ว

ข้อผิดพลาดที่พบบ่อย

รหัส	สิ่งที่ต้องทำ
`advanced_upload_required`	เกมใช้ SDK เซิร์ฟเวอร์ ไฟล์แยก หรือฟิลด์ที่ใช้ได้เฉพาะแพ็กเกจ คงฟีเจอร์เหล่านั้นไว้และอัปโหลดเป็นแพ็กเกจด้วย `requestId` ใหม่
`invalid_html_file`	HTML ว่างเปล่าหรือใหญ่กว่า 10 MiB ใช้แพ็กเกจสำหรับเกมที่ใหญ่กว่านี้
`visibility_required`	แอปในแพ็กเกจไม่มีการมองเห็น ตั้ง `visibility` ในคำขอหรือในแอป: `public`, `unlisted` หรือ `private`
`invalid_visibility`	ใช้ `public`, `unlisted` หรือ `private`
`visibility_conflict`	คำขอและรายการแอปขอการมองเห็นต่างกัน ระบุเพียงค่าเดียว เพื่อไม่ให้กลุ่มผู้ชมถูกเปลี่ยนโดยไม่รู้ตัว
`expected_current_version_required`	เพิ่มชื่อของทุกแอปลงใน `expectedCurrentVersion`: `null` สำหรับเกมใหม่ หรือเวอร์ชันปัจจุบันจาก `list_games`
`current_version_changed`	มีคนเผยแพร่เวอร์ชันที่ใหม่กว่าแล้ว เรียก `list_games` ยืนยันเกมเป้าหมายกับผู้ใช้ของคุณ แล้วอัปโหลดด้วยเวอร์ชันปัจจุบันและ `requestId` ใหม่
`game_exists_use_id`, `game_not_found`	เรียก `list_games` ใช้ `gameId` หรือชื่อที่ถูกต้อง และคงชื่อเดิมของเกมไว้
`request_id_content_conflict`	`requestId` นี้เป็นของเนื้อหาอื่นแล้ว ใช้ ID ใหม่ หรือส่งเนื้อหาเดิมซ้ำโดยไม่เปลี่ยนแปลง
`catalogue_file_missing_or_invalid`	มีไฟล์ที่ยังไม่ได้อัปโหลดหรือไบต์ไม่ตรงกัน เรียก `prepare_catalogue_upload` อีกครั้งด้วยข้อมูลเดิมทุกประการและ `requestId` เดิม PUT ไฟล์ที่ขาด แล้วเรียกขั้นตอนทำให้เสร็จอีกครั้ง
`catalogue_files_unclaimed`	มีไฟล์ที่ไม่ได้ใช้ในรายการแคตตาล็อกใดเลย ให้อ้างอิงไฟล์เหล่านั้น กำหนด `role: "LISTING"` และ `app` ให้ไฟล์ของหน้าเกม หรือลบออก
`entry_point_missing`	`apps[].file` ระบุไฟล์ที่ไม่ได้อัปโหลด หากไม่มี `file` รายการจะใช้ค่าเริ่มต้นเป็น `<name>.html`
`archive_catalogue_required`	วาง catalogue.json ไว้ที่รากของ ZIP ไม่ใช่ในโฟลเดอร์
`archive_too_large`	หากใหญ่กว่า 20 MiB เมื่อบีบอัด: แตกไฟล์แล้วอัปโหลดเป็นโฟลเดอร์ทีละไฟล์ผ่าน URL แบบมีลายเซ็น ซึ่งรองรับได้สูงสุด 50 MiB ต่อไฟล์ หากใหญ่กว่า 200 MiB เมื่อแตกไฟล์: ตัวเกมใหญ่เกินไปสำหรับหนึ่งเวอร์ชัน ให้บีบอัดหรือลบแอสเซ็ตออก
`procedural_module_validation_unavailable`	โมเดล 3D แบบโพรซีเจอรัลหรือแบบรูปแบบที่กำหนดเองที่รันโค้ดได้ อัปโหลดผ่าน MCP ไม่ได้ ให้แปลงเป็นไฟล์สำเร็จรูปหรืออ้างอิงแอสเซ็ตที่เผยแพร่แล้ว
`upload_expired`, `upload_cancelled`	เตรียมการอัปโหลดอีกครั้งด้วย `requestId` ใหม่ และทำให้เสร็จภายใน 30 นาที
`invalid_token`, `insufficient_scope`	เชื่อมต่อบัญชี PlayDrop ในแอป AI ของคุณอีกครั้งและอนุญาตการเผยแพร่

การเชื่อมต่อและไฟล์แนบ

การเชื่อมต่อหมดอายุ: การเชื่อมต่อที่ใช้งานอยู่จะต่ออายุเองระหว่างใช้งาน การเชื่อมต่อที่ไม่ได้ใช้ 30 วัน หรือที่หมดอายุไปก่อนมีกฎนี้ ต้องเชื่อมต่อใหม่
ไฟล์แนบถูกปฏิเสธ: PlayDrop ดาวน์โหลดไฟล์เฉพาะจากบริการไฟล์แนบของโฮสต์เองเท่านั้น นี่เป็นข้อจำกัดของผู้ให้บริการไฟล์ ไม่ใช่ข้อจำกัดตามประเทศ ส่งไฟล์แนบที่โฮสต์ระบุไว้ หรืออัปโหลดไฟล์ด้วย URL แบบมีลายเซ็น ห้ามแต่ง download_url หรือ file_id ขึ้นเองเด็ดขาด