คู่มือนี้อธิบายวิธีผสานรวมรีวิวในแอปในแอปของคุณโดยใช้ Unreal Engine มีคู่มือการผสานรวมแยกต่างหากสำหรับกรณีที่คุณใช้ Kotlin หรือ Java, โค้ดแบบเนทีฟ หรือ Unity
ภาพรวม Unreal Engine SDK
Play In-App Reviews API เป็นส่วนหนึ่งของกลุ่ม Play Core SDK API สำหรับ Unreal Engine มีคลาส UInAppReviewsManager เพื่อขอและเปิดใช้งานขั้นตอนโดยใช้เมธอด RequestReviewFlow และ LaunchReviewFlow หลังจากส่งคำขอแล้ว แอปของคุณจะตรวจสอบสถานะของคำขอได้โดยใช้ EInAppReviewErrorCode
เวอร์ชัน Unreal Engine ที่รองรับ
ปลั๊กอินรองรับ Unreal Engine 5.0 และเวอร์ชันต่อๆ มาทั้งหมด
ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์
ดาวน์โหลดปลั๊กอิน Play Unreal Engine จากที่เก็บ GitHub
คัดลอกโฟลเดอร์
GooglePlayไว้ในโฟลเดอร์Pluginsในโปรเจ็กต์ Unreal Engineเปิดโปรเจ็กต์ Unreal Engine แล้วคลิกแก้ไข → ปลั๊กอิน
ค้นหา Google Play แล้วเลือกช่องทำเครื่องหมายเปิดใช้
รีสตาร์ทโปรเจ็กต์เกมและทริกเกอร์บิลด์
เปิดไฟล์
Build.csของโปรเจ็กต์ แล้วเพิ่มโมดูลPlayInAppReviewsลงในPublicDependencyModuleNames:using UnrealBuildTool; public class MyGame : ModuleRules { public MyGame(ReadOnlyTargetRules Target) : base(Target) { // ... PublicDependencyModuleNames.Add("PlayInAppReviews"); // ... } }
ขอขั้นตอนการรีวิวในแอป
ทำตามคำแนะนำเกี่ยวกับเวลาที่ควรขอรีวิวในแอปเพื่อระบุจุดที่เหมาะสมในโฟลว์ผู้ใช้ของแอปเพื่อแจ้งให้ผู้ใช้เขียนรีวิว (เช่น หลังจากที่ผู้ใช้ปิดหน้าจอสรุปเมื่อจบด่านในเกม) เมื่อแอปใกล้ถึงขีดจำกัดเหล่านี้ ให้ใช้ UInAppReviewsManager เพื่อสร้างการดำเนินการ ดังที่แสดงในตัวอย่างต่อไปนี้
MyClass.h
void MyClass::OnReviewOperationCompleted(EInAppReviewErrorCode ErrorCode)
{
// ...
}
MyClass.cpp
void MyClass::RequestReviewFlow()
{
// Create a delegate to bind the callback function.
FReviewOperationCompletedDelegate Delegate;
// Bind the completion handler (OnReviewOperationCompleted) to the delegate.
Delegate.BindDynamic(this, &MyClass::OnReviewOperationCompleted);
// Initiate the review flow, passing the delegate to handle the result.
GetGameInstance()
->GetSubsystem<UInAppReviewsManager>()
->RequestReviewFlow(Delegate);
}
เมธอดจะสร้าง
FRreviewOperationCompletedDelegateเพื่อจัดการการดำเนินการตรวจสอบให้เสร็จสมบูรณ์ผู้รับมอบสิทธิ์จะเชื่อมโยงกับเมธอด
OnReviewOperationCompletedซึ่งจะเรียกใช้เมื่อการดำเนินการเสร็จสิ้นฟังก์ชัน
BindDynamicช่วยให้มั่นใจว่าผู้รับมอบสิทธิ์ลิงก์กับ Callback อย่างถูกต้องเมธอด
RequestReviewFlow(Delegate)จะเริ่มกระบวนการตรวจสอบ โดยส่งผู้รับมอบสิทธิ์เพื่อจัดการผลลัพธ์การดำเนินการตรวจสอบจะทำงานแบบอะซิงโครนัส ซึ่งช่วยให้งานอื่นๆ ในแอปดำเนินต่อไปได้ในขณะที่การดำเนินการตรวจสอบเสร็จสมบูรณ์
เมื่อการดำเนินการเสร็จสิ้น Callback
OnReviewOperationCompletedจะประมวลผลผลลัพธ์ รวมถึงความสำเร็จหรือความล้มเหลว
เปิดขั้นตอนการรีวิวในแอป
เมื่อการดำเนินการ RequestReviewFlow เสร็จสมบูรณ์แล้ว คุณจะเปิดขั้นตอนการรีวิวในแอปได้ ซึ่งทำได้โดยการเชื่อมโยงผู้รับมอบสิทธิ์เพื่อจัดการเหตุการณ์ที่เสร็จสมบูรณ์ เพื่อให้มั่นใจว่าแอปจะตอบสนองต่อผลลัพธ์ (สำเร็จหรือไม่สำเร็จ) ของคำขอรีวิว
MyClass.h
void MyClass::OnReviewOperationCompleted(EInAppReviewErrorCode ErrorCode)
{
// ...
}
MyClass.cpp
void MyClass::LaunchReviewFlow()
{
// Create a delegate to bind the callback function.
FReviewOperationCompletedDelegate Delegate;
// Bind the completion handler (OnReviewOperationCompleted) to the delegate.
Delegate.BindDynamic(this, &MyClass::OnReviewOperationCompleted);
// Launch the review flow, passing the delegate to handle the result.
GetGameInstance()
->GetSubsystem<UInAppReviewsManager>()
->LaunchReviewFlow(Delegate);
}
ขั้นตอนถัดไป
ทดสอบขั้นตอนการรีวิวในแอปของแอปเพื่อยืนยันว่าการผสานรวมทำงานได้อย่างถูกต้อง