Build a professional-grade And…

# Kotlin 安卓音乐播放器开发方案

一、核心架构与技术选型

• 语言：Kotlin + 协程
• 架构：MVVM（ViewModel + LiveData/Flow）
• 播放：Media3 (ExoPlayer)，适配 Android 13 推荐
• 数据库：Room 管理歌单
• UI：单 Activity + Fragment，RecyclerView 展示列表

二、权限配置（AndroidManifest.xml）

```xml

<uses-permission android:name="android.permission.READ_MEDIA_AUDIO"/>

<application>

<service android:name=".PlayerService"

android:foregroundServiceType="mediaPlayback"/>

</application>

```

Android 13 起读取音频需 READ_MEDIA_AUDIO 运行时授权；后台播放需申请 POST_NOTIFICATIONS 和前台服务权限。

三、本地 MP3 扫描（MediaStore）

```kotlin

fun scanAudios(context: Context): List<Song> {

val list = mutableListOf<Song>()

val proj = arrayOf(MediaStore.Audio.Media._ID,

MediaStore.Audio.Media.TITLE,

MediaStore.Audio.Media.ARTIST,

MediaStore.Audio.Media.DATA)

context.contentResolver.query(

MediaStore.Audio.Media.EXTERNAL_CONTENT_URI,

proj,

"${MediaStore.Audio.Media.IS_MUSIC} != 0",

null, null)?.use { c ->

while (c.moveToNext()) {

list += Song(c.getLong(0), c.getString(1),

c.getString(2), c.getString(3))

}

}

return list

}

```

四、播放控制（ExoPlayer）

```kotlin

val player = ExoPlayer.Builder(context).build()

player.setMediaItems(songs.map { MediaItem.fromUri(Uri.fromFile(File(it.path))) })

player.playWhenReady = true

// 播放模式

player.repeatMode = Player.REPEAT_MODE_ALL // 列表循环

// player.repeatMode = Player.REPEAT_MODE_ONE // 单曲循环

// player.repeatMode = Player.REPEAT_MODE_OFF // 顺序

player.shuffleModeEnabled = true // 随机播放

```

五、歌单管理

• Song