GitHub 오픈소스 탐험

최근 음악 스트리밍 서비스의 발전과 개인의 음악 관리 필요성으로 인해, 사용자 친화적인 음악 관리 애플리케이션에 대한 수요가 증가하고 있습니다. 이러한 요구를 충족시키기 위해 Music Assistant Mobile App이 개발되었습니다. 이 앱은 Kotlin Multiplatform(KMP) 및 Compose Multiplatform 프레임워크를 사용하여 개발된 크로스 플랫폼 모바일 애플리케이션으로, Android 및 iOS에서 일관된 음악 관리 경험을 제공합니다. 이번 글에서는 이 프로젝트의 주요 기능과 설치 방법, 기본 사용법에 대해 자세히 알아보겠습니다.

주요 기능 및 특징

1. 크로스 플랫폼 지원

이 앱은 Android와 iOS 모두에서 사용할 수 있으며, 각각의 플랫폼에 맞춘 최적화된 사용자 경험을 제공합니다. Android의 경우 Android 8.0 이상, iOS의 경우 iOS 18.5 이상이 필요합니다.

2. 세밀한 음악 관리

재생 목록 관리: 사용자는 Music Assistant의 플레이어 큐 및 재생을 손쉽게 관리할 수 있습니다.
그룹 관리: 동적 및 정적 그룹 관리를 지원하여 다양한 플레이어를 그룹화하여 음악을 즐길 수 있습니다.
로컬 재생: MA 라이브러리에서 직접 음악을 재생할 수 있는 기능을 제공합니다. WebRTC 또는 WebSocket을 통한 Sendspin 스트리밍 프로토콜을 사용합니다.

3. 다양한 설정 옵션

설정 화면: 서버 연결, 인증(내장/OAuth), 로컬 플레이어 설정을 위한 섹션 기반 UI를 제공합니다.
백그라운드 재생 및 알림: Android에서는 백그라운드 재생과 시스템 영역의 미디어 알림을 통해 빠른 접근이 가능합니다.

4. Apple CarPlay 및 Android Auto 지원

이 앱은 Apple CarPlay와 Android Auto를 지원하여 차량에서도 쉽게 음악을 즐길 수 있도록 설계되었습니다. 음성 명령을 통해 간편하게 플레이어 제어가 가능합니다.

설치 및 기본 사용법

1. 설치 준비

먼저, GitHub에서 프로젝트를 클론합니다. 터미널에서 다음 명령어를 실행하세요.

git clone https://github.com/music-assistant/mobile-app.git

2. 의존성 설치

프로젝트 폴더로 이동한 후, 필요한 의존성을 설치합니다. Kotlin Multiplatform을 사용하는 만큼, Gradle을 통해 간편하게 설치할 수 있습니다.

cd mobile-app
./gradlew build

3. 실행하기

Android Studio 또는 Xcode에서 해당 프로젝트를 열고, Android 또는 iOS 에뮬레이터에서 실행할 수 있습니다. Android의 경우, AVD가 설정되어 있어야 하며, iOS는 Xcode가 필요합니다.

4. 기본 사용 예시

앱이 실행되면, 메인 화면에서 현재 재생 중인 곡과 플레이어 정보를 볼 수 있습니다. 아래는 재생 제어에 대한 기본 코드 예제입니다.

// 재생 및 일시 정지 기능
fun togglePlayback(player: MusicPlayer) {
    if (player.isPlaying) {
        player.pause()
    } else {
        player.play()
    }
}

5. 실제 활용 시나리오

개인 음악 관리: 사용자는 자신의 음악 라이브러리를 효율적으로 관리하고, 다양한 플레이어에 연결하여 음악을 감상할 수 있습니다.
자동차에서의 음악 감상: 차량에서 음성 명령을 통해 음악을 재생하고, 운전 중에도 안전하게 음악을 즐길 수 있습니다.

유사 도구와의 비교

이 앱은 Spotify, Apple Music과 같은 기존의 스트리밍 서비스와는 다릅니다. Music Assistant는 개인의 음악 라이브러리를 관리하고 여러 플랫폼에서 통합된 경험을 제공하는 데 집중하고 있습니다. 반면, Spotify와 Apple Music은 주로 클라우드 기반으로 음악을 스트리밍하는 서비스입니다.

크로스 플랫폼 음악 관리의 혁신, Music Assistant Mobile App