system.vibrate()

类型 函数
库 system.*
返回值 无
修订 版本 2024.3703
关键词 振动，触觉反馈，taptic 引擎

概述

在手机上触发振动和触觉反馈。在 Corona 模拟器中，这将发出系统提示音（仅限 macOS）。

注意事项

触觉反馈仅在 Solar2D 2021.3660+ 版本中受支持，但经典的 "system.vibrate()" 在旧版本中仍然有效。

要在 Android 设备上启用振动功能，您必须在 build.settings 文件中设置权限级别。

settings =
{
    android =
    {
        usesPermissions =
        {
            "android.permission.VIBRATE",
        },
    },
}

语法

system.vibrate([type, style])
类型 （可选）

字符串。 可能的类型有 "impact"（冲击）, "selection"（选择）和 "notification"（通知）。如果未指定值，设备将执行经典振动。

样式 （可选）

字符串。 "impact" 的可能样式有 "light"（轻）, "medium"（中等）和 "heavy"（重）。默认类型为 "medium"。 "notification" 的可能样式有 "warning"（警告）, "success"（成功）和 "error"（错误）。默认类型为 "success"。

示例

经典振动
--make the device vibrate
system.vibrate()
触觉反馈
--medium impact
system.vibrate("impact") -- same as system.vibrate("impact", "medium")
--heavy impact
system.vibrate("impact", "heavy") 
--selection
system.vibrate("selection")
--warning notification
system.vibrate("notification", "warning")