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

news2024/12/28 3:00:05

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

运作机制

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个属性。

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

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

  2. "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]。

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

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

其他要求：

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

开发步骤

  1. 控制设备上的振动器，需要申请权限ohos.permission.VIBRATE。

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

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

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);

  1. 停止马达的振动。

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

    ​ 停止固定时长振动：

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、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

  • 《鸿蒙 (OpenHarmony)开发学习视频》
  • 《鸿蒙生态应用开发V2.0白皮书》
  • 《鸿蒙 (OpenHarmony)开发基础到实战手册》
  • OpenHarmony北向、南向开发环境搭建
  • 《鸿蒙开发基础》
  • 《鸿蒙开发进阶》
  • 《鸿蒙开发实战》

在这里插入图片描述

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿
1

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/2177991.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

小程序原生-地理位置授权用户拒绝后的解决方案

小程序原生-地理位置授权用户拒绝后的解决方案

在开发的过程中，我们会发现一个问题： 在调用 wx.getLocation() 获取用地理位置时，如果用户选择拒绝授权，代码会直接抛出错误。在拒绝授权以后，再次调用 wx.getLocation() 时，就不会在弹窗询问用户是否允许…
阅读更多...
【国庆要来了】基于Leaflet的旅游路线WebGIS可视化实践

【国庆要来了】基于Leaflet的旅游路线WebGIS可视化实践

前言 转眼2024年的国庆节马上就要来临了，估计很多小伙伴都计划好了旅游路线。金秋十月，不管是选择出门去看看风景，还是选择在家里看人。从自己生活惯了的城市去别人生活惯了的城市，去感受城市烟火、去感受人文风景，为2…
阅读更多...
Windows环境 源码编译 FFmpeg

Windows环境 源码编译 FFmpeg

记录一下windows环境纯代码编译ffmeg的过程！ 目录 一、安装MSYS2 1.下载安装 2.配置 3.修改源 4.测试与更新 二、安装其他必要工具 1.安装MinGW-w64 2.安装git 3..安装make等工具 4.编译前的其他准备工作 ①.重命名link.exe ②.下载和安装YASM ③.安装…
阅读更多...
ADC的原理

ADC的原理

一、介绍 模数转换，即Analog-to-Digital Converter，常称ADC，是指将连续变量的模拟信号转换为离散的数字信号的器件，比如将模温度感器产生的电信号转为控制芯片能处理的数字信号0101，这样ADC就建立了模拟世界的传感器和…
阅读更多...
tomcat服务器控制台乱码（超简单，其中一种方式）

tomcat服务器控制台乱码（超简单，其中一种方式）

一、问题 为解决前： 是这样子，控制台中文乱码 解决后： 二、解决 在tomcat的安装目录下，找到conf ---》logging.properties 点击去进行编辑 重点！！！ 编辑完之后，保存 如何返回到…
阅读更多...
文献阅读9.29

文献阅读9.29

目录 基于物理的神经网络在河流淤积模拟中的应用 文献摘要 讨论|结论 理论介绍 PINN 实验方程 Ansys中的数学模型 实验设置 基于物理的神经网络在河流淤积模拟中的应用 文献摘要 本文从水动力学和污染物运移动力学的基本原理出发，全面探讨了用于研究泥沙淤…
阅读更多...
六、动画系统

六、动画系统

一、动画事件 在此处实现：动画播放至此处，人物角色移动 1、添加动画事件 选择对应的动画 右键动画部分，选择添加动画事件 在人物身上挂载了对应的动画系统，需要在代码中，设置一个函数，作为动画事件 执行…
阅读更多...
【ADC】使用仪表放大器驱动 SAR 型 ADC 时的输入输出范围

【ADC】使用仪表放大器驱动 SAR 型 ADC 时的输入输出范围

概述 本文学习于TI 高精度实验室课程，介绍使用仪表放大器时 SAR ADC 驱动放大器的注意事项。具体包括：介绍如何使用仪表放大器设计数据转换器驱动电路。 仪表放大器（Instrumentation Amplifier，下文简称 INA）可抑制输…
阅读更多...
自定义knife4j访问路径

自定义knife4j访问路径

文章目录 本文档只是为了留档方便以后工作运维，或者给同事分享文档内容比较简陋命令也不是特别全，不适合小白观看，如有不懂可以私信，上班期间都是在得 原由，嫌弃doc.html 太大众 直接重定向，直接上代码了 p…
阅读更多...
【Linux】Linux内核结构基础

【Linux】Linux内核结构基础

Linux内核结构基础 一、Linux内核结构介绍二、Linux内核结构☆ Linux内核结构框图Linux系统架构 三、认识驱动为什么学驱动文件名与设备号open函数过程实例详解 四、shellshell脚本 参考博文： 【Linux】内核结构（全）linux内核结构介绍&#…
阅读更多...
理解Python闭包概念

