인앱 설치 프롬프트 통합

이 가이드에서는 Kotlin 또는 Java를 사용하여 앱에 인앱 설치 메시지를 통합하는 방법을 설명합니다.

개발 환경 설정

Play In-App Install Prompts 라이브러리는 Google Play Core 라이브러리의 일부입니다. 라이브러리를 사용하려면 다음 Gradle 종속 항목을 포함하세요.

Groovy

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:crossdeviceprompt:0.0.1-eap01'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:crossdeviceprompt:0.0.1-eap01")
    ...
}

CrossDevicePromptManager 만들기

CrossDevicePromptManager는 앱에서 정보를 요청하고 설치 프롬프트 흐름을 실행할 수 있는 인터페이스입니다. 인스턴스를 만들어 가져옵니다.

Kotlin

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest

...

val crossDevicePromptManager: CrossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context)

자바

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory;
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest;

...

CrossDevicePromptManager crossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context);

CrossDevicePromptInstallationRequest 객체 요청

앱의 흐름에서 다른 기기에 앱을 설치하라는 메시지를 사용자에게 표시할 최적의 순간을 결정합니다 (예: 휴대전화에서 TV로 동영상을 전송할 때). 앱이 이러한 지점 중 하나에 도달하면 다음 단계를 실행합니다.

  1. CrossDevicePromptInstallationRequest를 만듭니다.
  2. CrossDevicePromptManager를 사용하여 요청을 매개변수로 허용하는 요청 작업을 만듭니다.

작업이 성공하면 API는 성공 콜백에서 CrossDevicePromptInfo 객체를 반환합니다. 그렇지 않으면 API는 실패 콜백에서 Exception를 반환합니다.

Kotlin

val request: CrossDevicePromptInstallationRequest? =
    CrossDevicePromptInstallationRequest.create()
val result: Task<CrossDevicePromptInfo?> =
    crossDevicePromptManager.requestInstallationPromptFlow(request)

result.addOnSuccessListener { crossDevicePromptInfo ->
    // Requested a prompt flow successfully
}

result.addOnFailureListener { e ->
    // Failed to request a prompt flow
}

자바

CrossDevicePromptInstallationRequest request =
    CrossDevicePromptInstallationRequest.create();
Task<CrossDevicePromptInfo> result =
    crossDevicePromptManager.requestInstallationPromptFlow(request);

result.addOnSuccessListener(crossDevicePromptInfo -> {
    // Requested a prompt flow successfully
});

result.addOnFailureListener(e -> {
    // Failed to request a prompt flow
});

구현을 확인하려면 인앱 설치 메시지 테스트를 참고하세요.