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

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

ตัวอย่างการปักหมุดวิดเจ็ต
รูปที่ 1. ตัวอย่างการปักหมุดวิดเจ็ต

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

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

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

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

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 or PendingIntent.FLAG_IMMUTABLE
    )

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

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