Một số mặt đồng hồ hỗ trợ các tham số cấu hình để cho phép người dùng tuỳ chỉnh giao diện và hành vi của mặt đồng hồ. Ví dụ: một số mặt đồng hồ cho phép người dùng chọn màu nền tuỳ chỉnh. Các mặt đồng hồ khác cho biết thời gian của 2 múi giờ khác nhau giúp người dùng chọn được múi giờ mà họ quan tâm.
Mặt đồng hồ hỗ trợ các tham số cấu hình để người dùng có thể tuỳ chỉnh mặt đồng hồ bằng một hoạt động. Người dùng có thể bắt đầu hoạt động định cấu hình thiết bị đeo trên thiết bị đeo. Người dùng cũng có thể bắt đầu hoạt động định cấu hình đồng hành từ ứng dụng cầm tay nếu ứng dụng đã được cài đặt. Ngoài ra, người dùng có thể định cấu hình mặt đồng hồ trong ứng dụng đồng hành với thiết bị cho các thiết bị Wear OS 3.
Lưu ý: Cấu hình trên ứng dụng đồng hành với thiết bị có sẵn trên các thiết bị nhắm đến API cấp 30 trở lên. Cấu hình trên ứng dụng cầm tay có trên mọi thiết bị.
Sử dụng phiên chỉnh sửa
Bạn nên hỗ trợ cấu hình trên đồng hồ thông minh để người dùng có thể tuỳ chỉnh mặt đồng hồ của mình mà không cần đến thiết bị đồng hành.
Để hỗ trợ việc này, mặt đồng hồ có thể cung cấp cấu hình Activity
và cho phép người dùng thay đổi các chế độ cài đặt bằng cách sử dụng EditorSession
do EditorSession.createOnWatchEditorSession
trả về.
Khi người dùng thực hiện các thay đổi, lệnh gọi EditorSession.renderWatchFaceToBitmap
sẽ cung cấp bản xem trước trực tiếp của mặt đồng hồ trong Activity
của trình chỉnh sửa.
Chỉ định ý định cho hoạt động định cấu hình
Nếu mặt đồng hồ có các hoạt động định cấu hình và bạn đang định cấu hình mặt đồng hồ qua ứng dụng đồng hành với thiết bị, hãy thêm các mục siêu dữ liệu sau đây vào nội dung khai báo dịch vụ trong tệp kê khai của ứng dụng cho thiết bị đeo:
<service> <meta-data android:name="com.google.android.wearable.watchface.wearableConfigurationAction" android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" /> <meta-data android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled" android:value="true" /> </service>
Các hoạt động định cấu hình đăng ký bộ lọc ý định cho ý định này và hệ thống sẽ kích hoạt ý định này khi người dùng muốn định cấu hình mặt đồng hồ của bạn.
Nếu mặt đồng hồ chỉ bao gồm một hoạt động đồng hành hoặc hoạt động định cấu hình thiết bị đeo, thì bạn chỉ cần thêm mục nhập siêu dữ liệu tương ứng theo ví dụ ở trên.
Tạo hoạt động định cấu hình cho thiết bị đeo
Các hoạt động định cấu hình thiết bị đeo cung cấp một tập hợp các lựa chọn tuỳ chỉnh có giới hạn cho mặt đồng hồ, vì các trình đơn phức tạp khó di chuyển trên màn hình nhỏ hơn. Trong hoạt động định cấu hình thiết bị đeo, hãy cung cấp các lựa chọn nhị phân và chỉ một vài lựa chọn để tuỳ chỉnh các khía cạnh chính của mặt đồng hồ.
Để tạo một hoạt động định cấu hình thiết bị đeo, hãy thêm hoạt động mới vào mô-đun ứng dụng cho thiết bị đeo của bạn và khai báo bộ lọc ý định sau đây trong tệp kê khai của ứng dụng cho thiết bị đeo:
<activity android:name=".DigitalWatchFaceWearableConfigActivity" android:label="@string/digital_config_name"> <intent-filter> <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" /> <category android:name= "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Tên của hành động trong bộ lọc ý định này phải là androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR
.
Trong hoạt động định cấu hình, hãy tạo một giao diện người dùng đơn giản có các lựa chọn để người dùng có thể tuỳ chỉnh mặt đồng hồ.
Tạo một hoạt động cấu hình đồng hành
Hoạt động định cấu hình đồng hành cho phép người dùng tiếp cận tập hợp đầy đủ các lựa chọn cấu hình cho mặt đồng hồ, vì họ có thể tương tác dễ dàng hơn với các trình đơn phức tạp trên màn hình lớn hơn của thiết bị cầm tay. Ví dụ: hoạt động cấu hình trên thiết bị cầm tay cho phép bạn hiển thị cho người dùng các công cụ chọn màu sắc chi tiết để chọn màu nền của mặt đồng hồ.
Lưu ý: Bạn chỉ có thể viết các hoạt động định cấu hình cho thiết bị cầm tay chạy Android, chẳng hạn như điện thoại, máy tính bảng và thiết bị có thể gập lại.
Để tạo một hoạt động cấu hình đồng hành, hãy thêm một hoạt động mới vào mô-đun ứng dụng cầm tay của bạn rồi khai báo bộ lọc ý định sau đây trong tệp kê khai của ứng dụng cầm tay đó:
<activity android:name=".DigitalWatchFaceCompanionConfigActivity" android:label="@string/app_name"> <intent-filter> <action android:name= "com.example.android.wearable.watchface.CONFIG_DIGITAL" /> <category android:name= "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Trong hoạt động định cấu hình, hãy xây dựng một giao diện người dùng cung cấp các tuỳ chọn để tuỳ chỉnh mọi thành phần có thể định cấu hình của mặt đồng hồ. Sau khi người dùng đưa ra lựa chọn, hãy sử dụng API Lớp dữ liệu trên thiết bị đeo để thông báo về thay đổi cấu hình đối với hoạt động trên mặt đồng hồ.
Thông tin có liên quan
Hãy tham khảo các thông tin có liên quan sau: