Cung cấp các hoạt động định cấu hình trên Wear OS

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ồ.

Hãy tham khảo các thông tin có liên quan sau: