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