[AudioToolbox] Bind new Xcode 27 AudioToolbox APIs. - #25811
Conversation
Bind the missing AudioToolbox APIs reported by xtro-sharpie: * AUReverbRoomType.OutdoorGeneral (kReverbRoomType_OutdoorGeneral = 24) on iOS, tvOS, macOS and Mac Catalyst. * AUHeadTrackingBinauralRenderer (an AUAudioUnit subclass) and its three readonly properties (HeadTracking, Disabled, DeviceUID) on iOS. AUHeadTrackingBinauralRenderer re-exposes the base AUAudioUnit designated initializer as an [Internal] init plus a manual Create factory (guarded for iOS-only), mirroring AVCaptureEventSound, so it satisfies both the introspection DesignatedInitializer test and the cecil NoConstructorsWithOutErrorArguments test. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
This PR updates the AudioToolbox/AudioUnit bindings to cover newly introduced Xcode 27 APIs and clears the corresponding xtro-sharpie .todo reports.
Changes:
- Added
AUReverbRoomType.OutdoorGeneral(native value24) with Xcode 27 availability across iOS/tvOS/macOS/Mac Catalyst. - Added the iOS-only
AUHeadTrackingBinauralRendererbinding (includingHeadTracking,Disabled, andDeviceUID) plus an iOS-onlyCreatefactory that re-exposes the designated initializer via an[Internal]init. - Removed the now-resolved xtro-sharpie
AudioToolbox.todoentries and updated introspection matching for the factory-based constructor exposure.
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| tests/xtro-sharpie/api-annotations-dotnet/tvOS-AudioToolbox.todo | Removed resolved xtro-sharpie todo entry for the new enum value. |
| tests/xtro-sharpie/api-annotations-dotnet/macOS-AudioToolbox.todo | Removed resolved xtro-sharpie todo entry for the new enum value. |
| tests/xtro-sharpie/api-annotations-dotnet/MacCatalyst-AudioToolbox.todo | Removed resolved xtro-sharpie todo entry for the new enum value. |
| tests/xtro-sharpie/api-annotations-dotnet/iOS-AudioToolbox.todo | Removed resolved xtro-sharpie todo entries for the new type/selectors/enum value. |
| tests/introspection/ApiCtorInitTest.cs | Added a constructor match exception for AUHeadTrackingBinauralRenderer to align with the factory-based exposure pattern. |
| src/frameworks.sources | Included the new manual partial factory source in AUDIOUNIT_SOURCES. |
| src/AudioUnit/AUHeadTrackingBinauralRenderer.cs | Added the iOS-only Create factory wrapper around the internal designated initializer. |
| src/AudioUnit/AUEnums.cs | Added AUReverbRoomType.OutdoorGeneral = 24 with Xcode 27 availability attributes. |
| src/audiounit.cs | Added the AUHeadTrackingBinauralRenderer binding definition and its exported properties. |
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
Co-authored-by: Rolf Bjarne Kvinge <rokvin@microsoft.com>
✅ [PR Build #6c4a1a6] Build passed (Detect API changes) ✅Pipeline on Agent |
This comment has been minimized.
This comment has been minimized.
✅ [PR Build #6c4a1a6] Build passed (Build packages) ✅Pipeline on Agent |
✅ API diff for current PR / commitNET (empty diffs)✅ API diff vs stableNET (empty diffs)ℹ️ Generator diffGenerator Diff: vsdrops (html) vsdrops (raw diff) gist (raw diff) - Please review changes) Pipeline on Agent |
✅ [PR Build #6c4a1a6] Build passed (Build macOS tests) ✅Pipeline on Agent |
This comment has been minimized.
This comment has been minimized.
🚀 [CI Build #6c4a1a6] Test results 🚀Test results✅ All tests passed on VSTS: test results. 🎉 All 200 tests passed 🎉 Tests counts✅ assembly-processing: All 1 tests passed. Html Report (VSDrops) Download macOS tests✅ Tests on macOS Sonoma (14): All 5 tests passed. Html Report (VSDrops) Download Linux Build VerificationPipeline on Agent |
Merge the stashed macios-binding-creator skill work (Xcode 27 xtro/cecil/introspection accuracy from three real binding sessions) onto the rebased branch, which had already committed two other 2026-07-01 sessions (xkit.cs consolidation + runtime-only protocol conformance). 3-way merge against the clean common base preserves all three sessions with no content lost either way. Also fixes two claims in the session-3 content that went stale after the branch's main-merge pulled in their source PRs (#25811, #25828): - AUHeadTrackingBinauralRenderer is now a real factory-variant type; the illustrative plain-Constructor example is renamed to MySpatialAudioUnit and the real type is cited as a factory precedent. - iOSApiSelectorTest.cs already has a Skip(Type,string) override, so the selector-skip guidance now says to extend it (adding a second override would be CS0111), citing the AVAssetWriter precedent. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Bind the missing AudioToolbox APIs reported by xtro-sharpie:
AUHeadTrackingBinauralRenderer re-exposes the base AUAudioUnit designated initializer as an [Internal] init plus a manual Create factory (guarded for iOS-only), mirroring AVCaptureEventSound, so it satisfies both the introspection DesignatedInitializer test and the cecil NoConstructorsWithOutErrorArguments test.