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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ดูวิธีข้ามการตั้งค่าการกำหนดค่าโดยค่าเริ่มต้นได้ที่ส่วนใช้การกำหนดค่าเริ่มต้นของวิดเจ็ตแบบ Compose-first Use the widget's default configuration section ในเอกสารประกอบ Glance