diff --git a/multimedia/camera_framework/camera.h b/multimedia/camera_framework/camera.h index ea4231224401655ea6b19d80fb89017d684447f2..f415dacc2188a18a784e28c76cba12061bd87f04 100644 --- a/multimedia/camera_framework/camera.h +++ b/multimedia/camera_framework/camera.h @@ -1195,6 +1195,40 @@ typedef enum Camera_WhiteBalanceMode { CAMERA_WHITE_BALANCE_MODE_LOCKED = 6 } Camera_WhiteBalanceMode; +/** + * @brief Enumerates the system pressure levels of the current camera session. When the system pressure + * increases, you are advised to reduce the load of the current camera session. + * + * @since 20 + * @version 1.0 + */ +typedef enum Camera_SystemPressureLevel { + /** + * Normal level. This level indicates the system pressure is normal. + */ + SYSTEM_PRESSURE_NORMAL = 0, + + /** + * Mild level. This level indicates the system pressure is slightly elevated. + */ + SYSTEM_PRESSURE_MILD = 1, + + /** + * Severe level. This level indicates the system pressure is severely elevated. + */ + SYSTEM_PRESSURE_SEVERE = 2, + + /** + * Critical level. This level indicates the system pressure is critically elevated. + */ + SYSTEM_PRESSURE_CRITICAL = 3, + + /** + * Shutdown level. This level indicates the system pressure is fatal, so the camera session will be shut down soon. + */ + SYSTEM_PRESSURE_SHUTDOWN = 4 +} Camera_SystemPressureLevel; + #ifdef __cplusplus } #endif diff --git a/multimedia/camera_framework/camera.ndk.json b/multimedia/camera_framework/camera.ndk.json index 5bb71a86e196c8a5e8a3dae1e1ec126fbda71d0f..16b5ef3eca09416830a2f9a2e689ec38b7a5328a 100644 --- a/multimedia/camera_framework/camera.ndk.json +++ b/multimedia/camera_framework/camera.ndk.json @@ -694,5 +694,13 @@ { "first_introduced": "20", "name": "OH_CaptureSession_SetWhiteBalanceMode" + }, + { + "first_introduced": "20", + "name": "OH_CaptureSession_RegisterSystemPressureLevelChangeCallback" + }, + { + "first_introduced": "20", + "name": "OH_CaptureSession_UnregisterSystemPressureLevelChangeCallback" } ] diff --git a/multimedia/camera_framework/capture_session.h b/multimedia/camera_framework/capture_session.h index 6448626cf260d966a518729a655bb15560ffa117..7e711ce63db8066322dca54977b107a533bbe5a1 100644 --- a/multimedia/camera_framework/capture_session.h +++ b/multimedia/camera_framework/capture_session.h @@ -103,6 +103,15 @@ typedef void (*OH_CaptureSession_OnSmoothZoomInfo)(Camera_CaptureSession* sessio */ typedef void (*OH_CaptureSession_OnAutoDeviceSwitchStatusChange)(Camera_CaptureSession* session, Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo); +/** + * @brief Capture session system pressure level callback. + * + * @param session the {@link Camera_CaptureSession} which deliver the callback. + * @param systemPressureLevel the {@link Camera_SystemPressureLevel} which delivered by the callback. + * @since 20 + */ +typedef void (*OH_CaptureSession_OnSystemPressureLevelChange)(Camera_CaptureSession* session, + Camera_SystemPressureLevel* systemPressureLevel); /** * @brief A listener for capture session. @@ -1040,6 +1049,32 @@ Camera_ErrorCode OH_CaptureSession_SetWhiteBalance(Camera_CaptureSession *sessio Camera_ErrorCode OH_CaptureSession_SetWhiteBalanceMode( Camera_CaptureSession *session, Camera_WhiteBalanceMode whiteBalanceMode); +/** + * @brief Register system pressure level changes callback. + * + * @param session Pointer to a {@link Camera_CaptureSession} instance. + * @param systemPressureLevelChange the {@link OH_CaptureSession_OnSystemPressureLevelChange} to be registered. + * @return Result code. + * {@link #CAMERA_OK} is returned if the function is called successfully. + * {@link #CAMERA_INVALID_ARGUMENT} is returned if an input parameter is missing or the parameter type is incorrect. + * @since 20 + */ +Camera_ErrorCode OH_CaptureSession_RegisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session, + OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange); + +/** + * @brief Unregister system pressure level changes callback. + * + * @param session Pointer to a {@link Camera_CaptureSession} instance. + * @param systemPressureLevelChange the {@link OH_CaptureSession_OnSystemPressureLevelChange} to be unregistered. + * @return Result code. + * {@link #CAMERA_OK} is returned if the function is called successfully. + * {@link #CAMERA_INVALID_ARGUMENT} is returned if an input parameter is missing or the parameter type is incorrect. + * @since 20 + */ +Camera_ErrorCode OH_CaptureSession_UnregisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session, + OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange); + #ifdef __cplusplus } #endif