Mengintegrasikan ulasan dalam aplikasi (Unreal Engine)

Panduan ini menjelaskan cara mengintegrasikan ulasan dalam aplikasi di aplikasi Anda menggunakan Unreal Engine. Ada panduan integrasi terpisah jika Anda menggunakan Kotlin atau Java, kode native, atau Unity.

Ringkasan Unreal Engine SDK

Play In-App Reviews API adalah bagian dari keluarga Play Core SDK. API untuk Unreal Engine menawarkan class UInAppReviewsManager untuk meminta dan meluncurkan alur menggunakan metode RequestReviewFlow dan LaunchReviewFlow. Setelah permintaan dibuat, aplikasi Anda dapat memeriksa status permintaan menggunakan EInAppReviewErrorCode.

Versi Unreal Engine yang didukung

Plugin ini mendukung Unreal Engine 5.0 dan semua versi berikutnya.

Menyiapkan lingkungan pengembangan

1. Download Plugin Unreal Engine Play dari repositori GitHub.

2. Salin folder GooglePlay di dalam folder Plugins di project Unreal Engine Anda.

3. Buka project Unreal Engine Anda, lalu klik Edit → Plugins.

4. Telusuri Google Play, lalu centang kotak Diaktifkan.

5. Mulai ulang project game dan picu build.

6. Buka file Build.cs project Anda dan tambahkan modul PlayInAppReviews ke PublicDependencyModuleNames:

   using UnrealBuildTool;
   
   public class MyGame : ModuleRules
   {
     public MyGame(ReadOnlyTargetRules Target) : base(Target)
     {
       // ...
   
       PublicDependencyModuleNames.Add("PlayInAppReviews");
   
       // ...
     }
   }
   

Meminta alur ulasan dalam aplikasi

Ikuti panduan tentang kapan harus meminta ulasan dalam aplikasi untuk menentukan momen tepat dalam alur penggunaan aplikasi untuk meminta pengguna memberikan ulasan (misalnya, setelah pengguna menutup layar ringkasan di akhir level dalam game). Saat aplikasi Anda mendekati salah satu titik ini, gunakan UInAppReviewsManager untuk membuat operasi, seperti yang ditunjukkan dalam contoh berikut:

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);
}

1. Metode ini membuat FRreviewOperationCompletedDelegate untuk menangani penyelesaian operasi peninjauan.

2. Delegasi terikat dengan metode OnReviewOperationCompleted, yang akan dipanggil setelah operasi selesai.

3. Fungsi BindDynamic memastikan bahwa delegasi ditautkan dengan benar ke callback.

4. Metode RequestReviewFlow(Delegate) memulai proses peninjauan, dengan meneruskan delegasi untuk menangani hasilnya.

5. Operasi peninjauan berjalan secara asinkron, sehingga tugas lain di aplikasi dapat lanjutkan saat selesai.

6. Setelah operasi selesai, callback OnReviewOperationCompleted akan memproses hasilnya, termasuk keberhasilan atau kegagalan.

Meluncurkan alur ulasan dalam aplikasi

Setelah operasi RequestReviewFlow selesai, Anda dapat meluncurkan alur peninjauan dalam aplikasi. Hal ini dilakukan dengan mengikat delegasi untuk menangani peristiwa penyelesaian, yang memastikan aplikasi bereaksi terhadap hasil (sukses atau gagal) permintaan peninjauan.

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);
}

Langkah berikutnya

Uji alur peninjauan dalam aplikasi aplikasi Anda untuk memverifikasi bahwa integrasi Anda berfungsi dengan benar.