鸿蒙OS Vibrator开发指导
场景介绍
当设备需要设置不同的振动效果时，可以调用 Vibrator 模块，例如，设备的按键可以设置不同强度和时长的振动，闹钟和来电可以设置不同强度和时长的单次或周期性振动。
接口说明
振动器模块主要提供的功能有：查询设备上振动器的列表，查询某个振动器是否支持某种振动效果，触发和关闭振动器。VibratorAgent 类开放能力如下，具体请查阅 API 参考文档。
| 接口名 | 描述 |
|---|---|
| getVibratorIdList() | 获取硬件设备上的振动器列表。 |
| isSupport(int) | 根据指定的振动器Id查询硬件设备是否存在该振动器。 |
| isEffectSupport(int, String) | 查询指定的振动器是否支持指定的震动效果。 |
| startOnce(int, String) | 对指定的振动器创建指定效果的一次性振动。 |
| startOnce(String) | 对指定的振动器创建指定效果的一次性振动。 |
| startOnce(int, int) | 对指定的振动器创建指定振动时长的一次性振动。 |
| startOnce(int) | 对指定的振动器创建指定振动时长的一次性振动。 |
| start(int, VibrationPattern) | 对指定的振动器创建自定义效果的波形或一次性振动。 |
| start(VibrationPattern) | 对指定的振动器创建自定义效果的波形或一次性振动。 |
| stop(int, String) | 关闭指定的振动器指定模式的振动。 |
| stop(String) | 关闭指定的振动器指定模式的振动。 |
开发步骤
- 控制设备上的振动器，需要在“config.json”里面进行配置请求权限。具体如下：
"reqPermissions": [
{
"name": "ohos.permission.VIBRATE",
"reason": "",
"usedScene": {
"ability": [
".MainAbility"
],
"when": "inuse"
}
}
]- 查询硬件设备上的振动器列表。
- 查询指定的振动器是否支持指定的震动效果。
- 创建不同效果的振动。
- 关闭指定的振动器指定模式的振动。
private VibratorAgent vibratorAgent = new VibratorAgent();
private int[] timing = {1000, 1000, 2000, 5000};
private int[] intensity = {50, 100, 200, 255};
@Override
public void onStart(Intent intent) {
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_vibrator_layout);
// ...
// 查询硬件设备上的振动器列表
List<Integer> vibratorList = vibratorAgent.getVibratorIdList();
if (vibratorList.isEmpty()) {
return;
}
int vibratorId = vibratorList.get(0);
// 查询指定的振动器是否支持指定的振动效果
boolean isSupport = vibratorAgent.isEffectSupport(vibratorId,
VibrationPattern.VIBRATOR_TPYE_CAMERA_CLICK);
// 创建指定效果的一次性振动
boolean vibrateEffectResult = vibratorAgent.vibrate(vibratorId,
VibrationPattern.VIBRATOR_TPYE_CAMERA_CLICK);
// 创建指定振动时长的一次性振动
int vibratorTiming = 1000;
boolean vibrateResult = vibratorAgent.vibrate(vibratorId, vibratorTiming);
// 创建自定义效果的周期性波形振动
int count = 5;
VibrationPattern vibrationPeriodEffect = VibrationPattern.createPeriod(timing, intensity, count);
boolean vibratePeriodResult = vibratorAgent.vibrate(vibratorId, vibrationPeriodEffect);
// 创建自定义效果的一次性振动
VibrationPattern vibrationOnceEffect = VibrationPattern.createSingle(3000, 50);
boolean vibrateSingleResult = vibratorAgent.vibrate(vibratorId, vibrationOnceEffect);
// 关闭指定的振动器自定义模式的振动
boolean stopResult = vibratorAgent.stop(vibratorId,
VibratorAgent.VIBRATOR_STOP_MODE_CUSTOMIZED);
}