add visionos support

Author: fulldecent

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [5.1.1](https://github.com/fulldecent/FDWaveformView/releases/tag/5.1.1)
+
+Released on 2025-12-06.
+
+### Added
+
+- visionOS 1.0+ support with proper screen scale handling
+
+---
+
 ## [5.1.0](https://github.com/fulldecent/FDWaveformView/releases/tag/5.1.0)
 
 Released on 2025-12-06.

Example/Example.xcodeproj/project.pbxproj

@@ -292,6 +292,9 @@
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
 				DEVELOPMENT_TEAM = 8Q693ZG5RN;
+				ENABLE_APP_SANDBOX = YES;
+				ENABLE_HARDENED_RUNTIME = YES;
+				ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES;
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
@@ -307,9 +310,14 @@
 				MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = net.phor.Example;
 				PRODUCT_NAME = "$(TARGET_NAME)";
+				REGISTER_APP_GROUPS = YES;
+				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator xros xrsimulator";
+				SUPPORTS_MACCATALYST = NO;
+				SUPPORTS_MAC_DESIGNED_FOR_IPHONE_IPAD = NO;
+				SUPPORTS_XR_DESIGNED_FOR_IPHONE_IPAD = NO;
 				SWIFT_EMIT_LOC_STRINGS = YES;
 				SWIFT_VERSION = 5.0;
-				TARGETED_DEVICE_FAMILY = "1,2";
+				TARGETED_DEVICE_FAMILY = "1,2,7";
 			};
 			name = Debug;
 		};
@@ -321,6 +329,9 @@
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
 				DEVELOPMENT_TEAM = 8Q693ZG5RN;
+				ENABLE_APP_SANDBOX = YES;
+				ENABLE_HARDENED_RUNTIME = YES;
+				ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES;
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
@@ -336,9 +347,14 @@
 				MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = net.phor.Example;
 				PRODUCT_NAME = "$(TARGET_NAME)";
+				REGISTER_APP_GROUPS = YES;
+				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator xros xrsimulator";
+				SUPPORTS_MACCATALYST = NO;
+				SUPPORTS_MAC_DESIGNED_FOR_IPHONE_IPAD = NO;
+				SUPPORTS_XR_DESIGNED_FOR_IPHONE_IPAD = NO;
 				SWIFT_EMIT_LOC_STRINGS = YES;
 				SWIFT_VERSION = 5.0;
-				TARGETED_DEVICE_FAMILY = "1,2";
+				TARGETED_DEVICE_FAMILY = "1,2,7";
 			};
 			name = Release;
 		};

Package.swift

