กำหนดค่าแอปโทรศัพท์สำหรับการพุชหน้าปัด

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

สําหรับ Marketplace หลัก แอปโทรศัพท์เป็นช่องทางหลักที่ผู้ใช้โต้ตอบกับแอป

ตั้งค่าหน้าปัด

เมื่อผู้ใช้เลือกหน้าปัดในแอปโทรศัพท์ ขั้นตอนการตั้งค่าหน้าปัดต่อจากนั้นจะแบ่งออกเป็น 2 ส่วนดังนี้

1. การติดตั้ง: ติดตั้งหน้าปัดโดยใช้ Watch Face Push ซึ่งเริ่มต้นผ่าน MessageClient ขั้นตอนนี้ทำได้ง่าย ๆ โดยใช้ addWatchFace หรือ updateWatchFace โดยทริกเกอร์โดยใช้ MessageClient จากโทรศัพท์ไปยังนาฬิกา
2. การเปิดใช้งาน: ตั้งค่าหน้าปัดที่ติดตั้งเป็นหน้าปัดที่ใช้งานอยู่ ขั้นตอนนี้มีเส้นทางที่เป็นไปได้หลายเส้นทาง โดยขึ้นอยู่กับสถานะสิทธิ์ ดังนี้
   • คุณอาจไม่ต้องดำเนินการใดๆ มาร์เก็ตเพลสอาจมีการควบคุมหน้าปัดที่ใช้งานอยู่อยู่แล้ว
   • ผู้ใช้อาจไม่จําเป็นต้องดำเนินการใดๆ แอปมีสิทธิ์ที่จําเป็นในการตั้งค่าหน้าปัดที่ใช้งานอยู่ และสามารถดำเนินการดังกล่าวได้โดยตรงโดยใช้ setWatchFaceAsActive()
   • คุณอาจต้องได้รับคำแนะนำเกี่ยวกับวิธียอมรับคำขอสิทธิ์ หรือวิธีตั้งค่าหน้าปัดด้วยตนเองโดยใช้ท่าทางสัมผัสด้วยการกดค้างไว้หรือผ่านแอปที่ใช้ร่วมกัน

การตอบสนองการติดตั้ง

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

• ผลลัพธ์ของการพยายามติดตั้ง
• ผลลัพธ์ของ isWatchFaceActive() - เพื่อระบุว่าแอปมีหน้าปัดที่ใช้งานอยู่อยู่แล้วหรือไม่
• ไม่ว่าจะมีการเรียก setWatchFaceAsActive() ไปแล้วก่อนหน้านี้หรือไม่ แอป Wear OS ควรติดตามและเก็บข้อมูลนี้ไว้ในเครื่อง การเรียก API นี้ใช้ได้เพียงครั้งเดียว

การดำเนินการ

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

สถานการณ์ 1: พยายามตั้งค่าหน้าปัดที่ใช้งานอยู่ทั้งหมดแล้ว

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

สถานการณ์ 2 - ลองตั้งค่าหน้าปัดที่ใช้งานอยู่

โทรศัพท์ควรสั่งให้นาฬิกาตรวจสอบสิทธิ์ SET_PUSHED_WATCH_FACE_AS_ACTIVE ที่จำเป็น ดังนี้

• หากผู้ใช้ให้สิทธิ์แล้ว ให้เรียกใช้ setWatchFaceAsActive()
• หากผู้ใช้ปฏิเสธสิทธิ์ก่อนหน้านี้ นาฬิกาควรสื่อสารเรื่องนี้กลับไปที่โทรศัพท์ ซึ่งจะแสดงหน้าจอให้ความรู้ที่อธิบายถึงความจำเป็นของสิทธิ์และวิธีให้สิทธิ์ด้วยตนเอง

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

  • หากผู้ใช้ให้สิทธิ์แล้ว นาฬิกาจะโทรหา setWatchFaceAsActive()
  • ไม่เช่นนั้น นาฬิกาควรสั่งให้โทรศัพท์แสดงหน้าจอให้ข้อมูลเพื่ออธิบายความจำเป็นของสิทธิ์และวิธีให้สิทธิ์ด้วยตนเอง