Cá nhân hoá bằng ảnh

Lưu ý: Tính năng này có trong phiên bản 4 trở lên của Định dạng mặt đồng hồ.

Việc cho phép người dùng chọn ảnh để đưa vào mặt đồng hồ có thể giúp mang đến nét cá nhân cho trải nghiệm mặt đồng hồ của bạn.

Phần xử lý hình ảnh đã đề cập đến cách hiển thị hình ảnh trong mặt đồng hồ. Nếu bạn muốn cho phép người dùng chọn trong số một loạt hình ảnh được xác định trước, hãy sử dụng ListConfiguration như minh hoạ trong phần xác định cấu hình người dùng.

Để sử dụng hình ảnh trong mặt đồng hồ mà người dùng có thể định cấu hình, hãy dùng phần tử <PhotosConfiguration>, ví dụ:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
watchface_photos.xml

configType có thể là SINGLE hoặc MULTIPLE cho biết liệu người dùng có thể chọn một hình ảnh duy nhất trong ứng dụng đồng hành hay một bộ sưu tập ảnh.

Hỗ trợ một bức ảnh

Đối với trường hợp một hình ảnh, bạn có thể dùng ảnh trong phần tử PartImage như sau:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

Lưu ý defaultImageResource. Thẻ này xuất hiện khi người dùng chưa chọn ảnh trong ứng dụng đồng hành và là một thuộc tính bắt buộc.

Nếu muốn chọn một bức ảnh khác, người dùng phải sử dụng ứng dụng đồng hành để thay thế lựa chọn hiện tại bằng một lựa chọn khác.

Hỗ trợ nhiều ảnh

Việc sử dụng PhotosConfiguration với configType="MULTIPLE" cho phép mặt đồng hồ hiển thị một bức ảnh trong bộ sưu tập. Bạn có thể chuyển đổi giữa các bức ảnh bằng cách nhấn hoặc tự động sau khi đã xem một số lần.

<PartImage x="100" y="250" width="100" height="100">
    <Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
        source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos_multi.xml

Ví dụ trước cho thấy 2 lựa chọn được giới thiệu khi sử dụng MULTIPLE:

  1. Thuộc tính change cho phép nhà phát triển chỉ định những sự kiện nào sẽ khiến ảnh chuyển đổi qua các hình ảnh có sẵn.

Trong ví dụ trước, cả TAP và ON_VISIBLE đều được chỉ định, nghĩa là ảnh sẽ thay đổi khi một trong hai trường hợp sau xảy ra: người dùng nhấn vào ảnh hoặc ảnh xuất hiện.

  1. Thuộc tính changeAfterEvery chỉ áp dụng cho sự kiện thay đổi ON_VISIBLE, cho biết số lần ảnh phải xuất hiện trước khi ảnh được thay đổi. Ví dụ: bạn có thể cảm thấy rằng việc thay đổi ảnh mỗi khi người dùng đánh thức đồng hồ là quá thường xuyên. Giá trị mặc định ở đây là 3.

Để biết thêm thông tin chi tiết về cách làm việc với PhotosConfiguration, hãy xem các mẫu trên GitHub.