鸿蒙5.0开发进阶:NDK开发-使用Node-API接口进行buffer相关开发

鸿蒙二进制数组创建 c++层数据都是二进制,需要转换成arrayBuffer透传到ets层给业务使用,但是鸿蒙的使用下面两个api创建出来的二进制数组数据都是错误的。 阅读详情

往期鸿蒙全套实战文章必看:


简介

在ArkTS中,Buffer是一种用于处理二进制数据的数据类型。

基本概念

使用Node-API接口进行buffer相关开发时,使用Buffer对象与ArkTS代码之间进行二进制数据的有效交互,以便在Node-API模块创建、操纵和传递Buffer对象到ArkTS,从而处理和传递二进制数据,比如文件I/O、网络传输等。

  • Buffer对象:用于表示一段二进制数据的对象。
  • 外部Buffer:在Node-API模块中创建的Buffer,可以与现有的数据关联起来而不需要复制数据到新的Buffer中。

场景和功能使用

以下这些接口用于有效地与ArkTS层进行交互,这使Node-API模块能够更好地处理ArkTS层的二进制数据,比如处理文件I/O、网络传输等操作:

接口描述
napi_create_buffer用于创建并获取一个指定大小的ArkTS Buffer。
napi_create_buffer_copy用于创建并获取一个指定大小的ArkTS Buffer,并以给定的入参数据对buffer的缓冲区进行初始化。
napi_create_external_buffer用于创建并获取一个指定大小的ArkTS Buffer,并以给定数据进行初始化,该接口可为Buffer附带额外数据。
napi_get_buffer_info获取ArkTS Buffer底层数据缓冲区及其长度。
napi_is_buffer判断给定ArkTS value是否为Buffer对象。
napi_create_external_arraybuffer用于分配一个附加有外部数据的ArkTS ArrayBuffer。外部ArrayBuffer是一个特殊类型的ArrayBuffer,它持有对外部数据的引用而不实际拥有数据存储。

使用示例

本文仅对接口对应C++及ArkTS相关代码进行展示。

napi_create_buffer

此接口用于创建Buffer对象。Buffer对象是用于在Node-API模块中操作二进制数据的一种特殊类型。

cpp部分代码

#include <string>
#include "napi/native_api.h"

static napi_value CreateBuffer(napi_env env, napi_callback_info info)
{
    std::string str("CreateBuffer");
    void *bufferPtr = nullptr;
    size_t bufferSize = str.size();
    napi_value buffer = nullptr;
    // 调用napi_create_buffer接口创建并获取一个指定大小的ArkTS Buffer
    napi_create_buffer(env, bufferSize, &bufferPtr, &buffer);
    // 将字符串str的值复制到buffer的内存中
    strcpy((char *)bufferPtr, str.data());
    return buffer;
}

接口声明

// index.d.ts
export const createBuffer: () => string;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
try {
  hilog.info(0x0000, 'testTag', 'Test Node-API napi_create_buffer: %{public}s', testNapi.createBuffer().toString());
} catch (error) {
  hilog.error(0x0000, 'testTag', 'Test Node-API napi_create_buffer error');
}

napi_create_buffer_copy

本接口是Node-API中用于创建并复制数据到Buffer对象的函数。它可以在Node-API模块中创建一个新的Buffer对象,并将指定的数据复制到该Buffer对象中。

cpp部分代码

#include <string>
#include "hilog/log.h"
#include "napi/native_api.h"

static napi_value CreateBufferCopy(napi_env env, napi_callback_info info)
{
    // 要copy的内容
    std::string str("CreateBufferCopy");
    napi_value buffer = nullptr;
    // 调用napi_create_buffer_copy接口创建buffer并将str的内容copy到buffer
    void* resultData = nullptr;
    napi_create_buffer_copy(env, str.size(), str.data(), &resultData, &buffer);
    OH_LOG_INFO(LOG_APP, "Node-API resultData is : %{public}s.", resultData);
    return buffer;
}

接口声明

// index.d.ts
export const createBufferCopy: () => string;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
try {
  hilog.info(0x0000, 'testTag', 'Test Node-API napi_create_buffer_copy: %{public}s', testNapi.createBufferCopy().toString());
} catch (error) {
  hilog.error(0x0000, 'testTag', 'Test Node-API napi_create_buffer_copy error');
}

napi_create_external_buffer

当希望在ArkTS中使用现有的Node-API模块内存块,而不需要额外的拷贝时,可以使用napi_create_external_buffer。这将允许ArkTS层直接访问并操作该内存,避免额外的内存分配和拷贝操作。

