vibrator js接口hap

介绍

本样例展示了vibrator模块js接口的使用样例，包含time、preset、file、pattern四种形式的振动,订阅去订阅外设热插拔事件、获取设备上马达信息等接口功能

本示例用到了打开读取文件的操作@kit.LocalizationKit 错误信息@kit.BasicServicesKit

振动相关功能@kit.SensorServiceKit

效果预览

主页

依次介绍sample具有什么功能，怎样使用这些功能，以及使用后会达到什么效果；示例如下：

1. 在主界面，可以点击Please select effectId文本框选择使用的effectId，effectId作为preset形式振动的固定形式参数；
2. 在主界面，可以点击Please select usage文本框选择使用的usage信息，不选择会有默认值；
3. 可以选设置deviceid，手机上多设备功能底层暂时不支持，只能选择本机的deviceid：-1
4. 在主界面，点击file按钮可以下发工程中附带json文件的振动效果；
5. 在主界面，点击preset按钮可以下发预选effectId的振动效果；
6. 在主界面，点击time按钮可以下发默认的时长的振动效果；
7. 在主界面，点击pattern:addContinuousEvent按钮可以下发自定义振动事件长事件振动效果；
8. 在主界面，点击pattern:addTransientEvent按钮可以下发自定义振动事件短事件振动效果；
9. 在主界面，点击stopVibration按钮可以实现停止振动的效果；
10. 在主界面，点击on按钮和off按钮可以下发对设备热插拔事件的订阅和去订阅，此功能在手机上暂未实现；
11. 在主界面，点击getVibratorInfoSync按钮可以实现对设备上马达器件列表信息的获取，并在下方显示；
12. 在主界面，点击getVibratorInfoSyncByDeviceId按钮可以实现对指定设备上马达器件列表信息的获取，并在下方显示；
13. 在主界面，点击getEffectInfoSync按钮可以获取预置振动效果信息，并在下方显示（本示例查询的是haptic.clock.timer）；
14. 在主界面，点击isHdHapticSupported按钮可以查询设备是否支持高清振动，并在下方显示；

工程目录

entry
|   |--- src/main/
|        |--- module.json5              // vibrator模块配置hap类型："type": "feature"
|             |---ets/pages      
|                    |---index.ets      // vibrato组件接口实现页面

具体实现

time、preset、file、pattern四种形式的振动，订阅去订阅外设热插拔事件、获取设备上马达信息等的功能接口封装在index，源码参考：index.ets

• file文件形式振动：使用Vibrator.startVibration接口的file形式来实现文件形式振动的下发；
• preset文件形式振动：先使用窗口框选择Vibrator模块提供的effectId，然后使用Vibrator.startVibration接口使用preset形式来实现预置效果串形式振动的下发；
• time文件形式振动：使用Vibrator.startVibration接口的time形式来下发指定时间形式的振动；
• pattern文件形式振动：使用Vibrator.startVibration接口的pattern形式来实现ContinuousEvent和TransientEvent事件形式振动的下发；
• 停止振动：使用Vibrator.stopVibration来停止振动；
• 订阅去订阅外设热插拔事件，通过Vibrator.on和Vibrator.off来实现对扩设备热插拔事件订阅；
• 获取设备上马达信息列表：通过Vibrator.getVibratorInfoSync接口来实现对本设备及扩展设备上马达列表的获取；
• 获取预置振动效果信息：通过vibrator.getEffectInfoSync接口来实现对预置震动效果信息的查询；
• 查询是否支持高清振动：通过Vibrator.isHdHapticSupported接口来实现对本设备是否支持高清振动的查询；

相关权限

附上使用到的权限和链接，示例如下：

ohos.permission.VIBRATE

依赖

不涉及。

约束与限制

1.本示例仅支持标准系统上运行，支持设备：RK3568;

2.本示例为Stage模型，仅支持API20版本SDK，SDK版本号(API Version 20 Beta)，镜像版本号(6.0Beta);

3.本示例需要使用DevEco Studio 5.0.4 Release (Build Version: 5.0.11.100, built on March 28, 2025)及以上版本才可编译运行。

下载

如需单独下载本工程，执行如下命令：

git init  
git config core.sparsecheckout true  
echo sensors/Vibrator/VibratorJsSamples/ > .git/info/sparse-checkout  
git remote add origin https://gitcode.com/HarmonyOS_Samples/guide-snippets.git   
git pull origin master