[文章]HarmonyOS：NativeWindow 开发指导

场景介绍

NativeWindow 是 HarmonyOS本地平台化窗口，表示图形队列的生产者端。开发者可以通过 NativeWindow 接口进行申请和提交 Buffer，配置 Buffer 属性信息。

针对 NativeWindow，常见的开发场景如下：

● 通过 NativeWindow 提供的 Native API 接口申请图形 Buffer，并将生产图形内容写入图形 Buffer，最终提交 Buffer 到图形队列

● 在适配 EGL 层的 eglswapbuffer 接口时，进行申请和提交 Buffer

接口说明

详细的接口说明请参考native_window。

开发步骤

以下步骤描述了在 **HarmonyOS **中如何使用 NativeWindow 提供的 Native API 接口，申请图形 Buffer，并将生产图形内容写入图形 Buffer 后，最终提交 Buffer 到图形队列。

添加动态链接库

CMakeLists.txt 中添加以下 lib。

libace_ndk.z.solibnative_window.so

头文件

#include#include

1. 获取 OHNativeWindow 实例。

可在OH_NativeXComponent_Callback提供的接口中获取 OHNativeWindow，下面提供一份代码示例。XComponent 模块的具体使用方法请参考XComponent开发指导。

a. 在 xxx.ets 中添加一个 XComponent 组件。

XComponent({ id:'xcomponentId',type:'surface', libraryname:'entry'}) .width(360) .height(360)

b. 在 native c++ 层获取 NativeXComponent。

napi_value exportInstance =nullptr;// 用来解析出被wrap了NativeXComponent指针的属性napi_get_named_property(env, exports, OH_NATIVE_XCOMPONENT_OBJ, &exportInstance); OH_NativeXComponent *nativeXComponent =nullptr;// 通过napi_unwrap接口，解析出NativeXComponent的实例指针napi_unwrap(env, exportInstance,reinterpret_cast<void**>(&nativeXComponent));// 获取XComponentIdcharidStr[OH_XCOMPONENT_ID_LEN_MAX +1] = {};uint64_tidSize = OH_XCOMPONENT_ID_LEN_MAX +1;OH_NativeXComponent_GetXComponentId(nativeXComponent, idStr, &idSize);

c. 定义 OH_NativeXComponent_Callback。

// 定义回调函数voidOnSurfaceCreatedCB(OH_NativeXComponent* component,void* window){// 可获取 OHNativeWindow 实例OHNativeWindow* nativeWindow =static_cast(window);// ...}voidOnSurfaceChangedCB(OH_NativeXComponent* component,void* window){// 可获取 OHNativeWindow 实例OHNativeWindow* nativeWindow =static_cast(window);// ...}voidOnSurfaceDestroyedCB(OH_NativeXComponent* component,void* window){// 可获取 OHNativeWindow 实例OHNativeWindow* nativeWindow =static_cast(window);// ...}voidDispatchTouchEventCB(OH_NativeXComponent* component,void* window){// 可获取 OHNativeWindow 实例OHNativeWindow* nativeWindow =static_cast(window);// ...}

// 初始化 OH_NativeXComponent_CallbackOH_NativeXComponent_Callback callback; callback.OnSurfaceCreated = OnSurfaceCreatedCB; callback.OnSurfaceChanged = OnSurfaceChangedCB; callback.OnSurfaceDestroyed = OnSurfaceDestroyedCB; callback.DispatchTouchEvent = DispatchTouchEventCB;

d. 将 OH_NativeXComponent_Callback 注册给 NativeXComponent。

// 注册回调函数OH_NativeXComponent_RegisterCallback(nativeXComponent, &callback);

2. 设置 OHNativeWindowBuffer 的属性。使用 OH_NativeWindow_NativeWindowHandleOpt 设置 OHNativeWindowBuffer 的属性。

// 设置 OHNativeWindowBuffer 的宽高int32_tcode = SET_BUFFER_GEOMETRY;int32_twidth =0x100;int32_theight =0x100;// 这里的nativeWindow是从上一步骤中的回调函数中获得的int32_tret =OH_NativeWindow_NativeWindowHandleOpt(nativeWindow, code, width, height);

3. 从图形队列申请 OHNativeWindowBuffer。

OHNativeWindowBuffer* buffer =nullptr;intfenceFd;// 通过 OH_NativeWindow_NativeWindowRequestBuffer 获取 OHNativeWindowBuffer 实例OH_NativeWindow_NativeWindowRequestBuffer(nativeWindow, &buffer, &fenceFd);// 通过 OH_NativeWindow_GetBufferHandleFromNative 获取 buffer 的 handleBufferHandle* bufferHandle =OH_NativeWindow_GetBufferHandleFromNative(buffer);

4. 内存映射 mmap。

#include // 使用系统接口mmap将bufferHandle对应的共享内存映射到用户空间，可以通过映射出来的虚拟地址向bufferHandle中写入图像数据// bufferHandle->virAddr是bufferHandle在共享内存中的起始地址，bufferHandle->size是bufferHandle在共享内存中的内存占用大小void* mappedAddr = mmap(bufferHandle->virAddr, bufferHandle->size, PROT_READ | PROT_WRITE, MAP_SHARED, bufferHandle->fd,0);if(mappedAddr == MAP_FAILED) {// mmap failed}

5. 将生产的内容写入 OHNativeWindowBuffer。

staticuint32_tvalue =0x00; value++;uint32_t*pixel =static_cast<uint32_t*>(mappedAddr);// 使用mmap获取到的地址来访问内存for(uint32_tx =0; x < width; x++) {for(uint32_ty =0; y < height; y++) { *pixel++ = value; } }

6. 提交 OHNativeWindowBuffer 到图形队列。

// 设置刷新区域，如果Region中的Rect为nullptr,或者rectNumber为0，则认为OHNativeWindowBuffer全部有内容更改。Regionregion{nullptr,0};// 通过OH_NativeWindow_NativeWindowFlushBuffer 提交给消费者使用，例如：显示在屏幕上。OH_NativeWindow_NativeWindowFlushBuffer(nativeWindow, buffer, fenceFd, region);

7. 取消内存映射 munmap。

// 内存使用完记得去掉内存映射intresult = munmap(mappedAddr, bufferHandle->size);if(result == -1) {// munmap failed}