Integracja opinii w aplikacji (natywna)

Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji z zastosowaniem reklam natywnych (C lub C++). W przypadku korzystania z platformy Kotlin dostępne są osobne przewodniki po integracji lub Java albo Unity

Omówienie natywnego pakietu SDK

Pakiet Play Core Native SDK jest częścią podstawowych bibliotek Google Play rodzina. Pakiet Play Core Native SDK zawiera plik nagłówka C review.h, który obejmuje ReviewManager z bibliotek Java Play In-App Review. Ten plik nagłówka umożliwia aplikacji bezpośrednio z kodu natywnego. Ogólne informacje o usługach z dostępnych funkcji, zobacz moduł reklam natywnych Przegląd Play dokumentacji.

ReviewManager_requestReviewFlow rozpoczyna żądanie zebrania informacji, które są niezbędne do uruchomienia podczas sprawdzania aplikacji. Rezultat żądania możesz śledzić za pomocą: ReviewManager_getReviewStatus Więcej informacji o wszystkich stanach, które ReviewManager_getReviewStatus może zwrócić, patrz ReviewErrorCode.

Funkcje żądania i uruchamiania zwracają wartość REVIEW_NO_ERROR, jeśli funkcja działa.

Konfigurowanie środowiska programistycznego

1. Wykonaj jedną z tych czynności:

   • Zainstaluj Android Studio w wersji 4.0 lub nowszej. Korzystanie z pakietu SDK Interfejs menedżera przedstawiający instalowanie pakietu Android SDK Platform w wersji 10.0 (poziom interfejsu API 29).
   • zainstalować narzędzia wiersza poleceń pakietu Android SDK, i użyj sdkmanager do instalacji Platforma Android SDK w wersji 10.0 (poziom interfejsu API 29).

2. Przygotowanie Android Studio do natywnego programowania przy użyciu Menedżer SDK, aby zainstalować najnowszą wersję CMake i Android Native Development Kit (NDK). Więcej informacji na temat: tworzenia lub importowania projektów natywnych, patrz Wprowadzenie do NDK

3. Pobierz plik ZIP i rozpakuj go razem z projektem.

   Link do pobierania	Rozmiar	Suma kontrolna SHA-256
   play-core-native-sdk-1.14.0.zip	36 MiB	782a8522d937848c83a715c9a258b95a3ff2879a7cd71855d137b41c00786a5e

4. Zaktualizuj plik build.gradle aplikacji, jak pokazano poniżej:

   Odlotowe

       // 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. Zaktualizuj pliki CMakeLists.txt aplikacji, jak pokazano poniżej:

   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
           ...)
   

Zbieranie danych

Pakiet Play Core Native SDK może gromadzić dane dotyczące wersji, aby umożliwić Google: ulepszania usługi, w tym:

• Nazwa pakietu aplikacji
• Wersja pakietu aplikacji
• Wersja Core Native SDK w Google Play

Te dane będą zbierane, gdy prześlesz pakiet aplikacji. w Konsoli Play. Aby zrezygnować z tego procesu zbierania danych, usuń Import $playcoreDir/playcore-native-metadata.jar w pliku build.gradle.

Uwaga: te zbieranie danych jest związane z korzystaniem przez Ciebie z podstawowego natywnego pakietu SDK Google Play oraz Google będzie korzystać z zebranych danych oddzielnie i niezależnie od zbiór zależności bibliotek zadeklarowanych w Gradle podczas przesyłania aplikacji do Konsoli Play.

Po zintegrowaniu z projektem natywnego pakietu Play Core dołącz do projektu następujący wiersz w plikach zawierających wywołania interfejsu API:

Dodaj review.h

Po zintegrowaniu z projektem natywnego pakietu Play Core dołącz do projektu następujący wiersz w plikach, które będą zawierać wywołania interfejsu API:

#include "play/review.h"

Inicjowanie interfejsu Review API

Aby użyć interfejsu API, musisz go najpierw zainicjować, wywołując ReviewManager_init jak w przykładzie poniżej utworzonym przy użyciu funkcji 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.
  }
}

Poproś o proces sprawdzania w aplikacji

Postępuj zgodnie ze wskazówkami dotyczącymi tego, kiedy wysyłać prośby w aplikacji opinie, aby określić dobre punkty. w ramach wzorca aplikacji, aby poprosić użytkownika o opinię (np. po kliknięciu zamyka ekran podsumowania po zakończeniu poziomu w grze. Gdy zbliży się do jednego z tych punktów, wywołaj ReviewManager_requestReviewFlow aby asynchronicznie żądać informacji potrzebnych aplikacji do uruchomienia proces sprawdzania. Monitoruj postępy ReviewManager_requestReviewFlow – operacja przez wywołanie ReviewManager_getReviewStatus, np. co 1 klatkę. Może to potrwać kilka sekund, więc ten proces powinien rozpocząć się, zanim aplikacja dotrze do momentu, pokazują proces sprawdzania w aplikacji.

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.
}

Obsługa stanów i uruchamianie procesu sprawdzania aplikacji

Za każdym razem, gdy rozpoczniesz przesyłanie prośby lub rozpocznie się proces sprawdzania w aplikacji, możesz Sprawdź stan za pomocą ReviewManager_getReviewStatus Pozwala to zdefiniować logikę w zależności od stanu interfejsu API. W jedną stronę jest zachowanie stanu w postaci zmiennej globalnej i sprawdzenie, czy stan to REVIEW_REQUEST_FLOW_COMPLETED, gdy użytkownik wykona określoną (np. kliknięcie przycisku „Następny poziom”) w grze, tak jak widać na ekranie następujący przykład:

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

Gdy stan to REVIEW_REQUEST_FLOW_COMPLETED, a aplikacja będzie gotowa, uruchom ją proces sprawdzania aplikacji:

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

Po uruchomieniu procesu sprawdzania w aplikacji sprawdzaj jego stan i kontynuuj korzystanie z aplikacji. Popularnym sposobem rozwiązania tego problemu jest zgodnie ze wzorcem pętli gry.

Bezpłatne materiały

Pamiętaj o zwolnieniu zasobów, dzwoniąc pod numer ReviewManager_destroy gdy aplikacja zakończy korzystanie z interfejsu API (np. po zakończeniu proces sprawdzania).

void ReviewManager_destroy();

Dalsze kroki

Przetestuj proces sprawdzania aplikacji, aby sprawdź, czy integracja działa poprawnie.