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

หากเกมเฉพาะสำหรับ Google Play Games บน PC เรียกใช้ Play Billing APIs โดยตรง คุณต้องย้ายข้อมูลเกมให้ใช้ PC SDK

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

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

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

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

Native SDK ของ Google Play Games บน PC อาศัยอาร์กิวเมนต์บรรทัดคำสั่งบางอย่างที่ส่งผ่าน ในระหว่างการเริ่มต้นกระบวนการเกมเพื่อตรวจสอบสิทธิ์ผู้ใช้ อาร์กิวเมนต์เหล่านี้ต้อง ส่งผ่านไปยังกระบวนการที่เรียกใช้ 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 เซิร์ฟเวอร์แบ็กเอนด์จะเรียกข้อมูลรายการผลิตภัณฑ์โดยใช้ปลายทาง Play Developer API inappproduct.gets

ใน 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 ต้องอยู่ในรูปแบบ App Bundle ของ Windows และอัปโหลดผ่าน Play Console โปรดดูเอกสารประกอบเพื่อจัดแพ็กเกจเกมใน App Bundle ของ Windows สำหรับ