مثال پویانمایی پیشرفته: اشاره‌ها

وقتی با رویدادهای لمسی و پویانمایی‌ها کار می‌کنید، باید موارد بیشتری را نسبت به زمانی که فقط با پویانمایی‌ها کار می‌کنید درنظر بگیرید. ابتدا، ممکن است لازم باشد پویانمایی درحال اجرا را هنگام شروع رویدادهای لمسی قطع کنید، زیرا تعامل کاربر باید بالاترین اولویت را داشته باشد.

مثال زیر از Animatable برای نشان دادن موقعیت افست یک مؤلفه دایره استفاده می‌کند. رویدادهای لمسی با اصلاح‌کننده pointerInput پردازش می‌شوند. وقتی نمونه رویداد ضربه جدیدی را شناسایی می‌کند، animateTo را فراخوانی می‌کند تا مقدار افست را به موقعیت ضربه پویانمایی کند. رویداد تک‌ضرب هم می‌تواند درطول پویانمایی اتفاق بیفتد و در این صورت، animateTo پویانمایی درحال اجرا را قطع می‌کند و پویانمایی را به موقعیت هدف جدید شروع می‌کند، درحالی‌که سرعت پویانمایی قطع‌شده را حفظ می‌کند.

@Composable
fun Gesture() {
    val offset = remember { Animatable(Offset(0f, 0f), Offset.VectorConverter) }
    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerInput(Unit) {
                coroutineScope {
                    while (true) {
                        // Detect a tap event and obtain its position.
                        awaitPointerEventScope {
                            val position = awaitFirstDown().position

                            launch {
                                // Animate to the tap position.
                                offset.animateTo(position)
                            }
                        }
                    }
                }
            }
    ) {
        Circle(modifier = Modifier.offset { offset.value.toIntOffset() })
    }
}

private fun Offset.toIntOffset() = IntOffset(x.roundToInt(), y.roundToInt())

الگوی رایج دیگر همگام‌سازی مقادیر پویانمایی با مقادیر دریافتی از رویدادهای لمسی، مانند کشیدن، است. مثال زیر «تند کشیدن برای بستن» را به‌عنوان اصلاح‌کننده پیاده‌سازی می‌کند، نه بااستفاده از SwipeToDismissBox composable. انحراف افقی عنصر به‌صورت Animatable نشان داده می‌شود. این میانای برنامه‌سازی کاربردی ویژگی‌ای دارد که در پویانمایی اشاره مفید است. مقدار آن را می‌توان با رویدادهای لمسی و همچنین پویانمایی تغییر داد. در رویداد لمس کردن، اصلاح‌کننده Animatable را با روش stop متوقف می‌کند تا هر پویانمایی درحال اجرا رهگیری شود.

درطول رویداد کشیدن، اصلاح‌کننده از snapTo برای به‌روزرسانی مقدار Animatable با مقدار محاسبه‌شده از رویدادهای لمسی استفاده می‌کند. برای پرتاب، Compose VelocityTracker را برای ثبت رویدادهای کشیدن و محاسبه سرعت ارائه می‌دهد. سرعت می‌تواند مستقیماً به animateDecay برای پویانمایی پرتابی ارسال شود. برای برگرداندن مقدار آفست به موقعیت اصلی، اصلاح‌کننده مقدار آفست هدف 0f را با روش animateTo مشخص می‌کند.

fun Modifier.swipeToDismiss(
    onDismissed: () -> Unit
): Modifier = composed {
    val offsetX = remember { Animatable(0f) }
    pointerInput(Unit) {
        // Used to calculate fling decay.
        val decay = splineBasedDecay<Float>(this)
        // Use suspend functions for touch events and the Animatable.
        coroutineScope {
            while (true) {
                val velocityTracker = VelocityTracker()
                // Stop any ongoing animation.
                offsetX.stop()
                awaitPointerEventScope {
                    // Detect a touch down event.
                    val pointerId = awaitFirstDown().id

                    horizontalDrag(pointerId) { change ->
                        // Update the animation value with touch events.
                        launch {
                            offsetX.snapTo(
                                offsetX.value + change.positionChange().x
                            )
                        }
                        velocityTracker.addPosition(
                            change.uptimeMillis,
                            change.position
                        )
                    }
                }
                // No longer receiving touch events. Prepare the animation.
                val velocity = velocityTracker.calculateVelocity().x
                val targetOffsetX = decay.calculateTargetValue(
                    offsetX.value,
                    velocity
                )
                // The animation stops when it reaches the bounds.
                offsetX.updateBounds(
                    lowerBound = -size.width.toFloat(),
                    upperBound = size.width.toFloat()
                )
                launch {
                    if (targetOffsetX.absoluteValue <= size.width) {
                        // Not enough velocity; Slide back.
                        offsetX.animateTo(
                            targetValue = 0f,
                            initialVelocity = velocity
                        )
                    } else {
                        // The element was swiped away.
                        offsetX.animateDecay(velocity, decay)
                        onDismissed()
                    }
                }
            }
        }
    }
        .offset { IntOffset(offsetX.value.roundToInt(), 0) }
}