@nativescript/haptics
为 NativeScript 提供触觉反馈
npm i --save @nativescript/haptics

@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