cpp部分代码

#include <malloc.h>
#include <string>
#include "napi/native_api.h"

// 回调函数,用于释放内存
void FinalizeCallback(napi_env env, void *data, void *hint)
{
    if (data == nullptr) {
        return;
    }
    free(data);
    data = nullptr;
}

static napi_value CreateExternalBuffer(napi_env env, napi_callback_info info)
{
    // 创建一个字符串
    std::string str("CreateExternalBuffer");
    // 在堆上分配内存,大小为字符串的长度
    void* data = malloc(str.size());
    // 将字符串复制到分配的内存中
    strcpy((char *)(data), (char*)(str.data()));
    // 使用napi_create_external_buffer接口创建并获取一个指定大小buffer
    napi_value buffer = nullptr;
    napi_create_external_buffer(env, str.size(), data, FinalizeCallback, nullptr, &buffer);
    return buffer;
}

接口声明

// index.d.ts
export const createExternalBuffer: () => string;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
try {
  hilog.info(0x0000, 'testTag', 'Test Node-API napi_create_external_buffer: %{public}s', testNapi.createExternalBuffer()
    .toString());
} catch (error) {
  hilog.error(0x0000, 'testTag', 'Test Node-API napi_create_external_buffer error');
}

napi_get_buffer_info

在ArkTS中需要对Buffer对象中的数据执行特定的操作时,可以使用此接口来获取指向数据的指针和数据长度。这样可以在Node-API模块直接对数据进行操作,而无需进行数据的拷贝。

cpp部分代码

#include <string>
#include "napi/native_api.h"

static napi_value GetBufferInfo(napi_env env, napi_callback_info info)
{
    // 创建一个字符串
    std::string str("GetBufferInfo");
    napi_value buffer = nullptr;
    void *bufferPtr = nullptr;
    size_t bufferSize = str.size();
    napi_create_buffer(env, bufferSize, &bufferPtr, &buffer);
    strcpy((char *)bufferPtr, str.data());

    // 获取Buffer的信息
    void *tmpBufferPtr = nullptr;
    size_t bufferLength = 0;
    napi_get_buffer_info(env, buffer, &tmpBufferPtr, &bufferLength);

    // 创建一个新的ArkTS字符串来保存Buffer的内容并返出去
    napi_value returnValue = nullptr;
    napi_create_string_utf8(env, (char*)tmpBufferPtr, bufferLength, &returnValue);
    return returnValue;
}

接口声明

// index.d.ts
export const getBufferInfo: () => string;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
try {
  hilog.info(0x0000, 'testTag', 'Test Node-API napi_get_buffer_info: %{public}s', testNapi.getBufferInfo().toString());
} catch (error) {
  hilog.error(0x0000, 'testTag', 'Test Node-API napi_get_buffer_info error');
}

napi_is_buffer

判断给定ArkTS value是否为Buffer对象。

cpp部分代码

#include <string>
#include "napi/native_api.h"

static napi_value IsBuffer(napi_env env, napi_callback_info info)
{
    // 创建一个Buffer对象
    std::string str = "buffer";
    napi_value buffer = nullptr;
    napi_create_buffer(env, strlen(str.data()), (void **)(str.data()), &buffer);

    // 调用napi_is_buffer接口判断创建的对象是否为buffer
    bool reslut = false;
    napi_is_buffer(env, buffer, &reslut);
    // 将结果返回出去
    napi_value returnValue = nullptr;
    napi_get_boolean(env, reslut, &returnValue);
    return returnValue;
}

接口声明

// index.d.ts
export const isBuffer: () => boolean;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
try {
  hilog.info(0x0000, 'testTag', 'Test Node-API napi_is_buffer: %{public}s', JSON.stringify(testNapi.isBuffer()));
} catch (error) {
  hilog.info(0x0000, 'testTag', 'Test Node-API napi_is_buffer error');
}

napi_create_external_arraybuffer

分配一个附加有外部数据的ArkTS ArrayBuffer。

cpp部分代码

#include "napi/native_api.h"

typedef struct {
    uint8_t *data;
    size_t length;
} BufferData;

void FinalizeCallback(napi_env env, void *finalize_data, void *finalize_hint)
{
    // 获取终结时的数据
    BufferData *bufferData = static_cast<BufferData *>(finalize_data);

    // 执行清理操作,比如释放资源
    delete[] bufferData->data;
    delete bufferData;
}

