เหตุการณ์ในวงจรและเหตุการณ์การวิเคราะห์

TileService เป็นบริการที่มีผลผูกพัน TileService จะได้รับการเชื่อมโยงเนื่องจากคำขอแอปของคุณ หรือในกรณีที่ระบบต้องสื่อสารกับ TileService วงจรชีวิตของบริการที่เชื่อมโยงโดยทั่วไปจะมีเมธอดการเรียกกลับ 4 รายการ ได้แก่ onCreate(), onBind(), onUnbind() และ onDestroy() ระบบจะเรียกใช้เมธอดเหล่านี้ทุกครั้งที่บริการเข้าสู่ระยะวงจรใหม่

นอกจากการเรียกกลับที่ควบคุมวงจรบริการที่เชื่อมโยงแล้ว คุณยังใช้เมธอดอื่นๆ สำหรับวงจร TileService โดยเฉพาะได้ด้วย บริการการ์ดทั้งหมดต้องใช้ onTileRequest() และ onTileResourcesRequest() เพื่อตอบสนองคำขออัปเดตจากระบบ

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

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

  • onTileRemoveEvent(): ระบบจะเรียกใช้เมธอดนี้เฉพาะในกรณีที่ผู้ใช้นำการ์ดของคุณออกเท่านั้น

  • onTileEnterEvent(): ระบบจะเรียกใช้เมธอดนี้เมื่อการ์ดที่ผู้ให้บริการรายนี้ระบุปรากฏขึ้นบนหน้าจอ

  • onTileLeaveEvent(): ระบบจะเรียกใช้เมธอดนี้เมื่อการ์ดที่ผู้ให้บริการรายนี้ระบุไม่อยู่ในมุมมองบนหน้าจอ

  • onTileRequest(): ระบบจะเรียกใช้เมธอดนี้เมื่อระบบขอไทม์ไลน์ใหม่จากผู้ให้บริการรายนี้

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

ค้นหาว่าการ์ดใดที่ใช้งานอยู่

การ์ดที่ใช้งานอยู่คือการ์ดที่เพิ่มไว้เพื่อแสดงบนนาฬิกา ใช้เมธอดแบบคงที่ getActiveTilesAsync() ของ TileService เพื่อค้นหาว่าการ์ดใดของแอปคุณที่ใช้งานอยู่