diff --git a/api/@ohos.multimedia.camera.d.ts b/api/@ohos.multimedia.camera.d.ts index a8d27470139d527f40b57b4ab97abdd095d7dace..77990f3f821965b2f6be546dc93b64e8763a9681 100644 --- a/api/@ohos.multimedia.camera.d.ts +++ b/api/@ohos.multimedia.camera.d.ts @@ -475,6 +475,41 @@ declare namespace camera { readonly supportedMetadataObjectTypes: Array; } + /** + * Control center status info. + * + * @typedef ControlCenterStatusInfo + * @syscap SystemCapability.Multimedia.Camera.Core + * @atomicservice + * @since 20 + * @arkts 1.1&1.2 + */ + interface ControlCenterStatusInfo { + /** + * Control center effect type. + * + * @type { ControlCenterEffectType } + * @readonly + * @syscap SystemCapability.Multimedia.Camera.Core + * @atomicservice + * @since 20 + * @arkts 1.1&1.2 + */ + readonly effectType: ControlCenterEffectType; + + /** + * If effect type is active. + * + * @type { boolean } + * @readonly + * @syscap SystemCapability.Multimedia.Camera.Core + * @atomicservice + * @since 20 + * @arkts 1.1&1.2 + */ + readonly isActive: boolean; + } + /** * Enum for camera error code. * @@ -5866,6 +5901,36 @@ declare namespace camera { */ BLACK_WHITE = 3 } + + /** + * Enumerates the control center effect types. + * + * @enum { int } + * @syscap SystemCapability.Multimedia.Camera.Core + * @atomicservice + * @since 20 + * @arkts 1.1&1.2 + */ + enum ControlCenterEffectType { + /** + * Beauty type. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @atomicservice + * @since 20 + * @arkts 1.1&1.2 + */ + BEAUTY = 0, + /** + * Portrait type. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @atomicservice + * @since 20 + * @arkts 1.1&1.2 + */ + PORTRAIT = 1 + } /** * Enum for policy type @@ -8386,8 +8451,7 @@ declare namespace camera { * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ on(type: 'error', callback: ErrorCallback): void; @@ -8406,8 +8470,7 @@ declare namespace camera { * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ off(type: 'error', callback?: ErrorCallback): void; @@ -8430,8 +8493,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ on(type: 'focusStateChange', callback: AsyncCallback): void; @@ -8450,8 +8512,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ off(type: 'focusStateChange', callback?: AsyncCallback): void; @@ -8474,8 +8535,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the zoom info. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ on(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; @@ -8494,8 +8554,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the zoom info. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; @@ -8507,8 +8566,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ on(type: 'macroStatusChanged', callback: AsyncCallback): void; @@ -8520,8 +8578,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ off(type: 'macroStatusChanged', callback?: AsyncCallback): void; @@ -8533,8 +8590,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'13','1.2':'20'} - * @arkts 1.1&1.2 + * @since 13 */ on(type: 'lcdFlashStatus', callback: AsyncCallback): void; @@ -8546,8 +8602,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'13','1.2':'20'} - * @arkts 1.1&1.2 + * @since 13 */ off(type: 'lcdFlashStatus', callback?: AsyncCallback): void; @@ -8571,8 +8626,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to return the result. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ on(type: 'autoDeviceSwitchStatusChange', callback: AsyncCallback): void; @@ -8591,8 +8645,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to return the result. * @syscap SystemCapability.Multimedia.Camera.Core * @atomicservice - * @since arkts {'1.1':'19','1.2':'20'} - * @arkts 1.1&1.2 + * @since 19 */ off(type: 'autoDeviceSwitchStatusChange', callback?: AsyncCallback): void; @@ -8604,8 +8657,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'15','1.2':'20'} - * @arkts 1.1&1.2 + * @since 15 */ on(type: 'focusTrackingInfoAvailable', callback: Callback): void; @@ -8617,8 +8669,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'15','1.2':'20'} - * @arkts 1.1&1.2 + * @since 15 */ off(type: 'focusTrackingInfoAvailable', callback?: Callback): void; @@ -8709,8 +8760,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'18','1.2':'20'} - * @arkts 1.1&1.2 + * @since 18 */ on(type: 'lightStatusChange', callback: AsyncCallback): void; @@ -8722,174 +8772,422 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'18','1.2':'20'} - * @arkts 1.1&1.2 + * @since 18 */ off(type: 'lightStatusChange', callback?: AsyncCallback): void; - } - /** - * Enum for the camera light status. - * - * @enum { int } - * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'18','1.2':'20'} - * @arkts 1.1&1.2 - */ - enum LightStatus { /** - * Sufficient lighting. + * @since 20 + * @arkts 1.2 + */ + overload on { onError, onFocusStateChange, onSmoothZoomInfoAvailable, onMacroStatusChanged, onLcdFlashStatus, + onAutoDeviceSwitchStatusChange, onFocusTrackingInfoAvailable, onEffectSuggestionChange, onLightStatusChange }; + + /** + * Registers a listener for error events in normal photo sessions to get the result by registering + * a callback function. This API uses an asynchronous callback to return the result. + * + * Description: Currently, it is not allowed to use off() to unregister the callback + * within the callback method of on(). * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'18','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - NORMAL = 0, + onError(type: 'error', callback: ErrorCallback): void; /** - * Insufficient lighting. + * Registers a listener for error events in normal photo sessions to get the result by registering + * a callback function. This API uses an asynchronous callback to return the result. + * + * Description: Currently, it is not allowed to use off() to unregister the callback + * within the callback method of on(). * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'18','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - INSUFFICIENT = 1 - } + onFocusStateChange(type: 'focusStateChange', callback: AsyncCallback): void; - /** - * Enumerates the camera portrait effects. - * - * @enum { int } - * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'10','1.2':'20'} - * @arkts 1.1&1.2 - */ - enum PortraitEffect { /** - * portrait effect off. + * Registers a listener for state changes in the camera's smooth zoom to get the result by registering + * a callback function. This API uses an asynchronous callback to return the result. + * + * Description: Currently, it is not allowed to use off() to unregister the callback + * within the callback method of on(). * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the zoom info. * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'10','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - OFF = 0, + onSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; /** - * circular blurring for portrait. + * Subscribes camera macro status event callback. * + * @param { 'macroStatusChanged' } type - Event type. + * @param { AsyncCallback } callback - Callback used to return the result. + * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'10','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - CIRCLES = 1, + onMacroStatusChanged(type: 'macroStatusChanged', callback: AsyncCallback): void; /** - * heart blurring for portrait. + * Subscribes to lcd flash status. * + * @param { 'lcdFlashStatus' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the lcd flash status. + * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - HEART = 2, + onLcdFlashStatus(type: 'lcdFlashStatus', callback: AsyncCallback): void; /** - * rotated blurring for portrait. + * Registers a listener for the camera's automatic lens switching state changes to get the + * result by registering a callback function. This API uses an asynchronous callback to + * return the result. + * + * Description: Currently, it is not allowed to use off() to unregister the callback + * within the callback method of on(). * + * @param { 'autoDeviceSwitchStatusChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to return the result. * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - ROTATED = 3, + onAutoDeviceSwitchStatusChange(type: 'autoDeviceSwitchStatusChange', + callback: AsyncCallback): void; /** - * studio blurring for portrait. + * Subscribes to focus tracking info event callback. * + * @param { 'focusTrackingInfoAvailable' } type - Event type. + * @param { Callback } callback - Callback used to get the focus tracking info. + * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - STUDIO = 4, + onFocusTrackingInfoAvailable(type: 'focusTrackingInfoAvailable', callback: Callback): void; /** - * theater blurring for portrait. - * + * Subscribes to effect suggestion change events. + * @param { 'effectSuggestionChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to return the result. + * @throws { BusinessError } 202 - Not System Application.[object Object] * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - THEATER = 5 - } + onEffectSuggestionChange(type: 'effectSuggestionChange', callback: AsyncCallback): void; - /** - * Portrait Query object. - * - * @interface PortraitQuery - * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 - */ - interface PortraitQuery { /** - * Gets supported portrait effect. + * Subscribes camera light status event callback. * - * @returns { Array } List of portrait effect. - * @throws { BusinessError } 7400103 - Session not config. + * @param { 'lightStatusChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to return the result. + * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since 10 + * @since 20 + * @arkts 1.2 */ + onLightStatusChange(type: 'lightStatusChange', callback: AsyncCallback): void; + /** - * Gets supported portrait effect. - * Move to Portrait interface from PortraitPhotoSession interface since 11. + * @since 20 + * @arkts 1.2 + */ + overload off { offError, offFocusStateChange, offSmoothZoomInfoAvailable, offMacroStatusChanged, offLcdFlashStatus, + offAutoDeviceSwitchStatusChange, offFocusTrackingInfoAvailable, offEffectSuggestionChange, offLightStatusChange }; + + /** + * Unsubscribes from error events. * - * @returns { Array } List of portrait effect. - * @throws { BusinessError } 202 - Not System Application. - * @throws { BusinessError } 7400103 - Session not config. + * @param { 'error' } type - Event type. + * @param { ErrorCallback } [callback] - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since 11 + * @since 20 + * @arkts 1.2 */ + offError(type: 'error', callback?: ErrorCallback): void; + /** - * Gets supported portrait effect. - * Move to PortraitQuery interface from Portrait interface since 12. + * Unsubscribes from focus state change event callback. * - * @returns { Array } List of portrait effect. - * @throws { BusinessError } 202 - Not System Application. - * @throws { BusinessError } 7400103 - Session not config, only throw in session usage. + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - getSupportedPortraitEffects(): Array; - } + offFocusStateChange(type: 'focusStateChange', callback?: AsyncCallback): void; - /** - * Portrait object. - * - * @extends PortraitQuery - * @interface Portrait - * @syscap SystemCapability.Multimedia.Camera.Core - * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 - */ - interface Portrait extends PortraitQuery { /** - * Gets the portrait effect in use. + * Unsubscribes from zoom info event callback. * - * @returns { PortraitEffect } The portrait effect in use. + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the zoom info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + offSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; + + /** + * Unsubscribes camera macro status event callback. + * + * @param { 'macroStatusChanged' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to return the result. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offMacroStatusChanged(type: 'macroStatusChanged', callback?: AsyncCallback): void; + + /** + * Unsubscribes from lcd flash status. + * + * @param { 'lcdFlashStatus' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the lcd flash status. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offLcdFlashStatus(type: 'lcdFlashStatus', callback?: AsyncCallback): void; + + /** + * Unsubscribes to auto device switch status event callback. + * + * @param { 'autoDeviceSwitchStatusChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to return the result. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + offAutoDeviceSwitchStatusChange(type: 'autoDeviceSwitchStatusChange', + callback?: AsyncCallback): void; + + /** + * Unsubscribes from focus tracking info event callback. + * + * @param { 'focusTrackingInfoAvailable' } type - Event type. + * @param { Callback } [callback] - Callback used to get the focus tracking info. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offFocusTrackingInfoAvailable(type: 'focusTrackingInfoAvailable', callback?: Callback): void; + + /** + * Unsubscribes from effect suggestion change events. + * @param { 'effectSuggestionChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to return the result. + * @throws { BusinessError } 202 - Not System Application.[object Object] + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offEffectSuggestionChange(type: 'effectSuggestionChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes camera light status event callback. + * + * @param { 'lightStatusChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to return the result. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offLightStatusChange(type: 'lightStatusChange', callback?: AsyncCallback): void; + } + + /** + * Enum for the camera light status. + * + * @enum { int } + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'18','1.2':'20'} + * @arkts 1.1&1.2 + */ + enum LightStatus { + /** + * Sufficient lighting. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'18','1.2':'20'} + * @arkts 1.1&1.2 + */ + NORMAL = 0, + + /** + * Insufficient lighting. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'18','1.2':'20'} + * @arkts 1.1&1.2 + */ + INSUFFICIENT = 1 + } + + /** + * Enumerates the camera portrait effects. + * + * @enum { int } + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'10','1.2':'20'} + * @arkts 1.1&1.2 + */ + enum PortraitEffect { + /** + * portrait effect off. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'10','1.2':'20'} + * @arkts 1.1&1.2 + */ + OFF = 0, + + /** + * circular blurring for portrait. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'10','1.2':'20'} + * @arkts 1.1&1.2 + */ + CIRCLES = 1, + + /** + * heart blurring for portrait. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'11','1.2':'20'} + * @arkts 1.1&1.2 + */ + HEART = 2, + + /** + * rotated blurring for portrait. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'11','1.2':'20'} + * @arkts 1.1&1.2 + */ + ROTATED = 3, + + /** + * studio blurring for portrait. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'11','1.2':'20'} + * @arkts 1.1&1.2 + */ + STUDIO = 4, + + /** + * theater blurring for portrait. + * + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'11','1.2':'20'} + * @arkts 1.1&1.2 + */ + THEATER = 5 + } + + /** + * Portrait Query object. + * + * @interface PortraitQuery + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'12','1.2':'20'} + * @arkts 1.1&1.2 + */ + interface PortraitQuery { + /** + * Gets supported portrait effect. + * + * @returns { Array } List of portrait effect. + * @throws { BusinessError } 7400103 - Session not config. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 10 + */ + /** + * Gets supported portrait effect. + * Move to Portrait interface from PortraitPhotoSession interface since 11. + * + * @returns { Array } List of portrait effect. + * @throws { BusinessError } 202 - Not System Application. + * @throws { BusinessError } 7400103 - Session not config. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 11 + */ + /** + * Gets supported portrait effect. + * Move to PortraitQuery interface from Portrait interface since 12. + * + * @returns { Array } List of portrait effect. + * @throws { BusinessError } 202 - Not System Application. + * @throws { BusinessError } 7400103 - Session not config, only throw in session usage. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'12','1.2':'20'} + * @arkts 1.1&1.2 + */ + getSupportedPortraitEffects(): Array; + } + + /** + * Portrait object. + * + * @extends PortraitQuery + * @interface Portrait + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'11','1.2':'20'} + * @arkts 1.1&1.2 + */ + interface Portrait extends PortraitQuery { + /** + * Gets the portrait effect in use. + * + * @returns { PortraitEffect } The portrait effect in use. * @throws { BusinessError } 7400103 - Session not config. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi @@ -9142,8 +9440,7 @@ declare namespace camera { * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ on(type: 'error', callback: ErrorCallback): void; @@ -9154,8 +9451,7 @@ declare namespace camera { * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ off(type: 'error', callback?: ErrorCallback): void; @@ -9166,8 +9462,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ on(type: 'focusStateChange', callback: AsyncCallback): void; @@ -9178,8 +9473,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ off(type: 'focusStateChange', callback?: AsyncCallback): void; @@ -9190,8 +9484,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the zoom info. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ on(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; @@ -9202,8 +9495,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the zoom info. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; @@ -9215,8 +9507,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'13','1.2':'20'} - * @arkts 1.1&1.2 + * @since 13 */ on(type: 'lcdFlashStatus', callback: AsyncCallback): void; @@ -9228,27 +9519,136 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'13','1.2':'20'} - * @arkts 1.1&1.2 + * @since 13 */ off(type: 'lcdFlashStatus', callback?: AsyncCallback): void; /** - * Gets session functions. + * @since 20 + * @arkts 1.2 + */ + overload on { onError, onFocusStateChange, onSmoothZoomInfoAvailable, onLcdFlashStatus }; + + /** + * Subscribes to error events. * - * @param { CameraOutputCapability } outputCapability - CameraOutputCapability to set. - * @returns { Array } List of session functions. - * @throws { BusinessError } 202 - Not System Application. - * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Incorrect parameter types. + * @param { 'error' } type - Event type. + * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'13','1.2':'20'} - * @arkts 1.1&1.2 + * @since 20 + * @arkts 1.2 */ - getSessionFunctions(outputCapability: CameraOutputCapability): Array; + onError(type: 'error', callback: ErrorCallback): void; /** - * Gets session conflict functions. + * Subscribes focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the focus state change. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onFocusStateChange(type: 'focusStateChange', callback: AsyncCallback): void; + + /** + * Subscribes zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the zoom info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; + + /** + * Subscribes to lcd flash status. + * + * @param { 'lcdFlashStatus' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the lcd flash status. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onLcdFlashStatus(type: 'lcdFlashStatus', callback: AsyncCallback): void; + + /** + * @since 20 + * @arkts 1.2 + */ + overload off { offError, offFocusStateChange, offSmoothZoomInfoAvailable, offLcdFlashStatus }; + + /** + * Unsubscribes from error events. + * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } [callback] - Callback used to get the capture session errors. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offError(type: 'error', callback?: ErrorCallback): void; + + /** + * Unsubscribes from focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the focus state change. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offFocusStateChange(type: 'focusStateChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes from zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the zoom info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; + + /** + * Unsubscribes from lcd flash status. + * + * @param { 'lcdFlashStatus' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the lcd flash status. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offLcdFlashStatus(type: 'lcdFlashStatus', callback?: AsyncCallback): void; + + /** + * Gets session functions. + * + * @param { CameraOutputCapability } outputCapability - CameraOutputCapability to set. + * @returns { Array } List of session functions. + * @throws { BusinessError } 202 - Not System Application. + * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Incorrect parameter types. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since arkts {'1.1':'13','1.2':'20'} + * @arkts 1.1&1.2 + */ + getSessionFunctions(outputCapability: CameraOutputCapability): Array; + + /** + * Gets session conflict functions. * * @returns { Array } List of session conflict functions. * @throws { BusinessError } 202 - Not System Application. @@ -9279,8 +9679,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'error', callback: ErrorCallback): void; @@ -9292,8 +9691,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'error', callback?: ErrorCallback): void; @@ -9305,8 +9703,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'focusStateChange', callback: AsyncCallback): void; @@ -9318,8 +9715,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'focusStateChange', callback?: AsyncCallback): void; @@ -9331,8 +9727,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; @@ -9344,10 +9739,99 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; + + /** + * @since 20 + * @arkts 1.2 + */ + overload on { onError, onFocusStateChange, onSmoothZoomInfoAvailable }; + + /** + * Subscribes to error events. + * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } callback - Callback used to get the capture session errors. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onError(type: 'error', callback: ErrorCallback): void; + + /** + * Subscribes focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the focus state change. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onFocusStateChange(type: 'focusStateChange', callback: AsyncCallback): void; + + /** + * Subscribes zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the zoom info. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; + + /** + * @since 20 + * @arkts 1.2 + */ + overload off { offError, offFocusStateChange, offSmoothZoomInfoAvailable }; + + /** + * Unsubscribes from error events. + * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } [callback] - Callback used to get the capture session errors. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offError(type: 'error', callback?: ErrorCallback): void; + + /** + * Unsubscribes from focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the focus state change. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offFocusStateChange(type: 'focusStateChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes from zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the zoom info. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; } /** @@ -9464,8 +9948,7 @@ declare namespace camera { * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ on(type: 'error', callback: ErrorCallback): void; @@ -9476,8 +9959,7 @@ declare namespace camera { * @param { ErrorCallback } callback - Callback used to get the capture session errors. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ off(type: 'error', callback?: ErrorCallback): void; @@ -9488,8 +9970,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ on(type: 'focusStateChange', callback: AsyncCallback): void; @@ -9500,8 +9981,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the focus state change. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ off(type: 'focusStateChange', callback?: AsyncCallback): void; @@ -9512,8 +9992,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the zoom info. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ on(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; @@ -9524,8 +10003,7 @@ declare namespace camera { * @param { AsyncCallback } callback - Callback used to get the zoom info. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'11','1.2':'20'} - * @arkts 1.1&1.2 + * @since 11 */ off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; @@ -9537,8 +10015,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'lcdFlashStatus', callback: AsyncCallback): void; @@ -9550,10 +10027,119 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'lcdFlashStatus', callback?: AsyncCallback): void; + + /** + * @since 20 + * @arkts 1.2 + */ + overload on { onError, onFocusStateChange, onSmoothZoomInfoAvailable, onLcdFlashStatus }; + + /** + * Subscribes to error events. + * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } callback - Callback used to get the capture session errors. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onError(type: 'error', callback: ErrorCallback): void; + + /** + * Subscribes focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the focus state change. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onFocusStateChange(type: 'focusStateChange', callback: AsyncCallback): void; + + /** + * Subscribes zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the zoom info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; + + /** + * Subscribes to lcd flash status. + * + * @param { 'lcdFlashStatus' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the lcd flash status. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onLcdFlashStatus(type: 'lcdFlashStatus', callback: AsyncCallback): void; + + /** + * @since 20 + * @arkts 1.2 + */ + overload off { offError, offFocusStateChange, offSmoothZoomInfoAvailable, offLcdFlashStatus }; + + /** + * Unsubscribes from error events. + * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } [callback] - Callback used to get the capture session errors. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offError(type: 'error', callback?: ErrorCallback): void; + + /** + * Unsubscribes from focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the focus state change. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offFocusStateChange(type: 'focusStateChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes from zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the zoom info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; + + /** + * Unsubscribes from lcd flash status. + * + * @param { 'lcdFlashStatus' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the lcd flash status. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offLcdFlashStatus(type: 'lcdFlashStatus', callback?: AsyncCallback): void; } /** @@ -9666,8 +10252,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'error', callback: ErrorCallback): void; @@ -9679,8 +10264,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'error', callback?: ErrorCallback): void; @@ -9692,8 +10276,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'focusStateChange', callback: AsyncCallback): void; @@ -9705,8 +10288,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'focusStateChange', callback?: AsyncCallback): void; @@ -9718,8 +10300,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; @@ -9731,8 +10312,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; @@ -9744,8 +10324,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'isoInfoChange', callback: AsyncCallback): void; @@ -9757,8 +10336,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'isoInfoChange', callback?: AsyncCallback): void; @@ -9770,8 +10348,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'exposureInfoChange', callback: AsyncCallback): void; @@ -9783,8 +10360,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'exposureInfoChange', callback?: AsyncCallback): void; @@ -9796,8 +10372,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'apertureInfoChange', callback: AsyncCallback): void; @@ -9809,8 +10384,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'apertureInfoChange', callback?: AsyncCallback): void; @@ -9822,8 +10396,7 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ on(type: 'luminationInfoChange', callback: AsyncCallback): void; @@ -9835,10 +10408,185 @@ declare namespace camera { * @throws { BusinessError } 202 - Not System Application. * @syscap SystemCapability.Multimedia.Camera.Core * @systemapi - * @since arkts {'1.1':'12','1.2':'20'} - * @arkts 1.1&1.2 + * @since 12 */ off(type: 'luminationInfoChange', callback?: AsyncCallback): void; + + /** + * @since 20 + * @arkts 1.2 + */ + overload on { onError, onFocusStateChange, onSmoothZoomInfoAvailable, onIsoInfoChange, onExposureInfoChange, + onApertureInfoChange, onLuminationInfoChange }; + + /** + * Subscribes to error events. + * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } callback - Callback used to get the capture session errors. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + onError(type: 'error', callback: ErrorCallback): void; + + /** + * Subscribes focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the focus state change. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + onFocusStateChange(type: 'focusStateChange', callback: AsyncCallback): void; + + /** + * Subscribes zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the zoom info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + onSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback: AsyncCallback): void; + + /** + * Subscribes ISO info event callback. + * + * @param { 'isoInfoChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the ISO info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + onIsoInfoChange(type: 'isoInfoChange', callback: AsyncCallback): void; + + /** + * Subscribes exposure info event callback. + * + * @param { 'exposureInfoChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the exposure info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + onExposureInfoChange(type: 'exposureInfoChange', callback: AsyncCallback): void; + + /** + * Subscribes aperture info event callback. + * + * @param { 'apertureInfoChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the aperture info. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onApertureInfoChange(type: 'apertureInfoChange', callback: AsyncCallback): void; + + /** + * Subscribes lumination info event callback. + * + * @param { 'luminationInfoChange' } type - Event type. + * @param { AsyncCallback } callback - Callback used to get the lumination info. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + onLuminationInfoChange(type: 'luminationInfoChange', callback: AsyncCallback): void; + + /** + * @since 20 + * @arkts 1.2 + */ + overload off { offError, offFocusStateChange, offSmoothZoomInfoAvailable, offIsoInfoChange, offExposureInfoChange, + offApertureInfoChange, offLuminationInfoChange }; + + /** + * Unsubscribes from error events. + * + * @param { 'error' } type - Event type. + * @param { ErrorCallback } [callback] - Callback used to get the capture session errors. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + offError(type: 'error', callback?: ErrorCallback): void; + + /** + * Unsubscribes from focus state change event callback. + * + * @param { 'focusStateChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the focus state change. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + offFocusStateChange(type: 'focusStateChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes from zoom info event callback. + * + * @param { 'smoothZoomInfoAvailable' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the zoom info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + offSmoothZoomInfoAvailable(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback): void; + + /** + * Unsubscribes from ISO info event callback. + * + * @param { 'isoInfoChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the ISO info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + offIsoInfoChange(type: 'isoInfoChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes from exposure info event callback. + * + * @param { 'exposureInfoChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the exposure info. + * @syscap SystemCapability.Multimedia.Camera.Core + * @since 20 + * @arkts 1.2 + */ + offExposureInfoChange(type: 'exposureInfoChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes from aperture info event callback. + * + * @param { 'apertureInfoChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the aperture info. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offApertureInfoChange(type: 'apertureInfoChange', callback?: AsyncCallback): void; + + /** + * Unsubscribes from lumination info event callback. + * + * @param { 'luminationInfoChange' } type - Event type. + * @param { AsyncCallback } [callback] - Callback used to get the lumination info. + * @throws { BusinessError } 202 - Not System Application. + * @syscap SystemCapability.Multimedia.Camera.Core + * @systemapi + * @since 20 + * @arkts 1.2 + */ + offLuminationInfoChange(type: 'luminationInfoChange', callback?: AsyncCallback): void; } /**