harmony 鸿蒙振动开发指导

2025-06-12
浏览 (7)

振动开发指导

场景介绍

当设备需要振动固定时长时，可以调用Vibrator模块，例如：设备的按键可以设置不同时长的振动。

详细的接口介绍请参考Vibrator接口。

接口说明

名称	描述
startVibration(effect: VibrateTime, attribute: VibrateAttribute): Promise<void>	根据指定振动效果和振动属性触发马达振动，使用Promise异步回调。
startVibration(effect: VibrateTime, attribute: VibrateAttribute, callback: AsyncCallback<void>): void	根据指定振动效果和振动属性触发马达振动，使用Callback异步回调。
stopVibration(): Promise<void>	停止所有模式的马达振动，使用Promise异步回调。
stopVibration(callback: AsyncCallback<void>): void	停止所有模式的马达振动，使用Callback异步回调。

开发步骤

控制设备上的振动器，需要申请权限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 {
  // 停止所有模式的马达振动
  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}`);
}