文档管理中心
我的

图片接收

说明

当前开发指导使用的接口为Image模块下的C API,可完成图片编解码,图片接收器,处理图像数据等功能。这部分API在API version 11之前发布,在后续的版本不再增加新功能,不再推荐使用。

开发者可使用Image_NativeModule模块下的C API,不仅提供上述图片框架基础功能,还可以完成多图编解码等新特性,相关开发指导请参考图片开发指导(C/C++)节点下的内容。这部分API从API version 12开始支持,并将持续演进,推荐开发者使用。

两套C API不建议同时使用,在部分场景下存在不兼容的问题。

图片接收类,用于获取组件surface id,接收最新的图片和读取下一张图片,以及释放ImageReceiver实例。

开发步骤

添加依赖

在进行应用开发之前,开发者需要打开native工程的src/main/cpp/CMakeLists.txt,在target_link_libraries依赖中添加libace_napi.z.so、libimage_ndk.z.so、libimage_receiver_ndk.z.so、libnative_image.so以及日志依赖libhilog_ndk.z.so。

收起
自动换行
深色代码主题
复制
  1. target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so libimage_ndk.z.so libimage_receiver_ndk.z.so libnative_image.so)

添加接口映射

打开src/main/cpp/hello.cpp文件,在Init函数中添加接口映射如下:

收起
自动换行
深色代码主题
复制
  1. EXTERN_C_START
  2. static napi_value Init(napi_env env, napi_value exports)
  3. {
  4. napi_property_descriptor desc[] = {
  5. { "createFromReceiver", nullptr, createFromReceiver, nullptr, nullptr, nullptr, napi_default, nullptr },
  6. };
  7. napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
  8. return exports;
  9. }
  10. EXTERN_C_END

添加权限申请

此处通过camera图片获取输入数据,需要申请权限ohos.permission.CAMERA,申请方式请参考向用户申请授权。

JS侧调用

  1. 打开src\main\cpp\types\libentry\index.d.ts(其中libentry根据工程名生成),导入如下引用文件:

    收起
    自动换行
    深色代码主题
    复制
    1. import { image } from '@kit.ImageKit';
    2. export const createFromReceiver: (a: image.ImageReceiver) => image.Image;
  2. 打开src\main\ets\pages\index.ets,导入"libentry.so(根据工程名生成)",调用Native接口,传入JS的资源对象。示例如下:

    收起
    自动换行
    深色代码主题
    复制
    1. import testNapi from 'libentry.so';
    2. import { image } from '@kit.ImageKit';
    3. import { common, abilityAccessCtrl } from '@kit.AbilityKit';
    4. import { camera } from '@kit.CameraKit';
    5. @Entry
    6. @Component
    7. struct Index {
    8. private receiver: image.ImageReceiver | undefined = undefined;
    9. func (){
    10. let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    11. abilityAccessCtrl.createAtManager().requestPermissionsFromUser(context,['ohos.permission.CAMERA']).then(async () => {
    12. let cameraManager = await camera.getCameraManager(context);
    13. // 获取支持的相机设备对象。
    14. let cameraDevices: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
    15. if (cameraDevices.length <= 0) {
    16. return;
    17. }
    18. // 获取对应相机设备的profiles。
    19. let profiles: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraDevices[0], camera.SceneMode.NORMAL_PHOTO);
    20. let previewProfiles: Array<camera.Profile> = profiles.previewProfiles;
    21. if (previewProfiles.length <= 0) {
    22. return;
    23. }
    24. let profileObj = previewProfiles[0];
    25. this.receiver = image.createImageReceiver({width:profileObj.size.width, height:profileObj.size.height}, image.ImageFormat.JPEG, 8);
    26. let receiverSurfaceId: string = await this.receiver.getReceivingSurfaceId();
    27. // 创建预览流输出对象。
    28. let previewOutput: camera.PreviewOutput = cameraManager.createPreviewOutput(profileObj,receiverSurfaceId);
    29. let cameraInput : camera.CameraInput = cameraManager.createCameraInput(cameraDevices[0]);
    30. // 打开相机。
    31. await cameraInput.open();
    32. // 会话流程。
    33. let session : camera.PhotoSession = cameraManager.createSession(camera.SceneMode.NORMAL_PHOTO) as camera.PhotoSession;
    34. // 配置会话。
    35. session.beginConfig();
    36. // 把cameraInput加入到会话。
    37. session.addInput(cameraInput);
    38. // 把预览流加入到会话。
    39. session.addOutput(previewOutput);
    40. // 提交配置信息。
    41. await session.commitConfig();
    42. // 会话开始。
    43. await session.start();
    44. this.receiver.on('imageArrival', () => {
    45. let img : image.Image = testNapi.createFromReceiver(this.receiver);
    46. img.release();
    47. })
    48. });
    49. }
    50. build() {
    51. Row() {
    52. Column() {
    53. Button("start")
    54. .width(100)
    55. .height(100)
    56. .onClick(() => {
    57. console.info("button click in");
    58. if (this.receiver == undefined) {
    59. this.func();
    60. }
    61. })
    62. }
    63. .width('100%')
    64. }
    65. .height('100%')
    66. }
    67. }

