ผสานรวมรีวิวในแอป (เนทีฟ)

คู่มือนี้อธิบายวิธีผสานรวมรีวิวในแอปไว้ในแอปของคุณโดยใช้โฆษณาเนทีฟ (C หรือ C++) เรามีคู่มือการผสานรวมแยกต่างหากหากคุณใช้ Kotlin หรือ Java หรือ Unity

ภาพรวมของ SDK ในเครื่อง

Play Core Native SDK เป็นส่วนหนึ่งของไลบรารี Google Play Core ครอบครัว Play Core Native SDK มีไฟล์ส่วนหัว C review.h ซึ่ง รวม ReviewManager จากไลบรารีการรีวิวในแอปของ Java Play ไฟล์ส่วนหัวนี้ช่วยให้แอปของคุณสามารถ เรียก API จากโค้ดของระบบโดยตรง สำหรับภาพรวมของสาธารณะ ที่พร้อมใช้งาน โปรดดูโมดูลเนทีฟของ Play Review เอกสารประกอบ

ReviewManager_requestReviewFlow เริ่มต้นคำขอที่รวบรวมข้อมูลที่จำเป็นต่อการเปิดใช้งาน ขั้นตอนการตรวจสอบในแอปภายหลัง คุณสามารถติดตามผลลัพธ์ของคำขอโดยใช้ ReviewManager_getReviewStatus หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับสถานะทั้งหมดที่ ReviewManager_getReviewStatus ส่งคืนได้ โปรดดู ReviewErrorCode

ทั้งฟังก์ชันคำขอและการเปิดใช้งานแสดงผล REVIEW_NO_ERROR หากฟังก์ชัน สำเร็จ

ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์

1. เลือกดำเนินการอย่างหนึ่งดังต่อไปนี้

   • ติดตั้ง Android Studio เวอร์ชัน 4.0 ขึ้นไป ใช้ SDK UI ของ Manager เพื่อติดตั้งแพลตฟอร์ม Android SDK เวอร์ชัน 10.0 (API ระดับ 29)
   • ติดตั้งเครื่องมือบรรทัดคำสั่ง Android SDK และใช้ sdkmanager เพื่อติดตั้ง แพลตฟอร์ม Android SDK เวอร์ชัน 10.0 (API ระดับ 29)

2. เตรียม Android Studio สำหรับการพัฒนาในตัวโดยใช้ SDK Manager เพื่อติดตั้งเวอร์ชันล่าสุด CMake และ Android Native Development Kit (NDK) สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ การสร้างหรือการนำเข้าโปรเจ็กต์เนทีฟ โปรดดู เริ่มต้นใช้งาน NDK

3. ดาวน์โหลดไฟล์ ZIP และแตกข้อมูลควบคู่ไปกับโปรเจ็กต์ของคุณ

   ลิงก์ดาวน์โหลด	ขนาด	ผลรวมตรวจสอบ SHA-256
   play-core-native-sdk-1.14.0.zip	36 MiB	782a8522d937848c83a715c9a258b95a3ff2879a7cd71855d137b41c00786a5e

