ผสานรวมข้อความแจ้งให้ติดตั้งในแอป

คู่มือนี้อธิบายวิธีผสานรวมข้อความแจ้งให้ติดตั้งแอปในแอปโดยใช้ Kotlin หรือ Java

หมายเหตุ: เฉพาะพาร์ทเนอร์ที่ได้รับสิทธิ์ทดลองใช้ก่อนเปิดตัวเท่านั้นที่จะแสดงข้อความแจ้งให้ติดตั้งในแอปได้ ดูข้อมูลเกี่ยวกับการเข้าร่วมโปรแกรมสิทธิ์รับชมก่อนใคร

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

ไลบรารีข้อความแจ้งให้ติดตั้งในแอปของ Play เป็นส่วนหนึ่งของไลบรารี 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)

Java

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

พิจารณาช่วงเวลาที่ดีที่สุดในโฟลว์ของแอปเพื่อแจ้งให้ผู้ใช้ติดตั้งแอปของคุณในอุปกรณ์อื่น (เช่น เมื่อผู้ใช้แคสต์วิดีโอจากโทรศัพท์ไปยังทีวี) เมื่อแอปของคุณถึงจุดใดจุดหนึ่งต่อไปนี้ ให้ทำตามขั้นตอนต่อไปนี้

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
}

Java

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

สำคัญ: หากเกิดข้อผิดพลาดระหว่างโฟลว์ข้อความแจ้งให้ติดตั้งในแอป อย่า แจ้งให้ผู้ใช้ทราบหรือเปลี่ยนโฟลว์ปกติของแอป ดำเนินการตามโฟลว์ปกติของแอปต่อหลังจากเรียกใช้ onComplete

ดูทดสอบข้อความแจ้งให้ติดตั้งแอปเพื่อยืนยันการติดตั้งใช้งาน