프로젝트 소개

AF Media Bar는 Windows 10/11용 휴대용 작업 표시줄 미디어 컨트롤러로, 시스템 미디어 세션에서 재생 중인 콘텐츠를 읽어 앨범 커버, 가사, 재생 컨트롤 및 오디오 장치 전환을 데스크톱 가장자리에 유지합니다. 주요 기능 - 음악 제어: 이전 곡, 재생/일시정지, 다음 곡, 반복, 클릭 또는 드래그로 진행 표시줄 이동. - 작업 표시줄 가사: 웹 가사 엔진으로 실시간 가사 표시, 번역, 음역 및 두 줄 정렬 지원, NetEase Cloud Music, LRCLIB, QQ Music, Kugou Music, Qishui Music 순서로 매칭. - 소스 및 상호작용: 미디어 세션 전환; 커버, 제목 및 가사 클릭 동작을 각각 재생/일시정지, 미디어 앱 복귀 또는 전체 메뉴 열기로 설정 가능. - 오디오 및 시스템: 클릭 또는 휠로 기본 출력 장치 전환, 현재 미디어 앱 볼륨 조정, 공간 음향 확인, 네 가지 스펙트럼 스타일 및 성능 감지 구성 요소 제공. - 레이아웃 및 외관: 작업 표시줄 아이콘 및 시스템 영역 자동 회피, 대상 화면 선택 가능, 재생 없음 시 자동 숨김, 글꼴, 테마 색상 및 창 재질 조정 가능. - 빠른 작업: 호버 시 제어 버튼 표시, 전체 레이어에서 더 많은 정보 표시, 음표 아이콘으로 빠른 실행 목록 열기. 설치 및 실행 설치 프로그램과 휴대용 버전 두 가지 배포 패키지를 제공하며, 둘 다 .NET 런타임을 포함합니다. 설치 버전은 기본적으로 %LOCALAPPDATA%\Programs\AFMediaBar에 설치되며, 프로그램 내 업데이트 확인, 다운로드 및 설치를 지원합니다. 휴대용 버전은 레지스트리를 쓰지 않으며, 업데이트 시 파일을 수동으로 교체합니다. 시스템 요구 사항은 Windows 10 1809(빌드 17763) 이상 x64 시스템이며, Microsoft Edge WebView2 Runtime이 필요합니다. 프로그램은 아직 상업용 코드 서명이 없어 첫 실행 시 SmartScreen 경고가 나타날 수 있습니다. 작동 방식 독립 WPF 프로세스로 실행되며, 미디어 바를 작업 표시줄 하위 창으로 마운트하고, Windows 공개 GSMTC 인터페이스를 사용하여 미디어 세션을 읽고, Core Audio로 장치 및 볼륨을 처리하며, explorer.exe를 수정하거나 코드를 주입하지 않습니다. Windows에 GSMTC 미디어 세션을 게시하는 플레이어만 표시되며, 일부 플레이어는 자체 설정에서 시스템 미디어 제어 또는 미디어 키를 활성화해야 합니다. 현재 작업 표시줄 실행 모드만 있으며, 설정의 Dynamic Island, 데스크톱 카드, 플로팅 볼은 자리 표시자 옵션입니다. 개인정보 및 보안 원격 측정, 광고, 계정 시스템 또는 네트워크 분석 코드가 포함되어 있지 않으며, 미디어 정보, 시스템 지표 및 볼륨 작업은 모두 로컬에서 처리됩니다. 업데이트 확인은 두 개의 공개 매니페스트 엔드포인트만 요청합니다. 가사는 현재 미디어 정보를 기반으로 다섯 소스의 공개 인터페이스에 요청하며, 곡명, 가수, 앨범 및 길이만 전송합니다. 프로그램은 현재 사용자 권한으로 실행되며 관리자 권한을 요청하지 않습니다. 빌드 및 프로젝트 구조 Windows 10 1809 이상, .NET 10 SDK 및 PowerShell이 필요하며, 저장소는 global.json을 통해 지원되는 SDK 기능 밴드를 고정합니다. 소스 코드에는 WPF 앱 메인 프로젝트(계층화된 비즈니스 코드, 재사용 가능한 컨트롤, 테마 스타일 및 3개 언어 텍스트, MVVM 뷰 모델 및 페이지), 레이아웃 테스트 프로젝트, 아키텍처 정적 검사 스크립트, Inno Setup 설치 스크립트 및 문서 디렉터리가 포함됩니다. 라이선스 및 감사 프로젝트는 MIT License로 오픈소스이며, FluentFlyout, Lyricify-Lyrics-Helper, TaskbarLyrics 등의 오픈소스 프로젝트에 감사를 표합니다.