個人開発 » Ferrhythm

実装に着手しました。

• ブランチ: feature/354-wasapi-asio-output
• 対応方針: 出力バックエンドを trait（OutputBackend/RunningOutput）で抽象化し、#[cfg(windows)] の WASAPI 排他・イベント駆動出力（専用 Pro Audio スレッドが AudioEngine を駆動）を実装。排他不可時は共有モードへ自動フォールバック、既定エンドポイントのみ対応、IAudioClock でサンプルクロックのドリフト照合。ASIO は asio feature ゲートの seam（stub）のみ用意し実装は後続チケットへ分離。

対応が完了しました。

概要¶

RT ミキサ（#353）の出力を実デバイスへ接続。プラットフォーム非依存の出力バックエンド trait seam（OutputBackend/RunningOutput）を導入し、Windows で WASAPI 排他・イベント駆動出力（既定エンドポイント）を実装。排他不可時は共有イベント駆動モードへ自動フォールバックする。

変更点¶

• device.rs（新規・非依存）: OutputBackend/RunningOutput trait、OutputConfig/ShareModePref/DeviceFormat/AudioError、純ヘルパ convert（f32/i16 書込・HNS 換算、Linux テスト）。
• wasapi.rs（新規・#[cfg(windows)]）: 専用「Pro Audio」スレッドが AudioEngine を所有しイベント毎に engine.render を駆動。フォーマット交渉（float32→pcm16）・アラインリトライ・共有時 GetMixFormat・preroll・IAudioClock ドリフト照合。
• asio.rs（新規・#[cfg(feature="asio")]）: Unsupported を返す seam stub（実装本体は #372 へ分離）。
• examples/wasapi_play.rs（新規・Windows 限定）: 実機検証ハーネス。
• Cargo.toml（asio feature・Windows 限定 windows 0.58）/ lib.rs（モジュール・再エクスポート・ドキュメント）/ Cargo.lock。
• 変更ファイル: crates/ferrhythm-audio/src/{device,wasapi,asio,lib}.rs・examples/wasapi_play.rs・Cargo.toml ほか計 7 件。

テスト¶

• cargo test --locked（workspace 全体）: 成功（ferrhythm-audio 31 件、うち新規 device 6 件。全クレート緑）
• cargo clippy --all-targets --locked -- -D warnings / cargo fmt --all -- --check: 成功
• Windows FFI 型検査: cargo check/cargo clippy --all-features（--target x86_64-pc-windows-gnu）成功
• Windows ホスト実機検証（ユーザー）: 3 パターン（排他クリック・排他 WAV・共有 WAV）すべて正常。排他=48000Hz/16bit/128frames（2.667ms）、共有フォールバック=32bit float/1056frames（22ms）/exclusive=false を確認。発音・連続性 OK、sample-clock drift ログなし（サンプルクロック同期成立）、クリーン終了。

関連 MR¶

• !14 (feature/354-wasapi-asio-output → develop、マージ済み)

残課題 / 分離チケット¶

• #372: ASIO 出力バックエンド実装（asio-sys、trait seam に実装を追加）
• #373: WASAPI follow-up（CoUninitialize 未呼出し・RT 診断ログの整理、非ブロッカー）