שילוב של ביקורות מתוך האפליקציה (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 Plugin מהמאגר של GitHub.

2. מעתיקים את התיקייה GooglePlay לתוך התיקייה Plugins בפרויקט ב-Unreal Engine.

3. פותחים את הפרויקט ב-Unreal Engine ולוחצים על Edit (עריכה) → Plugins (פלאגינים).

4. מחפשים את Google Play ומסמנים את התיבה מופעל.

5. מפעילים מחדש את פרויקט המשחק ומפעילים build.

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. ה-delegate קשור לשיטה OnReviewOperationCompleted, שתופעל בסיום הפעולה.

3. הפונקציה BindDynamic מוודאת שהממשק למעקב אחר שינויים מקושר כראוי לקריאה החוזרת.

4. השיטה RequestReviewFlow(Delegate) מתחילה את תהליך הבדיקה, ומעבירה את ה-delegate לטיפול בתוצאה.

5. פעולת הבדיקה פועלת באופן אסינכרוני, כך שאפשר להמשיך במשימות אחרות באפליקציה בזמן שהיא מתבצעת.

6. בסיום הפעולה, פונקציית ה-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);
}

השלבים הבאים

בודקים את תהליך הבדיקה באפליקציה כדי לוודא שהשילוב פועל כמו שצריך.