關於小工具

小工具是指除了時間之外,錶面上顯示的任何功能。例如,電池指標就是小工具。Complications API 適用於錶面和資料來源應用程式。

本文件其他部分會再說明資料來源、錶面以及小工具類型。

小工具的資料來源

提供資料 (例如電池電量、天氣或步數) 到錶面供小工具使用的應用程式稱為「小工具的資料來源」。這些資料來源會提供原始資料,但不會負責控制在錶面上轉譯資料的方式。如要瞭解如何編寫可提供資料給錶面的應用程式,請參閱「向小工具提供資料」。

下圖顯示 Wear OS by Google 如何中介從來源到錶面的資料流。

小工具的資料流
圖 1. 小工具的資料流。

錶面上的小工具

錶面會從小工具的資料來源接收資料,提供給小工具使用,不需編寫程式碼來取得基礎資料。錶面會保留資料轉譯方式的控制權,以便配合自身設計自然整合資料。詳情請參閱「小工具」相關設計指南。

注意:在即將推出的 Wear OS 版本中,錶面必須使用錶面格式,才能支援包含使用者資料的小工具。建議您更新錶面,使用錶面格式。進一步瞭解這些小工具異動

如要瞭解如何在錶面新增小工具,請參閱「在錶面新增小工具」。

小工具類型

小工具類型可定義小工具中可顯示或資料來源可提供的資料類型。舉例來說,如果資料主要是由短字串組成,可使用 SHORT_TEXT 類型。一個 ComplicationData 物件一律屬於單一小工具類型,用來定義必填及選填欄位。必填欄位代表資料的主要內容,大多數類型名稱多半取自於必填欄位。

資料來源使用的小工具類型與錶面不同:

  • 資料來源會選擇要提供的小工具資料類型 (包括這些類型要提供哪些選填欄位) 以及可支援多少不同類型。舉例來說,步數來源可能會支援 RANGED_VALUESHORT_TEXT 類型,下次會議來源可能會支援 SHORT_TEXTLONG_TEXT 類型。
  • 您可以選擇要新增至錶面的小工具數量,以及支援的小工具類型。舉例來說,錶面上的撥號小工具可能會支援 SHORT_TEXTICONRANGED_VALUE 類型。錶面上的計量表可能僅支援 RANGED_VALUE 類型。

如要進一步瞭解不同小工具類型以及各類型支援的欄位,請參閱「小工具類型」。