SFBAudioEngine Files

SFBAudioEngine 0.12.1 Release Notes (2026-02-27)

What’s Changed

• Performance/Debug logging

• Short-circuit audio processing graph logging when the specified os_log type is disabled. (PR [#876])

• Decoders (FLAC)

• Return SFBUnknownFrameLength when FLAC total_samples is 0 (instead of reporting an invalid length). (PR [#877])

• Seeking robustness

• Strengthen seek parameter validation:

  • Reject non-finite values (NaN/±Inf) for seek-by-time and seek-by-position
  • Add overflow/underflow guards when converting time deltas to frame offsets
  • Centralize clamped seek behavior and avoid unnecessary seeks when already at target frame (PR #884)

• Swift API improvements

• Add Equatable conformance to PlaybackPosition and PlaybackTime. (PR [#880])

• Improve validity semantics and helpers:

  • Introduce “partially valid” concepts for position/time
  • Make progress/remaining behave sensibly when totals are 0 or values are invalid (PR #879)

• Documentation

• Improve documentation for playback position/time types and Swift extensions, including clarifying “unknown” vs “invalid” behavior. (PRs [#881], [#882])

Full Changelog

https://github.com/sbooth/SFBAudioEngine/compare/0.12.0...0.12.1

Included Pull Requests

• [#876] Short circuit processing graph logging if disabled
• [#877] Return SFBUnknownFrameLength if total_samples is 0
• [#879] Improve validity checks for position and time
• [#880] Add Equatable conformance to PlaybackPosition and PlaybackTime
• [#881] Improve documentation for position and time
• [#882] Update documentation for Swift position and time extensions
• [#884] Improve verification of seek parameters