JavaScript如何調用C++模塊中的函數(shù)
場景一：JS側調用C++側函數(shù)，并傳遞參數(shù)
JS側調用C++側函數(shù)
import testNapi from 'libentry.so'
const TAG = "beixiang";
@Entry
@Component
struct Index {
build() {
Row() {
Column() {
Text('調用testNapi.add')
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
const result = testNapi.add(3,4);
console.log(`${TAG} 調用testNapi.add的結果為${result}`);
})
}
.width('100%')
}
.height('100%')
}
}C++側方法實現(xiàn)
static napi_value Add(napi_env env, napi_callback_info info)
{
// 獲取 2 個參數(shù)，napi_value是對 JS 類型的封裝
size_t argc = 2;
napi_value argv[2] = {nullptr};
// 調用napi_get_cb_info方法，從 info 中讀取傳遞進來的參數(shù)放入argv里
napi_get_cb_info(env, info, &argc, argv , nullptr, nullptr);
// 獲取參數(shù)并校驗類型
napi_valuetype valuetype0;
napi_typeof(env, argv[0], &valuetype0);
napi_valuetype valuetype1;
napi_typeof(env, argv[1], &valuetype1);
// 調用napi_get_value_double把 napi_value 類型轉換成 C++ 的 double 類型
double value0;
napi_get_value_double(env, argv[0], &value0);
double value1;
napi_get_value_double(env, argv[1], &value1);
// 調用napi_create_double方法把 C++類型轉換成 napi_value 類型
napi_value sum;
napi_create_double(env, value0 + value1, &sum);
// 返回 napi_value 類型
return sum;
}napi_get_cb_info (napi_env env, napi_callback_info cbinfo, size_t *argc, napi_value *argv, napi_value *this_arg, void **data)
- env：調用 API 的環(huán)境
- cbinfo：傳遞給回調函數(shù)的回調信息
- argc：指定提供的 argv 數(shù)組的大小并接收參數(shù)的實際計數(shù)
- argv：將表示參數(shù)的 napi_value 復制到的緩沖區(qū)
- this_arg：接收調用的 JavaScript this 參數(shù)
- data：接收回調的數(shù)據(jù)指針
例如Add方法的代碼，
napi_get_cb_info(env, info, &argc, argv , nullptr, nullptr);，從 info 中讀取傳遞進來的&argc個參數(shù)放入argv。napi_get_value_double(napi_env env, napi_value value, double *result)
把 napi_value 類型轉換成 C++ 的 double 類型，供C++側使用
napi_create_double(napi_env env, double value, napi_value *result)
把 C++ double類型轉換成 napi_value 類型，供JS側使用
napi_create_function(napi_env env, const char *utf8name, size_t length, napi_callback cb, void *data, napi_value *result)
不同于以上定義函數(shù)，并在Init() 方法內聲明 napi_property_descriptor 結構體導出函數(shù)的方式，使用 napi_create_function允許將C++側函數(shù)創(chuàng)建為可供JS側調用的函數(shù)對象，然后使用napi_set_named_property將創(chuàng)建的函數(shù)對象導出，以便可以從JS側訪問該函數(shù)，如下代碼：
// xxx.cpp
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
napi_value fn;
// 根據(jù)C++側函數(shù)Add創(chuàng)建函數(shù)fn
napi_create_function(env, nullptr, 0, Add, nullptr, &fn);
// 將創(chuàng)建的函數(shù)fn導出，函數(shù)名為newAdd
napi_set_named_property(env, exports, "newAdd", fn);
napi_property_descriptor desc[] = {
{ "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr },
};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
EXTERN_C_END
// index.d.ts export const newAdd: (a: number, b: number) => number;
場景二：JS側不傳參給回調函數(shù)，C++側接收JS側回調函數(shù)并執(zhí)行
JS側調用C++側函數(shù)
import testNapi from 'libentry.so'
const TAG = "beixiang";
@Entry
@Component
struct Index {
build() {
Row() {
Column() {
Text('調用無參回調函數(shù)')
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
// 先注冊無參回調函數(shù)
testNapi.registerCallback(() => {
const a = 2;
const b = 3;
return a + b;
})
// 調用無參回調函數(shù)
const result = testNapi.handleCallbackWithoutParams();
console.log(`${TAG} 調用無參回調函數(shù)的結果為${result}`);
})
}
.width('100%')
}
.height('100%')
}
}C++側注冊回調函數(shù)
// js函數(shù)回調
static napi_ref callback = nullptr;
/**
* 注冊回調函數(shù)
* @param env
* @param info
* @return
*/
static napi_value RegisterCallback(napi_env env, napi_callback_info info)
{
size_t argc = 1;
napi_value argv[1] = {nullptr};
napi_get_cb_info(env, info, &argc, argv, nullptr, nullptr);
napi_create_reference(env, argv[0], 1, &callback);
return nullptr;
}C++側執(zhí)行注冊回調函數(shù)
/**
* 執(zhí)行回調函數(shù)，不帶參數(shù)
* @param env
* @param info
* @return
*/
static napi_value HandleCallbackWithoutParams(napi_env env, napi_callback_info info)
{
napi_value global;
napi_get_global(env, &global);
napi_value cb = nullptr;
napi_get_reference_value(env, callback, &cb);
napi_value result;
napi_status status = napi_call_function(env, global, cb, 0 , nullptr, &result);
if (status != napi_ok) return nullptr;
return result;
}napi_create_reference(napi_env env, napi_value value, uint32_t initial_refcount, napi_ref *result)
此 API 為傳入的對象創(chuàng)建一個具有指定引用計數(shù)的新引用，例如注冊回調函數(shù)RegisterCallback中的napi_create_reference(env, argv[0], 1, &callback)，將JS側傳入的對象argv[0]（對JS來說，函數(shù)也是對象）保存在callback中，供C++側方法調用;
napi_get_reference_value(napi_env env, napi_ref ref, napi_value *result)
將創(chuàng)建的引用ref保存到result中
napi_call_function(napi_env env, napi_value recv, napi_value func, size_t argc, const napi_value *argv, napi_value *result)
- env：調用 API 的環(huán)境
- recv：this 對象傳遞給被調用的函數(shù)，一般是當前環(huán)境的global對象，通過napi_get_global來獲取。
- func：表示要調用的 JavaScript 函數(shù)
- argc：argv 數(shù)組中元素的計數(shù)。
- argv：表示作為參數(shù)傳遞給函數(shù)的 JavaScript 值的 napi_values 數(shù)組
- result：napi_value 表示返回的 JavaScript 對象
在env環(huán)境下，在global對象中調用函數(shù)func，該函數(shù)參數(shù)數(shù)組為argv，有argc個參數(shù)，函數(shù)執(zhí)行結果保存在result。此API允許從C++側調用 JavaScript 函數(shù)對象，例如本文的napi_call_function(env, global, cb, 0 , nullptr, &result);
場景三：JS側傳參給回調函數(shù)，C++側接收JS側回調函數(shù)并執(zhí)行
JS側調用C++側函數(shù)
import testNapi from 'libentry.so'
const TAG = "beixiang";
@Entry
@Component
struct Index {
build() {
Row() {
Column() {
Text('調用有參回調函數(shù)')
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
// 先注冊無參回調函數(shù)
testNapi.registerCallback((a: number, b: number) => {
return a + b;
})
// 調用無參回調函數(shù)
const result = testNapi.handleCallbackWithParams();
console.log(`${TAG} 調用有參回調函數(shù)的結果為${result}`);
})
}
.width('100%')
}
.height('100%')
}
}C++側注冊回調函數(shù)
/**
* 注冊回調函數(shù)
* @param env
* @param info
* @return
*/
static napi_value RegisterCallback(napi_env env, napi_callback_info info)
{
size_t argc = 1;
napi_value args[1] = {nullptr};
napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);
napi_create_reference(env, args[0], 1, &callback);
return nullptr;
}C++側執(zhí)行注冊回調函數(shù)
/**
* 執(zhí)行回調函數(shù)，帶參數(shù)
* @param env
* @param info
* @return
*/
static napi_value HandleCallbackWithParams(napi_env env, napi_callback_info info)
{
napi_value argv[2] = {nullptr};
napi_valuetype valuetype0;
napi_typeof(env, argv[0], &valuetype0);
napi_valuetype valuetype1;
napi_typeof(env, argv[1], &valuetype1);
double value1 = 2;
double value2 = 3;
// 創(chuàng)建兩個double，給callback調用
napi_create_double(env, value1, &argv[0]);
napi_create_double(env, value2, &argv[1]);
napi_value global;
napi_get_global(env, &global);
napi_value cb = nullptr;
napi_get_reference_value(env, callback, &cb);
napi_valuetype type;
napi_typeof(env, cb, &type);
napi_value result;
// 調用回調函數(shù)
napi_status status = napi_call_function(env, global, cb, 2, argv, &result);
if (status != napi_ok) return nullptr;
return result;
}值得注意的是，本文JS側傳遞給C++的回調函數(shù)是匿名函數(shù)，C++側先將JS回調函數(shù)先在C++側注冊，即使用napi_create_reference將JS函數(shù)創(chuàng)建為ref，ref最終會作為napi_call_function的第三個參數(shù)，可以放心并沒有在global對象里面直接去取函數(shù)引用。
另一種實現(xiàn)方式是JS側傳遞給C++的回調函數(shù)是非匿名函數(shù)，使用napi_get_named_property在global對象中直接獲取函數(shù)引用：
JS側定義非匿名的回調函數(shù)：
function add(a: number, b:number) {
return a + b;
}C++側從global對象中取出add函數(shù)，在napi_call_function引入：
napi_value global, add, arg; napi_get_global(env, &global); // 在global對象中取出名為"add"的對象/函數(shù)名,保存在add中。 napi_get_named_property(env, global, "add", &add); ... // 調用add函數(shù) napi_call_function(env, global, add, 2 , argv, &result);
總結
到此這篇關于JavaScript如何調用C++模塊中函數(shù)的文章就介紹到這了,更多相關JS調用C++模塊的函數(shù)內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
js判斷手機是否安裝并打開app，未安裝則安裝app【兼容Android、ios,親測可用】
這篇文章主要介紹了js判斷手機是否安裝并打開app,未安裝則安裝app,通過調用瀏覽器判斷app,兼容Android、ios等系統(tǒng),,需要的朋友可以參考下2023-05-05
本文給大家分享的是使用javascript實現(xiàn)的一個簡單的三級聯(lián)動菜單，非常簡單實用，有需要的小伙伴過來參考下吧。2015-03-03
在WEB開發(fā)中，javascript提供了許多函數(shù)供開發(fā)人員使用，這些函數(shù)在Ajax流行前足夠了，但要構建一個交互性強些的應用恐怕就麻煩了。2009-10-10
本文主要介紹了JavaScript中清空數(shù)組的幾種方法，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-02-02
這篇文章主要介紹了通過實例解析js可枚舉屬性與不可枚舉屬性,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-12-12
使用requestAnimationFrame實現(xiàn)js動畫性能好
requestAnimationFrame優(yōu)于setTimeout/setInterval的地方在于它是由瀏覽器專門為動畫提供的API，在運行時瀏覽器會自動優(yōu)化方法的調用，并且如果頁面不是激活狀態(tài)下的話，動畫會自動暫停，有效節(jié)省了CPU開銷，這篇文章給大家詳細介紹使用requestAnimationFrame實現(xiàn)js動畫2015-08-08
這篇文章主要介紹了JS正則表達式封裝與使用操作,涉及javascript使用正則表達式針對郵箱、手機號、身份證、用戶名、中文等簡單驗證操作技巧,需要的朋友可以參考下2019-05-05
動態(tài)添加js事件，主要是不用具體指定位置的事件，這種動態(tài)添加事件的方法比較方便，并可以擴展等。2009-03-03
當一串數(shù)字的時候，很多瀏覽器不能自動換行，所以可以借助js來實現(xiàn)。2010-08-08
這篇文章主要介紹了JavaScript中$.ajax()最新用法的相關資料,包括基礎語法、現(xiàn)代回調方式、異步處理、高級場景示例、錯誤處理、安全注意事項、替代方法以及調試技巧,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2025-04-04