@@ -6,8 +6,8 @@ import PackageDescription
 let package = Package(
   name: "FDWaveformView",
   platforms: [
-    .iOS(.v13),
-    .macOS(.v10_14),
+    .iOS(.v15),
+    .visionOS(.v1),
   ],
   products: [
     // Products define the executables and libraries a package produces, making them visible to other packages.

README.md

@@ -65,7 +65,7 @@ UIView.animate(withDuration: 0.3) {
 
 - Antialiased waveforms draw extra pixels to avoid jagged edges.
 - Autolayout-driven size changes trigger re-rendering to prevent pixelation.
-- Supports iOS 12+ and Swift 5.
+- Supports iOS 15+ and visionOS 1.0+.
 - Includes unit tests running on GitHub Actions.
 
 ## Installation

Sources/FDWaveformView/FDWaveformAudioDataSource.swift

@@ -9,43 +9,52 @@ import Foundation
 final class FDWaveformAudioDataSource: FDWaveformDataSource {
     private let audioURL: URL
     private let asset: AVAsset
-    private let assetTrack: AVAssetTrack?
-    private let sampleRate: Int
-    private let channelCount: Int
-    private let cachedTotalSamples: Int
+    private var assetTrack: AVAssetTrack?
+    private var sampleRate: Int = 44100
+    private var channelCount: Int = 1
+    private var cachedTotalSamples: Int = 0
+    private var isLoaded: Bool = false
 
     init(audioURL: URL) {
         self.audioURL = audioURL
         self.asset = AVAsset(url: audioURL)
+    }
 
-        // Get the audio track and its properties
-        let tracks = asset.tracks(withMediaType: .audio)
-        self.assetTrack = tracks.first
-
-        if let track = assetTrack,
-            let formatDescriptions = track.formatDescriptions as? [CMAudioFormatDescription],
-            let formatDesc = formatDescriptions.first,
-            let streamDesc = CMAudioFormatDescriptionGetStreamBasicDescription(formatDesc)
-        {
-            self.sampleRate = Int(streamDesc.pointee.mSampleRate)
-            self.channelCount = Int(streamDesc.pointee.mChannelsPerFrame)
-
-            // Calculate total samples from duration
-            let duration = asset.duration
-            let durationInSeconds = CMTimeGetSeconds(duration)
-            self.cachedTotalSamples = Int(durationInSeconds * Double(sampleRate))
-        } else {
-            self.sampleRate = 44100
-            self.channelCount = 1
-            self.cachedTotalSamples = 0
+    /// Loads audio track properties asynchronously. Called automatically on first access.
+    private func loadTrackIfNeeded() async {
+        guard !isLoaded else { return }
+        isLoaded = true
+
+        do {
+            let tracks = try await asset.loadTracks(withMediaType: .audio)
+            self.assetTrack = tracks.first
+
+            if let track = assetTrack,
+                let formatDescriptions = try? await track.load(.formatDescriptions)
+                    as? [CMAudioFormatDescription],
+                let formatDesc = formatDescriptions.first,
+                let streamDesc = CMAudioFormatDescriptionGetStreamBasicDescription(formatDesc)
+            {
+                self.sampleRate = Int(streamDesc.pointee.mSampleRate)
+                self.channelCount = Int(streamDesc.pointee.mChannelsPerFrame)
+
+                // Calculate total samples from duration
+                let duration = try await asset.load(.duration)
+                let durationInSeconds = CMTimeGetSeconds(duration)
+                self.cachedTotalSamples = Int(durationInSeconds * Double(sampleRate))
+            }
+        } catch {
+            // Keep default values on error
         }
     }
 
     func numberOfSamples() async -> Int {
+        await loadTrackIfNeeded()
         return cachedTotalSamples
     }
 
     func samples(in range: Range<Int>) async -> [Float] {
+        await loadTrackIfNeeded()
         guard !range.isEmpty, let track = assetTrack else { return [] }
 
         guard let reader = try? AVAssetReader(asset: asset) else { return [] }
@@ -124,6 +133,7 @@ final class FDWaveformAudioDataSource: FDWaveformDataSource {
     }
 
     func maximums(from range: Range<Int>, numberOfBins: Int) async -> [Float] {
+        await loadTrackIfNeeded()
         guard !range.isEmpty, numberOfBins > 0, let track = assetTrack else { return [] }
 
         guard let reader = try? AVAssetReader(asset: asset) else { return [] }

Sources/FDWaveformView/FDWaveformRenderOperation.swift

@@ -17,14 +17,23 @@ struct FDWaveformRenderFormat {
   /// The scale factor to apply to the rendered image (usually the current screen's scale)
   var scale: CGFloat
 
+  /// Default scale factor for rendering
+  private static var defaultScale: CGFloat {
+    #if os(visionOS)
+      return 2.0
+    #else
+      return UIScreen.main.scale
+    #endif
+  }
+
   init(
     type: FDWaveformView.WaveformType = .linear,
     wavesColor: UIColor = .black,
-    scale: CGFloat = UIScreen.main.scale
+    scale: CGFloat? = nil
   ) {
     self.type = type
     self.wavesColor = wavesColor
-    self.scale = scale
+    self.scale = scale ?? Self.defaultScale
   }
 }
 

Sources/FDWaveformView/FDWaveformView.swift

@@ -192,7 +192,11 @@ open class FDWaveformView: UIView {
 
   /// Desired scale of image based on window's screen scale
   private var desiredImageScale: CGFloat {
-    return window?.screen.scale ?? UIScreen.main.scale
+    #if os(visionOS)
+      return 2.0
+    #else
+      return window?.screen.scale ?? UIScreen.main.scale
+    #endif
   }
 
   /// Represents the status of the waveform renderings