鴻蒙開發(fā)接口公共事件與通知：【FFI能力(Node-API)】
FFI能力(N-API)
ArkUI-X中支持的N-API接口情況
Node-API是封裝底層JavaScript運行時能力的一套Native接口。OpenHarmony的N-API組件對Node-API的接口進行了重新實現(xiàn)，ArkUI-X同樣擁有這部分能力，目前支持部分接口，支持列表。
Node-API
簡介
Node-API是封裝底層JavaScript運行時能力的一套Native接口。
支持的能力
Node-API屏蔽了底層不同JavaScript引擎的差異，提供一套穩(wěn)定的接口。
OpenHarmony的N-API組件對Node-API的接口進行了重新實現(xiàn)，ArkUI-X在此基礎(chǔ)上進行了跨平臺擴展，N-API接口可以在OpenHarmony/HarmonyOS/Android/iOS多個平臺上使用。當前支持[Node-API]標準庫中的部分接口，如下表所示。
N-API組件擴展的符號列表
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[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結(jié)構(gòu)體，其中包含最近一次出現(xiàn)的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 | 創(chuàng)建并獲取一個帶文本信息的jsError。 |
| FUNC | napi_create_type_error | 創(chuàng)建并獲取一個帶文本信息的jsTypeError。 |
| FUNC | napi_create_range_error | 創(chuàng)建并獲取一個帶文本信息的jsRangeError。 |
| FUNC | napi_get_and_clear_last_exception | 獲取并清除最近一次出現(xiàn)的異常。 |
| FUNC | napi_is_exception_pending | 判斷是否出現(xiàn)了異常。 |
| FUNC | napi_fatal_error | 引發(fā)致命錯誤以立即終止進程。 |
| FUNC | napi_open_handle_scope | 創(chuàng)建一個上下文環(huán)境使用。 |
| FUNC | napi_close_handle_scope | 關(guān)閉傳入的上下文環(huán)境，關(guān)閉后，在其中聲明的全部napi_value都將被回收。 |
| FUNC | napi_open_escapable_handle_scope | 創(chuàng)建出一個可逃逸的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)建一個reference，提升js對象生命周期。調(diào)用者需要自己管理reference生命周期。 |
| FUNC | napi_delete_reference | 刪除傳入的reference。 |
| FUNC | napi_reference_ref | 增加傳入的reference的引用計數(shù)，并獲取該計數(shù)。 |
| FUNC | napi_reference_unref | 減少傳入的reference的引用計數(shù)，并獲取該計數(shù)。 |
| FUNC | napi_get_reference_value | 獲取與reference相關(guān)聯(lián)的jsObject。 |
| FUNC | napi_create_array | 創(chuàng)建并獲取一個jsArray。 |
| FUNC | napi_create_array_with_length | 創(chuàng)建并獲取一個指定長度的jsArray。 |
| FUNC | napi_create_arraybuffer | 創(chuàng)建并獲取一個指定大小的jsArrayBuffer。 |
| FUNC | napi_create_external | 分配一個附加有外部數(shù)據(jù)的js value。 |
| FUNC | napi_create_external_arraybuffer | 分配一個附加有外部數(shù)據(jù)的jsArrayBuffer。 |
| FUNC | napi_create_object | 創(chuàng)建一個默認的jsObject。 |
| FUNC | napi_create_symbol | 創(chuàng)建一個jsSymbol。 |
| FUNC | napi_create_typedarray | 通過現(xiàn)有的ArrayBuffer創(chuàng)建一個jsTypeArray。 |
| FUNC | napi_create_dataview | 通過現(xiàn)有的ArrayBuffer創(chuàng)建一個jsDataView。 |
| FUNC | napi_create_int32 | 通過一個C的int32_t數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_uint32 | 通過一個C的uint32_t數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_int64 | 通過一個C的int64_t數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_double | 通過一個C的double數(shù)據(jù)創(chuàng)建jsNumber。 |
| FUNC | napi_create_string_latin1 | 通過ISO-8859-1編碼的C字符串數(shù)據(jù)創(chuàng)建jsString。 |
| FUNC | napi_create_string_utf8 | 通過UTF8編碼的C字符串數(shù)據(jù)創(chuàng)建jsString。 |
| FUNC | napi_create_string_utf16 | 通過UTF16編碼的C字符串數(shù)據(jù)創(chuàng)建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()傳遞的外部數(shù)據(jù)指針。 |
| 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 | 根據(jù)給定的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強轉(zhuǎn)成jsBoolean。 |
| FUNC | napi_coerce_to_number | 將給定的js value強轉(zhuǎn)成jsNumber。 |
| FUNC | napi_coerce_to_object | 將給定的js value強轉(zhuǎn)成jsObject。 |
| FUNC | napi_coerce_to_string | 將給定的js value強轉(zhuǎn)成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 | 以字符串數(shù)組的形式獲取對象的可枚舉屬性的名稱。 |
| FUNC | napi_set_property | 對給定Object設(shè)置屬性。 |
| 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設(shè)置一個給定名稱的屬性。 |
| 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)用的詳細信息，如參數(shù)和this指針。 |
| FUNC | napi_get_new_target | 獲取構(gòu)造函數(shù)調(diào)用的new.target。 |
| FUNC | napi_new_instance | 通過給定的構(gòu)造函數(shù)，構(gòu)建一個實例。 |
| 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 | 創(chuàng)建一個異步工作對象。 |
| FUNC | napi_delete_async_work | 釋放先前創(chuàng)建的異步工作對象。 |
| FUNC | napi_queue_async_work | 將異步工作對象加到隊列，由底層去調(diào)度執(zhí)行。 |
| FUNC | napi_cancel_async_work | 取消入隊的異步任務。 |
| FUNC | napi_get_node_version | 獲取node的版本信息。 |
| FUNC | napi_get_version | 獲取Node運行時支持的最高 N-API 版本。 |
| FUNC | napi_create_promise | 創(chuàng)建一個延遲對象和js promise。 |
| FUNC | napi_resolve_deferred | resolve與js promise對象關(guān)聯(lián)的延遲函數(shù)。 |
| FUNC | napi_reject_deferred | reject與js promise對象關(guān)聯(lián)的延遲函數(shù)。 |
| FUNC | napi_is_promise | 判斷給定js value是否為promise對象。 |
| FUNC | napi_get_uv_event_loop | 獲取當前l(fā)ibuv loop實例。 |
| 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 | 指示在主線程上運行的事件循環(huán)在線程安全函數(shù)被銷毀之前不應退出。 |
| FUNC | napi_unref_threadsafe_function | 指示在主線程上運行的事件循環(huán)可能會在線程安全函數(shù)被銷毀之前退出。 |
| FUNC | napi_create_date | 通過一個C的double數(shù)據(jù)創(chuàng)建jsDate。 |
| FUNC | napi_get_date_value | 獲取給定jsDate對應的C double值。 |
| FUNC | napi_create_bigint_int64 | 通過一個C的int64數(shù)據(jù)創(chuàng)建jsBigInt。 |
| FUNC | napi_create_bigint_uint64 | 通過一個C的uint64數(shù)據(jù)創(chuàng)建jsBigInt。 |
| FUNC | napi_create_bigint_words | 通過一個C的uint64數(shù)組創(chuàng)建單個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位小端序數(shù)組和數(shù)組中的元素個數(shù)。 |
| FUNC | napi_create_buffer | 創(chuàng)建并獲取一個指定大小的jsBuffer。 |
| FUNC | napi_create_buffer_copy | 創(chuàng)建并獲取一個指定大小的jsBuffer，并以給定數(shù)據(jù)進行初始化。 |
| FUNC | napi_create_external_buffer | 創(chuàng)建并獲取一個指定大小的jsBuffer，并以給定數(shù)據(jù)進行初始化，該接口可為Buffer附帶額外數(shù)據(jù)。 |
| FUNC | napi_get_buffer_info | 獲取jsBuffer底層data及其長度。 |
| FUNC | napi_is_buffer | 判斷給定js value是否為Buffer對象。 |
| FUNC | napi_object_freeze | 凍結(jié)給定的對象。 |
| FUNC | napi_object_seal | 密封給定的對象。 |
| FUNC | napi_get_all_property_names | 獲取一個數(shù)組，其中包含此對象過濾后的屬性名稱。 |
| FUNC | napi_detach_arraybuffer | 分離給定ArrayBuffer的底層數(shù)據(jù)。 |
| FUNC | napi_is_detached_arraybufferHarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿 | 判斷給定的ArrayBuffer是否已被分離過。 |
ArkUI-X中N-API的使用場景
在OpenHarmony中，N-API接口可以實現(xiàn)ArkTS/TS/JS與C/C++(Native)之間的交互。ArkUI-X在此基礎(chǔ)上進行了跨平臺的拓展，開發(fā)者可在OpenHarmony/HarmonyOS/Android/iOS多個平臺上使用N-API能力，完成跨語言工程開發(fā)。ArkUI-X中的N-API典型使用場景與OpenHarmony相同，即：
- 通過N-API封裝Native能力，暴露相應接口到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)載。文章觀點僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學習之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。
舉報投訴
-
接口
+關(guān)注
關(guān)注
33文章
8257瀏覽量
149956 -
API
+關(guān)注
關(guān)注
2文章
1461瀏覽量
61490 -
javascript
+關(guān)注
關(guān)注
0文章
515瀏覽量
53658 -
鴻蒙
+關(guān)注
關(guān)注
56文章
2267瀏覽量
42489
發(fā)布評論請先 登錄
相關(guān)推薦
鴻蒙開發(fā)接口公共事件與通知：【@ohos.commonEvent (公共事件模塊)】
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。
鴻蒙開發(fā)接口公共事件與通知：【@ohos.events.emitter (Emitter)】
本模塊首批接口從API version 7開始支持。
鴻蒙開發(fā)接口公共事件與通知：【Notification模塊】
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。
鴻蒙開發(fā)接口公共事件與通知：【@ohos.reminderAgent (后臺代理提醒)】
開發(fā)應用時，開發(fā)者可以調(diào)用后臺提醒發(fā)布的接口創(chuàng)建定時提醒，包括倒計時、日歷、鬧鐘三種提醒類型。使用后臺代理提醒能力后，應用可以被凍結(jié)或退出，計時和彈出提醒的功能將被后臺系統(tǒng)服務代理。
鴻蒙開發(fā)接口公共事件與通知：【application/EventHub (EventHub)】
EventHub模塊提供了事件中心，提供訂閱、取消訂閱、觸發(fā)事件的能力。
鴻蒙開發(fā)接口公共事件與通知：【FFI能力】 N-API在Android、iOS平臺應用的使用指導
N-API接口可以實現(xiàn)ArkTS/TS/JS與C/C++(Native)之間的交互，ArkUI-X中支持的N-API接口情況和使用場景請見[FFI
鴻蒙原生應用/元服務開發(fā)-通知添加行為意圖
WantAgent提供了封裝行為意圖的能力，這里所說的行為意圖主要是指拉起指定的應用組件及發(fā)布公共事件等能力。HarmonyOS支持以通知的形式，將WantAgent從發(fā)布方傳遞至接收
發(fā)表于 01-05 15:07
基于ArkTS語言的OpenHarmony APP應用開發(fā)：公共事件的訂閱和發(fā)布
/d05_CustomCommonEvent
API接口：9
2、知識準備
2.1、commonEvent模塊
OpenHarmony通過CES（Common Event Service，公共事件服務）為
發(fā)表于 09-18 13:16
HarmonyOS應用開發(fā)-公共事件處理
在開發(fā)過程中service想要控制多個ability時，可以考慮使用公共事件處理。發(fā)布無序的公共事件： //發(fā)布公共事件 同步修改卡片與頁面public void subscribeE
發(fā)表于 11-02 15:15
HarmonyOS-API7相對API6差異主要變更內(nèi)容
條件、循環(huán)渲染、懶加載渲染，支持自定義組件。JS新增5800+的API接口，覆蓋多個能力模塊：新增一系列事件通知能力的接口，可實現(xiàn)普通
發(fā)表于 02-15 14:35
HarmonyOS/OpenHarmony應用開發(fā)-ArkTSAPI系統(tǒng)能力SystemCapability
一、 系統(tǒng)能力與API
SysCap，全稱SystemCapability，即系統(tǒng)能力，指操作系統(tǒng)中每一個相對獨立的特性，如包管理、公共事件、通知
發(fā)表于 08-10 16:39
OpenHarmony 應用開發(fā)SDK、API 與基礎(chǔ)工具
ArkTS 對象的能力，使用類 Node 的 N-API 接口命名。開發(fā)者使用 C/C++開發(fā)
發(fā)表于 09-19 15:45
鴻蒙原生應用/元服務開發(fā)-Stage模型能力接口（四）
一、說明
AbilityStage是HAP的運行時類。AbilityStage類提供在HAP加載的時候，通知開發(fā)者，可以在此進行該HAP的初始化（如資源預加載，線程創(chuàng)建等）能力。
本模塊首批接
發(fā)表于 12-14 15:39
觸覺智能RK3568使用體驗：NAPI 類對象導出及其生命周期管理(上)
.js Node-API 框架擴展而來。 什么是Node.js Node-API 框架 Node.js Node-API為
基于ArkTS語言的OpenHarmony APP應用開發(fā)：公共事件的訂閱和發(fā)布
1、程序介紹本示例主要展示了公共事件相關(guān)的功能，實現(xiàn)了一個檢測用戶部分行為的應用。具體而言，本案例實現(xiàn)了如下幾個公共事件功能：通過訂閱系統(tǒng)公共事件，實現(xiàn)對用戶操作行為（亮滅屏、斷聯(lián)網(wǎng)）的監(jiān)測；通過
工商網(wǎng)監(jiān)
評論