การย้ายข้อมูลจาก API ไปยัง SDK

หากเกม Native ของ Google Play Games บน PC เรียกใช้ Play Billing API โดยตรง คุณต้องย้ายข้อมูลเกมไปใช้ PC SDK

คุณสามารถผสานรวม C++ SDK หรือ C# SDKได้ ทั้งนี้ขึ้นอยู่กับเอนจินเกมที่ใช้ โปรดดูโปรเจ็กต์ตัวอย่าง ที่แสดงตัวอย่างที่ใช้ย้ายข้อมูล เกม Native ไปยัง SDK ได้

การตั้งค่าและการเตรียมการ

ส่วนนี้อธิบายขั้นตอนการย้ายข้อมูลจากโซลูชันที่อิงตาม API ไปเป็น Google Play Games บน PC Native SDK

อาร์กิวเมนต์บรรทัดคำสั่ง

Google Play Games บน PC Native SDK อาศัยอาร์กิวเมนต์บรรทัดคำสั่งบางรายการที่ส่งผ่านเข้ามาในระหว่างการเริ่มต้นกระบวนการของเกมเพื่อตรวจสอบสิทธิ์ผู้ใช้ คุณต้องส่งอาร์กิวเมนต์เหล่านี้ ไปยังกระบวนการที่เรียกใช้ Initialize SDK หากการเริ่มต้นเกมเกี่ยวข้องกับหลายกระบวนการ คุณต้องตรวจสอบว่าได้ส่งอาร์กิวเมนต์ทั้งหมดไปยังกระบวนการที่ใช้ SDK ในท้ายที่สุด ดูขั้นตอนการรองรับกระบวนการของเกมหลายรายการในการตั้งค่า

การแมป API

หากต้องการย้ายข้อมูลให้เสร็จสมบูรณ์ คุณจะต้องนำการเรียกใช้ API ทั้งหมดไปยังเซิร์ฟเวอร์ Play ออก SDK มีการเรียกใช้ฟังก์ชันที่สอดคล้องกันเพื่อให้ได้ฟังก์ชันการทำงานเดียวกัน ส่วนนี้แสดงการแมปสำหรับฟังก์ชันการทำงานแต่ละอย่าง

Google Sign-In

Google Sign-In หรือที่เรียกว่าการลงชื่อเข้าใช้ด้วย บัญชี Google เป็นวิธีการตรวจสอบสิทธิ์ OAuth ที่มีตัวเลือกการตรวจสอบสิทธิ์แบบคลิกเดียวสำหรับผู้ใช้ที่มี บัญชี Google ในโปรเจ็กต์ที่อิงตาม API คุณจะเชื่อมโยงบัญชีของผู้เล่นกับการซื้อของผู้เล่น โซลูชันที่อิงตาม SDK ไม่จำเป็นต้องมีการเชื่อมโยงนี้

โซลูชันที่อิงตาม SDK ใช้บัญชี Google ของไคลเอ็นต์ Google Play Games ที่ เชื่อมโยงกับโปรไฟล์ผู้เล่นและสิทธิ์ของผู้เล่นอยู่แล้ว วิธีนี้จะมอบประสบการณ์การใช้งานที่ราบรื่นยิ่งขึ้นสำหรับผู้เล่นและสภาพแวดล้อมที่ปลอดภัยยิ่งขึ้นสำหรับนักพัฒนาแอป เนื่องจาก SDK สามารถสื่อสารกับไคลเอ็นต์ Google Play Games ผ่าน IPC ได้อย่างปลอดภัย

ให้เรียกใช้ Initialize SDK โดยเร็วที่สุดแทนการใช้ Google Sign-In ดำเนินการตามรหัสข้อผิดพลาดเพื่อให้สภาพแวดล้อมที่ปลอดภัยสำหรับการรันไทม์ของเกม

รับรายการผลิตภัณฑ์

ในโซลูชัน API เซิร์ฟเวอร์แบ็กเอนด์จะดึงข้อมูลรายการผลิตภัณฑ์โดยใช้ ปลายทาง inappproduct.gets ของ Play Developer API

ใน SDK ให้ดึงข้อมูลรายการผลิตภัณฑ์ในแอปบนไคลเอ็นต์โดยตรงโดยใช้ฟังก์ชัน QueryProductDetails

รับการซื้อ

ในโซลูชัน API เซิร์ฟเวอร์แบ็กเอนด์จะดึงข้อมูลการซื้อของผู้ใช้โดยใช้ Play Developer API purchases.products.get ปลายทาง

ใน SDK ให้ใช้ฟังก์ชัน QueryPurchases จากไคลเอ็นต์เกม โดยตรง

เปิดขั้นตอนการซื้อ

ในโซลูชัน API การเปิดขั้นตอนการซื้อต้องเรียกใช้ปลายทางหลายรายการเพื่อตั้งค่าและรับโทเค็นที่จำเป็น

ใน SDK ให้เปิดกระบวนการโดยเรียกใช้ฟังก์ชัน BillingClient's LaunchPurchaseFlow SDK จะจัดการงานที่จำเป็นทั้งหมด

ประมวลผลการซื้อ

การประมวลผลการซื้อของผู้ใช้ เกี่ยวข้องกับการรับทราบและใช้การซื้อหลังจากตรวจสอบแล้ว ว่าการซื้อนั้นถูกต้อง ทั้งโซลูชัน API และโซลูชัน SDK แนะนำให้ทำตามขั้นตอนจากแบ็กเอนด์เพื่อความปลอดภัย

กระบวนการนี้คล้ายกันสำหรับทั้งโซลูชัน API และโซลูชัน SDK โดยมีขั้นตอนดังนี้

หลังจากดึงข้อมูล purchaseToken จากการซื้อแล้ว เช่น ProductPurchase.purchaseToken ในโซลูชัน API หรือ ProductPurchaseDetails's purchase_token ในโซลูชัน SDK ให้ส่งโทเค็นดังกล่าวไปยังแบ็กเอนด์เพื่อทำการ ยืนยัน

เมื่อยืนยันแล้ว แบ็กเอนด์จะรับทราบหรือใช้การซื้อได้อย่างปลอดภัยหลังจากให้สิทธิ์แล้ว

ส่งเพื่อทดสอบ

หากต้องการส่งเกมเพื่อทดสอบ ให้ทำตามขั้นตอนต่อไปนี้

จัดแพ็กเกจเพื่อส่ง

เกมที่ใช้ SDK ต้องจัดแพ็กเกจในรูปแบบ Windows App Bundle และอัปโหลดผ่าน Play Console โปรดดูเอกสารประกอบเพื่อจัดแพ็กเกจเกมใน Windows App Bundle สำหรับ