refactor(macos): modernize screen capture and require macOS 12

Use RTC SDK screen enumeration for local video transcoding and remove WindowsCenter. Adopt @main and align the app, Pods, and documentation on a macOS 12 deployment target.

Author: zhangwei

macOS/APIExample.xcodeproj/project.pbxproj

@@ -39,7 +39,6 @@
 		034C62712525A35800296ECF /* StreamEncryption.swift in Sources */ = {isa = PBXBuildFile; fileRef = 034C62702525A35700296ECF /* StreamEncryption.swift */; };
 		034C62772525C68D00296ECF /* AgoraCustomEncryption.mm in Sources */ = {isa = PBXBuildFile; fileRef = 034C62752525C68C00296ECF /* AgoraCustomEncryption.mm */; };
 		034C627C2526C43900296ECF /* ScreenShare.swift in Sources */ = {isa = PBXBuildFile; fileRef = 034C627A2526C43900296ECF /* ScreenShare.swift */; };
-		034C62872528255F00296ECF /* WindowsCenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 034C62862528255F00296ECF /* WindowsCenter.swift */; };
 		034C628A25282D5D00296ECF /* JoinMultiChannel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 034C628925282D5D00296ECF /* JoinMultiChannel.swift */; };
 		034C62912528327800296ECF /* ChannelMediaRelay.swift in Sources */ = {isa = PBXBuildFile; fileRef = 034C628F2528327800296ECF /* ChannelMediaRelay.swift */; };
 		034C62932528474D00296ECF /* StatisticsInfo.swift in Sources */ = {isa = PBXBuildFile; fileRef = 034C62922528474D00296ECF /* StatisticsInfo.swift */; };
@@ -211,7 +210,6 @@
 		034C62752525C68C00296ECF /* AgoraCustomEncryption.mm */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.objcpp; path = AgoraCustomEncryption.mm; sourceTree = "<group>"; };
 		034C62762525C68C00296ECF /* AgoraCustomEncryption.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = AgoraCustomEncryption.h; sourceTree = "<group>"; };
 		034C627A2526C43900296ECF /* ScreenShare.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ScreenShare.swift; sourceTree = "<group>"; };
-		034C62862528255F00296ECF /* WindowsCenter.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = WindowsCenter.swift; sourceTree = "<group>"; };
 		034C628925282D5D00296ECF /* JoinMultiChannel.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = JoinMultiChannel.swift; sourceTree = "<group>"; };
 		034C628F2528327800296ECF /* ChannelMediaRelay.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ChannelMediaRelay.swift; sourceTree = "<group>"; };
 		034C62922528474D00296ECF /* StatisticsInfo.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = StatisticsInfo.swift; sourceTree = "<group>"; };
@@ -649,7 +647,6 @@
 				5770E2C0258C580E00812A80 /* Component */,
 				57887A7F25885FC2006E962A /* Settings */,
 				034C62922528474D00296ECF /* StatisticsInfo.swift */,
-				034C62862528255F00296ECF /* WindowsCenter.swift */,
 				034C626325257EA600296ECF /* GlobalSettings.swift */,
 				03B12DA3250E8F7F00E55818 /* AgoraExtension.swift */,
 				034C62742525C68C00296ECF /* CustomEncryption */,
@@ -1265,7 +1262,6 @@
 				03B12DA4250E8F7F00E55818 /* AgoraExtension.swift in Sources */,
 				0336A1C725034F4700D61B7F /* AudioWriteToFile.m in Sources */,
 				671BD67927E09E3B0076D5E1 /* AgoraPcmSourcePush.swift in Sources */,
-				034C62872528255F00296ECF /* WindowsCenter.swift in Sources */,
 				034C62912528327800296ECF /* ChannelMediaRelay.swift in Sources */,
 				033A9F9E252EA86A00BC26E1 /* CustomVideoSourcePush.swift in Sources */,
 				8BD4AE73272513FF00E95B87 /* SimpleFilter.swift in Sources */,
@@ -1663,7 +1659,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				MACOSX_DEPLOYMENT_TARGET = 10.15;
+				MACOSX_DEPLOYMENT_TARGET = 12.0;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				ONLY_ACTIVE_ARCH = YES;
@@ -1719,7 +1715,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				MACOSX_DEPLOYMENT_TARGET = 10.15;
+				MACOSX_DEPLOYMENT_TARGET = 12.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				MTL_FAST_MATH = YES;
 				SDKROOT = macosx;

macOS/APIExample/AppDelegate.swift

@@ -8,7 +8,7 @@
 
 import Cocoa
 