4. อัปเดตไฟล์ build.gradle ของแอปตามที่แสดงด้านล่าง

   ดึงดูด

       // App build.gradle
   
       plugins {
         id 'com.android.application'
       }
   
       // Define a path to the extracted Play Core SDK files.
       // If using a relative path, wrap it with file() since CMake requires absolute paths.
       def playcoreDir = file('../path/to/playcore-native-sdk')
   
       android {
           defaultConfig {
               ...
               externalNativeBuild {
                   cmake {
                       // Define the PLAYCORE_LOCATION directive.
                       arguments "-DANDROID_STL=c++_static",
                                 "-DPLAYCORE_LOCATION=$playcoreDir"
                   }
               }
               ndk {
                   // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                   abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
               }
           }
           buildTypes {
               release {
                   // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                   proguardFile '$playcoreDir/proguard/common.pgcfg'
                   proguardFile '$playcoreDir/proguard/gms_task.pgcfg'
                   proguardFile '$playcoreDir/proguard/per-feature-proguard-files'
                   ...
               }
               debug {
                   ...
               }
           }
           externalNativeBuild {
               cmake {
                   path 'src/main/CMakeLists.txt'
               }
           }
       }
   
       dependencies {
           // Import these feature-specific AARs for each Google Play Core library.
           implementation 'com.google.android.play:app-update:2.1.0'
           implementation 'com.google.android.play:asset-delivery:2.2.2'
           implementation 'com.google.android.play:integrity:1.4.0'
           implementation 'com.google.android.play:review:2.0.1'
   
           // Import these common dependencies.
           implementation 'com.google.android.gms:play-services-tasks:18.0.2'
           implementation files("$playcoreDir/playcore-native-metadata.jar")
           ...
       }
       

   Kotlin

   // App build.gradle
   
   plugins {
       id("com.android.application")
   }
   
   // Define a path to the extracted Play Core SDK files.
   // If using a relative path, wrap it with file() since CMake requires absolute paths.
   val playcoreDir = file("../path/to/playcore-native-sdk")
   
   android {
       defaultConfig {
           ...
           externalNativeBuild {
               cmake {
                   // Define the PLAYCORE_LOCATION directive.
                   arguments += listOf("-DANDROID_STL=c++_static", "-DPLAYCORE_LOCATION=$playcoreDir")
               }
           }
           ndk {
               // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
               abiFilters.clear()
               abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
           }
       }
       buildTypes {
           release {
               // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
               proguardFile("$playcoreDir/proguard/common.pgcfg")
               proguardFile("$playcoreDir/proguard/gms_task.pgcfg")
               proguardFile("$playcoreDir/proguard/per-feature-proguard-files")
               ...
           }
           debug {
               ...
           }
       }
       externalNativeBuild {
           cmake {
               path = "src/main/CMakeLists.txt"
           }
       }
   }
   
   dependencies {
       // Import these feature-specific AARs for each Google Play Core library.
       implementation("com.google.android.play:app-update:2.1.0")
       implementation("com.google.android.play:asset-delivery:2.2.2")
       implementation("com.google.android.play:integrity:1.4.0")
       implementation("com.google.android.play:review:2.0.1")
   
       // Import these common dependencies.
       implementation("com.google.android.gms:play-services-tasks:18.0.2")
       implementation(files("$playcoreDir/playcore-native-metadata.jar"))
       ...
   }
   

5. อัปเดตไฟล์ CMakeLists.txt ของแอปตามที่แสดงด้านล่าง

   cmake_minimum_required(VERSION 3.6)
   
   ...
   
   # Add a static library called “playcore” built with the c++_static STL.
   include(${PLAYCORE_LOCATION}/playcore.cmake)
   add_playcore_static_library()
   
   // In this example “main” is your native code library, i.e. libmain.so.
   add_library(main SHARED
           ...)
   
   target_include_directories(main PRIVATE
           ${PLAYCORE_LOCATION}/include
           ...)
   
   target_link_libraries(main
           android
           playcore
           ...)
   

การรวบรวมข้อมูล

Play Core Native SDK อาจรวบรวมข้อมูลที่เกี่ยวข้องกับเวอร์ชันเพื่อให้ Google ดำเนินการต่อไปนี้ได้ เพื่อปรับปรุงผลิตภัณฑ์ รวมถึง

• ชื่อแพ็กเกจของแอป
• เวอร์ชันแพ็กเกจของแอป
• เวอร์ชันของ Play Core Native SDK

ข้อมูลนี้จะรวบรวมเมื่อคุณอัปโหลดแพ็กเกจแอป ไปยัง Play Console หากต้องการเลือกไม่ใช้กระบวนการเก็บรวบรวมข้อมูลนี้ ให้นำ นำเข้า $playcoreDir/playcore-native-metadata.jar ในไฟล์build.gradle

โปรดทราบว่าการรวบรวมข้อมูลนี้เกี่ยวข้องกับการใช้ Play Core Native SDK และ การใช้ข้อมูลที่เก็บรวบรวมของ Google แยกต่างหาก และเป็นอิสระจาก คอลเล็กชันของทรัพยากร Dependency ของไลบรารีที่ประกาศใน Gradle เมื่อคุณอัปโหลดแอป ลงใน Play Console ได้

หลังจากที่คุณผสานรวม Play Core Native SDK เข้ากับโปรเจ็กต์แล้ว ให้ใส่ บรรทัดต่อไปนี้ในไฟล์ที่มีการเรียก API

รวม review.h

หลังจากผสานรวม Play Core Native SDK ลงในโปรเจ็กต์ของคุณแล้ว ให้ใส่ บรรทัดต่อไปนี้ในไฟล์ที่จะมีการเรียก API

#include "play/review.h"

เริ่มต้น Review API

เมื่อใดก็ตามที่คุณต้องการใช้ API คุณต้องเริ่มต้น API นั้นก่อนโดยเรียกการเรียก ReviewManager_init ดังที่ปรากฏในตัวอย่างต่อไปนี้ android_native_app_glue.h:

void android_main(android_app* app) {
  app->onInputEvent = HandleInputEvent;

  ReviewErrorCode error_code = ReviewManager_init(app->activity->vm, app->activity->clazz);
  if (error_code == REVIEW_NO_ERROR) {
    // You can use the API.
  }
}

