ใช้รายการตรวจสอบนี้เพื่อให้แน่ใจว่าเกมเป็นไปตามข้อกำหนดและแนวทางปฏิบัติแนะนำทั้งหมดก่อนส่งเข้ารับการตรวจสอบใน Google Play Games บน PC
ตั้งค่าและกำหนดค่าโปรเจ็กต์
- ดาวน์โหลดและนำเข้า SDK: ผสานรวม SDK เวอร์ชันล่าสุดของ Play Games บน PC สำหรับสภาพแวดล้อมของคุณ ดูข้อมูลเพิ่มเติมได้ที่คู่มือ Unity หรือคู่มือ C++
- สร้างไฟล์ Manifest ของแอปพลิเคชัน: สร้างไฟล์
manifest.xmlที่แมป<PackageName>กับแพ็กเกจ Play Console ที่อ้างสิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่คู่มือไฟล์ Manifest - รับรองไฟล์ปฏิบัติการแบบดิจิทัล: รับรองเกมโดยใช้ลายเซ็นดิจิทัล Authenticode และปกป้องใบรับรองสำหรับการอัปเดตทั้งหมดในอนาคต แม้ว่าคุณจะข้ามขั้นตอนนี้ได้ในระหว่างการพัฒนาในเครื่องโดยเปิดใช้โหมดนักพัฒนาซอฟต์แวร์ แต่คุณต้องรับรองไบนารีขั้นสุดท้ายด้วยใบรับรองเวอร์ชันที่ใช้งานจริงจากผู้ออกใบรับรองที่รู้จัก ดูข้อมูลเพิ่มเติมได้ที่ลงนามเกมแบบดิจิทัล
- จัดรูปแบบและส่งใบรับรอง: กำหนดค่าใบรับรองใน Play Console, แชร์ข้อมูลใบรับรองกับตัวแทนของ Google หรือส่งอีเมลไปที่ google-play-games-pc@google.com ในระหว่างการเริ่มต้นใช้งาน ไฟล์ใบรับรองต้องมีเฉพาะข้อมูลที่เกี่ยวข้องกับใบรับรองเท่านั้น โปรดตรวจสอบว่าได้นำบล็อกที่ไม่ใช่ใบรับรองออกทั้งหมดแล้ว คุณสามารถใช้ 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) ในเครื่อง หากต้องการเริ่มการเตรียมความพร้อมผู้ใช้งานใหม่ โปรดส่งอีเมลไปที่ google-play-games-pc@google.com เพื่อขอความช่วยเหลือเกี่ยวกับขั้นตอนถัดไป - จัดการการซื้อในโหมดนักพัฒนาซอฟต์แวร์: เมื่อทดสอบการซื้อในโหมดนักพัฒนาซอฟต์แวร์ ให้ใช้การซื้อภายใน 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 ดูข้อมูลเพิ่มเติมได้ที่การเผยแพร่ที่จัดการของ 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 หรือโปรแกรมติดตั้ง: การเผยแพร่ที่จัดการของ Play จะจัดการการอัปเดตเกมโดยอัตโนมัติ หากคุณใช้การเผยแพร่ผ่านโปรแกรมติดตั้ง เนื้อหาแพ็กเกจ รวมถึงโปรแกรมติดตั้ง Launcher ต้องอัปเดตได้ด้วยตนเองและจัดการทรัพยากรทั้งหมดที่เกมต้องการ รวมถึงการอัปเดต Launcher เองด้วย
- เพิ่มรูปแบบของอุปกรณ์ PC: ใน Play Console ให้ไปที่ทดสอบและเผยแพร่ > การตั้งค่าขั้นสูง > รูปแบบของอุปกรณ์และแพลตฟอร์ม แล้วคลิกเพิ่ม Windows ในส่วน Windows หากไม่เห็นตัวเลือก Windows คุณต้องเริ่มต้นใช้งานบัญชีก่อน พร้อมเริ่มการเตรียมความพร้อมผู้ใช้งานใหม่แล้วหรือยัง ติดต่อเราทางอีเมลที่ google-play-games-pc@google.com ผู้เชี่ยวชาญด้านการเริ่มต้นใช้งานจะช่วยเหลือคุณเกี่ยวกับขั้นตอนถัดไป
- กำหนดค่าข้อกำหนดของ PC: ป้อนข้อกำหนดด้านฮาร์ดแวร์ (RAM, GPU, พื้นที่เก็บข้อมูล) สำหรับ Windows PC และยอมรับนโยบายการตรวจสอบใน Play Console ดูข้อมูลเพิ่มเติมได้ที่คู่มือข้อกำหนดสำหรับ PC
- ตั้งค่าสิทธิ์เข้าถึงการทดสอบ: กำหนดค่าผู้ทดสอบสูงสุด 100 คนในแทร็กการทดสอบภายในของ Google Play Games บน PC ใน Play Console (ทดสอบและเผยแพร่ > การทดสอบ > การทดสอบภายใน) แล้วอัปโหลดไฟล์
.wabผู้ทดสอบต้องยอมรับลิงก์เว็บที่เลือกใช้และติดตั้งบิลด์โดยใช้googleplaygames://deeplink/details?id=PACKAGE_NAMEWindows ไม่รองรับแทร็กทดสอบแบบเปิดและแบบปิด - อัปโหลดเนื้อหา Store และส่งไปยังเวอร์ชันที่ใช้งานจริง: อัปโหลดเนื้อหาข้อมูลผลิตภัณฑ์ใน Store ของ Google Play Games บน PC เลือกประเทศเป้าหมายที่ตรงกันหรือเป็นชุดย่อยของการกำหนดเป้าหมาย Android แล้วส่งไฟล์
.wabในแทร็กเวอร์ชันที่ใช้งานจริงของ Google Play Games บน PC (ทดสอบและเผยแพร่ > เวอร์ชันที่ใช้งานจริง) การตรวจสอบใช้เวลาไม่เกิน 7 วัน ดูข้อมูลเพิ่มเติมได้ที่คู่มือการเผยแพร่เวอร์ชันที่ใช้งานจริง - ควบคุมช่วงเวลาเปิดตัว: ใช้การเผยแพร่ที่จัดการในหน้าภาพรวมการเผยแพร่ใน Play Console เพื่อควบคุมเวลาที่รุ่นที่ได้รับอนุมัติจะเผยแพร่สู่สาธารณะ
- ทดสอบระหว่างการลงทะเบียนล่วงหน้า: ในช่วงการลงทะเบียนล่วงหน้า คุณต้องทำการทดสอบภายในในประเทศที่ไม่ได้รวมอยู่ในภูมิภาคที่เลือกลงทะเบียนล่วงหน้า
- ตรวจสอบการสิ้นสุดกระบวนการของโปรแกรมติดตั้ง: ยืนยันว่ากระบวนการของโปรแกรมติดตั้งหลักยังคงทำงานอยู่จนกว่าจะมีการสร้างและลงทะเบียนคีย์รีจิสทรีที่จำเป็นทั้งหมด หากกระบวนการสิ้นสุดก่อนเวลา การยืนยันการติดตั้งจะไม่สำเร็จ ดูข้อมูลเพิ่มเติมได้ที่การเผยแพร่โปรแกรมติดตั้ง
- รักษา 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