Jetpack Compose 阻尼动画效果之SplineBasedDecay

SplineBasedDecay() 是 Jetpack Compose 中的一个函数，用于创建一个基于曲线衰减的动画效果。它通常用于创建平滑的动画效果，比如惯性滚动或惯性拖动的动画效果。

作用：

• 创建基于曲线衰减的动画效果，使得动画在结束时会逐渐减速。
• 提供了更自然和平滑的动画体验，特别是在实现滚动、拖动等交互式操作时。

使用场景：

• 滚动列表或滚动视图的惯性滚动效果：当用户滑动列表或滚动视图后，可以使用 SplineBasedDecay() 创建惯性滚动的动画效果，使得滚动在松手后逐渐减速并停止。
• 拖动操作的惯性效果：当用户拖动某个元素后释放，可以使用 SplineBasedDecay() 创建拖动的惯性动画效果，使得元素在释放后逐渐减速并最终停止。
• 自定义交互式动画：可以结合 SplineBasedDecay() 和其他动画函数，创建自定义的交互式动画效果，比如基于物理模型的动画效果。

private fun Modifier.swipeToDismiss(
    onDismissed: () -> Unit
): Modifier = composed {
    // This `Animatable` stores the horizontal offset for the element.
    val offsetX = remember { Animatable(0f) }
    pointerInput(Unit) {
        // Used to calculate a settling position of a fling animation.
        val decay = splineBasedDecay<Float>(this)
        // Wrap in a coroutine scope to use suspend functions for touch events and animation.
        coroutineScope {
            while (true) {
                // Wait for a touch down event.
                val pointerId = awaitPointerEventScope { awaitFirstDown().id }
                // Interrupt any ongoing animation.
                offsetX.stop()
                // Prepare for drag events and record velocity of a fling.
                val velocityTracker = VelocityTracker()
                // Wait for drag events.
                awaitPointerEventScope {
                    horizontalDrag(pointerId) { change ->
                        // Record the position after offset
                        val horizontalDragOffset = offsetX.value + change.positionChange().x
                        launch {
                            // Overwrite the `Animatable` value while the element is dragged.
                            offsetX.snapTo(horizontalDragOffset)
                        }
                        // Record the velocity of the drag.
                        velocityTracker.addPosition(change.uptimeMillis, change.position)
                        // Consume the gesture event, not passed to external
                        if (change.positionChange() != Offset.Zero) change.consume()
                    }
                }
                // Dragging finished. Calculate the velocity of the fling.
                val velocity = velocityTracker.calculateVelocity().x
                // Calculate where the element eventually settles after the fling animation.
                val targetOffsetX = decay.calculateTargetValue(offsetX.value, velocity)
                // The animation should end as soon as it reaches these bounds.
                offsetX.updateBounds(
                    lowerBound = -size.width.toFloat(),
                    upperBound = size.width.toFloat()
                )
                launch {
                    if (targetOffsetX.absoluteValue <= size.width) {
                        // Not enough velocity; Slide back to the default position.
                        offsetX.animateTo(targetValue = 0f, initialVelocity = velocity)
                    } else {
                        // Enough velocity to slide away the element to the edge.
                        offsetX.animateDecay(velocity, decay)
                        // The element was swiped away.
                        onDismissed()
                    }
                }
            }
        }
    }
        // Apply the horizontal offset to the element.
        .offset { IntOffset(offsetX.value.roundToInt(), 0) }
}

总之，SplineBasedDecay() 用于创建平滑的曲线衰减动画效果，适用于多种交互式场景，提供了更加自然和流畅的用户体验。