คู่มือนี้อธิบายวิธีผสานรวมรีวิวในแอปในแอปของคุณโดยใช้ Unity มีคู่มือการผสานรวมแยกต่างหากสำหรับกรณีที่คุณใช้ Kotlin หรือ Java, โค้ดแบบเนทีฟ หรือ Unreal Engine
ภาพรวมของ Unity SDK
Play In-App Review API เป็นส่วนหนึ่งของกลุ่ม Play Core SDK API สำหรับ Unity มีคลาส ReviewManager เพื่อขอและเปิดใช้งานขั้นตอนโดยใช้เมธอด RequestReviewFlow และ LaunchReviewFlow หลังจากส่งคำขอแล้ว แอปจะตรวจสอบสถานะของคำขอได้โดยใช้ ReviewErrorCode
ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์
OpenUPM-CLI
หากติดตั้ง OpenUPM CLI ไว้ คุณจะติดตั้งรีจิสทรี OpenUPM ได้ด้วยคำสั่งต่อไปนี้
openupm add com.google.play.reviewOpenUPM
เปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจโดยเลือกตัวเลือกเมนู Unity Edit > Project Settings > Package Manager
เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตลงในหน้าต่าง Package Manager โดยทำดังนี้
Name: package.openupm.com URL: https://package.openupm.com Scopes: com.google.external-dependency-manager com.google.play.common com.google.play.core com.google.play.reviewเปิดเมนูเครื่องมือจัดการแพ็กเกจโดยเลือกตัวเลือกเมนู Unity Window > Package Manager
ตั้งค่าเมนูแบบเลื่อนลงขอบเขตผู้จัดการเพื่อเลือกรีจิสทรีของฉัน
เลือกแพ็กเกจปลั๊กอิน Google Play Integrity สำหรับ Unity จากรายการแพ็กเกจ แล้วกดติดตั้ง
นำเข้าจาก GitHub
ดาวน์โหลด
.unitypackageเวอร์ชันล่าสุดจาก GitHubนำเข้าไฟล์
.unitypackageโดยเลือกตัวเลือกเมนู Unity Assets > Import package > Custom Package แล้วนำเข้ารายการทั้งหมด
สร้าง ReviewManager
สร้างอินสแตนซ์ของ ReviewManager ที่จัดการการสื่อสารระหว่างแอปของคุณกับ Google Play API
using Google.Play.Review;
// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();
ขอออบเจ็กต์ ReviewInfo
ทำตามคำแนะนำเกี่ยวกับเวลาที่ควรขอรีวิวในแอปเพื่อระบุจุดที่เหมาะสมในโฟลว์ผู้ใช้ของแอปเพื่อแจ้งให้ผู้ใช้เขียนรีวิว (เช่น หลังจากที่ผู้ใช้ปิดหน้าจอสรุปเมื่อจบด่านในเกม) เมื่อแอปใกล้ถึงจุดใดจุดหนึ่งเหล่านี้ ให้ใช้อินสแตนซ์ ReviewManager เพื่อสร้างการดำเนินการแบบไม่พร้อมกัน ดังที่แสดงในตัวอย่างต่อไปนี้
var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.Error.ToString().
yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();
หากการเรียกใช้สำเร็จ API จะแสดงออบเจ็กต์ PlayReviewInfo ที่แอปของคุณต้องใช้เพื่อเปิดใช้ขั้นตอนการรีวิวในแอป ในตัวอย่างนี้ การเรียกใช้จะทำภายใน coroutine เพื่อดำเนินการแบบไม่พร้อมกัน (ซึ่งจะไม่บล็อกเธรดหลัก) เนื่องจากระบบจะเรียกใช้แบบอะซิงโครนัส จึงอาจใช้เวลาถึง 2-3 วินาที ดังนั้นแอปจึงควรเรียกใช้ก่อนที่แอปจะถึงจุดในโฟลว์ผู้ใช้ที่คุณต้องการแสดงรีวิวในแอป
เปิดขั้นตอนการรีวิวในแอป
หลังจากแอปได้รับอินสแตนซ์ PlayReviewInfo แล้ว ก็จะเปิดขั้นตอนการรีวิวในแอปได้ ออบเจ็กต์ PlayReviewInfo จะใช้ได้ในระยะเวลาที่จำกัดเท่านั้น ดังนั้นแอปของคุณจึงไม่ควรรอนานเกินไปก่อนที่จะเปิดใช้งานขั้นตอน
var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using launchFlowOperation.Error.ToString().
yield break;
}
// The flow has finished. The API does not indicate whether the user
// reviewed or not, or even whether the review dialog was shown. Thus, no
// matter the result, we continue our app flow.
ขั้นตอนถัดไป
ทดสอบขั้นตอนการรีวิวในแอปของแอปเพื่อยืนยันว่าการผสานรวมทำงานได้อย่างถูกต้อง