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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เปิดให้ผู้ใช้กำหนดค่าวิดเจ็ตที่วางไว้ใหม่

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

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

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