SecondHand

秒針は時計で 1 分ごとに 1 回ウォッチフェイスの周りを回転する針です。

Wear OS 4 から導入されました。

構文

<SecondHand resource ="string" x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float" alpha="integer"
             tintColor="argb-color | rgb-color" />

属性

SecondHand 要素には次の属性があります。

必須属性

次の属性は必須です。

resource
res ディレクトリにあるドローアブルの名前に対応したリソース ID。
x、y、width、height
要素のサイズと位置を指定する整数のコレクション。

オプションの属性

次の属性は省略可能です。

pivotX、pivotY
要素が回転する中心となる 2 次元のピボット ポイント。どちらの値も浮動小数点数であり、$ [0, 1] $ の範囲に収まるように調整されます。
alpha
この要素に必要な透過性レベルを設定します。値 0 は要素が完全に透明であることを表します。値 255 は要素が完全に不透明であることを表します。
tintColor
要素に色合い調整フィルタを適用します。ARGB 形式（#ff000000 = 不透明な黒）または RGB 形式（#000000 = 黒）を使用して、色を指定する必要があります。

内部要素

SecondHand 要素には次のいずれかの要素を含めることができます。

Sweep
要素がウォッチフェイスの周りを連続的に動きます。詳しくは、Sweep リファレンスをご覧ください。
Tick
要素がウォッチフェイスの周りを個別の短いバーストで動きます。詳しくは、Tick リファレンスをご覧ください。

また、SecondHand 要素には次の内部要素を含めることができます。

Variant
Wear OS デバイスがアンビエント モードのときに、この要素の属性を変更できるようにします。詳しくは、Variant リファレンスをご覧ください。