ปักหมุดวิดเจ็ต Glance ในแอป

ใน Android 8.0 (ระดับ API 26) ขึ้นไป คุณสามารถอนุญาตให้ผู้ใช้ปักหมุดวิดเจ็ตไว้ที่หน้าจอหลักภายในแอปของคุณได้ การโปรโมตวิดเจ็ตภายในแอปโดยตรงเป็นวิธีที่ยอดเยี่ยมในการเพิ่มการมีส่วนร่วมของผู้ใช้ โดยเฉพาะหลังจากที่ผู้ใช้ทำงานที่เกี่ยวข้องเสร็จแล้ว หรือเมื่อผู้ใช้เข้าถึงฟีเจอร์ในแอปของคุณซ้ำๆ

สร้างคำขอ PIN

หากต้องการเริ่มการปักหมุดวิดเจ็ต ให้ใช้เมธอด requestPinGlanceAppWidget จากคลาส GlanceAppWidgetManager สำหรับแอปที่ทำงานบน Android เวอร์ชันต่ำกว่า ระบบจะแสดงผลเป็น "เท็จ" อย่างไรก็ตาม หากส่งคำขอไปยังระบบสำเร็จ เมธอดนี้จะแสดงผลเป็น "จริง"

ตัวอย่างวิธีสร้างคำขอ PIN มีดังนี้

@Composable
fun AnInAppComposable() {
    val context = LocalContext.current
    val coroutineScope = rememberCoroutineScope()
    Button(
        onClick = {
            coroutineScope.launch {
                GlanceAppWidgetManager(context).requestPinGlanceAppWidget(
                    receiver = MyWidgetReceiver::class.java,
                    preview = MyWidget(),
                    previewState = DpSize(245.dp, 115.dp)
                )
            }
        }
    ) {}
}
GlancePinAppWidget.kt

ในตัวอย่างนี้ MyWidgetReceiver คือคลาสที่รับ Callback ของวิดเจ็ต และ MyWidget คือวิดเจ็ต Glance ที่คุณต้องการปักหมุด successCallback คือ PendingIntent ที่จะทริกเกอร์เมื่อปักหมุดวิดเจ็ตสำเร็จ

จัดการการตอบกลับคำขอ PIN

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

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