Composer制作设备震动效果动画_Composer模拟机器运行状态【频率】

先说结论：Compose里没有“一键震动”的魔法

如果你在Jetpack Compose里找现成的“设备震动”API，那可能要失望了。androidx.core:haptic-feedback库提供的HapticFeedbackType，只支持点击、长按这类系统级的触感反馈，什么时长、波形、频率，一概不归它管。所以，想用Compose模拟机器运行状态的震动动画，本质上是在做一件“视觉+触觉”的双重拟物表达——这事得拆成两半来看：UI动画和真实震动，谁也替不了谁。而且，后半段那个“真实震动”，还受Android权限、系统版本和硬件能力的严格限制。

真实震动：得手动调用Vibrator

Compose是声明式UI框架，不负责硬件交互。想让手机真正震起来，你得绕过Compose的生命周期，从Context里拿到Vibrator实例，然后手动调用它的方法。这里有几个硬性门槛：

• 权限：需要android.permission.VIBRATE。从Android 12开始，还得在AndroidManifest.xml里声明android:required="false"，否则Google Play可能直接拒绝上架。
• API版本：Android 8.0（API 26）之后，旧的vibrate(long[] pattern, int repeat)方法已被标记为废弃，推荐改用vibrate(VibrationEffect)。但VibrationEffect.createWa veform()才支持自定义频率序列，而它最低要求API 29（Android 10）。
• 兼容性：低于API 29的设备，只能用VibrationEffect.createOneShot()或者干脆静音回退——想模拟频率变化？基本没戏。

所以，正确的调用方式应该是这样（注意要在LaunchedEffect或DisposableEffect里安全执行）：

val vibrator = context.getSystemService(Context.VIBRATOR_SERVICE) as Vibrator
if (vibrator.hasVibrator()) {
    val pattern = longArrayOf(0, 50, 100, 50, 200) // 延迟 + 震动/停顿交替
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        vibrator.vibrate(
            VibrationEffect.createWa veform(pattern, -1)
        )
    } else {
        vibrator.vibrate(pattern, -1)
    }
}

视觉抖动：用Animatable + graphicsLayer

视觉上的“机器运行抖动”，不能依赖真实震动，得靠Canvas或修饰符动画来实现。核心思路是让UI元素在小范围内高频位移，配合缩放或旋转来增强机械感。这里有几个关键点：

• 选对工具：用Animatable驱动offset或rotation，比animate*AsState更适合循环高频动画，能有效避免重组开销。
• 频率控制：通过infiniteRepeatable + tween的durationMillis来设定周期。比如100ms一圈 ≈ 10Hz，200ms ≈ 5Hz。但要注意，人眼能分辨的抖动上限大约在15–20Hz，再高就变成模糊一片了。
• 避免混乱：不建议用rememberInfiniteTransition()做多属性联动（比如同时offset+scale），不同动画周期错相后，效果会很不自然。

一个简单的水平抖动+微缩放例子：

val offsetX = remember { Animatable(0f) }
val scale = remember { Animatable(1f) }

LaunchedEffect(Unit) {
    offsetX.animateTo(
        1f,
        animationSpec = infiniteRepeatable(
            animation = tween(100, easing = LinearEasing),
            repeatMode = RepeatMode.Reverse
        )
    )
    scale.animateTo(
        0.98f,
        animationSpec = infiniteRepeatable(
            animation = tween(200, easing = LinearEasing),
            repeatMode = RepeatMode.Reverse
        )
    )
}

Box(
    modifier = Modifier
        .graphicsLayer(
            translationX = offsetX.value,
            scaleX = scale.value,
            scaleY = scale.value
        )
)

“频率”这个词，不能当单一参数用

很多人提到“模拟运行频率”，下意识就想用一个frequencyHz: Int参数统管一切。但实际项目中，频率这个概念横跨了三层，每一层都有自己的逻辑：

• UI层：Compose动画帧率由MonotonicFrameClock控制，默认尽量跟屏幕刷新率（60/90/120Hz）同步。你设的tween(durationMillis = 50)只是目标周期，实际帧间隔会受到系统调度的影响。
• 系统震动层：Android对连续波形有最小间隔限制，通常不低于20ms。低端设备甚至可能把高频的pattern合并执行，导致你标称的“10Hz”，实际只有3–4次有效震动。
• 感知层：人对震动频率的敏感区间是30–300Hz，但手机马达的物理响应带宽往往只有50–150Hz。低于20Hz，感觉是“咚咚”的脉冲；高于200Hz，就变成“麻刺感”。这和你UI抖动的5–20Hz，完全是两个世界。

所以，必须明确地区分配置：UI抖动周期用visualPulseIntervalMs，震动波形用vibrationPattern数组，运行状态切换用独立的isRunning布尔值。这三层频率，就像三套不同的乐谱，各弹各的，混在一起就乱套了。

说到最后，真正考验人的不是写几行动画代码，而是判断当前设备能不能支撑你想要的“频率感”：API级别够不够、马达类型是ERM还是LRA、用户有没有关闭触感反馈。这些都没法在Compose里声明式处理，必须在调用前做运行时探测，并且准备好降级方案——比如震动失效时，至少保留视觉抖动和声音提示，让用户觉得“这机器还在运行”。