From aa165bd2c9cdff3529df0caed8e0f3fa103d6d47 Mon Sep 17 00:00:00 2001
From: zhaona45 <zhaona45@huawei.com>
Date: Fri, 9 May 2025 15:00:08 +0800
Subject: [PATCH] =?UTF-8?q?ImageReceiver=20on=E5=9B=9E=E8=B0=83=E6=94=AF?=
 =?UTF-8?q?=E6=8C=81=E4=BC=A0=E5=85=A5=E7=94=A8=E6=88=B7=E8=87=AA=E5=AE=9A?=
 =?UTF-8?q?=E4=B9=89=E6=95=B0=E6=8D=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: zhaona45 <zhaona45@huawei.com>
---
 .../include/image/image_common.h              |  5 +++
 .../include/image/image_receiver_native.h     | 34 +++++++++++++++++++
 .../libimage_receiver.ndk.json                |  8 +++++
 3 files changed, 47 insertions(+)

diff --git a/multimedia/image_framework/include/image/image_common.h b/multimedia/image_framework/include/image/image_common.h
index 05662665f..44d925e76 100644
--- a/multimedia/image_framework/include/image/image_common.h
+++ b/multimedia/image_framework/include/image/image_common.h
@@ -227,6 +227,11 @@ typedef enum {
     IMAGE_PACKER_INVALID_PARAMETER = 7800202,
     /** encode failed */
     IMAGE_ENCODE_FAILED = 7800301,
+    /**
+     * @error Invalid parameter for ImageReceiver
+     * @since 20
+     */
+    IMAGE_RECEIVER_INVALID_PARAMETER = 7900201,
 } Image_ErrorCode;
 
 /**
diff --git a/multimedia/image_framework/include/image/image_receiver_native.h b/multimedia/image_framework/include/image/image_receiver_native.h
index 09fef3b1b..098c4b8b4 100644
--- a/multimedia/image_framework/include/image/image_receiver_native.h
+++ b/multimedia/image_framework/include/image/image_receiver_native.h
@@ -76,6 +76,13 @@ typedef struct OH_ImageReceiverOptions OH_ImageReceiverOptions;
  */
 typedef void (*OH_ImageReceiver_OnCallback)(OH_ImageReceiverNative *receiver);
 
+/**
+ * @brief brief Callback for ImageArrive event.
+ *
+ * @since 20
+ */
+typedef void (*OH_ImageReceiver_ImageArriveCallback)(OH_ImageReceiverNative *receiver, void *userData);
+
 /**
  * @brief Creates an <b>OH_ImageReceiverOptions</b> object at the application layer.
  *
@@ -223,6 +230,33 @@ Image_ErrorCode OH_ImageReceiverNative_On(OH_ImageReceiverNative* receiver, OH_I
  */
 Image_ErrorCode OH_ImageReceiverNative_Off(OH_ImageReceiverNative* receiver);
 
+/**
+ * Registers an {@link OH_ImageReceiver_ImageArriveCallback} callback.
+ *
+ * @param receiver Pointer to an OH_ImageReceiverNative object that processes the callback.
+ * @param callback OH_ImageReceiver_ImageArriveCallback to register.
+ * @param userData Pointer to the user data passed to the callback.
+ * @return Result code. {@link Image_ErrorCode} IMAGE_SUCCESS is returned if the operation is successful.
+ * {@link Image_ErrorCode} IMAGE_RECEIVER_INVALID_PARAMETER is returned if receiver or callback is null.
+ * @since 20
+ */
+Image_ErrorCode OH_ImageReceiverNative_OnImageArrive(OH_ImageReceiverNative *receiver,
+    OH_ImageReceiver_ImageArriveCallback callback, void *userData);
+
+/** 
+ * Unregisters an {@link OH_ImageReceiver_ImageArriveCallback} callback
+ * 
+ * @param receiver The OH_ImageReceiverNative object that handle the callback.
+ * @param callback A OH_ImageReceiver_ImageArriveCallback to unregister. If callback is nullptr,
+ * all OH_ImageReceiver_ImageArriveCallback of receiver will be removed.
+ * @return Returns {@link Image_ErrorCode} IMAGE_SUCCESS - if the operation is successful
+ * returns {@link Image_ErrorCode} IMAGE_RECEIVER_INVALID_PARAMETER - if receiver is nullptr,
+ * or callback is not registered
+ * @since 20
+*/
+Image_ErrorCode OH_ImageReceiverNative_OffImageArrive(OH_ImageReceiverNative *receiver,
+    OH_ImageReceiver_ImageArriveCallback callback);
+
 /**
  * @brief Obtains the size of the image receiver through an {@link OH_ImageReceiverNative} object.
  *
diff --git a/multimedia/image_framework/libimage_receiver.ndk.json b/multimedia/image_framework/libimage_receiver.ndk.json
index 95058723f..2ff42d643 100644
--- a/multimedia/image_framework/libimage_receiver.ndk.json
+++ b/multimedia/image_framework/libimage_receiver.ndk.json
@@ -47,6 +47,14 @@
         "first_introduced": "12",
         "name": "OH_ImageReceiverNative_Off"
     },
+    {
+        "first_introduced": "20",
+        "name": "OH_ImageReceiverNative_OnImageArrive"
+    },
+    {
+        "first_introduced": "20",
+        "name": "OH_ImageReceiverNative_OffImageArrive"
+    },
     {
         "first_introduced": "12",
         "name": "OH_ImageReceiverNative_GetSize"
-- 
Gitee