作るもの
Android 13はメディア通知のシークバーを描き直した。トラックの再生済み部分は直線ではなく波打つサインウェーブとして描かれ、未再生の残り部分は平らなままで、再生が一時停止するとすぐに全体が直線へと戻る。MediaStyle通知を出すアプリならどれでも、SpotifyやYouTube Musicも含めて、システムからこの見た目をそのまま手に入れる。
これに相当する標準のComposableは存在しない。LinearProgressIndicatorが描くのは一本の直線のトラックだけだ。必要なのは、シームレスにループし、再生が進むにつれて正確な位置までトリムされるウェーブ形のストロークだ。さらに、求められればフラットに戻り、切り落とされたような端ではなくきれいに丸められた先端を保つ必要もある。
フルソース: WavyLoaderScreen.kt。
直感的な理解
- このウェーブに
sin()は不要だ。各半周期は 内の1本の二次ベジェ曲線であり、両端は中心線上にあり、1つの制御点がそれを上下に引き上げる。以下の4つのステップはすべて、同じ2本のカーブで作る膨らみを再利用している。 - ウェーブを正確な先端にトリムすることと、再生済み/未再生に分割することは、どちらも同じ問いに帰着する。「このベジェ曲線は今まさに、実際にはどこで終わっているのか?」ステップ3は曲線分割の公式でこれに一度だけ答える。ステップ4は、固定の終点の代わりに動く再生位置を終点として、その答えを再利用する。
StrokeCap.Roundはパスの実際の端点だけを丸める。ウェーブをウィンドウでクリッピングするとピクセルが切り取られ、平らな切り口が残る。曲線そのものをトリムすることで初めて、丸いキャップが丸めるべき実際の曲線の終点が得られる。
- →Traveling Wave Phase: Turning Position and Time Into One AngleThe phase math (position + time → one angle) the shift-as-phase trick in Step 2 is built on, generalized beyond a single scrolling line.
- →Quadratic vs Cubic Bezier vs Arc: Picking the Right Path CurveWhy quadraticTo is the right curve type for a wave's dip-then-rise shape, and when a cubic or arc would be the better call instead.
- →animate*AsState vs Animatable: Animation Is Just an Interpolated ValueWhy this post calls Animatable.animateTo directly inside a coroutine instead of animate*AsState, letting amplitude, shift, and progress stage and cancel independently.
ステップ1: 対になった二次ベジェ曲線としてウェーブをサンプリングする
// crop the drawing to exactly WAVE_COUNT waves wide
clipRect(
left = 0f,
top = center.y - (amplitude * 2),
right = (waveLength * WAVE_COUNT),
bottom = center.y + (amplitude * 2)
) {
val path = Path().apply {
moveTo(0f, center.y)
repeat(WAVE_COUNT + 1) { idx ->
val quarterWaveLength = waveLength / 4
val startX = (waveLength * idx)
val endX = waveLength * (idx + 1)
val midPointX = startX + (endX - startX) / 2
val controlPoint1 = Offset(
x = startX + quarterWaveLength,
y = center.y - (amplitude * 2)
)
val controlPoint2 = Offset(
x = midPointX + quarterWaveLength,
y = center.y + (amplitude * 2)
)
quadraticTo(x1 = controlPoint1.x, y1 = controlPoint1.y, x2 = midPointX, y2 = center.y)
quadraticTo(x1 = controlPoint2.x, y1 = controlPoint2.y, x2 = endX, y2 = center.y)
}
}
drawPath(
path = path,
color = theme.primary,
style = Stroke(width = WAVE_WIDTH.toPx(), cap = StrokeCap.Round)
)
}どのウェーブも2回のquadraticTo呼び出しでできている。どちらの曲線もcenter.y上で始まり終わり、異なるのは制御点だけだ。
- 最初の曲線の制御点は
center.y - amplitude * 2にある。画面のyは下方向に増えるので、この半分は上に膨らむ。 - 2番目の曲線の制御点は
center.y + amplitude * 2にあるので、下に膨らみ、endXでcenter.yに戻って着地する。
制御点のyオフセットはamplitudeではなくamplitude * 2だ。二次ベジェ曲線の中点は、制御点の端点からのオフセットの半分の位置にあるため、制御点のオフセットを2倍にすることで曲線の実際の視覚的なピークがamplitudeと等しくなる。
WAVE_COUNT + 1個のウェーブが作られる。これはclipRect内に収まる数より1つ多い。その余分なウェーブは右端からはみ出し、今のところは切り取られて見えないが、ステップ2でこのパスがスクロールを始めたときに、常に次に滑り込んでくる完全なウェーブが1つ用意されていることになる。
ステップ2: アニメーションする位相シフトでウェーブをループさせる
val shiftAnimatable = remember { Animatable(0f) }
LaunchedEffect(Unit) {
shiftAnimatable.animateTo(
targetValue = waveLength,
animationSpec = infiniteRepeatable(
animation = tween(durationMillis = 1000, easing = LinearEasing),
repeatMode = RepeatMode.Restart
)
)
}
// same clipRect and path-building loop as Step 1, now offset by the animated shift
val path = Path().apply {
moveTo(0f - shiftAnimatable.value, center.y)
repeat(WAVE_COUNT + 1) { idx ->
val startX = (waveLength * idx) - shiftAnimatable.value
val endX = waveLength * (idx + 1) - shiftAnimatable.value
// ...same control points and quadraticTo calls as Step 1
}
}サンプリングされるすべてのxからアニメーションするshiftの値を引くことで、ウェーブのパターン全体が左にスライドする。infiniteRepeatableとRepeatMode.Restartを使ってshiftを0から1つのwaveLengthまでアニメーションさせることで、1000msごとに0へ飛び戻るようになる。
ウェーブはwaveLengthごとに繰り返されるので、clipRectのウィンドウ内では、shift = 0とshift = waveLengthはピクセル単位で同一の曲線を描く。この飛びは、見た目が同じ2フレーム間の飛びであるため見えない。ウィンドウの外側ではパスの端は実際に動いているが、これはまさにクリップがそれを隠すために存在している。
ステップ3: クリッピングせずに先端を正確にトリムする
// blends a and b by fraction t: t=0 returns a, t=1 returns b
private fun lerp(a: Offset, b: Offset, t: Float): Offset =
Offset(a.x + (b.x - a.x) * t, a.y + (b.y - a.y) * t)
// De Casteljau split: returns the control points of quadratic Bézier (p0, c, p2)
// restricted to the parameter range [t0, t1], reparameterized back to [0, 1].
private fun trimQuadratic(
p0: Offset, c: Offset, p2: Offset,
t0: Float, t1: Float,
): Triple<Offset, Offset, Offset> {
val q0 = lerp(p0, c, t0)
val q1 = lerp(c, p2, t0)
val tailP0 = lerp(q0, q1, t0)
if (t1 >= 1f) return Triple(tailP0, q1, p2)
val t1Prime = (t1 - t0) / (1f - t0)
val s0 = lerp(tailP0, q1, t1Prime)
val s1 = lerp(q1, p2, t1Prime)
val headP2 = lerp(s0, s1, t1Prime)
return Triple(tailP0, s0, headP2)
}ステップ1と2では、ウェーブをclipRectで終わらせているが、クリップはピクセルを切り取るだけだ。パス自体はウィンドウを越えて続いているので、StrokeCap.Roundが丸めるべき端点を見つけることは決してない。ストロークはウィンドウの直線的な端で、曲線の途中で、平らな切り口のまま止まってしまう。
実際に丸い先端を得るには、曲線そのものがちょうど境界線で終わる必要があり、それは切り取られた曲線ではなく、別の、より短い曲線でなければならないということだ。ベジェ曲線自身の点同士をパラメータtで繰り返しすることはであり、これによって曲線を2本の曲線に分割し、それぞれが依然として有効なベジェ曲線であり、tにおいて正確に共有点を持つようにできる。
trimQuadraticはこの分割を2回適用する。1回はt0で、それより前の部分を落とすため。もう1回はt1で、それより後の部分を落とすためだ。
ただし2回目の分割では、t1をそのまま再利用することはできない。t1は元の曲線に対する割合だったが、2回目の分割が実行される時点では、1回目の分割によって曲線は既に(tailP0, q1, p2)へと短縮されている。t1Primeは、2回目の分割が実行される前に、t1をその短くなった残りの部分に対して再スケールする。そして関数はその残りの部分の3つの点を返す。
drag either handle along the curve — trimmed from t=0.25 to t=0.72
trimQuadratic(
p0 = Offset(20f, 150f), c = Offset(150f, 30f), p2 = Offset(280f, 150f),
t0 = 0.25f, t1 = 0.72f,
)デモ内のP0、C、P2は、trimQuadraticが引数として受け取る同名のパラメータだ。すなわち、曲線の固定された開始点、制御点、終了点だ。いずれかのハンドルを曲線に沿ってドラッグして、t0かt1を選んでみてほしい。
ドラッグ中に光る細い線はQ0-Q1で、2回目のlerpが沿って進むセグメントだ。ハンドル自体は、どちらのハンドルを動かしたかに応じて、tailP0かheadP2にそのlerpが行き着く位置だ。中央の実線のセグメントがtrimQuadraticの実際の戻り値であり、元の曲線を切り取ったコピーではない。
repeat(WAVE_COUNT + 1) { idx ->
val segmentStart = (waveLength * idx) - shiftAnimatable.value
// each full wave is two quadratic halves: dip down, then rise back up
for (half in 0..1) {
val halfStart = segmentStart + half * halfWaveLength
val halfEnd = halfStart + halfWaveLength
if (halfEnd <= leftBound || halfStart >= rightBound) continue
val controlYOffset = if (half == 0) -amplitude * 2 else amplitude * 2
val p0 = Offset(halfStart, center.y)
val c = Offset(halfStart + quarterWaveLength, center.y + controlYOffset)
val p2 = Offset(halfEnd, center.y)
val t0 = if (halfStart < leftBound) (leftBound - halfStart) / halfWaveLength else 0f
val t1 = if (halfEnd > rightBound) (rightBound - halfStart) / halfWaveLength else 1f
val (trimmedP0, trimmedC, trimmedP2) = trimQuadratic(p0, c, p2, t0, t1)
if (!started) {
path.moveTo(trimmedP0.x, trimmedP0.y)
started = true
}
path.quadraticTo(trimmedC.x, trimmedC.y, trimmedP2.x, trimmedP2.y)
}
}描画ループは各半波を走査し、t0/t1を「その半波のうち[leftBound, rightBound]の内側に実際に収まる割合」として計算する。完全にウィンドウの内側にある半波はt0 = 0、t1 = 1となり、これは「半波全体を使い、何もトリムしない」ことを意味する。境界が実際に通り抜ける1つか2つの半波だけが、本当のトリムを受ける。
t0=0 t1=0.22 the highlighted half-wave is the only one actually trimmed; every other curve passes trimQuadratic unchanged
every half-wave above passes through trimQuadratic, but only the highlighted one gets a real trim: the rest come back as t0=0, t1=1, unchanged
このバージョンではclipRectを完全に取り除いている。パスは今、実際にleftBoundとrightBoundで終わっているので、StrokeCap.Roundはループのどの位相であっても両端を正確に丸める。
デ・カステリョのアルゴリズムが実際に曲線を分割する仕組み
二次ベジェ曲線の場合、任意のtで曲線を評価することは、次の順序で行う3回の線形補間に帰着する。
lerp(p0, c, t)、結果をq0と呼ぶlerp(c, p2, t)、結果をq1と呼ぶlerp(q0, q1, t)、tにおける曲線の実際の位置
最初の2つは互いに依存しない。どちらも元の3つの点の間を単純にブレンドするだけだ。3番目こそが実際にそれらを使うもので、q0とq1を一緒にブレンドする。
trimQuadraticはまさにこの最初の2回の線形補間を実行し、結果をq0とq1と名付けている。上のドラッグ可能なデモは、すでにそれらを示している。Q0-Q1はドラッグ中に光る細いセグメントだ。
違いはその次に何が起こるかだ。曲線を評価すると、q0とq1は1つの最終的な点に畳み込まれ、捨てられる。分割する場合は、1回手前の線形補間で止めてそれらを保持する。というのも、q0、q1、そしてその最終的にブレンドされた点tailP0自体が、新しい、より短いベジェ曲線の3つの制御点になるからだ。
分割ごとに、こうした3つ組が2組存在する。(p0, q0, tailP0)は曲線の0からtまでをカバーし、(tailP0, q1, p2)はtから1までをカバーする。これらがtailP0でちょうど一致するのは、その点がもともと両方の半分を一緒にブレンドして作られたものであり、元の曲線上の点を選んでそれが一致することを期待したわけではないからだ。trimQuadraticは常に2番目の3つ組だけを保持する。これは、呼び出しのたびに、あるtより前のすべてを切り取っているからであり、それが実際のt0であろうと、再スケールされたt1Primeであろうと変わらない。
ステップ4: 再生済み/未再生を分割し、一時停止時にフラット化する
var isPlaying by remember { mutableStateOf(true) }
val shiftAnimatable = remember { Animatable(0f) }
val amplitudeAnimatable = remember { Animatable(fullAmplitude) }
val progressAnimatable = remember { Animatable(0f) }
LaunchedEffect(isPlaying) {
if (isPlaying) {
amplitudeAnimatable.animateTo(fullAmplitude, animationSpec = tween(300))
launch {
shiftAnimatable.animateTo(
targetValue = shiftAnimatable.value + waveLength,
animationSpec = infiniteRepeatable(
animation = tween(durationMillis = 1000, easing = LinearEasing),
repeatMode = RepeatMode.Restart
)
)
}
val remainingMillis = ((1f - progressAnimatable.value) * PLAYBACK_DURATION_MILLIS).toInt()
progressAnimatable.animateTo(
targetValue = 1f,
animationSpec = tween(durationMillis = remainingMillis.coerceAtLeast(1), easing = LinearEasing)
)
} else {
amplitudeAnimatable.animateTo(0f, animationSpec = tween(300))
}
}これはステップ3の正確なトリムをそのまま再利用している。変わるのはトリムの境界だけだ。ループの固定されたrightBoundが、独自のAnimatableによって駆動される動くprogressXに置き換わる。同じ丸い先端の数式が、再生が進むにつれて目に見えて成長していく先端を生み出すようになる。もはや静的なループの端ではない。
val progressX = leftBound + progressAnimatable.value * (rightBound - leftBound)
// ...same trimQuadratic loop as Step 3, culled and trimmed against
// progressX instead of rightBound...
drawPath(path = wavyPath, color = theme.primary, style = Stroke(WAVE_WIDTH.toPx(), cap = StrokeCap.Round))
// Skipped once progress reaches the end: a zero-length line still
// renders its StrokeCap.Round as a filled dot, pinned at rightBound
// forever while the wavy portion keeps animating past it.
if (progressX < rightBound) {
drawLine(
color = theme.primary.copy(alpha = 0.3f),
start = Offset(progressX, center.y),
end = Offset(rightBound, center.y),
strokeWidth = WAVE_WIDTH.toPx(),
cap = StrokeCap.Round
)
}未再生の残り部分は、progressXからrightBoundまでの、より低いアルファ値で描かれた単純なdrawLineだ。progressXがrightBoundに達した時点でこれはスキップされる。なぜなら、長さがゼロの線でもStrokeCap.Roundは塗りつぶされた点として描画されてしまうからだ。その点は画面上の1つの位置に固定されたままになり、波打つ部分がその先をループし続ける一方で、これはストロークがその場で跳ねているように見えてしまう。
一時停止するとシフトのループが停止し(LaunchedEffect(isPlaying)はキーが変わった瞬間に以前のコルーチンをキャンセルする)、amplitudeは短いtweenで0へとイーズする。すべての曲線のアンカー点はすでにcenter.y上にあり、動くのは制御点だけなので、amplitudeを0に縮めることで、波打つ部分全体が、未再生の残り部分がもともとそうだった同じ平らな線へと退化する。別途フラット化のパスを用意する必要はない。
infiniteRepeatableの再開
animateTo(targetValue, infiniteRepeatable(...))は、呼び出された瞬間にアクティブな初期値・目標値のペアをそのまま固定し、RepeatMode.Restartはそのペアを永遠に繰り返し再生する。つまり0に戻るのではなく、呼び出し時の初期値に戻ってジャンプする。固定のwaveLengthをターゲットにすると、シフトが0から始まる最初の1回はうまく機能する。しかし一時停止後の再開ごとに、シフトは停止していた位置から始まるので、ターゲットは固定のリテラル値ではなくshiftAnimatable.value + waveLengthを追う必要がある。そうしないと、再開されたループはすべて、一時停止したときに偶然そうなっていた任意の位相へと飛んでしまう。
バリエーションとトレードオフ
- クリッピング vs トリミング。 ステップ2の
clipRectは呼び出し1回で済み、曲線1本あたりの追加コストもない。ウェーブの端がどうせ隠れている場合、たとえば指の下にあったり、コンテナの端にぴったり収まっている場合には、良い選択だ。しかし、これでは丸い先端を生み出すことは決してできない。それがステップ3と4で曲線そのものをトリムする理由だ。 - サンプリングの解像度はウェーブ単位で固定されており、ピクセル単位ではない。 各半波が線分の連なりではなく1本の二次曲線であるため、
WAVE_COUNTが制御するのは膨らみがいくつ収まるかであり、1つの膨らみがどれだけ滑らかかではない。ウェーブを1つ増やすごとに増えるコストは、trimQuadraticの呼び出しがさらに2回(半波1つにつき1回)増えるだけであり、lineToベースのアプローチのように数百もの追加サンプル点が増えるわけではない。 PLAYBACK_DURATION_MILLISとシフトループの速度は独立したつまみだ。 1波長あたり1000msのさざ波のtweenは、PLAYBACK_DURATION_MILLISを読み取ることは一切ない。再生速度とウェーブ自身の移動速度は、互いの数式に触れることなく、別々に調整できる。- 再開時は、動く前にウェーブが再び成長する。
LaunchedEffect(isPlaying)は、シフトループと進行度のtweenを開始する前に、300msの振幅tweenを待つ。そのため再開時には、ウェーブはその場で固まったまま成長し、それからスクロールを始める。3つすべてを同時に始めたい場合は、振幅のtweenも独自のlaunchブロックで起動すべきだ。 - 長さゼロの線の点は、進行度が最大になったときだけ現れる。 これは実装してしまいやすく、かつ手軽な確認では見逃しやすい。なぜなら、大半の手動テストは再生の途中で行われるからだ。このようにストロークを2つの異なるスタイルのセグメントに分割するバーでは、中間だけでなく
0と1という両方の進行度の端を、意識的に確認する価値がある。



