ادغام نظرات درون برنامه ای (Unreal Engine)

این راهنما نحوه ادغام نظرات درون برنامه ای را با استفاده از 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 و تمامی نسخه های بعدی پشتیبانی می کند.

محیط توسعه خود را تنظیم کنید

راه اندازی

1. افزونه Play Unreal Engine را از مخزن GitHub دانلود کنید.

2. پوشه GooglePlay را در داخل پوشه Plugins خود در پروژه Unreal Engine خود کپی کنید.

3. پروژه Unreal Engine خود را باز کنید و روی Edit → Plugins کلیک کنید.

4. Google Play را جستجو کنید و چک باکس Enabled را علامت بزنید.

5. پروژه بازی را دوباره راه اندازی کنید و یک ساخت را راه اندازی کنید.

6. فایل 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);
}

1. این روش یک FRreviewOperationCompletedDelegate ایجاد می کند تا عملیات بررسی را انجام دهد.

2. نماینده به متد OnReviewOperationCompleted محدود می شود، که پس از پایان عملیات فراخوانی می شود.

3. تابع BindDynamic تضمین می کند که نماینده به درستی به تماس پاسخ داده شده است.

4. متد RequestReviewFlow(Delegate) فرآیند بررسی را شروع می‌کند و از نماینده برای رسیدگی به نتیجه عبور می‌کند.

5. عملیات بازبینی به‌صورت ناهمزمان اجرا می‌شود و به سایر وظایف در برنامه اجازه می‌دهد تا زمانی که کامل می‌شود ادامه پیدا کنند.

6. پس از پایان عملیات، پاسخ به تماس 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);
}

مراحل بعدی

جریان بررسی درون برنامه ای برنامه خود را آزمایش کنید تا مطمئن شوید که یکپارچه سازی شما به درستی کار می کند.