คู่มือนี้อธิบายวิธีผสานรวมรีวิวในแอปไว้ในแอปของคุณโดยใช้โฆษณาเนทีฟ (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
หากฟังก์ชัน
สำเร็จ
ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์
Download Play Core Native SDK
Before downloading, you must agree to the following terms and conditions.
Terms and Conditions
Last modified: September 24, 2020- By using the Play Core Software Development Kit, you agree to these terms in addition to the Google APIs Terms of Service ("API ToS"). If these terms are ever in conflict, these terms will take precedence over the API ToS. Please read these terms and the API ToS carefully.
- For purposes of these terms, "APIs" means Google's APIs, other developer services, and associated software, including any Redistributable Code.
- “Redistributable Code” means Google-provided object code or header files that call the APIs.
- Subject to these terms and the terms of the API ToS, you may copy and distribute Redistributable Code solely for inclusion as part of your API Client. Google and its licensors own all right, title and interest, including any and all intellectual property and other proprietary rights, in and to Redistributable Code. You will not modify, translate, or create derivative works of Redistributable Code.
- Google may make changes to these terms at any time with notice and the opportunity to decline further use of the Play Core Software Development Kit. Google will post notice of modifications to the terms at https://developer.android.com/guide/playcore/license. Changes will not be retroactive.
เลือกดำเนินการอย่างหนึ่งดังต่อไปนี้
- ติดตั้ง Android Studio เวอร์ชัน 4.0 ขึ้นไป ใช้ SDK UI ของ Manager เพื่อติดตั้งแพลตฟอร์ม Android SDK เวอร์ชัน 10.0 (API ระดับ 29)
- ติดตั้งเครื่องมือบรรทัดคำสั่ง Android SDK
และใช้
sdkmanager
เพื่อติดตั้ง แพลตฟอร์ม Android SDK เวอร์ชัน 10.0 (API ระดับ 29)
เตรียม Android Studio สำหรับการพัฒนาในตัวโดยใช้ SDK Manager เพื่อติดตั้งเวอร์ชันล่าสุด CMake และ Android Native Development Kit (NDK) สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ การสร้างหรือการนำเข้าโปรเจ็กต์เนทีฟ โปรดดู เริ่มต้นใช้งาน NDK
ดาวน์โหลดไฟล์ ZIP และแตกข้อมูลควบคู่ไปกับโปรเจ็กต์ของคุณ
ลิงก์ดาวน์โหลด ขนาด ผลรวมตรวจสอบ SHA-256 36 MiB 782a8522d937848c83a715c9a258b95a3ff2879a7cd71855d137b41c00786a5e อัปเดตไฟล์
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")) ... }
อัปเดตไฟล์
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();
ขั้นตอนถัดไป
ทดสอบขั้นตอนการตรวจสอบในแอปเพื่อ ตรวจสอบว่าการผสานรวมทำงานได้อย่างถูกต้อง