From e04edfb60b21be4765e6c02c45ad0d75c956e409 Mon Sep 17 00:00:00 2001 From: Dynamsoft-Henry <78675724+Dynamsoft-Henry@users.noreply.github.com> Date: Mon, 2 Feb 2026 11:25:26 +0800 Subject: [PATCH] Updating 3.4.1000 and fixed some bugs --- .../camera-enhancer-exception.md | 4 +- .../auxiliary-api/camera-enhancer-module.md | 4 +- .../android/auxiliary-api/capabilities.md | 4 +- .../android/auxiliary-api/dcecameraview.md | 4 +- .../android/auxiliary-api/dcedrawinglayer.md | 4 +- .../android/auxiliary-api/dcefeedback.md | 4 +- .../auxiliary-api/dceimageeditorview.md | 4 +- .../android/auxiliary-api/drawingitem-arc.md | 4 +- .../android/auxiliary-api/drawingitem-line.md | 4 +- .../android/auxiliary-api/drawingitem-quad.md | 4 +- .../android/auxiliary-api/drawingitem-rect.md | 4 +- .../android/auxiliary-api/drawingitem-text.md | 4 +- .../android/auxiliary-api/drawingitem.md | 4 +- .../android/auxiliary-api/drawingstyle.md | 4 +- .../auxiliary-api/drawingstylemanager.md | 4 +- .../auxiliary-api/interface-click-listener.md | 4 +- .../interface-dcecamerastatelistener.md | 4 +- .../interface-dceframelistener.md | 4 +- .../interface-dcephotolistener.md | 4 +- .../auxiliary-api/interface-focus-listener.md | 45 +++++++++++++ .../interface-zoomfactorchangelistener.md | 4 +- programming/android/auxiliary-api/note.md | 4 +- .../android/auxiliary-api/permission-util.md | 6 ++ .../android/auxiliary-api/tip-config.md | 4 +- programming/android/enum/resolution.md | 2 + .../android/primary-api/camera-enhancer.md | 19 +++++- .../auxiliary-api/protocol-focus-listener.md | 67 +++++++++++++++++++ programming/ios/enum/resolution.md | 10 ++- .../ios/primary-api/camera-enhancer.md | 24 ++++++- 29 files changed, 235 insertions(+), 26 deletions(-) create mode 100644 programming/android/auxiliary-api/interface-focus-listener.md create mode 100644 programming/ios/auxiliary-api/protocol-focus-listener.md diff --git a/programming/android/auxiliary-api/camera-enhancer-exception.md b/programming/android/auxiliary-api/camera-enhancer-exception.md index 45f89b5..4a3c81f 100644 --- a/programming/android/auxiliary-api/camera-enhancer-exception.md +++ b/programming/android/auxiliary-api/camera-enhancer-exception.md @@ -14,7 +14,9 @@ noTitleIndex: true ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class CameraEnhancerException extends Exception diff --git a/programming/android/auxiliary-api/camera-enhancer-module.md b/programming/android/auxiliary-api/camera-enhancer-module.md index 4a35182..59f949a 100644 --- a/programming/android/auxiliary-api/camera-enhancer-module.md +++ b/programming/android/auxiliary-api/camera-enhancer-module.md @@ -14,7 +14,9 @@ The `CameraEnhancerModule` class defines general functions of the camera enhance ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class CameraEnhancerModule diff --git a/programming/android/auxiliary-api/capabilities.md b/programming/android/auxiliary-api/capabilities.md index ec0eef0..fd38d08 100644 --- a/programming/android/auxiliary-api/capabilities.md +++ b/programming/android/auxiliary-api/capabilities.md @@ -14,7 +14,9 @@ The `Capabilities` class represents the capability properties of the hardware, i ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class Capabilities diff --git a/programming/android/auxiliary-api/dcecameraview.md b/programming/android/auxiliary-api/dcecameraview.md index bb29737..38638f5 100644 --- a/programming/android/auxiliary-api/dcecameraview.md +++ b/programming/android/auxiliary-api/dcecameraview.md @@ -14,7 +14,9 @@ The `CameraView` class is used to display the camera preview and provides UI con ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class CameraView diff --git a/programming/android/auxiliary-api/dcedrawinglayer.md b/programming/android/auxiliary-api/dcedrawinglayer.md index c2ae0c1..11971c1 100644 --- a/programming/android/auxiliary-api/dcedrawinglayer.md +++ b/programming/android/auxiliary-api/dcedrawinglayer.md @@ -14,7 +14,9 @@ The `DrawingLayer` class represents a drawing layer, which is used for managing ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class DrawingLayer diff --git a/programming/android/auxiliary-api/dcefeedback.md b/programming/android/auxiliary-api/dcefeedback.md index 5a1315c..89f2bc6 100644 --- a/programming/android/auxiliary-api/dcefeedback.md +++ b/programming/android/auxiliary-api/dcefeedback.md @@ -14,7 +14,9 @@ The `Feedback` class provides methods to trigger feedbacks from the hardware, su ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class Feedback diff --git a/programming/android/auxiliary-api/dceimageeditorview.md b/programming/android/auxiliary-api/dceimageeditorview.md index aedc6a6..9947de1 100644 --- a/programming/android/auxiliary-api/dceimageeditorview.md +++ b/programming/android/auxiliary-api/dceimageeditorview.md @@ -14,7 +14,9 @@ The `ImageEditorView` class represents an image editor view, which allows users ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class ImageEditorView : UIView diff --git a/programming/android/auxiliary-api/drawingitem-arc.md b/programming/android/auxiliary-api/drawingitem-arc.md index acbef46..b414f3c 100644 --- a/programming/android/auxiliary-api/drawingitem-arc.md +++ b/programming/android/auxiliary-api/drawingitem-arc.md @@ -14,7 +14,9 @@ The `ArcDrawingItem` class is a subclass of `DrawingItem`. It represents a drawi ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class ArcDrawingItem extends DrawingItem diff --git a/programming/android/auxiliary-api/drawingitem-line.md b/programming/android/auxiliary-api/drawingitem-line.md index 6c64f7a..b23fc87 100644 --- a/programming/android/auxiliary-api/drawingitem-line.md +++ b/programming/android/auxiliary-api/drawingitem-line.md @@ -14,7 +14,9 @@ The `LineDrawingItem` class is a subclass of `DrawingItem` and represents a line ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class LineDrawingItem extends DrawingItem diff --git a/programming/android/auxiliary-api/drawingitem-quad.md b/programming/android/auxiliary-api/drawingitem-quad.md index 9de1a72..4314025 100644 --- a/programming/android/auxiliary-api/drawingitem-quad.md +++ b/programming/android/auxiliary-api/drawingitem-quad.md @@ -14,7 +14,9 @@ The `QuadDrawingItem` class is a subclass of `DrawingItem`. It represents a draw ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class QuadDrawingItem extends DrawingItem diff --git a/programming/android/auxiliary-api/drawingitem-rect.md b/programming/android/auxiliary-api/drawingitem-rect.md index cbf7da2..ff09905 100644 --- a/programming/android/auxiliary-api/drawingitem-rect.md +++ b/programming/android/auxiliary-api/drawingitem-rect.md @@ -14,7 +14,9 @@ The `RectDrawingItem` class is a subclass of `DrawingItem` that represents a rec ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class RectDrawingItem extends DrawingItem diff --git a/programming/android/auxiliary-api/drawingitem-text.md b/programming/android/auxiliary-api/drawingitem-text.md index 243bc1b..6fe8aef 100644 --- a/programming/android/auxiliary-api/drawingitem-text.md +++ b/programming/android/auxiliary-api/drawingitem-text.md @@ -14,7 +14,9 @@ The `TextDrawingItem` class is a subclass of `DrawingItem` and represents a text ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class TextDrawingItem extends DrawingItem diff --git a/programming/android/auxiliary-api/drawingitem.md b/programming/android/auxiliary-api/drawingitem.md index 4f7e7b6..08e52e8 100644 --- a/programming/android/auxiliary-api/drawingitem.md +++ b/programming/android/auxiliary-api/drawingitem.md @@ -14,7 +14,9 @@ The `DrawingItem` class represents a base class for drawing items, which can be ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class DrawingItem diff --git a/programming/android/auxiliary-api/drawingstyle.md b/programming/android/auxiliary-api/drawingstyle.md index 9b1aa0b..15faa2f 100644 --- a/programming/android/auxiliary-api/drawingstyle.md +++ b/programming/android/auxiliary-api/drawingstyle.md @@ -14,7 +14,9 @@ The `DrawingStyle` class represents the style attributes of the drawing items, i ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class DrawingStyle diff --git a/programming/android/auxiliary-api/drawingstylemanager.md b/programming/android/auxiliary-api/drawingstylemanager.md index ee2cf93..9e351fa 100644 --- a/programming/android/auxiliary-api/drawingstylemanager.md +++ b/programming/android/auxiliary-api/drawingstylemanager.md @@ -14,7 +14,9 @@ The `DrawingStyleManager` class is the manager of DrawingStyles in Dynamsoft Cam ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class DrawingStyleManager diff --git a/programming/android/auxiliary-api/interface-click-listener.md b/programming/android/auxiliary-api/interface-click-listener.md index 4e79c1e..f74bf86 100644 --- a/programming/android/auxiliary-api/interface-click-listener.md +++ b/programming/android/auxiliary-api/interface-click-listener.md @@ -14,7 +14,9 @@ The `DrawingItemClickListener` interface includes methods for monitoring the cli ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java interface DrawingItemClickListener diff --git a/programming/android/auxiliary-api/interface-dcecamerastatelistener.md b/programming/android/auxiliary-api/interface-dcecamerastatelistener.md index ae797b2..d1eb5b3 100644 --- a/programming/android/auxiliary-api/interface-dcecamerastatelistener.md +++ b/programming/android/auxiliary-api/interface-dcecamerastatelistener.md @@ -14,7 +14,9 @@ The `CameraStateListener` interface includes methods for monitoring the camera s ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java interface CameraStateListener diff --git a/programming/android/auxiliary-api/interface-dceframelistener.md b/programming/android/auxiliary-api/interface-dceframelistener.md index 21603fb..324010d 100644 --- a/programming/android/auxiliary-api/interface-dceframelistener.md +++ b/programming/android/auxiliary-api/interface-dceframelistener.md @@ -14,7 +14,9 @@ The `VideoFrameListener` interface includes methods for monitoring the camera st ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java interface VideoFrameListener diff --git a/programming/android/auxiliary-api/interface-dcephotolistener.md b/programming/android/auxiliary-api/interface-dcephotolistener.md index 86f4bfa..5de736a 100644 --- a/programming/android/auxiliary-api/interface-dcephotolistener.md +++ b/programming/android/auxiliary-api/interface-dcephotolistener.md @@ -14,7 +14,9 @@ The `PhotoListener` interface defines the methods for monitoring the photo outpu ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java interface PhotoListener diff --git a/programming/android/auxiliary-api/interface-focus-listener.md b/programming/android/auxiliary-api/interface-focus-listener.md new file mode 100644 index 0000000..15554c1 --- /dev/null +++ b/programming/android/auxiliary-api/interface-focus-listener.md @@ -0,0 +1,45 @@ +--- +layout: default-layout +title: FocusListener - Dynamsoft Camera Enhancer Android Edition API Reference +description: The interface that includes methods for monitoring the focus status. +keywords: Focus listener, Java, Kotlin +needGenerateH3Content: true +needAutoGenerateSidebar: true +noTitleIndex: true +--- + +# FocusListener + +The `FocusListener` interface includes methods for monitoring the focus status and receiving focus completion events. + +## Definition + +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce + +```java +interface FocusListener +``` + +## Methods + +### onFocusFinished + +The method for receiving notifications when a focus operation is completed. + +```java +void onFocusFinished(PointF focusPoint); +``` + +**Parameters** + +`focusPoint`: A `PointF` object that represents the coordinates of the focus point. + +**Remarks** + +This callback is triggered under the following conditions: + +- Always triggered when calling `setFocus(Point, FocusModeLocked)` +- Might be triggered when performing tap-to-focus +- Never triggered when calling `setFocus(Point, FocusModeContinuousAuto)` diff --git a/programming/android/auxiliary-api/interface-zoomfactorchangelistener.md b/programming/android/auxiliary-api/interface-zoomfactorchangelistener.md index 71a3a11..1b53ede 100644 --- a/programming/android/auxiliary-api/interface-zoomfactorchangelistener.md +++ b/programming/android/auxiliary-api/interface-zoomfactorchangelistener.md @@ -14,7 +14,9 @@ The `ZoomFactorChangeListener` interface defines the methods for monitoring the ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java interface ZoomFactorChangeListener diff --git a/programming/android/auxiliary-api/note.md b/programming/android/auxiliary-api/note.md index febd83c..7b6d8ac 100644 --- a/programming/android/auxiliary-api/note.md +++ b/programming/android/auxiliary-api/note.md @@ -14,7 +14,9 @@ The `Note` class represents a note, which contains a key and content. ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class Note diff --git a/programming/android/auxiliary-api/permission-util.md b/programming/android/auxiliary-api/permission-util.md index bd99104..06099c3 100644 --- a/programming/android/auxiliary-api/permission-util.md +++ b/programming/android/auxiliary-api/permission-util.md @@ -14,6 +14,12 @@ permalink: /programming/android/auxiliary-api/permission-util.html The `PermissionUtil` class defines the methods for requesting the camera permission. +## Definition + +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce + ```java final class PermissionUtil ``` diff --git a/programming/android/auxiliary-api/tip-config.md b/programming/android/auxiliary-api/tip-config.md index bd66100..c39fa30 100644 --- a/programming/android/auxiliary-api/tip-config.md +++ b/programming/android/auxiliary-api/tip-config.md @@ -14,7 +14,9 @@ The `TipConfig` class defines the configurations of tip, including the top left ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class TipConfig diff --git a/programming/android/enum/resolution.md b/programming/android/enum/resolution.md index f970d4e..4f17482 100644 --- a/programming/android/enum/resolution.md +++ b/programming/android/enum/resolution.md @@ -27,5 +27,7 @@ public @interface EnumResolution { int RESOLUTION_2K = 4; // 4K int RESOLUTION_4K = 5; + // Set the resolution to max so that you can capture 3024*4032 size photo. + int RESOLUTION_MAX = 6; } ``` diff --git a/programming/android/primary-api/camera-enhancer.md b/programming/android/primary-api/camera-enhancer.md index 6730181..ef0b31b 100644 --- a/programming/android/primary-api/camera-enhancer.md +++ b/programming/android/primary-api/camera-enhancer.md @@ -15,7 +15,9 @@ The `CameraEnhancer` class is the primary class of Dynamsoft Camera Enhancer tha ## Definition -*Assembly:* package com.dynamsoft.dce +*Assembly:* DynamsoftCaptureVisionBundle.aar + +*Namespace:* com.dynamsoft.dce ```java class CameraEnhancer extends ImageSourceAdapter @@ -61,6 +63,7 @@ class CameraEnhancer extends ImageSourceAdapter | [`turnOffTorch`](#turnofftorch) | Turn off the torch. | | [`setFocus`](#setfocus) | Set the focus point of interest and trigger an one-off auto-focus. | | [`setFocus(subsequentFocusMode)`](#setfocussubsequentfocusmode) | Set the focus point of interest and trigger an one-off auto-focus. After the focus, you can either lock the focalngth or keep the continuous auto focus enabled by configuring the subsequent focus mode. | +| [`setFocusListener`](#setfocuslistener) | Set a [`FocusListener`](../auxiliary-api/interface-focus-listener.md) to receive callback when the focus operation is completed. | | [`convertRectToViewCoordinates`](#convertrecttoviewcoordinates) | Convert the coordinates of a [`DSRect`]({{ site.dcv_android_api }}core/basic-structures/rect.html) under video coordinate system to a CGRect under camera view coordinate system. | | [`convertPointToViewCoordinates`](#convertpointtoviewcoordinates) | Convert the coordinates of a CGPoint under video coordinate system to another CGPoint under camera view coordinate system. | | [`setImageCaptureDistanceMode`](#setimagecapturedistancemode) | Set/get the capture distance property of the video frame. The capture distance property will be recorded by VideoFrameTag. | @@ -71,7 +74,7 @@ class CameraEnhancer extends ImageSourceAdapter | [`getAllCameras`](#getallcameras) | Get the IDs of all available cameras. | | [`selectCamera`](#selectcamera) | Select a camera with a camera ID. | | [`getSelectedCamera`](#getselectedcamera) | Get the currently actived camera. | -| [`setZoomFactorChangeListener`](#setzoomfactorchangelistener) | Set a `ZoomFactorChangeListener` to receive callback when the zoom-factor changed. | +| [`setZoomFactorChangeListener`](#setzoomfactorchangelistener) | Set a [`ZoomFactorChangeListener`](../auxiliary-api/interface-zoomfactorchangelistener.md) to receive callback when the zoom-factor changed. | ## Inherited Methods @@ -663,6 +666,18 @@ void setZoomFactorChangeListener(ZoomFactorChangeListener listener); `listener`: A [`ZoomFactorChangeListener`](../auxiliary-api/interface-zoomfactorchangelistener.md) to receive callback when the zoom-factor changed. +### setFocusListener + +Set a [`FocusListener`](../auxiliary-api/interface-focus-listener.md) to receive callback when the focus operation is completed. + +```java +void setFocusListener(FocusListener listener); +``` + +**Parameters** + +`listener`: A [`FocusListener`](../auxiliary-api/interface-focus-listener.md) to receive focus completion notifications. + ### getAllCameras > This method is deprecated. diff --git a/programming/ios/auxiliary-api/protocol-focus-listener.md b/programming/ios/auxiliary-api/protocol-focus-listener.md new file mode 100644 index 0000000..2a93b8e --- /dev/null +++ b/programming/ios/auxiliary-api/protocol-focus-listener.md @@ -0,0 +1,67 @@ +--- +layout: default-layout +title: DSFocusListener - DynamsoftCameraEnhancer iOS Edition API Reference +description: The protocol that includes methods for monitoring the focus status. +keywords: Focus listener, objective-c, swift +needGenerateH3Content: true +needAutoGenerateSidebar: true +noTitleIndex: true +--- + +# DSFocusListener + +The `DSFocusListener` protocol includes methods for monitoring the focus status and receiving focus completion events. + +## Definition + +*Assembly:* DynamsoftCaptureVisionBundle.xcframework + +
+>- Objective-C +>- Swift +> +>1. +```objc +@protocol DSFocusListener +``` +2. +```swift +protocol FocusListener : NSObjectProtocol +``` + +## Methods + +| Method | Description | +|------- |-------------| +| [`onFocusFinished`](#onfocusfinished) | The method for receiving notifications when a focus operation is completed. | + +### onFocusFinished + +The method for receiving notifications when a focus operation is completed. + +
+>- Objective-C +>- Swift +> +>1. +```objc +- (void)onFocusFinished:(CGPoint)focusPoint; +``` +2. +```swift +func onFocusFinished(_ focusPoint: CGPoint) +``` + +**Parameters** + +`focusPoint`: A `CGPoint` object that represents the coordinates of the focus point. + +**Remarks** + +If a new focus request is triggered before the previous one completes, the previous request will be canceled, and only the final successfully completed focus operation will invoke this callback. + +This callback is triggered under the following conditions: + +- Always triggered when calling `setFocus(Point, FocusModeLocked)` +- Might be triggered when performing tap-to-focus +- Never triggered when calling `setFocus(Point, FocusModeContinuousAuto)` diff --git a/programming/ios/enum/resolution.md b/programming/ios/enum/resolution.md index f39b904..0baaa2d 100644 --- a/programming/ios/enum/resolution.md +++ b/programming/ios/enum/resolution.md @@ -40,7 +40,11 @@ typedef NS_ENUM(NSInteger, DSResolution) /** * Set the video streaming to the 4K resolution. */ - DSResolution4K = 4 + DSResolution4K = 4, + /** + * Set the resolution to max so that you can capture 3024*4032 size photo. + */ + DSResolutionMax }; ``` > @@ -66,5 +70,9 @@ public enum Resolution : Int{ * Set the video streaming to the 4K resolution. */ 4K = 4 + /** + * Set the resolution to max so that you can capture 3024*4032 size photo. + */ + max } ``` diff --git a/programming/ios/primary-api/camera-enhancer.md b/programming/ios/primary-api/camera-enhancer.md index e82017a..234be9f 100644 --- a/programming/ios/primary-api/camera-enhancer.md +++ b/programming/ios/primary-api/camera-enhancer.md @@ -67,12 +67,13 @@ class CameraEnhancer : ImageSourceAdapter | [`turnOffTorch`](#turnofftorch) | Turn off the torch. | | [`setFocus`](#setfocus) | Set the focus point of interest and trigger an one-off auto-focus. | | [`setFocus(subsequentFocusMode)`](#setfocussubsequentfocusmode) | Set the focus point of interest and trigger an one-off auto-focus. After the focus, you can either lock the focalngth or keep the continuous auto focus enabled by configuring the subsequent focus mode. | +| [`setFocusListener`](#setfocuslistener) | Set a [`DSFocusListener`](../auxiliary-api/protocol-focus-listener.md) to receive callback when the focus operation is completed. | | [`convertRectToViewCoordinates`](#convertrecttoviewcoordinates) | Convert the coordinates of a [`DSRect`]({{ site.dcv_ios_api }}core/basic-structures/rect.html) under video coordinate system to a CGRect under camera view coordinate system. | | [`convertPointToViewCoordinates`](#convertpointtoviewcoordinates) | Convert the coordinates of a CGPoint under video coordinate system to another CGPoint under camera view coordinate system. | | [`getAllCameras`](#getallcameras) | Get the IDs of all available cameras. | | [`selectCamera`](#selectcamera) | Select a camera with a camera ID. | | [`getSelectedCamera`](#getselectedcamera) | Get the currently actived camera. | -| [`setZoomFactorChangeListener`](#setzoomfactorchangelistener) | Set a `DSZoomFactorChangeListener` to receive callback when the zoom-factor changed. | +| [`setZoomFactorChangeListener`](#setzoomfactorchangelistener) | Set a [`DSZoomFactorChangeListener`](../auxiliary-api/protocol-zoomfactorchangelistener.md) to receive callback when the zoom-factor changed. | ## Attributes @@ -1083,3 +1084,24 @@ func setZoomFactorChangeListener(_ listener: DSZoomFactorChangeListener?) **Parameters** `listener`: A delegate object of [`DSZoomFactorChangeListener`](../auxiliary-api/protocol-zoomfactorchangelistener.md) to receive zoom-factor changed notification. + +### setFocusListener + +Set a [`DSFocusListener`](../auxiliary-api/protocol-focus-listener.md) to receive callback when the focus operation is completed. + +
+>- Objective-C +>- Swift +> +>1. +```objc +- (void)setFocusListener:(nullable id)listener; +``` +2. +```swift +func setFocusListener(_ listener: DSFocusListener?) +``` + +**Parameters** + +`listener`: A delegate object of [`DSFocusListener`](../auxiliary-api/protocol-focus-listener.md) to receive focus completion notifications.