-@NSApplicationMain
+@main
 class AppDelegate: NSObject, NSApplicationDelegate {
 
 

macOS/APIExample/Common/WindowsCenter.swift

@@ -21,13 +21,12 @@ class LocalVideoTranscoding: BaseViewController {
         layoutVideos(2)
     }
 
-    var windowManager: WindowList = WindowList()
-    var windowlist:[Window] = [], screenlist:[Window] = []
+    var screenlist: [AgoraScreenCaptureSourceInfo] = []
     /**
      --- Screen Picker ---
      */
     @IBOutlet weak var selectScreenPicker: Picker!
-    var selectedScreen: Window? {
+    var selectedScreen: AgoraScreenCaptureSourceInfo? {
         let index = self.selectScreenPicker.indexOfSelectedItem
         if index >= 0 && index < screenlist.count {
             return screenlist[index]
@@ -36,9 +35,14 @@ class LocalVideoTranscoding: BaseViewController {
         }
     }
     func initSelectScreenPicker() {
-        screenlist = windowManager.items.filter({$0.type == .screen})
+        let sources = agoraKit.getScreenCaptureSources(withThumbSize: .zero, iconSize: .zero, includeScreen: true)
+        screenlist = sources?.filter { $0.type == .screen } ?? []
         selectScreenPicker.label.stringValue = "Screen Share".localized
-        selectScreenPicker.picker.addItems(withTitles: screenlist.map {"\($0.name ?? "Unknown")(\($0.id))"})
+        selectScreenPicker.picker.removeAllItems()
+        selectScreenPicker.picker.addItems(withTitles: screenlist.enumerated().map { index, source in
+            let name = source.sourceName.isEmpty ? "Screen \(index + 1)" : source.sourceName
+            return "\(name)(\(source.sourceId))"
+        })
     }
     var isScreenSharing: Bool = false {
         didSet {
@@ -109,7 +113,7 @@ class LocalVideoTranscoding: BaseViewController {
         params.highLightWidth = 5
         params.highLightColor = .green
         params.highLighted = true
-        let result = agoraKit.startScreenCapture(byDisplayId: UInt32(screen.id), regionRect: .zero, captureParams: params)
+        let result = agoraKit.startScreenCapture(byDisplayId: UInt32(screen.sourceId), regionRect: .zero, captureParams: params)
 
         if result == 0 {
             isScreenSharing = true
@@ -248,8 +252,6 @@ class LocalVideoTranscoding: BaseViewController {
 
     override func viewDidLoad() {
         super.viewDidLoad()
-        // prepare window manager and list
-        windowManager.getList()
         // Do view setup here.
         let config = AgoraRtcEngineConfig()
         config.appId = KeyCenter.AppId

macOS/APIExample/Examples/Advanced/LocalVideoTranscoding/LocalVideoTranscoding.swift

@@ -95,7 +95,7 @@ All examples share utilities from `APIExample/Common/`:
 | CustomVideoSourcePushMulti | `Examples/Advanced/CustomVideoSourcePushMulti/` | `setExternalVideoSource()`, `pushVideoFrame()` with multiple sources | Multiple custom video sources |
 | JoinMultiChannel | `Examples/Advanced/JoinMultiChannel/` | `createRtcChannel()`, `joinChannel()` on multiple channels | Join and manage multiple channels simultaneously |
 | LiveStreaming | `Examples/Advanced/LiveStreaming/` | `setClientRole()`, `addVideoWatermark()` with `WatermarkConfig`, `startRtmpStreamWithTranscoding()`, `stopRtmpStream()` | Live streaming with watermark configuration and RTMP transcoding |
-| LocalVideoTranscoding | `Examples/Advanced/LocalVideoTranscoding/` | `startLocalVideoTranscoding()`, `updateLocalTranscodingConfig()`, `stopLocalVideoTranscoding()` | Local video transcoding and composition |
+| LocalVideoTranscoding | `Examples/Advanced/LocalVideoTranscoding/` | `getScreenCaptureSources()`, `startLocalVideoTranscoder()`, `updateLocalTranscoderConfiguration()`, `stopLocalVideoTranscoder()` | Local video transcoding and composition |
 | MediaPlayer | `Examples/Advanced/MediaPlayer/` | `createMediaPlayer()`, `open()`, `play()`, `pause()`, `stop()` | Media file playback and control |
 | MultiCameraSourece | `Examples/Advanced/MultiCameraSourece/` | `enumerateDevices()`, `setDevice()` with multiple cameras | Multiple camera source selection |
 | Multipath | `Examples/Advanced/Multipath/` | `enableMultipath()`, `setMultipathConfig()` | Multipath redundancy for reliability |

macOS/ARCHITECTURE.md

@@ -1,4 +1,5 @@
-# Uncomment the next line to define a global platform for your project
+macos_deployment_target = '12.0'
+platform :osx, macos_deployment_target
 
 
 def common_pods
@@ -24,7 +25,10 @@ post_install do |installer|
   # system("sh .download_script.sh 4.7.0 true")
   installer.pods_project.targets.each do |target|
     target.build_configurations.each do |config|
-      config.build_settings['MACOSX_DEPLOYMENT_TARGET'] = '10.13'
+      deployment_target = config.build_settings['MACOSX_DEPLOYMENT_TARGET']
+      if deployment_target.nil? || Gem::Version.new(deployment_target) < Gem::Version.new(macos_deployment_target)
+        config.build_settings['MACOSX_DEPLOYMENT_TARGET'] = macos_deployment_target
+      end
     end
   end
 end

macOS/Podfile

@@ -7,7 +7,8 @@ This project presents you a set of API examples to help you understand how to us
 
 ## Prerequisites
 
-- Xcode 13.0+
+- macOS 12.0 or later
+- Xcode 13.1+
 
 ## Quick Start