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

移动开发技术栈

于 2024-09-29 22:29:54 发布

阅读量1k

点赞数 12

分类专栏：鸿蒙开发文章标签： harmonyos 鸿蒙系统鸿蒙硬件架构振动嵌入式硬件 openharmony

本文链接：https://blog.csdn.net/m0_70748845/article/details/142644645

版权

鸿蒙开发专栏收录该内容

835 篇文章 22 订阅

订阅专栏

场景介绍

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

函数说明

名称	描述
OHOS::Sensors::OH_Vibrator_PlayVibration(int32_t duration, Vibrator_Attribute attribute)	控制马达在指定时间内持续振动。
OHOS::Sensors::OH_Vibrator_PlayVibrationCustom(Vibrator_FileDescription fileDescription, Vibrator_Attribute vibrateAttribute)	播放自定义振动序列。
OHOS::Sensors::OH_Vibrator_Cancel()	停止马达振动。

振动效果说明

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

固定时长振动

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

自定义振动

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

开发步骤

新建一个Native C++工程。
控制设备上的振动器，需要申请权限ohos.permission.VIBRATE。

"requestPermissions": [
      {
        "name": "ohos.permission.VIBRATE",
      },
    ]

CMakeLists.txt文件中引入动态依赖库。

target_link_libraries(entry PUBLIC libace_napi.z.so)
target_link_libraries(entry PUBLIC libhilog_ndk.z.so)
target_link_libraries(entry PUBLIC libohvibrator.z.so)

导入模块。

#include <sensors/vibrator.h>
#include "napi/native_api.h"
#include "hilog/log.h"
#include <thread>
#include <fcntl.h>
#include <unistd.h>
#include <sys/stat.h>

定义常量。

const int GLOBAL_RESMGR = 0xFF00;
const char *TAG = "[NativeVibratorTest]";
constexpr int32_t TIME_WAIT_FOR_OP = 2;

控制马达在指定时间内持续振动和停止马达振动。

static napi_value Vibration_Test(napi_env env, napi_callback_info info)
{
    Vibrator_Attribute vibrateAttribute;
    vibrateAttribute.usage = VIBRATOR_USAGE_ALARM;

    int32_t ret = OH_Vibrator_PlayVibration(0, vibrateAttribute); // 控制马达在指定时间内持续振动。
    OH_LOG_Print(LOG_APP, LOG_INFO, GLOBAL_RESMGR, TAG, "Vibration successful");
    if (ret != PARAMETER_ERROR) {
        return nullptr;
    }
    std::this_thread::sleep_for(std::chrono::milliseconds(TIME_WAIT_FOR_OP));
    ret = OH_Vibrator_Cancel(); // 停止马达振动。
    if (ret == 0) {
        return nullptr;
    }
}

播放自定义振动序列。

static napi_value VibrationCustom_Test(napi_env env, napi_callback_info info)
{
    int32_t fd = open("/data/test/vibrator/coin_drop.json", O_RDONLY);
    OH_LOG_Print(LOG_APP, LOG_INFO, GLOBAL_RESMGR, TAG, "Test fd:%{public}d", fd);
    struct stat64 statbuf = { 0 };
    if (fd == 0) {
        close(fd);
        return nullptr;
    }
    if (fstat64(fd, &statbuf) == 0) {
        Vibrator_FileDescription fileDescription = {
            .fd = fd,
            .offset = 0,
            .length = statbuf.st_size
        };
        Vibrator_Attribute vibrateAttribute = {
            .usage = VIBRATOR_USAGE_RING
        };
        int32_t ret = OH_Vibrator_PlayVibrationCustom(fileDescription, vibrateAttribute); // 播放自定义振动序列。
        OH_LOG_Print(LOG_APP, LOG_INFO, GLOBAL_RESMGR, TAG, "Vibratecustom successful");
        bool isSuccess = ((ret == 0) || (ret == UNSUPPORTED));
        if (isSuccess == true) {
            close(fd);
            return nullptr;
        }
    }
    std::this_thread::sleep_for(std::chrono::milliseconds(TIME_WAIT_FOR_OP));
    close(fd);
    OH_Vibrator_Cancel(); // 停止马达振动。
}

在types/libentry路径下index.d.ts文件中引入Napi接口。

export const vibration_Test: () => number;
export const vibrationCustom_Test: () => number;

编写Js用例调用接口。

最后呢

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

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

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

在这里插入图片描述