Native接口调用

具体接口说明请参考Image。

在hello.cpp文件中获取JS的资源对象,并转为Native的资源对象,即可调用Native接口,调用方式示例代码如下:

添加引用文件

收起
自动换行
深色代码主题
复制
  1. #include <multimedia/image_framework/image_mdk.h>
  2. #include <multimedia/image_framework/image_receiver_mdk.h>
  3. #include <hilog/log.h>
  4. static napi_value createFromReceiver(napi_env env, napi_callback_info info)
  5. {
  6. size_t argc = 1;
  7. napi_value args[2] = {nullptr};
  8. napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
  9. napi_valuetype valuetype0;
  10. napi_typeof(env, args[0], &valuetype0);
  11. napi_ref reference;
  12. napi_create_reference(env, args[0], 1 ,&reference);
  13. napi_value imgReceiver_js;
  14. napi_get_reference_value(env, reference, &imgReceiver_js);
  15. ImageReceiverNative * imgReceiver_c = OH_Image_Receiver_InitImageReceiverNative(env, imgReceiver_js);
  16. int32_t capacity;
  17. OH_Image_Receiver_GetCapacity(imgReceiver_c, &capacity);
  18. OH_LOG_Print(LOG_APP, LOG_INFO, 0xFF00, "[receiver]", "capacity: %{public}d", capacity);
  19. int32_t format;
  20. OH_Image_Receiver_GetFormat(imgReceiver_c, &format);
  21. OH_LOG_Print(LOG_APP, LOG_INFO, 0xFF00, "[receiver]", "format: %{public}d", format);
  22. char surfaceId[128] = {0};
  23. OH_Image_Receiver_GetReceivingSurfaceId(imgReceiver_c, surfaceId, sizeof(surfaceId));
  24. OH_LOG_Print(LOG_APP, LOG_INFO, 0xFF00, "[receiver]", "surfaceId: %{public}s", surfaceId);
  25. OhosImageSize size;
  26. OH_Image_Receiver_GetSize(imgReceiver_c, &size);
  27. OH_LOG_Print(LOG_APP, LOG_INFO, 0xFF00, "[receiver]", "OH_Image_Receiver_GetSize width: %{public}d, height:%{public}d", size.width, size.height);
  28. napi_value nextImage;
  29. // 或调用 OH_Image_Receiver_ReadNextImage(imgReceiver_c, &nextImage);
  30. OH_Image_Receiver_ReadLatestImage(imgReceiver_c, &nextImage);
  31. ImageNative * nextImage_native = OH_Image_InitImageNative(env, nextImage);
  32. OhosImageSize imageSize;
  33. OH_Image_Size(nextImage_native, &imageSize);
  34. OH_LOG_Print(LOG_APP, LOG_INFO, 0xFF00, "[receiver]", "OH_Image_Size width: %{public}d, height:%{public}d", imageSize.width, imageSize.height);
  35. OhosImageComponent imgComponent;
  36. OH_Image_GetComponent(nextImage_native, OHOS_IMAGE_COMPONENT_FORMAT_JPEG, &imgComponent);
  37. uint8_t *img_buffer = imgComponent.byteBuffer;
  38. OH_Image_Release(nextImage_native);
  39. OH_Image_Receiver_Release(imgReceiver_c);
  40. return nextImage;
  41. }