การค้นพบวิดเจ็ตได้

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

ตัวอย่างเลย์เอาต์ที่ปรับเปลี่ยนตามอุปกรณ์
รูปที่ 2 ตัวอย่างการปักหมุดวิดเจ็ต

อนุญาตให้ผู้ใช้ปักหมุดวิดเจ็ต

ในแอป คุณสามารถสร้างคําขอให้ระบบปักหมุดวิดเจ็ตลงในโปรแกรมเปิดใช้งานที่รองรับได้โดยทําตามขั้นตอนต่อไปนี้

  1. ตรวจสอบว่าคุณได้ประกาศวิดเจ็ตในไฟล์ Manifest ของแอป

  2. เรียกใช้เมธอด requestPinAppWidget() ดังที่แสดงในข้อมูลโค้ดต่อไปนี้

Kotlin

val appWidgetManager = AppWidgetManager.getInstance(context)
val myProvider = ComponentName(context, ExampleAppWidgetProvider::class.java)

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    val successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT)

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

Java

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
ComponentName myProvider = new ComponentName(context, ExampleAppWidgetProvider.class);

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    PendingIntent successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ new Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT);

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback);
}

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