Add zoom methods

Author: mekya

WebRTCiOSSDK/api/AntMediaClient.swift

@@ -524,6 +524,54 @@ open class AntMediaClient: NSObject, AntMediaClientProtocol {
     open func switchCamera() {
         self.webRTCClientMap[(self.publisherStreamId ?? (self.p2pStreamId)) ?? ""]?.switchCamera()
     }
+    
+    /**
+     Instant zoom
+     1.0 means no zoom, 2.0 means 2x zoom, and so on.
+     The method ensures the zoom does not exceed the camera’s limits.
+     */
+    open func setZoomLevel(zoomFactor: CGFloat) {
+       guard let streamId = publisherStreamId, let camera = webRTCClientMap[streamId]?.captureDevice else { return }
+
+       do {
+           try camera.lockForConfiguration()
+           camera.videoZoomFactor = max(1.0, min(zoomFactor, camera.activeFormat.videoMaxZoomFactor)) // Keep within limits
+           camera.unlockForConfiguration()
+       } catch {
+           print("Failed to set zoom level: \(error)")
+       }
+    }
+
+    /**
+     Smooth zoom
+     The rate controls how fast the zoom happens.
+     Lower values (e.g., 1.0) mean slow zoom; higher values (e.g., 5.0) mean faster zoom.
+     */
+    open func smoothZoom(to zoomFactor: CGFloat, rate: Float) {
+       guard let streamId = publisherStreamId, let camera = webRTCClientMap[streamId]?.captureDevice else { return }
+
+       do {
+           try camera.lockForConfiguration()
+           camera.ramp(toVideoZoomFactor: max(1.0, min(zoomFactor, camera.activeFormat.videoMaxZoomFactor)), withRate: rate)
+           camera.unlockForConfiguration()
+       } catch {
+           print("Failed to ramp zoom: \(error)")
+       }
+    }
+    /**
+     If a zoom ramp is in progress, you can cancel it immediately:
+     */
+    open func stopZoomRamp() {
+       guard let streamId = publisherStreamId, let camera = webRTCClientMap[streamId]?.captureDevice else { return }
+
+       do {
+           try camera.lockForConfiguration()
+           camera.cancelVideoZoomRamp()
+           camera.unlockForConfiguration()
+       } catch {
+           print("Failed to cancel zoom ramp: \(error)")
+       }
+    }
 
     /*
      Send data through WebRTC Data channel.

WebRTCiOSSDK/api/AntMediaClientProtocol.swift

@@ -162,6 +162,25 @@ public protocol AntMediaClientProtocol {
      */
     func switchCamera()
 
+    /**
+     Instant zoom
+     1.0 means no zoom, 2.0 means 2x zoom, and so on.
+     The method ensures the zoom does not exceed the camera’s limits.
+     */
+    func setZoomLevel(zoomFactor: CGFloat)
+
+    /**
+     Smooth zoom
+     The rate controls how fast the zoom happens.
+     Lower values (e.g., 1.0) mean slow zoom; higher values (e.g., 5.0) mean faster zoom.
+     */
+    func smoothZoom(to zoomFactor: CGFloat, rate: Float)
+
+    /**
+     If a zoom ramp is in progress, you can cancel it immediately:
+     */
+    func stopZoomRamp()
+    
     /**
     Sends data via WebRTC's Data Channel.
      - Parameters:

WebRTCiOSSDK/api/webrtc/WebRTCClient.swift

@@ -66,6 +66,16 @@ class WebRTCClient: NSObject {
 
     private var degradationPreference: RTCDegradationPreference = .maintainResolution
 
+    // this is not an ideal method to get current capture device, we need more legit solution
+    var captureDevice: AVCaptureDevice? {
+        if videoEnabled {
+          return (RTCCameraVideoCapturer.captureDevices().first { $0.position == self.cameraPosition })
+        }
+        else {
+          return nil;
+        }
+    }
+    
     public init(remoteVideoView: RTCVideoRenderer?, localVideoView: RTCVideoRenderer?, delegate: WebRTCClientDelegate, externalAudio: Bool) {
         RTCInitializeSSL()
 
@@ -388,11 +398,10 @@ class WebRTCClient: NSObject {
     }
 
     private func startCapture() -> Bool {
+      
 
-        let camera = (RTCCameraVideoCapturer.captureDevices().first { $0.position == self.cameraPosition })
-        
-        if camera != nil {
-            let supportedFormats = RTCCameraVideoCapturer.supportedFormats(for: camera!)
+        if captureDevice != nil {
+            let supportedFormats = RTCCameraVideoCapturer.supportedFormats(for: captureDevice!)
 
             var currentDiff = INT_MAX
 
@@ -422,7 +431,7 @@ class WebRTCClient: NSObject {
 
                 let cameraVideoCapturer = self.videoCapturer as? RTCCameraVideoCapturer
 
-                cameraVideoCapturer?.startCapture(with: camera!,
+                cameraVideoCapturer?.startCapture(with: captureDevice!,
                                                   format: selectedFormat!,
                                                   fps: Int(fps))