ใช้รายการตรวจสอบนี้เพื่อให้แน่ใจว่าเกมเป็นไปตามข้อกำหนดและแนวทางปฏิบัติแนะนำทั้งหมดก่อนส่งเข้ารับการตรวจสอบใน Google Play Games บน PC
ตั้งค่าและกำหนดค่าโปรเจ็กต์
- ดาวน์โหลดและนำเข้า SDK: ผสานรวม SDK เวอร์ชันล่าสุดของ Play Games บน PC สำหรับสภาพแวดล้อมของคุณ ดูข้อมูลเพิ่มเติมได้ที่คู่มือ Unity หรือคู่มือ C++
- สร้างไฟล์ Manifest ของแอปพลิเคชัน: สร้างไฟล์
manifest.xmlที่แมป<PackageName>กับแพ็กเกจ Play Console ที่อ้างสิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่คู่มือไฟล์ Manifest - รับรองไฟล์ปฏิบัติการแบบดิจิทัล: รับรองเกมโดยใช้ลายเซ็นดิจิทัล Authenticode และปกป้องใบรับรองสำหรับการอัปเดตทั้งหมดในอนาคต แม้ว่าคุณจะข้ามขั้นตอนนี้ได้ในระหว่างการพัฒนาในเครื่องโดยเปิดใช้โหมดนักพัฒนาซอฟต์แวร์ แต่คุณต้องรับรองไบนารีขั้นสุดท้ายด้วยใบรับรองเวอร์ชันที่ใช้งานจริงจากผู้ออกใบรับรองที่รู้จัก ดูข้อมูลเพิ่มเติมได้ที่ลงนามเกมแบบดิจิทัล
- จัดรูปแบบและส่งใบรับรอง: ส่งข้อมูลใบรับรองไปยังตัวแทนของ Google ไฟล์ใบรับรองควรมีเฉพาะข้อมูลที่เกี่ยวข้องกับใบรับรองเท่านั้น โปรดตรวจสอบว่าได้นำบล็อกที่ไม่ใช่ใบรับรองออกทั้งหมดแล้ว คุณสามารถใช้ OpenSSL เพื่อแปลงไฟล์ DER/CER เป็นรูปแบบ PEM ที่จำเป็นได้
ผสานรวม API และฟีเจอร์
- เริ่มต้น SDK: ใช้ตรรกะการเริ่มต้น SDK เช่น
InitializeAsyncระหว่างการเริ่มต้นก่อนที่จะใช้ฟีเจอร์อื่นๆ ดูข้อมูลเพิ่มเติมได้ในคู่มือการเริ่มต้นใช้งาน - ใช้การลงชื่อเข้าใช้ที่ราบรื่น: ตรวจสอบสิทธิ์ผู้เล่นโดยอัตโนมัติโดยใช้บัญชีไคลเอ็นต์ Play Games ผ่าน Recall API ดูข้อมูลเพิ่มเติมได้ที่คู่มือการลงชื่อเข้าใช้ที่ราบรื่น
- ผสานรวม Play Integrity: ใช้
IntegrityClientเพื่อขอโทเค็นและยืนยันความถูกต้องของเซสชันเกมในแบ็กเอนด์ ดูข้อมูลเพิ่มเติมได้ในคู่มือ Play Integrity - เพิ่ม Play Install Referrer: ผสานรวม Install Referrer API หากคุณต้องการติดตามแหล่งที่มาของการได้ผู้ใช้ใหม่สำหรับ PC ดูข้อมูลเพิ่มเติมได้ในคู่มือ Install Referrer
- จัดการข้อผิดพลาดในการเริ่มต้น: หากต้องการใช้ SDK ให้เรียกใช้
GooglePlayInitialize(C++) หรือGooglePlayInitialization.InitializeAsync(C#) เพื่อเริ่มต้น API คุณต้องเรียกใช้เมธอดนี้และยืนยันว่า Callback ต่อเนื่องเสร็จสมบูรณ์ด้วยInitializeResult::ok()(C++) หรือResult.IsOk(C#) แสดงผลtrueก่อนจึงจะใช้ API อื่นๆ ได้ - จัดการการปิดระบบที่จำเป็น: จัดการ
kActionRequiredShutdownClientProcessโดยปิดกระบวนการของไคลเอ็นต์โดยเร็วที่สุด - จัดการข้อกำหนดในการติดตั้ง Google Play Games: จัดการ
kSdkRuntimeUnavailableโดยแจ้งให้ผู้ใช้ทราบว่าต้องติดตั้ง Google Play Games และรันไทม์ SDK เพื่อดำเนินการต่อ - จัดการการอัปเดต Google Play Games: จัดการ
kSdkRuntimeUpdateRequiredโดยแจ้งให้ผู้ใช้ทราบว่าต้องอัปเดตรันไทม์ของ Google Play Games
ติดตั้งใช้งาน Google Play Billing
- ตรวจสอบประเภทการซื้อ: ยืนยันว่าเกมของคุณใช้เฉพาะการซื้อในแอป เนื่องจากระบบไม่รองรับการชำระเงินตามรอบและการสมัครใช้บริการ ดูข้อมูลเพิ่มเติมได้ที่คำถามที่พบบ่อยเกี่ยวกับการเรียกเก็บเงิน
- ค้นหารายละเอียดสินค้า: ใช้
QueryProductDetailsเพื่อดึงข้อมูลร้านค้าที่แปลแล้ว หากมีสินค้ามากกว่า 50 รายการ ให้แบ่งคำขอออกเป็นการเรียกหลายครั้ง ดูข้อมูลเพิ่มเติมได้ในคู่มือการค้นหาผลิตภัณฑ์ - เปิดขั้นตอนการซื้อ: ใช้
LaunchPurchaseFlowเพื่อประมวลผลธุรกรรมในแอป ข้อผิดพลาดเกี่ยวกับระยะหมดเวลา 5 นาทีจะเกิดขึ้นหากคุณปิดเบราว์เซอร์การชำระเงินโดยไม่ได้ชำระเงิน ดูข้อมูลเพิ่มเติมได้ที่คู่มือขั้นตอนการซื้อ - กู้คืนการซื้อที่มีอยู่: เรียกใช้
QueryPurchasesเมื่อเริ่มต้นระบบและเมื่อแอปทำงานอยู่เบื้องหน้าเพื่อตรวจหาการซื้อข้ามอุปกรณ์ที่ยังไม่ได้รับทราบ ดูข้อมูลเพิ่มเติมได้ในคู่มือการกู้คืนการซื้อ - การประมวลผลแบ็กเอนด์ที่ปลอดภัย: ตรวจสอบ
purchaseTokenในแบ็กเอนด์ก่อนให้สิทธิ์และสรุปด้วยAcknowledgePurchaseหรือConsumePurchaseดูข้อมูลเพิ่มเติมได้ที่คู่มือการประมวลผลที่ปลอดภัย - พิจารณาความล่าช้าในการเผยแพร่คีย์การอนุญาตให้ใช้สิทธิ: เมื่อกำหนดค่าคีย์การเรียกเก็บเงินหรือคีย์การอนุญาตให้ใช้สิทธิใหม่ใน Play Console โปรดรอหลายชั่วโมงเพื่อให้แคชแบ็กเอนด์ซิงค์ข้อมูลในสภาพแวดล้อมการแสดงโฆษณาเชิงพาณิชย์ก่อนที่จะทำการทดสอบการซื้อแบบเรียลไทม์ การพยายามซื้อก่อนที่การซิงค์จะเสร็จสมบูรณ์จะแสดงรหัสข้อผิดพลาด 6
ทดสอบในโหมดนักพัฒนาซอฟต์แวร์และดำเนินการ QA ก่อนการเปิดตัว
- ทดสอบในโหมดนักพัฒนาซอฟต์แวร์: เพิ่ม
<IsDeveloperMode>true</IsDeveloperMode>ลงในไฟล์ Manifest และกำหนดค่า GUID ของพาร์ทเนอร์ทดลองใช้ก่อนเปิดตัวสำหรับการทดสอบสภาพแวดล้อมในการพัฒนาซอฟต์แวร์แบบรวม (IDE) ในเครื่อง หากไม่มี GUID ของพาร์ทเนอร์ทดลองใช้ก่อนเปิดตัว โปรดกรอกแบบฟอร์มแสดงความสนใจ - จัดการการซื้อในโหมดนักพัฒนาซอฟต์แวร์: เมื่อทดสอบการซื้อในโหมดนักพัฒนาซอฟต์แวร์ ให้ใช้การซื้อภายใน 3 นาทีเพื่อป้องกันไม่ให้ระบบคืนเงินโดยอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่คำถามที่พบบ่อยเกี่ยวกับการทดสอบ
- นำโหมดนักพัฒนาซอฟต์แวร์ออก: คุณต้องนำแท็ก
<IsDeveloperMode>ออกก่อนที่จะแพ็กเกจบิลด์ที่เผยแพร่โดยเร็วที่สุด ดูข้อมูลเพิ่มเติมได้ที่คู่มือโหมดนักพัฒนาซอฟต์แวร์ - ส่งต่ออาร์กิวเมนต์โดยใช้ Launcher ของบุคคลที่สาม: ส่งอาร์กิวเมนต์บรรทัดคำสั่งที่ไม่รู้จักทั้งหมดที่ Launcher ได้รับจากไคลเอ็นต์ Google Play Games ไปยังกระบวนการเกมที่สร้างขึ้นโดยตรง ดูข้อมูลเพิ่มเติมได้ที่คู่มือการทำงานแบบหลายกระบวนการ
- ทดสอบด้วย VPN: หากคุณทดสอบจากภูมิภาคที่ไม่รองรับ ให้ใช้ VPN ที่เปิดใช้โหมด TUN เพื่อรับที่อยู่ IP ที่รองรับ ดูข้อมูลเพิ่มเติมได้ที่คำถามที่พบบ่อยเกี่ยวกับการทดสอบ VPN
- รองรับทางลัดบนเดสก์ท็อป: ดูคำถามที่พบบ่อยเกี่ยวกับทางลัดสำหรับการเรียกใช้ทางลัดเพื่อให้รองรับทางลัดได้อย่างราบรื่น การเปิดเกมหรือตัวเปิดใช้ของบุคคลที่สามโดยตรงโดยใช้ทางลัดอาจทำให้เกิดข้อผิดพลาดในการเริ่มต้น
จัดแพ็กเกจ ทดสอบ และเผยแพร่เกม
- จัดแพ็กเกจ WAB: ใช้ Play Publishing Tool เพื่อจัดแพ็กเกจเกมเป็น App Bundle ของ Windows (WAB) ไฟล์ WAB ต้องมีขนาดไม่เกิน 10 GB สำหรับการเผยแพร่ผ่านโปรแกรมติดตั้ง และไม่เกิน 200 GB สำหรับการเผยแพร่ที่จัดการของ Play ดูข้อมูลเพิ่มเติมได้ที่คู่มือการจัดแพ็กเกจ
- ใช้ SDK และเครื่องมือล่าสุด: คอมไพล์และแพ็กเกจรุ่นของคุณด้วย Play Games PC SDK, Play Games PC Unity SDK, เครื่องมือสำหรับนักพัฒนาแอป Play PC และเครื่องมือการเผยแพร่ของ Play เวอร์ชันล่าสุด
- ยืนยันว่าจำเป็นต้องมีการยกระดับหรือไม่: หากโปรแกรมติดตั้ง โปรแกรมเปิด หรือโปรแกรมถอนการติดตั้งต้องทำงานในฐานะผู้ดูแลระบบทุกครั้งที่เปิดใช้งาน โปรดตรวจสอบว่าคุณได้ตั้งค่า
INSTALLER_REQUIRES_ELEVATION,LAUNCHER_REQUIRES_ELEVATIONหรือUNINSTALLER_REQUIRES_ELEVATIONเป็นtrueหรือไม่ ไม่เช่นนั้น โปรแกรมจะไม่ทำงานด้วยสิทธิ์ของผู้ดูแลระบบ ซึ่งจะทำให้การเริ่มต้นระบบล้มเหลว ดูรายละเอียดเพิ่มเติมได้ที่รูปแบบไฟล์การกำหนดค่า WAB - ส่งตัวติดตั้ง Launcher ของบุคคลที่สาม: หากคุณใช้ Launcher ของบุคคลที่สาม ให้ส่งตัวติดตั้งภายใน WAB ดูข้อมูลเพิ่มเติมได้ที่คู่มือการเผยแพร่โปรแกรมติดตั้ง
- จัดการโทเค็นของเซสชันการเล่นอัตโนมัติ: หากคุณเปิดใช้การเล่นอัตโนมัติโดยตั้งค่า
acceptsCommandLineArguments="true"ในplay_publishing_config.xmlให้ยืนยันว่าโปรแกรมติดตั้งแยกอาร์กิวเมนต์บรรทัดคำสั่ง--g_session_token=<token>และใช้เพื่อเปิดเกม ตรวจสอบว่าโปรแกรมติดตั้งจัดการเคสสำรองที่ไม่มีโทเค็นอยู่ ดูข้อมูลเพิ่มเติมได้ที่คำถามที่พบบ่อยเกี่ยวกับ Launcher - อัปเดตเกมและ Launcher หรือโปรแกรมติดตั้ง: เนื้อหาแพ็กเกจของคุณ รวมถึงโปรแกรมติดตั้ง Launcher ต้องอัปเดตได้ด้วยตนเอง จัดการทรัพยากรทั้งหมดที่เกมต้องการ รวมถึงการอัปเดตตัวเปิดเกมเอง
- แชร์ข้อมูลการเปิดตัวกับ Google: ติดต่อพาร์ทเนอร์ Play และแชร์ชื่อแพ็กเกจ ประเทศที่เปิดตัว (โดยใช้รหัส ISO 2 ตัว เช่น US, CA, MX) รวมถึงวันที่และเวลาเปิดตัวในรูปแบบเวลาสากลเชิงพิกัด (UTC)
- ตั้งค่าสิทธิ์เข้าถึงเพื่อทดสอบ: ระบุ Google Group ภายนอกเพื่อเพิ่มลงในรายการที่อนุญาตสำหรับการทดสอบ เอกสารประกอบ และสิทธิ์เข้าถึง Google ไดรฟ์ แชร์รายชื่ออีเมลของบัญชีทดสอบกับพาร์ทเนอร์ Play เนื่องจากแทร็กทดสอบของ Play Console ไม่รองรับ PC
- เพิ่มรูปแบบของอุปกรณ์ PC: เพิ่มรูปแบบของอุปกรณ์ "Google Play Games บน PC" ลงในแอปของคุณใน Google Play Console อย่างชัดเจน หากเข้าถึงแท็บนี้ไม่ได้ โปรดติดต่อพาร์ทเนอร์ Play เพื่อเพิ่มบัญชีของคุณลงในรายการที่อนุญาต
- กำหนดค่าข้อกำหนดของ PC: ป้อนข้อกำหนดด้านฮาร์ดแวร์ (RAM, GPU, พื้นที่เก็บข้อมูล) สำหรับ Windows PC ดูข้อมูลเพิ่มเติมได้ที่คู่มือข้อกำหนดของ PC
- อัปโหลดเนื้อหา Store: อัปโหลดไฟล์ WAB ที่แพ็กเกจแล้วไปยังแทร็กเวอร์ชันที่ใช้งานจริงและกำหนดค่าเนื้อหาภาพ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการอัปโหลดชิ้นงาน
- เผยแพร่เพื่อทดสอบสภาพแวดล้อมของผู้ใช้: เลือกเผยแพร่ใน Google Play Console การเลือกเผยแพร่ใน WAB จะไม่ทริกเกอร์การเผยแพร่ต่อสาธารณะ ซึ่งแตกต่างจากเวอร์ชัน Android แต่จะทำให้บัญชีทดสอบที่แชร์สามารถค้นหาแอปเพื่อทำการทดสอบในสภาพแวดล้อมของผู้ใช้หลังจากกระบวนการตรวจสอบของ Google ได้
- เปิดตัวอย่างเป็นทางการ: Google จะควบคุมการเปิดตัวตามวันที่เปิดตัวอย่างเป็นทางการที่คุณแชร์กับพาร์ทเนอร์ Play
- ทดสอบระหว่างการลงทะเบียนล่วงหน้า: ในช่วงการลงทะเบียนล่วงหน้า คุณต้องทำการทดสอบภายในในประเทศที่ไม่ได้รวมอยู่ในภูมิภาคที่เลือกลงทะเบียนล่วงหน้า
- ตรวจสอบการสิ้นสุดกระบวนการของโปรแกรมติดตั้ง: ยืนยันว่ากระบวนการของโปรแกรมติดตั้งหลักยังคงทำงานอยู่จนกว่าจะมีการสร้างและลงทะเบียนคีย์รีจิสทรีที่จำเป็นทั้งหมด หากกระบวนการสิ้นสุดก่อนเวลา การยืนยันการติดตั้งจะไม่สำเร็จ ดูข้อมูลเพิ่มเติมได้ที่การเผยแพร่โปรแกรมติดตั้ง
- รักษา Hive ของรีจิสทรีให้สอดคล้องกันและล้างข้อมูลเมื่อถอนการติดตั้ง:
Google Play Games บน PC จะตรวจสอบ
HKEY_LOCAL_MACHINEก่อนHKEY_CURRENT_USERและใช้ค่าแรกที่ตรงกัน รักษา Hive ของรีจิสทรีให้สอดคล้องกันในการอัปเดตและชื่อ Launcher ที่แชร์ และนำคีย์รีจิสทรีออกระหว่างการถอนการติดตั้ง เพื่อไม่ให้รายการHKEY_LOCAL_MACHINEที่ล้าสมัยบดบังเส้นทางHKEY_CURRENT_USERที่ถูกต้อง ดูข้อมูลเพิ่มเติมได้ที่การเผยแพร่โปรแกรมติดตั้ง
ย้ายข้อมูลจาก API ไปยัง SDK
การย้ายข้อมูลจาก API ไปยัง SDK เป็นขั้นตอนที่ไม่บังคับ หากเลือกที่จะย้ายข้อมูล ให้ทำตามคำแนะนำต่อไปนี้
- นำ REST API เดิมออก: แมปการเรียก API ของ Play Developer เดิม (เช่น
purchases.products.get) กับฟังก์ชัน SDK แบบเนทีฟฝั่งไคลเอ็นต์ ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำในการย้ายข้อมูล - ตรวจสอบอาร์กิวเมนต์บรรทัดคำสั่ง: อาร์กิวเมนต์บรรทัดคำสั่งในสภาพแวดล้อม SDK อาจแตกต่างจากอาร์กิวเมนต์ในสภาพแวดล้อม API ยืนยันว่าแพ็กเกจของคุณจัดการและส่งอาร์กิวเมนต์ทั้งหมดอย่างถูกต้อง ดูข้อมูลเพิ่มเติมได้ที่ยืนยัน
- ยืนยันเส้นทางรีจิสทรี: เพื่อให้การย้ายข้อมูลไปยัง SDK แบบเนทีฟเป็นไปอย่างราบรื่น การกำหนดค่ารีจิสทรีต้องสอดคล้องกับเวอร์ชันก่อนหน้า ดูข้อมูลเพิ่มเติมได้ที่คู่มือไฟล์ WAB