HarmonyOS 振动效果开发指导

Vibrator 开发概述

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

运作机制

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

图 1 控制类小器件中的 Vibrator

● Vibrator API:提供振动器基础的 API,主要包含振动器的列表查询,振动器的振动器效果查询,触发/关闭振动器等接口。

● Vibrator Framework:实现振动器的框架层管理,实现与控制类小器件 Service 的通信。

● Vibrator Service:实现控制器的服务管理。

● HDF 层:适配不同设备。

约束与限制

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

Vibrator 开发指导

场景介绍

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

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

接口说明

开发步骤

  1. 控制设备上的振动器,需要申请权限 ohos.permission.VIBRATE。具体配置方式请参考权限申请声明。

  2. 根据指定振动效果和振动属性触发马达振动。

    import vibrator from '@ohos.vibrator';
    try {
    vibrator.startVibration({
    type: 'time',
    duration: 1000,
    }, {
    id: 0,
    usage: 'alarm'
    }, (error) => {
    if (error) {
    console.error('vibrate fail, error.code: ' + error.code + 'error.message: ', + error.message);
    return;
    }
    console.log('Callback returned to indicate a successful vibration.');
    });
    } catch (err) {
    console.error('errCode: ' + err.code + ' ,msg: ' + err.message);
    }

  3. 按照指定模式停止马达的振动。

    import vibrator from '@ohos.vibrator';
    try {
    // 按照VIBRATOR_STOP_MODE_TIME模式停止振动
    vibrator.stopVibration(vibrator.VibratorStopMode.VIBRATOR_STOP_MODE_TIME, function (error) {
    if (error) {
    console.log('error.code' + error.code + 'error.message' + error.message);
    return;
    }
    console.log('Callback returned to indicate successful.');
    })
    } catch (err) {
    console.info('errCode: ' + err.code + ' ,msg: ' + err.message);
    }

相关推荐
GitCode官方8 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追9 小时前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追13 小时前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue13 小时前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
程序猿追16 小时前
鸿蒙 PC 用 Tauri 迁移配置文件,先保留旧版再写新版
华为·harmonyos
码间留白1 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农2 天前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
我闪了个去2 天前
一个 Scroll 撑起整个首页:HarmonyOS 7 懒加载布局把网格、瀑布流、吸顶分组装进一次滚动
harmonyos·arkts