理解Python闭包概念

闭包并不只是一个python中的概念，在函数式编程语言中应用较为广泛。理解python中的闭包一方面是能够正确的使用闭包，另一方面可以好好体会和思考闭包的设计思想。 1.概念介绍 首先看一下维基上对闭包的解释： 在计算机科学中，闭包…
阅读更多...
【动态规划-分组背包】【hard】力扣2218. 从栈中取出 K 个硬币的最大面值和

【动态规划-分组背包】【hard】力扣2218. 从栈中取出 K 个硬币的最大面值和

一张桌子上总共有 n 个硬币 栈 。每个栈有 正整数 个带面值的硬币。 每一次操作中，你可以从任意一个栈的 顶部 取出 1 个硬币，从栈中移除它，并放入你的钱包里。 给你一个列表 piles ，其中 piles[i] 是一个整数数组，分…
阅读更多...
OpenEuler虚拟机安装保姆级教程 | 附可视化界面

OpenEuler虚拟机安装保姆级教程 | 附可视化界面

0x00 系统介绍 在 2019 年 7 月 19 日，华为宣布要在年底正式开源 openEuler 操作系统；在半年后的 12 月 31 日，华为正式开源了 openEuler 操作系统，邀请社区开发者共同来贡献。 一年后，截止到 2020 年12 月 25日&…
阅读更多...
注册中心Eureka

注册中心Eureka

Eureka 文章目录 前言一、Eureka是什么？二、使用步骤1.搭建一个SpringCloud项目2.启动类上增加注解 EnableEurekaServer3.启动项目 访问 配置文件里定义的端口号4.启动成功访问 localhost:70005.以同样的方式创建子项目 eureka-client-xx 作为 服务客户端 然后向eur…
阅读更多...
实用SQL小总结

实用SQL小总结

WHERE 条件 column 为纯英文字符 或 不包含任何字符 语法： SELECT * FROM your_table WHERE REGEXP(your_column,^[A-Za-z]$); SELECT * FROM your_table WHERE NOT REGEXP(your_column,^[A-Za-z]$);例： SELECT DISTINCT t.pldlibho FROM kibb_pldlyw…
阅读更多...
gRPC基础讲解

gRPC基础讲解

一、gRPC原理 1、什么是RPC RPC 即远程过程调用协议（Remote Procedure Call Protocol），可以让我们像调用本地函数一样发起远程调用。RPC 凭借其强大的治理功能，成为解决分布式系统通信问题的一大利器。 gRPC是一个现代的、高性能…
阅读更多...
电路学习——反激电源（2024.09.29）

电路学习——反激电源（2024.09.29）

参考链接1: XXX 在此感谢各位前辈大佬的总结，写这个只是为了记录学习大佬资料的过程，内容基本都是搬运的大佬博客，觉着有用自己搞过来自己记一下，如果有大佬觉着我搬过来不好，联系我删。 电路学习——反激电源&#xf…
阅读更多...
基于大数据的高校新生数据可视化分析系统

基于大数据的高校新生数据可视化分析系统

作者：计算机学姐 开发技术：SpringBoot、SSM、Vue、MySQL、JSP、ElementUI、Python、小程序等，“文末源码”。 专栏推荐：前后端分离项目源码、SpringBoot项目源码、Vue项目源码、SSM项目源码、微信小程序源码 精品专栏：…
阅读更多...
生信科研，教授（优青）团队一站式指导：高通量测序技术--农业植物基因组分析、组蛋白甲基化修饰、DNA亲和纯化测序、赖氨酸甲基化

生信科研，教授（优青）团队一站式指导：高通量测序技术--农业植物基因组分析、组蛋白甲基化修饰、DNA亲和纯化测序、赖氨酸甲基化

组蛋白甲基化修饰工具(H3K4me3 ChIP-seq) 组蛋白甲基化类型也有很多种，包括赖氨酸甲基化位点H3K4、H3K9、H3K27、H3K36、H3K79和H4K20等。组蛋白H3第4位赖氨酸的甲基化修饰(H3K4)在进化上高度保守，是被研究最多的组蛋白修饰之一。 DNA亲和纯化测序 DNA亲…
阅读更多...
QT设计中文输入法软键盘DLL给到C#开发步骤

QT设计中文输入法软键盘DLL给到C#开发步骤

开发目的：本文提供解决触摸屏C#程序中无法输入中文问题，中文拼音采用开源的谷歌输入法程序、使用QT编译中文输入法界面和中文输入法接口给到C#使用。 开发步骤： 1、QT中设计字母和字符输入界面 2、QT中设计数字输入界面 3、QT中封装调用谷歌…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023