دمج المراجعات داخل التطبيق (Unreal Engine)

يوضّح هذا الدليل كيفية دمج ميزة "المراجعات داخل التطبيق" في تطبيقك باستخدام محرّك Unreal. تتوفّر أدلة دمج منفصلة في حال استخدام Kotlin أو Java أو الرموز البرمجية الأصلية أو Unity.

نظرة عامة على حزمة تطوير البرامج (SDK) الخاصة بمحرّك Unreal Engine

تُعدّ واجهة Play In-App Reviews API جزءًا من مجموعة حِزم تطوير البرامج (SDK) في "مكتبة Play الأساسية". توفّر واجهة برمجة التطبيقات في 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 وضَع علامة في المربّع مفعَّل.

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

الخطوات التالية

اختبِر مسار المراجعة داخل التطبيق للتأكّد من أنّ عملية الدمج تعمل بشكل صحيح.