napi_value CreateExternalArraybuffer(napi_env env, napi_callback_info info)
{
    // 创建一个有五个元素的C++数组
    uint8_t *dataArray = new uint8_t[5]{1, 2, 3, 4, 5};
    napi_value externalBuffer = nullptr;
    BufferData *bufferData = new BufferData{dataArray, 5};

    // 使用napi_create_external_arraybuffer创建一个外部Array Buffer对象,并指定终结回调函数
    napi_status status =
        napi_create_external_arraybuffer(env, dataArray, 5, FinalizeCallback, bufferData, &externalBuffer);
    if (status != napi_ok) {
        // 处理错误
        napi_throw_error(env, nullptr, "Node-API napi_create_external_arraybuffer fail");
        return nullptr;
    }
    napi_value outputArray;
    // 使用napi_create_typedarray创建一个Array对象,并将externalBuffer对象作为参数传入
    status = napi_create_typedarray(env, napi_int8_array, 5, externalBuffer, 0, &outputArray);
    if (status != napi_ok) {
        // 处理错误
        napi_throw_error(env, nullptr, "Node-API napi_create_typedarray fail");
        return nullptr;
    }
    return outputArray;
}

接口声明

// index.d.ts
export const createExternalArraybuffer: () => ArrayBuffer | void;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'

hilog.info(0x0000, 'testTag', 'Node-API createExternalArraybuffer: %{public}s',
           JSON.stringify(testNapi.createExternalArraybuffer()));

以上代码如果要在native cpp中打印日志,需在CMakeLists.txt文件中添加以下配置信息(并添加头文件:#include "hilog/log.h"):

// CMakeLists.txt
add_definitions( "-DLOG_DOMAIN=0xd0d0" )
add_definitions( "-DLOG_TAG=\"testTag\"" )
target_link_libraries(entry PUBLIC libhilog_ndk.z.so)

Godot引擎与HarmonyOS分布式能力融合:跨设备游戏开发实战 在移动应用与游戏开发领域,跨平台与高性能渲染是开发者持续关注的核心议题。其技术原理在于通过统一的图形接口与高效的资源调度,实现应用在不同硬件环境下的稳定运行。随着分布式操作系统的兴起,技术价值进一步延伸至设备协同,旨在突破单机算力与交互限制,创造无缝的多设备体验。HarmonyOS的分布式软总线与硬件虚拟化能力,为这一场景提供了系统级支持。应用场景典型如将手机作为控制器,在智慧屏上进行游戏渲染与交互,实现资源与体验的分离与整合。本文聚焦于将轻量级开源游戏引擎Godot与HarmonyOS 5.0的分布式特性 阅读详情

相关推荐

【PLIO学习总结】laserMapping中的时间戳与状态更新逻辑

本文仅用于个人学习总结记录。如有错误,请批评指正。

larrydong的博客 1649

node-cpp-addon cpp传递Buffer时会出现Illegal instruction

在使用node-addon-api实现Buffer传递时出现 原使用代码 Napi::Buffer<uint8_t> buf = Napi::Buffer<uint8_t>::New(info.Env(), (uint8_t *)_encode.data(), _encode.size()); 这个代码持续运行一段时间后,程序会崩溃,目前分析的原因时,cpp传递给js的Buffer在js引擎自动回收时导致内存问题。然后看了一下node-addon-api源码发现 temp

u010853380的博客 716

VUE3如何使得大屏自适应的几种方法?

16:9。

weixin_42711805的博客 1万+

N-API编程之HelloWord

1 技术研究背景 公司产品考虑部署到kubernetes环境中,为了使产品具备云原生应用的一些特性和优点,整个系统需要重构。公司产品原有界面全部基于C/S架构设计,基于云原生的特点,界面逐步实行B/S重构,B/S重构必须选定一种web化技术路线。 1.1 产品特点因素 原有产品大部分使用C/C++语言开发,产品的大部分数据都在共享内存中。因此,总的思路使通过C++写扩展的JavaScript接口,实现对共享内存的读取,实现对数据的读取。并可以对已有的C++模块封装成JavaScript接口,实...

eruter的专栏 1636

YonSuite如何新增用户并分配角色角色授权图文教程

用友YonSuite产品基础教学

ct341688的博客 623

unity pc运行包导入glb

本文介绍了在Unity中实现GLB/GLTF模型动态导入的方法。主要使用glTFast插件进行模型导入,配合StandaloneFileBrowser实现文件选择功能。文章提供了详细的插件安装方式(包括国内镜像源),并给出了核心导入脚本代码。脚本实现了模型加载、父对象设置、材质修复等功能,解决了常见的材质显示异常问题。该方法支持编辑器和PC平台,兼容不同版本的glTFastAPI,通过简易UI操作即可完成模型导入,适合需要运行时加载3D模型的Unity项目开发。

懒懒的蓝的博客 545

基于C++的Node.js插件开发

1.c++类型到js类型的转换方式 c++与js的类型转换及函数调用有两种方式:NAPI和V8。 NAPI 1.模块接口导出 NAPI_MODULE_INIT() { napi_value fn = nullptr; NODE_API_CALL(env, napi_create_function(env, nullptr, 0, Init, nullptr, &fn)); NODE_API_CALL(env, napi_set_named_property(env, e

gb173652770的专栏 2556

【Claude】权限被拒绝 (Permission Denied) 全场景排查 — 已解决

权限配置是 Claude Code 安全使用的核心机制。通过合理的 allow/deny 规则、正确的通配符使用、子代理独立配置、定期安全审计,可以在保证安全性的同时不影响开发效率。deny 优先:deny 规则优先级高于 allow,先保护敏感资源通配符精确单层匹配,**递归匹配,Bash(cmd*)允许带参数最小权限:只允许必要的操作,避免Bash(*)等危险规则CI 用 skip:Headless 模式用避免挂起子代理独立:每个子代理单独配置权限,不自动继承保护密钥:deny.env。

一键难忘的博客 3951

鸿蒙HarmonyOS应用开发之Rawfile开发指导_rawfiledescriptor 怎么导入(2)

基本涵盖了95%以上HarmonyOS鸿蒙开发知识点,真正体系化!**

m0_57541068的博客 1014

PSINS工具箱学习(四)捷联惯导更新算法

原始 Markdown文档、Visio流程图、XMind思维导图见:https://github.com/LiZhengXiao99/Navigation-Learning。

实践出真理,接毕设/课设项目开发指导 607

基于RK3588平台的高分辨率多摄像头系统深度优化:从48M单摄到双摄分时复用的完整解决方案

本文深入解析了RK3588平台的高分辨率摄像头实现方案。重点介绍了:1)RK3588的MIPI PHY硬件架构,包括DCPHY和DPHY的资源配置及工作模式;2)双ISP合成技术,通过并行处理提升48M高分辨率图像的处理能力;3)以OV50C40传感器为例,详细展示了48M单摄系统的硬件连接、I2C设备配置和关键参数设置。文章为开发者提供了从硬件连接到软件配置的完整技术方案,有助于实现高性能嵌入式视觉系统。

FJN110的博客 675

鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API接口进行buffer相关开发)

