当前位置：首页 > news >正文

鸿蒙开发（NEXT/API 12）【硬件（振动开发1）】振动

news 2025/5/1 10:12:11

通过最大化开放马达器件能力，振动器模块服务拓展了原生马达服务，实现了振动与交互融合设计，从而打造出细腻精致的一体化振动体验和差异化体验，提升用户交互效率、易用性以及用户体验，并增强品牌竞争力。

运作机制

Vibrator属于控制类小器件，主要包含以下四个模块：Vibrator API，Vibrator Framework，Vibrator Service和HDF层。

图1 控制类小器件中的Vibrator

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

Vibrator API：提供振动器基础的API，主要包含振动器的列表查询，振动器的振动器效果查询，触发/关闭振动器等接口。
Vibrator Framework：实现振动器的框架层管理，实现与控制类小器件Service的通信。
Vibrator Service：实现控制器的服务管理。
HDF层：适配不同设备。

约束与限制

在使用振动器时，开发者需要配置请求振动器的权限ohos.permission.VIBRATE，才能控制振动器振动。

场景介绍

当设备需要设置不同的振动效果时，可以调用Vibrator模块，例如：设备的按键可以设置不同强度和不同时长的振动，闹钟和来电可以设置不同强度和时长的单次或周期振动。

接口说明

名称	描述
startVibration(effect: VibrateEffect, attribute: VibrateAttribute): Promise	根据指定振动效果和振动属性触发马达振动，使用Promise异步回调。
startVibration(effect: VibrateEffect, attribute: VibrateAttribute, callback: AsyncCallback): void	根据指定振动效果和振动属性触发马达振动，使用Callback异步回调。
stopVibration(stopMode: VibratorStopMode): Promise	按照指定模式停止马达的振动，使用Promise异步回调。
stopVibration(stopMode: VibratorStopMode, callback: AsyncCallback): void	按照指定模式停止马达的振动，使用Callback异步回调。
stopVibration(): Promise	停止所有模式的马达振动，使用Promise异步回调。
stopVibration(callback: AsyncCallback): void	停止所有模式的马达振动，使用Callback异步回调。
isSupportEffect(effectId: string): Promise	查询是否支持传入的参数effectId。返回true则表示支持，否则不支持，使用Promise异步回调。
isSupportEffect(effectId: string, callback: AsyncCallback): void	查询是否支持传入的参数effectId。返回true则表示支持，否则不支持，使用Callback异步回调。

振动效果说明

目前支持三类振动效果，如下所示。

固定时长振动

传入一个固定时长，马达按照默认强度和频率触发振动

预置振动

系统中的[预置振动效果]，这些效果适用于某些固定场景，比如效果"haptic.clock.timer"通常用于用户调整计时器时的振感反馈

自定义振动

自定义振动提供给用户设计自己所需振动效果的能力，用户可通过自定义振动配置文件，并遵循相应规则编排所需振动形式，使能更加开放的振感交互体验

自定义振动配置文件为Json格式，在形式上如下所示：

{"MetaData": {"Create": "2023-01-09","Description": "a haptic case","Version": 1.0,"ChannelNumber": 1},"Channels": [{"Parameters": {"Index": 0},"Pattern": [{"Event": {"Type": "transient","StartTime": 0,"Parameters": {"Frequency": 31,"Intensity": 100}}},{"Event": {"Type": "continuous","StartTime": 40,"Duration": 54,"Parameters": {"Frequency": 30,"Intensity": 38,"Curve": [{"Time": 0,"Frequency": 0,"Intensity": 0},{"Time": 1,"Frequency": 15,"Intensity": 0.5},{"Time": 40,"Frequency": -8,"Intensity": 1.0},{"Time": 54,"Frequency": 0,"Intensity": 0}]}}}]}]
}

Json文件共包含2个属性。

"MetaData"属性中为文件头信息，可在如下属性中添加描述：

名称	必填项	说明
Version	是	文件格式的版本号，向前兼容，目前支持版本1.0。
ChannelNumber	是	表示马达振动的通道数，最大支持双马达通道。
Create	否	可记录文件创作时间。
Description	否	可指明振动效果、创建信息等附加说明。

"Channels"属性中为马达振动通道的相关信息。

"Channels"是Json数组，表示各个通道的信息，包含2个属性。

名称	必填项	说明
Parameters	是	为通道参数。其中"Index"表示通道编号，0表示全通道发送，1、2分别对应左右马达。
Pattern	否	马达振动序列。

"Pattern"是Json数组，包含振动事件序列，每个"Event"属性代表1个振动事件，支持添加2种振动类型。

振动类型	说明
transient	瞬态短振动，干脆有力。
continuous	稳态长振动，具备长时间输出强劲有力振动的能力。

"Event"表示一个振动事件，包含如下属性：

名称	必填项	说明
Type	是	振动事件类型，为"transient" 或"continuous"。
StartTime	是	振动的起始时间，单位ms，有效范围为[0, 1800,000]。
Duration	是	振动持续时间，仅当类型为"continuous"时有效，单位ms，有效范围为[0, 5000]。

"Parameters"表示振动事件参数设置，必填项，可设置以下属性参数：

