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

สำหรับมาร์เก็ตเพลสที่กำหนด โทรศัพท์เป็นวิธีหลักที่ผู้ใช้โต้ตอบกับแอป

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

เมื่อผู้ใช้เลือกหน้าปัดในแอปโทรศัพท์ ขั้นตอนถัดไปในการตั้งค่าหน้าปัดจะมี 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()
  • หรือนาฬิกาควรสั่งให้โทรศัพท์แสดงหน้าจอการศึกษา ที่อธิบายถึงความจำเป็นในการขอสิทธิ์และวิธีให้สิทธิ์ด้วยตนเอง