在ArkTS中,Buffer是一种用于处理二进制数据的数据类型。

Androidbye的博客 1026

把 SAP Activate 六个阶段看透:从项目落地到 SAP BTP 扩展与 AI 运营的一体化实践

摘要: SAP Activate 方法论常被误解为简单的项目阶段划分,实则是一套将业务目标、标准流程、系统配置和持续运营串联的实施控制体系。其六个阶段(Discover至Run)构成价值递进的实施通道,核心交付集中在Prepare到Deploy阶段。Discover阶段通过DDA评估确立项目方向与范围,Prepare阶段聚焦可执行性准备,Explore阶段采用Fit-to-Standard工作坊进行需求分层,Realize阶段基于前期决策进行配置与扩展开发。该方法论强调标准化优先,差异化需求通过SAP BT

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 2336

鸿蒙5.0开发进阶:NDK开发-Node-API支持的数据类型和接口

是一个枚举数据类型,表示Node-API接口返回的状态信息

Androidbye的博客 1035

汉书HE8,好用的汇编代码编写工具

汉书HE8,好用的汇编代码编写工具早期编写汇编代码所用功能强大

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

鸿蒙5.0&next开发【使用Node-API接口进行buffer相关开发】NDK开发

在ArkTS中,Buffer是一种用于处理二进制数据的数据类型。

bbq的博客 934

OV9734 DATASHEET,完整规格书

OV9734完整规格书,包括电气参数,尺寸规格,寄存器配置表等

鸿蒙5.0开发进阶:NDK代码开发-使用Node-API实现跨语言交互(Node-API支持的数据类型和接口)

Node-API支持的数据类型和接口.................

Androidbye的博客 1129

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

鸿蒙5.0&next开发【Node-API支持的数据类型和接口】NDK开发

是一个枚举数据类型,表示Node-API接口返回的状态信息。 每当调用一个Node-API函数,都会返回该值,表示操作成功与否的相关信息。

