HarmonyOS 鸿蒙Next中关于应用侧与前端页面的相互调用(C/C++)

HarmonyOS 鸿蒙Next中关于应用侧与前端页面的相互调用(C/C++) https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkweb-ndk-jsbridge#%E4%BD%BF%E7%94%A8native%E6%8E%A5%E5%8F%A3%E5%AE%9E%E7%8E%B0jsbridge%E9%80%9A%E4%BF%A1

cke_210.png

教程说明支持返回buffer类型到JS，但是并没有给出相关代码。并且我查看了 ArkWeb_JavaScriptValueType 枚举，没有发现buffer类型，所以要怎么构建并返回？


更多关于HarmonyOS 鸿蒙Next中关于应用侧与前端页面的相互调用(C/C++)的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

HarmonyOS Next中应用侧与前端页面通过C/C++调用主要通过Native API实现。应用侧使用ArkTS/JS与C++交互，通过NAPI机制桥接。前端页面通过Web组件加载，使用JavaScript与C++交互时需通过Native API封装接口。具体流程涉及ArkTS调用C++函数，C++通过NAPI暴露接口给前端。

更多关于HarmonyOS 鸿蒙Next中关于应用侧与前端页面的相互调用(C/C++)的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，应用侧（C/C++）通过NDK与前端页面（JavaScript）进行相互调用时，确实支持传递ArrayBuffer类型数据。虽然ArkWeb_JavaScriptValueType枚举中没有直接的“buffer”类型，但ArrayBuffer是通过NATIVE_OBJECT_ARRAY_BUFFER类型来标识和处理的。

要构建并返回一个ArrayBuffer给JavaScript，核心步骤如下：

  1. 创建ArkWeb_JavaScriptValue：首先，你需要创建一个类型为NATIVE_OBJECT_ARRAY_BUFFER的ArkWeb_JavaScriptValue对象。
  2. 关联原生内存：通过arkweb_create_array_buffer_with_external_buffer或类似接口，将你的C/C++原生内存缓冲区（void*指针和长度）与这个JavaScript值关联起来。这个函数会负责在ArkWeb引擎中创建一个对应的ArrayBuffer对象，并建立与原生内存的映射。
  3. 返回或传递：在Native方法实现中，将这个创建好的ArkWeb_JavaScriptValue作为返回值传递给JavaScript调用方。

关键代码示例（概念性）：

// 假设你有一段原生内存数据
uint8_t* native_buffer = (uint8_t*)malloc(buffer_length);
// ... 填充 native_buffer 数据 ...

// 1. 创建关联原生内存的 ArrayBuffer JavaScript值
ArkWeb_JavaScriptValue array_buffer_js_value;
arkweb_create_array_buffer_with_external_buffer(
    env, // 当前引擎环境
    native_buffer, // 你的原生内存指针
    buffer_length, // 缓冲区长度
    [](void* data, size_t length, void* hint) {
        // 可选的回调，当JavaScript端ArrayBuffer被GC时，用于释放原生内存
        free(data);
    },
    nullptr, // 传递给回调的hint数据
    &array_buffer_js_value
);

// 2. 在你的Native方法中，将此值返回
// 例如，在注册的Native函数实现里：
static ArkWeb_JavaScriptValue MyNativeFunction(ArkWeb_Engine* engine, const ArkWeb_JavaScriptValue this_val, const ArkWeb_JavaScriptValue* argv, uint32_t argc) {
    // ... 创建 array_buffer_js_value ...
    return array_buffer_js_value;
}

重要说明：

  • 内存管理：当你使用arkweb_create_array_buffer_with_external_buffer时，需要仔细管理原生内存的生命周期。你可以提供释放回调（如示例中的lambda），让系统在JavaScript对象被垃圾回收时自动释放内存；或者，如果你需要更精细的控制，可以在回调中做其他处理，但必须确保内存最终被正确释放，避免泄漏。
  • 线程安全：确保对共享原生缓冲区的访问是线程安全的，特别是在异步操作中。
  • 文档参考：具体函数名和参数可能随NDK版本更新，请以最新官方文档为准。你提供的链接指南是正确起点，但需查找NDK API Reference中关于ArkWeb_ArrayBuffer创建和管理的详细接口。

通过以上方式，即可在C/C++侧构建ArrayBuffer并返回给JavaScript使用，实现高效的大块二进制数据传递。

回到顶部