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

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

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

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 một dải hình ảnh được xác định trước, hãy sử dụng ListConfiguration như 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>

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 tập hợp ảnh.

Hỗ trợ một ảnh

Đối với trường hợp một hình ảnh, bạn có thể sử 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>

Lưu ý defaultImageResource, thuộc tính 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à thuộc tính bắt buộc.

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

Hỗ trợ nhiều ảnh

Khi sử dụng PhotosConfiguration với configType="MULTIPLE", mặt đồng hồ có thể hiển thị ảnh trong một bộ sưu tập. Người dùng có thể chuyển đổi giữa các ảnh bằng cách nhấn vào ảnh hoặc ảnh sẽ tự động chuyển đổi sau một số lượt xem nhất định.

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

Ví dụ trước cho thấy hai tuỳ 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 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 thay đổi để phản hồi hoặc khi người dùng nhấn vào ảnh hoặc khi ảnh hiển thị.

  1. Thuộc tính changeAfterEvery chỉ áp dụng cho sự kiện thay đổi ON_VISIBLE, chỉ định số lần ảnh sẽ hiển thị trước khi ảnh được thay đổi. Ví dụ: bạn có thể cảm thấy việc thay đổi ảnh mỗi khi người dùng bật đồ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.