อนุญาตให้ผู้ใช้กำหนดค่าวิดเจ็ตแอป

วิดเจ็ตแอปสามารถกำหนดค่าได้ ตัวอย่างเช่น วิดเจ็ตนาฬิกาช่วยให้ผู้ใช้กำหนดค่าเขตเวลาที่จะแสดงได้

หากต้องการให้ผู้ใช้กำหนดการตั้งค่าวิดเจ็ตได้ ให้สร้างการกำหนดค่าวิดเจ็ต Activity

ประกาศกิจกรรมการกำหนดค่า

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

ดูวิธีประกาศกิจกรรมการกำหนดค่าได้ที่ส่วนประกาศกิจกรรมการกำหนดค่าในเอกสารประกอบการกำหนดค่า Glance

ใช้กิจกรรมการกำหนดค่า

เนื่องจากกิจกรรมการกำหนดค่าเป็นคอมโพเนนต์มาตรฐานที่เรียกใช้โดย Launcher ของแพลตฟอร์ม Lifecycle Callback พื้นฐานจึงต้องเป็นไปตามกฎค่าที่แสดงผลของระบบ

หากต้องการดูวิธีใช้กิจกรรมการกำหนดค่า โปรดดูส่วนใช้กิจกรรมการกำหนดค่าที่เน้น Compose เป็นหลักในเอกสารประกอบของ Glance

อัปเดตวิดเจ็ตจากกิจกรรมการกำหนดค่า

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

หากคุณกำลังสร้างวิดเจ็ตที่อิงตาม Views เดิมและต้องการอัปเดตเลย์เอาต์ RemoteViews โปรดดูโค้ดตัวอย่างการอัปเดต Views แบบดั้งเดิมใน GitHub สำหรับวิดเจ็ตที่เน้น Compose สมัยใหม่ โปรดดูส่วนอัปเดตจากกิจกรรมการกำหนดค่าในเอกสารประกอบของ Glance

ตัวเลือกการกำหนดค่าวิดเจ็ต

ลักษณะการทำงานของวิดเจ็ต (เช่น การอนุญาตให้กำหนดค่าใหม่ในภายหลังหรือข้ามขั้นตอนการตั้งค่าการกำหนดค่าเริ่มต้นทั้งหมด) จะได้รับการลงทะเบียนภายในแอตทริบิวต์ข้อมูลเมตาโดยใช้แฟล็ก Android 12 มาตรฐาน

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

อนุญาตให้ผู้ใช้กำหนดค่าวิดเจ็ตที่วางไว้อีกครั้ง

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

ใช้การกำหนดค่าเริ่มต้นของวิดเจ็ต

หากต้องการดูวิธีข้ามการตั้งค่าการกำหนดค่าโดยค่าเริ่มต้น โปรดดูส่วนใช้การกำหนดค่าเริ่มต้นของวิดเจ็ตในเอกสารประกอบของ Glance