Định cấu hình ứng dụng điện thoại cho tính năng đẩy mặt đồng hồ

Đối với trang web thương mại chuẩn, ứng dụng điện thoại là cách chính mà người dùng tương tác với ứng dụng.

Đặt mặt đồng hồ

Khi người dùng chọn một mặt đồng hồ trong ứng dụng điện thoại, quy trình tiếp theo sẽ có hai phần để đặt mặt đồng hồ:

  1. Cài đặt: Cài đặt mặt đồng hồ bằng tính năng đẩy mặt đồng hồ, được bắt đầu thông qua MessageClient. Bước này rất đơn giản, sử dụng addWatchFace hoặc updateWatchFace, được kích hoạt bằng MessageClient từ điện thoại đến đồng hồ.
  2. Kích hoạt: Đặt mặt đồng hồ đã cài đặt làm mặt đồng hồ đang hoạt động. Bước này có thể có một số đường dẫn, tuỳ thuộc vào trạng thái quyền:
    • Có thể bạn không cần làm gì cả. Thị trường có thể đã kiểm soát mặt đồng hồ đang hoạt động.
    • Có thể người dùng không cần can thiệp. Ứng dụng có các quyền cần thiết để đặt mặt đồng hồ đang hoạt động và có thể thực hiện việc này trực tiếp bằng cách sử dụng setWatchFaceAsActive().
    • Bạn có thể cần hướng dẫn về cách chấp nhận yêu cầu cấp quyền hoặc cách đặt mặt đồng hồ theo cách thủ công bằng cử chỉ nhấn và giữ hoặc thông qua ứng dụng đồng hành.

Phản hồi cài đặt

Để hỗ trợ giai đoạn Kích hoạt, giai đoạn Cài đặt phải trả về thông tin sau từ đồng hồ đến điện thoại:

  • Kết quả của lượt cài đặt
  • Kết quả của isWatchFaceActive() – để xác định xem ứng dụng đã có mặt đồng hồ đang hoạt động hay chưa.
  • Liệu setWatchFaceAsActive() đã được gọi trước đây hay chưa – ứng dụng Wear OS sẽ theo dõi và lưu trữ thông tin này cục bộ. Lệnh gọi API này chỉ có thể được sử dụng một lần.

Cách triển khai

Sau khi cài đặt, phản hồi có thể cho biết rằng ứng dụng đã có mặt đồng hồ đang hoạt động. Tuy nhiên, nếu không, ứng dụng có thể chọn hiển thị một nút để đặt mặt đồng hồ làm mặt đồng hồ đang hoạt động.

Tình huống 1: Tất cả các nỗ lực đặt mặt đồng hồ đang hoạt động đều không thành công

Nếu phản hồi từ quá trình cài đặt cho biết setWatchFaceAsActive() đã được gọi trước đây, thì nút này sẽ chuyển đến màn hình hướng dẫn trên điện thoại, hướng dẫn người dùng cách chạm và giữ mặt đồng hồ để đặt mặt đồng hồ theo cách thủ công.

Trường hợp 2 – Thử đặt mặt đồng hồ đang hoạt động

Điện thoại sẽ hướng dẫn đồng hồ kiểm tra quyền SET_PUSHED_WATCH_FACE_AS_ACTIVE cần thiết:

  • Nếu người dùng đã cấp quyền, hãy tiếp tục gọi setWatchFaceAsActive().
  • Nếu người dùng từng từ chối cấp quyền, thì đồng hồ sẽ thông báo lại điều này cho điện thoại. Tại đây, một màn hình hướng dẫn có thể hiển thị để giải thích về nhu cầu cấp quyền và cách cấp quyền theo cách thủ công.

  • Nếu chưa từng yêu cầu quyền này, đồng hồ sẽ hướng dẫn điện thoại hiển thị một khoảnh khắc hướng dẫn người dùng cách chấp nhận quyền trên đồng hồ, sau đó đồng hồ sẽ tiến hành yêu cầu quyền.

    • Nếu người dùng cấp quyền, đồng hồ sẽ gọi setWatchFaceAsActive().
    • Nếu không, đồng hồ sẽ hướng dẫn điện thoại hiển thị màn hình hướng dẫn giải thích về nhu cầu cấp quyền và cách cấp quyền theo cách thủ công.