鴻蒙開發(fā)接口公共事件與通知：【FFI能力(Node-API)】
FFI能力(N-API)
ArkUI-X中支持的N-API接口情況
Node-API是封裝底層JavaScript運(yùn)行時(shí)能力的一套Native接口。OpenHarmony的N-API組件對(duì)Node-API的接口進(jìn)行了重新實(shí)現(xiàn)，ArkUI-X同樣擁有這部分能力，目前支持部分接口，支持列表。
Node-API
簡(jiǎn)介
Node-API是封裝底層JavaScript運(yùn)行時(shí)能力的一套Native接口。
支持的能力
Node-API屏蔽了底層不同JavaScript引擎的差異，提供一套穩(wěn)定的接口。
OpenHarmony的N-API組件對(duì)Node-API的接口進(jìn)行了重新實(shí)現(xiàn)，ArkUI-X在此基礎(chǔ)上進(jìn)行了跨平臺(tái)擴(kuò)展，N-API接口可以在OpenHarmony/HarmonyOS/Android/iOS多個(gè)平臺(tái)上使用。當(dāng)前支持[Node-API]標(biāo)準(zhǔn)庫中的部分接口，如下表所示。
N-API組件擴(kuò)展的符號(hào)列表
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
標(biāo)準(zhǔn)庫中導(dǎo)出的符號(hào)列表
| 符號(hào)類型 | 符號(hào)名 | 說明 |
|---|---|---|
| FUNC | napi_module_register | napi native模塊注冊(cè)接口。 |
| FUNC | napi_get_last_error_info | 獲取napi_extended_error_info結(jié)構(gòu)體，其中包含最近一次出現(xiàn)的error信息。 |
| FUNC | napi_throw | 拋出一個(gè)js value。 |
| FUNC | napi_throw_error | 拋出一個(gè)帶文本信息的jsError。 |
| FUNC | napi_throw_type_error | 拋出一個(gè)帶文本信息的jsTypeError。 |
| FUNC | napi_throw_range_error | 拋出一個(gè)帶文本信息的jsRangeError。 |
| FUNC | napi_is_error | 判斷napi_value是否表示為一個(gè)error對(duì)象。 |
| FUNC | napi_create_error | 創(chuàng)建并獲取一個(gè)帶文本信息的jsError。 |
| FUNC | napi_create_type_error | 創(chuàng)建并獲取一個(gè)帶文本信息的jsTypeError。 |
| FUNC | napi_create_range_error | 創(chuàng)建并獲取一個(gè)帶文本信息的jsRangeError。 |
| FUNC | napi_get_and_clear_last_exception | 獲取并清除最近一次出現(xiàn)的異常。 |
| FUNC | napi_is_exception_pending | 判斷是否出現(xiàn)了異常。 |
| FUNC | napi_fatal_error | 引發(fā)致命錯(cuò)誤以立即終止進(jìn)程。 |
| FUNC | napi_open_handle_scope | 創(chuàng)建一個(gè)上下文環(huán)境使用。 |
| FUNC | napi_close_handle_scope | 關(guān)閉傳入的上下文環(huán)境，關(guān)閉后，在其中聲明的全部napi_value都將被回收。 |
| FUNC | napi_open_escapable_handle_scope | 創(chuàng)建出一個(gè)可逃逸的handel scope，可將范圍內(nèi)聲明的值返回到父作用域。 |
| FUNC | napi_close_escapable_handle_scope | 關(guān)閉傳入的可逃逸的handel scope。 |
| FUNC | napi_escape_handle | 提升傳入的js object的生命周期到其父作用域。 |
| FUNC | napi_create_reference | 為napi_value創(chuàng)建一個(gè)reference，提升js對(duì)象生命周期。調(diào)用者需要自己管理reference生命周期。 |
| FUNC | napi_delete_reference | 刪除傳入的reference。 |
| FUNC | napi_reference_ref | 增加傳入的reference的引用計(jì)數(shù)，并獲取該計(jì)數(shù)。 |
| FUNC | napi_reference_unref | 減少傳入的reference的引用計(jì)數(shù)，并獲取該計(jì)數(shù)。 |
| FUNC | napi_get_reference_value | 獲取與reference相關(guān)聯(lián)的jsObject。 |
| FUNC | napi_create_array | 創(chuàng)建并獲取一個(gè)jsArray。 |
| FUNC | napi_create_array_with_length | 創(chuàng)建并獲取一個(gè)指定長(zhǎng)度的jsArray。 |
| FUNC | napi_create_arraybuffer | 創(chuàng)建并獲取一個(gè)指定大小的jsArrayBuffer。 |
| FUNC | napi_create_external | 分配一個(gè)附加有外部數(shù)據(jù)的js value。 |
| FUNC | napi_create_external_arraybuffer | 分配一個(gè)附加有外部數(shù)據(jù)的jsArrayBuffer。 |
| FUNC | napi_create_object | 創(chuàng)建一個(gè)默認(rèn)的jsObject。 |
| FUNC | napi_create_symbol | 創(chuàng)建一個(gè)jsSymbol。 |
| FUNC | napi_create_typedarray | 通過現(xiàn)有的ArrayBuffer創(chuàng)建一個(gè)jsTypeArray。 |
| FUNC | napi_create_dataview | 通過現(xiàn)有的ArrayBuffer創(chuàng)建一個(gè)jsDataView。 |
| FUNC | napi_create_int32 | 通過一個(gè)C的int32_t數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_uint32 | 通過一個(gè)C的uint32_t數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_int64 | 通過一個(gè)C的int64_t數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_double | 通過一個(gè)C的double數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_string_latin1 | 通過ISO-8859-1編碼的C字符串?dāng)?shù)據(jù)創(chuàng)建jsString。 |
| FUNC | napi_create_string_utf8 | 通過UTF8編碼的C字符串?dāng)?shù)據(jù)創(chuàng)建jsString。 |
| FUNC | napi_create_string_utf16 | 通過UTF16編碼的C字符串?dāng)?shù)據(jù)創(chuàng)建jsString。 |
| FUNC | napi_get_array_length | 獲取array的length。 |
| FUNC | napi_get_arraybuffer_info | 獲取ArrayBuffer的底層data buffer及其長(zhǎng)度。 |
| FUNC | napi_get_prototype | 獲取給定jsObject的prototype。 |
| FUNC | napi_get_typedarray_info | 獲取給定TypedArray的各種屬性。 |
| FUNC | napi_get_dataview_info | 獲取給定DataView的各種屬性。 |
| FUNC | napi_get_value_bool | 獲取給定jsBoolean對(duì)應(yīng)的C bool值。 |
| FUNC | napi_get_value_double | 獲取給定jsNumber對(duì)應(yīng)的C double值。 |
| FUNC | napi_get_value_external | 獲取先前通過napi_create_external()傳遞的外部數(shù)據(jù)指針。 |
| FUNC | napi_get_value_int32 | 獲取給定jsNumber對(duì)應(yīng)的C int32值。 |
| FUNC | napi_get_value_int64 | 獲取給定jsNumber對(duì)應(yīng)的C int64值。 |
| FUNC | napi_get_value_string_latin1 | 獲取給定js vaule對(duì)應(yīng)的ISO-8859-1編碼的字符串。 |
| FUNC | napi_get_value_string_utf8 | 獲取給定js vaule對(duì)應(yīng)的UTF8編碼的字符串。 |
| FUNC | napi_get_value_string_utf16 | 獲取給定js vaule對(duì)應(yīng)的UTF16編碼的字符串。 |
| FUNC | napi_get_value_uint32 | 獲取給定jsNumber對(duì)應(yīng)的C uint32值。 |
| FUNC | napi_get_boolean | 根據(jù)給定的C boolean值，獲取js bool對(duì)象。 |
| FUNC | napi_get_global | 獲取global對(duì)象。 |
| FUNC | napi_get_null | 獲取null對(duì)象。 |
| FUNC | napi_get_undefined | 獲取undefined對(duì)象。 |
| FUNC | napi_coerce_to_bool | 將給定的js value強(qiáng)轉(zhuǎn)成jsBoolean。 |
| FUNC | napi_coerce_to_number | 將給定的js value強(qiáng)轉(zhuǎn)成jsNumber。 |
| FUNC | napi_coerce_to_object | 將給定的js value強(qiáng)轉(zhuǎn)成jsObject。 |
| FUNC | napi_coerce_to_string | 將給定的js value強(qiáng)轉(zhuǎn)成jsString。 |
| FUNC | napi_typeof | 獲取給定js value的js type。 |
| FUNC | napi_instanceof | 判斷給定object是否為給定constructor的實(shí)例。 |
| FUNC | napi_is_array | 判斷給定js value是否為array。 |
| FUNC | napi_is_arraybuffer | 判斷給定js value是否為ArrayBuffer。 |
| FUNC | napi_is_typedarray | 判斷給定js value是否表示一個(gè)TypedArray。 |
| FUNC | napi_is_dataview | 判斷給定js value是否表示一個(gè)DataView。 |
| FUNC | napi_is_date | 判斷給定js value是否為jsDate對(duì)象。 |
| FUNC | napi_strict_equals | 判斷給定的兩個(gè)js value是否嚴(yán)格相等。 |
| FUNC | napi_get_property_names | 以字符串?dāng)?shù)組的形式獲取對(duì)象的可枚舉屬性的名稱。 |
| FUNC | napi_set_property | 對(duì)給定Object設(shè)置屬性。 |
| FUNC | napi_get_property | 獲取給定Object的給定屬性。 |
| FUNC | napi_has_property | 判斷給定對(duì)象中是否存在給定屬性。 |
| FUNC | napi_delete_property | 嘗試從給定Object中刪除給定key屬性。 |
| FUNC | napi_has_own_property | 判斷給定Object中是否有名為key的own property。 |
| FUNC | napi_set_named_property | 對(duì)給定Object設(shè)置一個(gè)給定名稱的屬性。 |
| FUNC | napi_get_named_property | 獲取給定Object中指定名稱的屬性。 |
| FUNC | napi_has_named_property | 判斷給定Object中是否有給定名稱的屬性。 |
| FUNC | napi_set_element | 在給定Object的指定索引處，設(shè)置元素。 |
| FUNC | napi_get_element | 獲取給定Object指定索引處的元素。 |
| FUNC | napi_has_element | 若給定Object的指定索引處擁有屬性，獲取該元素。 |
| FUNC | napi_delete_element | 嘗試刪除給定Object的指定索引處的元素。 |
| FUNC | napi_define_properties | 批量的向給定Object中定義屬性。 |
| FUNC | napi_type_tag_object | 將tag指針的值與Object關(guān)聯(lián)。 |
| FUNC | napi_check_object_type_tag | 判斷給定的tag指針是否被關(guān)聯(lián)到了jsObject上。 |
| FUNC | napi_call_function | 在Native方法中調(diào)用js function，即native call js。 |
| FUNC | napi_create_function | 創(chuàng)建native方法給js使用，以便于js call native。 |
| FUNC | napi_get_cb_info | 從給定的callback info中獲取有關(guān)調(diào)用的詳細(xì)信息，如參數(shù)和this指針。 |
| FUNC | napi_get_new_target | 獲取構(gòu)造函數(shù)調(diào)用的new.target。 |
| FUNC | napi_new_instance | 通過給定的構(gòu)造函數(shù)，構(gòu)建一個(gè)實(shí)例。 |
| FUNC | napi_define_class | 定義與C++類相對(duì)應(yīng)的JavaScript類。 |
| FUNC | napi_wrap | 在js object上綁定一個(gè)native對(duì)象實(shí)例。 |
| FUNC | napi_unwrap | 從js object上獲取先前綁定的native對(duì)象實(shí)例。 |
| FUNC | napi_remove_wrap | 從js object上獲取先前綁定的native對(duì)象實(shí)例，并解除綁定。 |
| FUNC | napi_create_async_work | 創(chuàng)建一個(gè)異步工作對(duì)象。 |
| FUNC | napi_delete_async_work | 釋放先前創(chuàng)建的異步工作對(duì)象。 |
| FUNC | napi_queue_async_work | 將異步工作對(duì)象加到隊(duì)列，由底層去調(diào)度執(zhí)行。 |
| FUNC | napi_cancel_async_work | 取消入隊(duì)的異步任務(wù)。 |
| FUNC | napi_get_node_version | 獲取node的版本信息。 |
| FUNC | napi_get_version | 獲取Node運(yùn)行時(shí)支持的最高 N-API 版本。 |
| FUNC | napi_create_promise | 創(chuàng)建一個(gè)延遲對(duì)象和js promise。 |
| FUNC | napi_resolve_deferred | resolve與js promise對(duì)象關(guān)聯(lián)的延遲函數(shù)。 |
| FUNC | napi_reject_deferred | reject與js promise對(duì)象關(guān)聯(lián)的延遲函數(shù)。 |
| FUNC | napi_is_promise | 判斷給定js value是否為promise對(duì)象。 |
| FUNC | napi_get_uv_event_loop | 獲取當(dāng)前l(fā)ibuv loop實(shí)例。 |
| FUNC | napi_create_threadsafe_function | 創(chuàng)建線程安全函數(shù)。 |
| FUNC | napi_get_threadsafe_function_context | 獲取線程安全函數(shù)中的context。 |
| FUNC | napi_call_threadsafe_function | 調(diào)用線程安全函數(shù)。 |
| FUNC | napi_acquire_threadsafe_function | 指示線程安全函數(shù)可以開始使用。 |
| FUNC | napi_release_threadsafe_function | 指示線程安全函數(shù)將停止使用。 |
| FUNC | napi_ref_threadsafe_function | 指示在主線程上運(yùn)行的事件循環(huán)在線程安全函數(shù)被銷毀之前不應(yīng)退出。 |
| FUNC | napi_unref_threadsafe_function | 指示在主線程上運(yùn)行的事件循環(huán)可能會(huì)在線程安全函數(shù)被銷毀之前退出。 |
| FUNC | napi_create_date | 通過一個(gè)C的double數(shù)據(jù)創(chuàng)建jsDate。 |
| FUNC | napi_get_date_value | 獲取給定jsDate對(duì)應(yīng)的C double值。 |
| FUNC | napi_create_bigint_int64 | 通過一個(gè)C的int64數(shù)據(jù)創(chuàng)建jsBigInt。 |
| FUNC | napi_create_bigint_uint64 | 通過一個(gè)C的uint64數(shù)據(jù)創(chuàng)建jsBigInt。 |
| FUNC | napi_create_bigint_words | 通過一個(gè)C的uint64數(shù)組創(chuàng)建單個(gè)jsBigInt。 |
| FUNC | napi_get_value_bigint_int64 | 獲取給定jsBigInt對(duì)應(yīng)的C int64值。 |
| FUNC | napi_get_value_bigint_uint64 | 獲取給定jsBigInt對(duì)應(yīng)的C uint64值。 |
| FUNC | napi_get_value_bigint_words | 獲取給定jsBigInt對(duì)應(yīng)的信息，包括符號(hào)位、64位小端序數(shù)組和數(shù)組中的元素個(gè)數(shù)。 |
| FUNC | napi_create_buffer | 創(chuàng)建并獲取一個(gè)指定大小的jsBuffer。 |
| FUNC | napi_create_buffer_copy | 創(chuàng)建并獲取一個(gè)指定大小的jsBuffer，并以給定數(shù)據(jù)進(jìn)行初始化。 |
| FUNC | napi_create_external_buffer | 創(chuàng)建并獲取一個(gè)指定大小的jsBuffer，并以給定數(shù)據(jù)進(jìn)行初始化，該接口可為Buffer附帶額外數(shù)據(jù)。 |
| FUNC | napi_get_buffer_info | 獲取jsBuffer底層data及其長(zhǎng)度。 |
| FUNC | napi_is_buffer | 判斷給定js value是否為Buffer對(duì)象。 |
| FUNC | napi_object_freeze | 凍結(jié)給定的對(duì)象。 |
| FUNC | napi_object_seal | 密封給定的對(duì)象。 |
| FUNC | napi_get_all_property_names | 獲取一個(gè)數(shù)組，其中包含此對(duì)象過濾后的屬性名稱。 |
| FUNC | napi_detach_arraybuffer | 分離給定ArrayBuffer的底層數(shù)據(jù)。 |
| FUNC | napi_is_detached_arraybufferHarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿 | 判斷給定的ArrayBuffer是否已被分離過。 |
ArkUI-X中N-API的使用場(chǎng)景
在OpenHarmony中，N-API接口可以實(shí)現(xiàn)ArkTS/TS/JS與C/C++(Native)之間的交互。ArkUI-X在此基礎(chǔ)上進(jìn)行了跨平臺(tái)的拓展，開發(fā)者可在OpenHarmony/HarmonyOS/Android/iOS多個(gè)平臺(tái)上使用N-API能力，完成跨語言工程開發(fā)。ArkUI-X中的N-API典型使用場(chǎng)景與OpenHarmony相同，即：
- 通過N-API封裝Native能力，暴露相應(yīng)接口到ArkTS/TS/JS層，即ArkTS/TS/JS call Native。
- Native代碼中調(diào)用ArkTS/TS/JS提供的方法，即Native call ArkTS/TS/JS。
審核編輯 黃宇
聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請(qǐng)聯(lián)系本站處理。
舉報(bào)投訴
-
接口
+關(guān)注
關(guān)注
33文章
8575瀏覽量
151014 -
API
+關(guān)注
關(guān)注
2文章
1499瀏覽量
61957 -
javascript
+關(guān)注
關(guān)注
0文章
516瀏覽量
53850 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2339瀏覽量
42804
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
鴻蒙開發(fā)接口公共事件與通知：【@ohos.commonEvent (公共事件模塊)】
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
鴻蒙開發(fā)接口公共事件與通知：【@ohos.events.emitter (Emitter)】
本模塊首批接口從API version 7開始支持。
鴻蒙開發(fā)接口公共事件與通知：【Notification模塊】
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
鴻蒙開發(fā)接口公共事件與通知：【@ohos.reminderAgent (后臺(tái)代理提醒)】
開發(fā)應(yīng)用時(shí)，開發(fā)者可以調(diào)用后臺(tái)提醒發(fā)布的接口創(chuàng)建定時(shí)提醒，包括倒計(jì)時(shí)、日歷、鬧鐘三種提醒類型。使用后臺(tái)代理提醒能力后，應(yīng)用可以被凍結(jié)或退出，計(jì)時(shí)和彈出提醒的功能將被后臺(tái)系統(tǒng)服務(wù)代理。
鴻蒙開發(fā)接口公共事件與通知：【application/EventHub (EventHub)】
EventHub模塊提供了事件中心，提供訂閱、取消訂閱、觸發(fā)事件的能力。
鴻蒙開發(fā)接口公共事件與通知：【FFI能力】 N-API在Android、iOS平臺(tái)應(yīng)用的使用指導(dǎo)
N-API接口可以實(shí)現(xiàn)ArkTS/TS/JS與C/C++(Native)之間的交互，ArkUI-X中支持的N-API接口情況和使用場(chǎng)景請(qǐng)見[FFI
鴻蒙原生應(yīng)用/元服務(wù)開發(fā)-通知添加行為意圖
WantAgent提供了封裝行為意圖的能力，這里所說的行為意圖主要是指拉起指定的應(yīng)用組件及發(fā)布公共事件等能力。HarmonyOS支持以通知的形式，將WantAgent從發(fā)布方傳遞至接收
發(fā)表于 01-05 15:07
基于ArkTS語言的OpenHarmony APP應(yīng)用開發(fā)：公共事件的訂閱和發(fā)布
/d05_CustomCommonEvent
API接口：9
2、知識(shí)準(zhǔn)備
2.1、commonEvent模塊
OpenHarmony通過CES（Common Event Service，公共事件服務(wù)）為
發(fā)表于 09-18 13:16
HarmonyOS應(yīng)用開發(fā)-公共事件處理
在開發(fā)過程中service想要控制多個(gè)ability時(shí)，可以考慮使用公共事件處理。發(fā)布無序的公共事件： //發(fā)布公共事件 同步修改卡片與頁面public void subscribeE
發(fā)表于 11-02 15:15
HarmonyOS-API7相對(duì)API6差異主要變更內(nèi)容
條件、循環(huán)渲染、懶加載渲染，支持自定義組件。JS新增5800+的API接口，覆蓋多個(gè)能力模塊：新增一系列事件通知能力的接口，可實(shí)現(xiàn)普通
發(fā)表于 02-15 14:35
HarmonyOS/OpenHarmony應(yīng)用開發(fā)-ArkTSAPI系統(tǒng)能力SystemCapability
一、 系統(tǒng)能力與API
SysCap，全稱SystemCapability，即系統(tǒng)能力，指操作系統(tǒng)中每一個(gè)相對(duì)獨(dú)立的特性，如包管理、公共事件、通知
發(fā)表于 08-10 16:39
OpenHarmony 應(yīng)用開發(fā)SDK、API 與基礎(chǔ)工具
ArkTS 對(duì)象的能力，使用類 Node 的 N-API 接口命名。開發(fā)者使用 C/C++開發(fā)
發(fā)表于 09-19 15:45
鴻蒙原生應(yīng)用/元服務(wù)開發(fā)-Stage模型能力接口（四）
一、說明
AbilityStage是HAP的運(yùn)行時(shí)類。AbilityStage類提供在HAP加載的時(shí)候，通知開發(fā)者，可以在此進(jìn)行該HAP的初始化（如資源預(yù)加載，線程創(chuàng)建等）能力。
本模塊首批接
發(fā)表于 12-14 15:39
觸覺智能RK3568使用體驗(yàn)：NAPI 類對(duì)象導(dǎo)出及其生命周期管理(上)
.js Node-API 框架擴(kuò)展而來。 什么是Node.js Node-API 框架 Node.js Node-API為
基于ArkTS語言的OpenHarmony APP應(yīng)用開發(fā)：公共事件的訂閱和發(fā)布
1、程序介紹本示例主要展示了公共事件相關(guān)的功能，實(shí)現(xiàn)了一個(gè)檢測(cè)用戶部分行為的應(yīng)用。具體而言，本案例實(shí)現(xiàn)了如下幾個(gè)公共事件功能：通過訂閱系統(tǒng)公共事件，實(shí)現(xiàn)對(duì)用戶操作行為（亮滅屏、斷聯(lián)網(wǎng)）的監(jiān)測(cè)；通過
工商網(wǎng)監(jiān)
評(píng)論