# Mingle Audio 0.3.7

Windows x64 소프트웨어 프리뷰 릴리즈입니다. ASIO를 사용하는 독립 오디오 앱이며 Face/카메라 앱은 필요하지 않습니다.

## 다운로드

- [설치 파일](https://kindnick-git.duckdns.org/api/packages/mingle/generic/mingle-audio-desktop/0.3.7/Mingle%20Audio_0.3.7_x64-setup.exe)
- [포터블 ZIP](https://kindnick-git.duckdns.org/api/packages/mingle/generic/mingle-audio-desktop/0.3.7/MingleAudio-0.3.7-win64.zip)
- [SHA-256](https://kindnick-git.duckdns.org/api/packages/mingle/generic/mingle-audio-desktop/0.3.7/SHA256SUMS.txt)

설치 파일에는 엔진·네이티브 DLL·S3 0.2.2 펌웨어·Microsoft WebView2 오프라인 설치 파일이 포함됩니다. 포터블은 ZIP 전체를 풀고 `MingleAudio/MingleAudio.exe`를 실행합니다. 포터블 실행 PC에는 WebView2 Runtime과 믹서 제조사의 ASIO 드라이버가 필요합니다. 설치형도 ASIO 드라이버는 별도로 설치해야 합니다.

앱 설치만으로 보드 펌웨어를 쓰거나 오디오를 시작하지 않습니다. 펌웨어 갱신은 앱에서 별도로 실행합니다. 이번 배포는 수동 다운로드 방식이며 자동 업데이트 채널 변경은 없습니다. 앱 설치 파일은 Windows Authenticode 서명이 없는 상태입니다.

## 주요 변경

- COM 연결 확인에서 장치 읽기와 무선 제어 등록을 함께 수행합니다.
- Wi-Fi 검색·저장 후 같은 송신기의 재연결을 확인합니다.
- 출연자 추가/수정에서 USB 연결 또는 무선 장치 찾기로 IP와 장치 ID를 입력합니다.
- 미저장 설정은 저장 성공 후 오디오를 시작하며, 미등록 장치는 ASIO를 열기 전에 안내합니다.
- 좁은 창과 설정 팝업의 배치·스크롤·하단 버튼을 개선했습니다.
- 손상된 설정/페어링/프리셋 처리, 제어 대기 중 상태 조회, ASIO/UDP 작업 스레드 시작 실패와 PCM 극값 처리를 보강했습니다.
- **48 kHz / PCM16을 유지합니다.** 24비트 카드로 교체해도 자동으로 전송 형식이 바뀌지 않습니다.

## 검증 범위

앱 실행 코드는 `8a1fe52995b065b946c0fda0554c0153f685e78f` 빌드입니다. 이번 릴리즈 정리는 문서에 한정하며 설치 EXE는 기존 검증된 파일을 유지합니다. 포터블에는 최신 안내 문서를 포함합니다.

기존 코드 검증: Python 249 passed / 1 skipped, React 53 passed, TypeScript 검사, C++ CTest 5/5, frozen 엔진 루프백/API/종료 및 C5 호환 검사를 통과했습니다. 브라우저에서 등록·저장·시작·정지와 작은 창의 팝업을 검증했습니다.

S3 0.2.2 + Audient ASIO의 약 23초 시험에서 마이크 수신·모니터 반환·정지를 확인했습니다. 다만 워밍업 후 20초 동안 무선 지터 버퍼 누락 프레임 946개와 늦은 패킷 3개가 관측됐습니다. 무선 무손실, 장시간/다중 송신기 운용, 전체 음향 지연, 새 PC 설치를 보장하는 결과는 아닙니다.

자세한 사용법은 [빠른 시작](https://kindnick-git.duckdns.org/mingle/MFT/src/commit/f622269212b173599de31709c638f8fefd9dcea8/docs/MINGLE_AUDIO_QUICKSTART_KO.md), 변경과 실기 결과는 [코드 리뷰](https://kindnick-git.duckdns.org/mingle/MFT/src/commit/f622269212b173599de31709c638f8fefd9dcea8/docs/MINGLE_AUDIO_CODE_REVIEW_2026-09-14.md)를 참고하세요.

릴리즈 소스: `f622269212b173599de31709c638f8fefd9dcea8`