Repository navigation
MusicSync v0.10.2 — Web & multi-platform apps
한국어
Android 재생 끊김, 변동하는 출력 시각 및 네트워크 혼잡 시 연결 종료를 줄이기 위한 패치입니다. v0.10.1의 Windows WASAPI 출력 개선도 포함합니다. 실제 스피커 간 시간차 개선 여부는 기기 재시험이 필요합니다.
- Android 오디오 스레드 우선순위를 높이고 실제 AudioTrack 버퍼 크기와 하드웨어 timestamp를 사용합니다.
- underrun 발생 시 출력 버퍼를 단계적으로 늘리고, 쓰기 완료 프레임과 재생 프레임으로 출력 경로의 대기 시간을 추정합니다.
- 패킷 sequence 누락과 AudioTrack underrun을 adaptive buffer에 반영합니다.
- 활성 세션에서 CPU/Wi-Fi 절전 영향을 줄이도록 wake/Wi-Fi locks를 사용합니다. Android OS의 적용 조건에 따라 효과는 달라질 수 있습니다.
- 전송 큐가 밀리면 오래된 오디오를 버리거나 새 오디오 전송을 생략하여 큐를 제한합니다. 오디오 혼잡만으로 연결을 종료하지 않으며 인증·제어 메시지는 보존합니다. 실제 소켓 종료, 인증 실패 및 제어 큐 한도 초과는 여전히 연결을 종료합니다.
- 일시적인 정체에 대한 heartbeat 제한은 10초입니다. SocketException 로그에 단계와 OS 오류 메시지를 표시합니다.
버전: Android/Windows/Linux 0.9.2 · Build 14, Apple 0.8.1 · Build 12, 웹 0.10.0.
재시험: APK/호스트 앱을 함께 갱신하고 화면의 버전을 확인하세요. 먼저 내장/유선 스피커에서 비교하세요. 문제가 남으면 Android 모델/OS, 호스트 종류, 출력 장치, 앞서거나 늦는 정도, 연결 직전의 로그를 함께 보내 주세요. CI의 Android debug 서명 키는 빌드 사이에 달라질 수 있어 기존 설치에 업데이트가 거부되면 제거 후 설치가 필요할 수 있으며 앱 데이터·페어링이 삭제됩니다.
시스템 오디오 monitor capture는 원래 호스트 소리를 지연시키지 않습니다. 그 원음과 수신음을 비교할 때는 여전히 차이가 날 수 있습니다. WAV 파일 호스트 출력은 MusicSync의 예약 재생 타임라인을 사용합니다. Bluetooth/드라이버가 보고하지 않는 지연과 실제 음향 정렬은 CI로 검증할 수 없습니다.
Unsigned iOS IPA, ad-hoc 서명·미공증 macOS, CI debug 서명 Android 및 웹의 개인 LAN CA 설정 요구사항은 그대로입니다. MIT 라이선스와 SHA256SUMS.txt를 포함합니다.
English
Android playback and transport stability patch, including the Windows WASAPI renderer from v0.10.1. Android uses audio thread priority, actual AudioTrack buffer size/timestamps, adaptive growth on underruns and submitted-versus-presented frame backlog estimates. Missing sequences and output underruns feed the shared adaptive buffer. Active sessions hold CPU/Wi-Fi locks, subject to Android's operating conditions.
Bounded audio queues shed audio under congestion while preserving authentication/control messages, rather than disconnecting solely for audio pressure. Real socket/authentication failures and control queue exhaustion still close connections. Heartbeat timeout is 10 seconds; socket diagnostics include the phase and OS reason.
Ports are 0.9.2 build 14; Apple is 0.8.1 build 12; web remains 0.10.0. Update both endpoints and confirm versions. Physical speaker alignment, Bluetooth latency and device-specific stability require hardware retesting. Original monitor-captured host audio remains undelayed. Installation/signing requirements are unchanged; replacing a differently debug-signed APK may require uninstalling and losing app data/pairings.
Verification / 검증
Application source: 0b4e303690a29526f6a2e188298a5644e8f2649d. Release automation verifies source equality before packaging CI binaries. Local Swift core tests: 36 passed, including congested audio/control delivery.