bbq的博客 1083

鸿蒙NDK实战:JSVM-API桥接WebAssembly实现高性能计算

WebAssembly(Wasm)是一种为高性能计算设计的二进制指令格式,它允许C/C++、Rust等语言编译成可在多种环境中安全、高效运行的字节码。其核心原理是提供接近原生速度的沙箱化执行环境,通过线性内存模型和精简指令集实现跨平台性能优化。在移动应用开发中,尤其在处理图像渲染、音视频编解码、物理模拟等计算密集型任务时,Wasm能有效突破JavaScript引擎的性能瓶颈。鸿蒙(HarmonyOS)的JSVM-API为原生层与JavaScript引擎提供了交互通道,结合NDK(Native Develop

weixin_30314793的博客 273

把 FCEUX 移植到HarmonyOS鸿蒙PC:一个 NES 模拟器的移植笔记

本文记录了将经典NES模拟器FCEUX移植到HarmonyOS的完整过程,重点介绍了技术架构和实现方案。作者通过分析FCEUX的代码结构,发现核心模块(6502 CPU、PPU渲染等)具有跨平台特性,只需重写驱动层即可实现移植。项目采用四层架构设计:ArkTS界面层通过NAPI桥接调用C++原生层,后者对接HarmonyOS驱动层并最终调用FCEUX核心模块。文章详细分享了视频输出方案的迭代过程(从失败的Canvas方案到成功的XComponent原生渲染方案),以及编译环境配置中的典型问题(头文件路径、库

猫哥 的沉淀、积累、总结。天天学习,好好向上...c/c++,嵌入式 linux,Android,HarmonyOS,AIOT) 3551

HarmonyOS媒体(一)——一篇教你看懂Image Kit

本文摘要:文章系统介绍了鸿蒙系统中的图像处理技术,主要分为三部分:1)基础概念,包括PixelMap、Picture、FFI和NAPI的区别;2)鸿蒙Image Kit框架的功能,涵盖解码、编码和图像处理;3)图片解码和编码的详细流程,包含单图和多图的不同处理路径。关键技术点包括:PixelMap和Picture的数据结构差异,FFI与NAPI的性能对比,以及图像处理中的解码、编码实现方案。文章通过流程图和对比表格,清晰展示了鸿蒙系统处理图像的技术架构和API设计理念。

qq_51405411的博客 417

C++对JS Object的操作

N-API提供一些API来创建JavaScript所有类型值。

Hens_Hello_Mr的博客 1419

Native Rawfile 开发指导

开发者可以通过本指导了解在 HarmonyOS 应用中,如何使用 Native Rawfile 接口操作 Rawfile 目录和文件。功能包括遍历、打开、搜索、读取和关闭 Rawfile。

HarmonyOSDev的博客 1489

从c++ addon看napi的实现

Node.js的napi极大地方便了c++ addon的编写,使得用户不再那么需要面对复杂的v8。本文通过一个例子来分析一下napi的使用和napi到底做了什么。 1 导出给js使用的功能 #include <node_api.h> NAPI_MODULE(NODE_GYP_MODULE_NAME, Init) 上面的代码是使用napi时的通用模式,我们只需要实现Init函数就行(当然也可以叫其他名字)。接下来我们看看Init的实现。 napi_value Init(napi_env env,

标子 的专栏 1629

鸿蒙NEXT版实战开发:在ArkTS侧如何引用Native侧使用napi_create_buffer接口构造的对象?

napi_create_buffer接口如何使用,构建出来的结果如何在ArkTS与Native之间传递?

qq_39652397的博客 673

三方库移植之NAPI开发[4]异步调用:Callback&Promise

以下图片为个人总结,可以在文末下载清晰的图片,下载之后推荐到[diagrams]。

m0_70748458的博客 934

鸿蒙HarmonyOS应用开发之Node-API开发规范

当传入napi_get_cb_info的argv不为nullptr时,argv的长度必须大于等于传入argc声明的大小。当argv不为nullptr时,napi_get_cb_info会根据argc声明的数量将JS实际传入的参数写入argv。如果argc小于等于实际JS传入参数的数量,该接口仅会将声明的argc数量的参数写入argv;而当argc大于实际参数数量时,该接口会在argv的尾部填充undefined。

1 1918
上一篇: 鸿蒙5.0开发进阶:NDK开发-使用Node-API接口操作bigint类型值
下一篇: 鸿蒙5.0开发进阶:NDK开发-使用Node-API接口创建基本数据类型
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值