npm i --save @nativescript/haptics
- 版本: 3.1.0
- GitHub: https://github.com/NativeScript/plugins
- NPM: https://npmjs.net.cn/package/%40nativescript%2Fhaptics
- 下载
- 昨天: 5
- 上周: 38
- 上个月: 228
@nativescript/haptics
一个允许您向应用程序添加触觉反馈的插件。
播放触觉反馈可以激发人们的触觉感知,并将他们对物理世界的熟悉度带入您的应用程序或游戏。 ~ 开发者文档
感谢 Eddy Verbruggen 提供了 nativescript-taptic-engine,这使得随着 API 的精简和 Android 支持的添加,该插件得以继续其发展,灵感来源于 react-native-haptic-feedback。
内容
安装
npm install @nativescript/haptics
使用 @nativescript/haptics
在 StackBlitz 上找到 @nativescript/haptics
的用法示例 这里。
API
该插件提供以下 API。
isSupported()
isHapticsSupported: boolean = Haptics.isSupported()
检查设备是否支持触觉。
selection()
import { Haptics } from "@nativescript/haptics";
Haptics.selection();
notification()
import { Haptics, HapticNotificationType } from "@nativescript/haptics";
Haptics.notification(HapticNotificationType.ERROR);
使用通知反馈生成器来指示成功、失败和警告。
其他触觉通知类型包括
SUCCESS
(默认)WARNING
impact()
import { Haptics, HapticImpactType } from "@nativescript/haptics";
Haptics.impact(HapticImpactType.HEAVY);
使用冲击反馈生成器来指示已发生冲击。例如,您可能需要在用户界面对象与某物碰撞或固定到位时触发冲击反馈。
有 3 种冲击类型
LIGHT
MEDIUM
(默认)HEAVY
.
HapticsFallback
要使用触觉后备方案,请检查是否存在支持
if (!Haptics.isSupported()) {
// use HapticsFallback
}
注意 这使用了可能被苹果审查时拒绝的应用未记录功能。 尽管如此,人们已经使用了这种方法 而没有问题。
weakBoom()
这将触发与“Peek & Pop”中的“Peek”相同的效果,这是一种非常短暂的振动。
import { HapticsFallback } from "@nativescript/haptics";
HapticsFallback.weakBoom();
strongBoom()
import { HapticsFallback } from "@nativescript/haptics";
HapticsFallback.strongBoom();
这将触发“Peek & Pop”中的“Pop”效果,这比“Peek”效果更为深刻。
burst()
import { HapticsFallback } from "@nativescript/haptics";
HapticsFallback.burst();
这将触发当强制触摸没有动作的主图标时获得的“Nope”效果。这是一个大约 3 次的“弱爆炸”短脉冲。
变更日志
- 3.0.0 移至 @nativescript/haptics 并添加 Android 支持。调整命名约定。
- 2.1.0 代码现代化,迁移到插件种子结构,并添加 Vue 示例。
- 2.0.0 为 iPhone 7 添加了官方 API。将旧 API 移至 TapticEngineUnofficial.*。需要 Xcode 8 来构建。
- 1.0.0 首次发布,仅提供非官方 API。与任何 Xcode 版本兼容。
许可
Apache 许可证版本 2.0