การย้ายข้อมูลจาก 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 ดำเนินการตามรหัสข้อผิดพลาดเพื่อให้สภาพแวดล้อมที่ปลอดภัยสำหรับรันไทม์ของเกม

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

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

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

รับการซื้อ

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

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

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

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

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

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

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

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

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

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

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

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

แพ็กเกจสำหรับการส่ง

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