ขอขั้นตอนการตรวจสอบในแอป

ทำตามคำแนะนำว่าควรขอในแอปเมื่อใด ความเห็น เพื่อพิจารณาจุดที่ดี ในกระบวนการของผู้ใช้ของแอปเพื่อแจ้งให้ผู้ใช้ตรวจสอบ (เช่น หลังจาก ผู้ใช้ปิดหน้าจอสรุปเมื่อสิ้นสุดด่านในเกม) เมื่อ ปิดจุดใดจุดหนึ่งเหล่านี้ โทร ReviewManager_requestReviewFlow เพื่อขอข้อมูลที่แอปของคุณต้องใช้ในการเปิดตัว ขั้นตอนการรีวิวในแอป ตรวจสอบความคืบหน้าของ การดำเนินการโดยการโทร ReviewManager_requestReviewFlow ครั้ง ReviewManager_getReviewStatus, เช่น 1 ครั้งต่อทุกเฟรม อาจใช้เวลา 2-3 วินาที คุณจึง ควรเริ่มกระบวนการนี้ก่อนที่แอปของคุณจะไปถึงจุดเวลาที่คุณต้องการ แสดงขั้นตอนการตรวจสอบในแอป

ReviewErrorCode error_code = ReviewManager_requestReviewFlow();
if (error_code == REVIEW_NO_ERROR) {
    // The request has successfully started, check the status using
    // ReviewManager_getReviewStatus.
} else {
    // Error such as REVIEW_PLAY_STORE_NOT_FOUND indicating that the in-app
    // review isn't currently possible.
}

จัดการสถานะและเปิดขั้นตอนการตรวจสอบในแอป

เมื่อใดก็ตามที่คำขอเริ่มต้นขึ้นหรือขั้นตอนการตรวจสอบในแอปเปิดขึ้น คุณจะทำสิ่งต่อไปนี้ได้ ตรวจสอบสถานะโดยใช้ ReviewManager_getReviewStatus ซึ่งจะช่วยให้คุณกำหนดตรรกะตามสถานะ API ได้ วิธีเดียวในการ ให้รักษาสถานะเป็นตัวแปรร่วม และดูว่า สถานะเป็น REVIEW_REQUEST_FLOW_COMPLETED เมื่อผู้ใช้ดำเนินการ (เช่น แตะปุ่ม "เลเวลถัดไป" ในเกม) ดังที่แสดงใน ตัวอย่างต่อไปนี้

ReviewStatus status;
ReviewErrorCode error_code = ReviewManager_getReviewStatus(&status);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error with the most recent operation.
    return;
}

switch (status) {
    case REVIEW_REQUEST_FLOW_PENDING:
        // Request is ongoing. The flow can't be launched yet.
        break;
    case REVIEW_REQUEST_FLOW_COMPLETED:
        // Request completed. The flow can be launched now.
        break;
    case REVIEW_LAUNCH_FLOW_PENDING:
        // The review flow is ongoing, meaning the dialog might be displayed.
        break;
    case REVIEW_LAUNCH_FLOW_COMPLETED:
        // The review flow has finished. Continue with your app flow (for
        // example, move to the next screen).
        break;
    default:
        // Unknown status.
        break;
}

เมื่อสถานะคือ REVIEW_REQUEST_FLOW_COMPLETED และแอปพร้อมแล้ว ให้เปิด กระบวนการตรวจสอบในแอป

// This call uses android_native_app_glue.h.
ReviewErrorCode error_code = ReviewManager_launchReviewFlow(app->activity->clazz);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error while launching the flow.
    return;
}

หลังจากเปิดขั้นตอนการตรวจสอบในแอปแล้ว ให้ตรวจสอบสถานะอย่างต่อเนื่องว่าเสร็จสมบูรณ์ และดำเนินการตามขั้นตอนของแอปต่อ วิธีทั่วไปในการจัดการกับปัญหานี้คือ ตามรูปแบบ Game Loop

แหล่งข้อมูลฟรี

อย่าลืมทรัพยากรฟรีโดยโทรไปที่ ReviewManager_destroy หลังจากที่แอปของคุณใช้ API เสร็จแล้ว (เช่น หลังจากในแอป ผ่านขั้นตอนการตรวจสอบเรียบร้อยแล้ว)

void ReviewManager_destroy();

ขั้นตอนถัดไป

ทดสอบขั้นตอนการตรวจสอบในแอปเพื่อ ตรวจสอบว่าการผสานรวมทำงานได้อย่างถูกต้อง