名称	必填项	说明
Intensity	是	振动事件强度，有效范围为[0, 100]。
Frequency	是	振动事件频率，有效范围为[0, 100]。
Curve	否	振动曲线，当振动事件类型为"continuous"时有效，为Json数组，支持设置一组调节点，调节点数量最大支持16个，最小为4个，每个调节点需包含如下属性：“Time”：相对事件起始时间的偏移，最小为0，最大不能超过事件振动时长；“Intensity”：相对事件振动强度的增益，范围为[0, 1]，此值乘上振动事件强度为对应时间点调节后的强度；“Frequency”：相对事件振动频率的变化，范围为[-100, 100]，此值加上振动事件频率为对应时间点调节后的频率。

其他要求：

参数	要求
振动事件(event)的数量	不得超过128个。
振动配置文件长度	不得超过64KB。

开发步骤

控制设备上的振动器，需要申请权限ohos.permission.VIBRATE。
根据指定振动效果和振动属性触发马达振动。

情形一，按照指定持续时间触发马达振动：

import { vibrator } from '@kit.SensorServiceKit';
import { BusinessError } from '@kit.BasicServicesKit';try {// 触发马达振动vibrator.startVibration({type: 'time',duration: 1000,}, {id: 0,usage: 'alarm'}, (error: BusinessError) => {if (error) {console.error(`Failed to start vibration. Code: ${error.code}, message: ${error.message}`);return;}console.info('Succeed in starting vibration');});
} catch (err) {let e: BusinessError = err as BusinessError;console.error(`An unexpected error occurred. Code: ${e.code}, message: ${e.message}`);
}

情形二，按照预置振动效果触发马达振动，可先查询振动效果是否被支持，再调用振动接口：

import { vibrator } from '@kit.SensorServiceKit';
import { BusinessError } from '@kit.BasicServicesKit';try {// 查询是否支持'haptic.effect.soft'vibrator.isSupportEffect('haptic.effect.soft', (err: BusinessError, state: boolean) => {if (err) {console.error(`Failed to query effect. Code: ${err.code}, message: ${err.message}`);return;}console.info('Succeed in querying effect');if (state) {try {// 触发马达振动vibrator.startVibration({type: 'preset',effectId: 'haptic.effect.soft',count: 1,intensity: 50,}, {usage: 'unknown'}, (error: BusinessError) => {if (error) {console.error(`Failed to start vibration. Code: ${error.code}, message: ${error.message}`);} else {console.info('Succeed in starting vibration');}});} catch (error) {let e: BusinessError = error as BusinessError;console.error(`An unexpected error occurred. Code: ${e.code}, message: ${e.message}`);}}})
} catch (error) {let e: BusinessError = error as BusinessError;console.error(`An unexpected error occurred. Code: ${e.code}, message: ${e.message}`);
}

情形三，按照自定义振动配置文件触发马达振动：

import { vibrator } from '@kit.SensorServiceKit';
import { resourceManager } from '@kit.LocalizationKit';
import { BusinessError } from '@kit.BasicServicesKit';const fileName: string = 'xxx.json';// 获取文件资源描述符
let rawFd: resourceManager.RawFileDescriptor = getContext().resourceManager.getRawFdSync(fileName);// 触发马达振动
try {vibrator.startVibration({type: "file",hapticFd: { fd: rawFd.fd, offset: rawFd.offset, length: rawFd.length }}, {id: 0,usage: 'alarm'}, (error: BusinessError) => {if (error) {console.error(`Failed to start vibration. Code: ${error.code}, message: ${error.message}`);return;}console.info('Succeed in starting vibration');});
} catch (err) {let e: BusinessError = err as BusinessError;console.error(`An unexpected error occurred. Code: ${e.code}, message: ${e.message}`);
}// 关闭文件资源描述符
getContext().resourceManager.closeRawFdSync(fileName);

停止马达的振动。

方式一，按照指定模式停止对应的马达振动，自定义振动不支持此类停止方式：

停止固定时长振动：

import { vibrator } from '@kit.SensorServiceKit';
import { BusinessError } from '@kit.BasicServicesKit';try {// 按照VIBRATOR_STOP_MODE_TIME模式停止振动vibrator.stopVibration(vibrator.VibratorStopMode.VIBRATOR_STOP_MODE_TIME, (error: BusinessError) => {if (error) {console.error(`Failed to stop vibration. Code: ${error.code}, message: ${error.message}`);return;}console.info('Succeed in stopping vibration');})
} catch (err) {let e: BusinessError = err as BusinessError;console.error(`An unexpected error occurred. Code: ${e.code}, message: ${e.message}`);
}

停止预置振动：

import { vibrator } from '@kit.SensorServiceKit';
import { BusinessError } from '@kit.BasicServicesKit';try {// 按照VIBRATOR_STOP_MODE_PRESET模式停止振动vibrator.stopVibration(vibrator.VibratorStopMode.VIBRATOR_STOP_MODE_PRESET, (error: BusinessError) => {if (error) {console.error(`Failed to stop vibration. Code: ${error.code}, message: ${error.message}`);return;}console.info('Succeed in stopping vibration');})
} catch (err) {let e: BusinessError = err as BusinessError;console.error(`An unexpected error occurred. Code: ${e.code}, message: ${e.message}`);
}

方式二，停止所有模式的马达振动，包括自定义振动：

import { vibrator } from '@kit.SensorServiceKit';
import { BusinessError } from '@kit.BasicServicesKit';try {// 停止所有模式的马达振动vibrator.stopVibration((error: BusinessError) => {if (error) {console.error(`Failed to stop vibration. Code: ${error.code}, message: ${error.message}`);return;}console.info('Succeed in stopping vibration');})
} catch (error) {let e: BusinessError = error as BusinessError;console.error(`An unexpected error occurred. Code: ${e.code}, message: ${e.message}`);
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述