简介安卓音乐播放器课程设计项目源码是一份面向计算机专业学生和安卓移动开发初学者的高分结课作业源自大三学期经导师指导、获98分评审认可的真实项目涵盖工程搭建、界面设计到功能实现等完整流程可直接用于课程设计或期末大作业参考。压缩包共96个文件以Java源码、XML布局与配置、Android工程结构文件为主体Java文件承载主要播放逻辑XML文件定义界面与资源另含效果展示图、4段MP3示例音频及README说明整体约29.09MB在CSDN已有191人浏览学习。通过完整源码可梳理播放器界面搭建、数据解析、音频播放控制等核心实现尤其适合需要借鉴整体架构的同学图片展示便于对照界面与功能效果工程目录包含gradle配置与wrapper文件导入Android Studio后即可查看运行思路为独立完成大作业提供高参考价值的落地范本。1. 课程设计交源码前先想清楚 Android 音乐播放器要踩的坑课程设计交源码前的最后一晚最折磨人的不是播放逻辑写不完而是锁屏后音乐被系统回收、换一台模拟器专辑封面全部变灰、答辩老师随手划走通知栏播放器就崩。题目里「源码图片展示」看起来很朴素实际把 Android 里最容易丢分的几个点都点了名播放引擎选型、前台服务、媒体权限和封面缩略图。下面按可复现的课程设计路线往下推从 MediaPlayer 和 ExoPlayer 怎么选讲到 MediaStore 扫描歌曲和封面再落到前台 Service、通知栏控制、content URI 权限排错适合刚完成 Android 基础课、准备把 demo 升级成可演示项目的开发者也适合当评审清单来评估一个播放器工程是不是只做了个 UI 壳。2. Android 音乐播放器播放引擎怎么选MediaPlayer 与 ExoPlayer 的取舍和前台服务2.1 MediaPlayer 仍是课程设计的主干ExoPlayer 留给进阶答辩播放引擎是整份源码的第一处评审点。绝大多数课程设计只要求播放本地音频和简单在线音频MediaPlayer 提供的setDataSource、prepareAsync、start三步就能跑通代码量小、状态机直观老师顺着代码就能看出你理解生命周期这是它最大的优势。ExoPlayer 的缓冲、DASH/HLS 和自定义渲染能力更强但引入依赖和异步管线后课程设计阶段很容易把错误处理写散答辩被问「为什么缓冲卡顿但日志没有异常」会答不上来。常见做法是主干用 MediaPlayer把播放接口抽象成PlaybackManager后续要换 ExoPlayer 时只改一个实现类这也是我通常会写在课程设计报告里的演进设计。对比项MediaPlayerExoPlayer本地音频播放直接可用代码最少功能超出需求配置略重网络流媒体支持 HTTP 简单流重定向处理一般内置缓冲、重试、自适应码率状态管理官方状态机适合用来讲原理事件监听多需要理解 PlaybackException答辩加分点状态机图与焦点处理播放器复用与 LoadControl 调优课程设计推荐主干使用作为扩展功能在文档里说明选定 MediaPlayer 之后第一步不是直接 new 出来 start而是先把生命周期管理好。我一般会写一个PlaybackManager内部持有MediaPlayer对外只暴露play(uri)、pause()、seekTo(position)、release()界面层不直接碰原生方法。这样后续 Service、Fragment、通知栏三处共用同一套播放控制不会出现「通知栏暂停了但页面还在走进度」的状态漂移也方便在 Android Studio 的单元测试里直接 mock 播放器接口。2.2 前台 Service 与播放状态刷新别让进度条起死回生课程设计最常见的扣分点是后台播放掉链子。Activity 进入后台后进程可能随时被回收后台播放必须放在持有前台通知的 Service 里。做法是在AndroidManifest.xml为 Service 声明android:foregroundServiceTypemediaPlayback启动时调用startForeground(id, notification)并申请FOREGROUND_SERVICE权限。这里容易漏的是startForeground必须发生在 Service 的onCreate到onStartCommand这段窗口期内超过 5 秒系统会抛RemoteServiceException在模拟器上表现为「服务启动失败」的 ANR 弹窗。class PlaybackService : Service() { override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int { // 每次 startService 都需要检查是否已进入前台避免重复 startForeground if (!isInForeground) { startForeground(NOTIFICATION_ID, buildNotification(准备播放)) isInForeground true } when (intent?.action) { ACTION_PLAY - playbackManager.play(currentUri) ACTION_PAUSE - playbackManager.pause() ACTION_NEXT - skipToNext() } return START_NOT_STICKY } }这段代码的关键点有两个isInForeground自己维护布尔标记防止多次startService导致前台状态重复设置START_NOT_STICKY表示进程被系统杀掉后不主动重建课程设计阶段比START_STICKY更安全后者一般留到真正做音乐 App 的恢复场景再用。播放进度刷新不要直接在 Service 里写Thread.sleep常见做法是Handler.postDelayed每 500 毫秒向已注册的 Activity 推送一次getCurrentPosition()Activity 收到消息后再更新进度条Activity 不可见时停止推送避免无意义重绘。2.3 音频焦点来电话、切蓝牙、拔耳机时让播放器让路音乐播放器不只是「能出声」还要会在其他应用抢音频时让路。Android 从 API 26 开始推荐用AudioFocusRequest请求音频焦点而不是老的requestAudioFocus。焦点分三档焦点类型使用场景焦点丢失回调建议动作AUDIOFOCUS_GAIN开始播放、恢复播放无需处理AUDIOFOCUS_GAIN_TRANSIENT暂时占用如语音提示播放完后恢复音量AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK允许压低音量共存降低音量或暂停焦点结束恢复AudioManager.OnAudioFocusChangeListener的onAudioFocusChange里要处理三件事AUDIOFOCUS_LOSS时暂停并释放焦点AUDIOFOCUS_LOSS_TRANSIENT时暂停但不释放AUDIOFOCUS_LOSS_TRANSIENT_MAY_DUCK时降低音量。val focusRequest AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN) .setAudioAttributes( AudioAttributes.Builder() .setUsage(AudioAttributes.USAGE_MEDIA) .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC) .build() ) .setOnAudioFocusChangeListener(focusListener) .build() audioManager.requestAudioFocus(focusRequest)参数说明USAGE_MEDIA告诉系统这是媒体音量不要跟随闹钟或通知音量CONTENT_TYPE_MUSIC用于蓝牙耳机等设备上的音质协商。答辩时老师常问「来电挂断后为什么音乐没有自动恢复」答案通常是焦点回调只写了暂停没有在焦点重新获得时调用playbackManager.resume()。把焦点重新获得的判断写在AUDIOFOCUS_GAIN分支里并联动播放状态这里是全项目最容易暴露逻辑漏洞的位置。3. 扫描 MediaStore 拿音频与专辑封面用协调布局和 Banner 做图片展示3.1 先搞定权限与分区存储别把 scan 写成翻文件管理器「图片展示」四个字如果只理解为截图代码还没开始就丢了一半分。音乐播放器的图片展示指的是专辑封面、Banner 轮播和列表 item 的封面缩略图这些数据全部来自媒体库扫描。Android 13 及以上读音频要用READ_MEDIA_AUDIOAndroid 12 及以下还是READ_EXTERNAL_STORAGE判分设备不固定最好用Build.VERSION.SDK_INT做分支申请。val perms if (Build.VERSION.SDK_INT 33) { arrayOf(Manifest.permission.READ_MEDIA_AUDIO) } else { arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE) } if (ContextCompat.checkSelfPermission(this, perms[0]) ! PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, perms, REQ_CODE_READ_MEDIA) }这里要注意Android 10 之后MediaStore.Audio.Media.DATA已标记 deprecated虽然部分机型还能读到但不应再做File(cursor.getString(DATA))后直接读文件。课程设计报告里说清这一点比多写一个 RecyclerView 更显工程素养。权限弹窗被拒后要引导用户去 App 详情页手动开启判断入口是shouldShowRequestPermissionRationale补上这段就能把「权限被拒直接闪退」升级为「收到拒绝原因提示」的完整闭环。3.2 MediaStore 查询音频、专辑封面与加载中的进度条权限到位后用ContentResolver.query查询MediaStore.Audio.Media.EXTERNAL_CONTENT_URI。建议用 projection 指定字段不要直接select *因为DATA等字段在分区存储下不一定返回有效值。查询条件里用IS_MUSIC ! 0排除录音、铃声等非音乐条目。我一般按DATE_ADDED倒序排保证新推入的测试音频排在最前面。val projection arrayOf( MediaStore.Audio.Media._ID, MediaStore.Audio.Media.TITLE, MediaStore.Audio.Media.ARTIST, MediaStore.Audio.Media.ALBUM_ID, MediaStore.Audio.Media.DURATION, MediaStore.Audio.Media.SIZE ) val selection ${MediaStore.Audio.Media.IS_MUSIC} ! 0 contentResolver.query( MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, projection, selection, null, ${MediaStore.Audio.Media.DATE_ADDED} DESC )?.use { cursor - val idCol cursor.getColumnIndexOrThrow(MediaStore.Audio.Media._ID) while (cursor.moveToNext()) { val musicUri ContentUris.withAppendedId( MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, cursor.getLong(idCol) ) // 把 musicUri 直接交给 PlaybackManager 播放不要转成绝对路径 } }ContentUris.withAppendedId是扫描阶段最重要的 API它把_ID拼成content://media/external/audio/media/123形式的标准媒体 URI。这个 URI 能直接传给MediaPlayer.setDataSource(context, uri)也能被图片加载库当作封面图源。专辑封面用ALBUM_ID拼content://media/external/audio/albumart示例是ContentUris.withAppendedId(Uri.parse(content://media/external/audio/albumart), albumId)。Android 11 上封面字段可能返回空 URI图片加载要用占位图兜底而不是让加载库抛FileNotFoundException。扫描期间在页面顶部放一个ProgressBar查询完再View.GONE这是典型的前台加载反馈避免「加载中」和空列表同时出现的尴尬。查询字段用途分区存储注意事项_ID拼 content URI始终用 withAppendedIdALBUM_ID拼 albumart 封面可能为空需占位图DURATION列表显示时长毫秒需格式化DATA调试用deprecated不要持久化3.3 协调布局 Banner让图片展示和列表页待在同一个工程「图片展示」加分项的做法是首页用一个CoordinatorLayout包住AppBarLayout CollapsingToolbarLayout顶部放 Banner 轮播下方放歌曲列表。Banner 不一定要引第三方库用ViewPager2自己写适配器展示三张专辑封面就能避开「第三方库版本冲突导致构建失败」的答辩翻车场景。协调布局里app:layout_scrollFlagsscroll|exitUntilCollapsed控制折叠标题栏的回弹图片展示区折叠后露出的Toolbar写当前歌曲名。androidx.coordinatorlayout.widget.CoordinatorLayout com.google.android.material.appbar.AppBarLayout android:layout_height200dp androidx.viewpager2.widget.ViewPager2 android:idid/banner_pager android:layout_widthmatch_parent android:layout_heightmatch_parent / androidx.appcompat.widget.Toolbar app:layout_collapseModepin / !-- 折叠后 Toolbar 钉在顶部Banner 被推出去 -- /com.google.android.material.appbar.AppBarLayout androidx.recyclerview.widget.RecyclerView app:layout_behaviorstring/appbar_scrolling_view_behavior android:clipToPaddingfalse android:paddingBottom80dp / /androidx.coordinatorlayout.widget.CoordinatorLayout这段布局的关键参数是RecyclerView上的appbar_scrolling_view_behavior它让列表滚动时带动AppBarLayout折叠而不是被它遮挡pin模式保证 Banner 完全折叠后Toolbar钉在顶部。列表 item 用ConstraintLayout放封面、歌名、播放进度三条信息封面通过图片加载库的磁盘缓存避免每次滚回都重新读albumart。如果想再加一点图片展示效果可以用DynamicColors让应用主题随专辑主色变化这是 Android 12 之后的系统能力在课程设计文档里写一句「使用动态取色协调界面」视觉冲击力比多写两个页面还明显。4. Android 音乐播放器最小闭环MediaPlayer 封装到通知栏和耳机控制4.1 播放状态机与 UI 状态联动音乐播放器的状态机是唯一值得画在课程设计报告里的图。MediaPlayer 官方状态图很长课程设计只需维护六个状态Idle、Preparing、Prepared、Started、Paused、PlaybackCompleted。对外抛出isPlaying()时把Started和PlaybackCompleted视为在播放。每次切歌要先reset()旧实例再setDataSource、prepareAsync监听setOnPreparedListener后才能start顺序错一步就会听到「咔哒」一声然后崩溃。状态触发时机对外信号Idle创建或 reset 后不可播放PreparingprepareAsync 后等待PreparedonPrepared 回调可 seekStartedstart 后isPlaying truePausedpause 后isPlaying falsePlaybackCompleted播放结束触发 onCompletionclass PlaybackManager(private val context: Context) { private var mediaPlayer: MediaPlayer? null fun play(uri: Uri) { release() val player MediaPlayer().apply { // 先设置音频属性再 setDataSource顺序不能反 setAudioAttributes( AudioAttributes.Builder() .setUsage(AudioAttributes.USAGE_MEDIA) .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC) .build() ) setDataSource(context, uri) setOnPreparedListener { start() onPlaybackStateChanged?.invoke(true) } setOnCompletionListener { onPlaybackStateChanged?.invoke(false) onCompletion?.invoke() } // 返回 true 表示错误已消费避免误触发 onCompletion setOnErrorListener { _, what, extra - onPlaybackError?.invoke(what, extra) true } } mediaPlayer player player.prepareAsync() } }这里的setAudioAttributes负责把播放器挂到媒体音量流上漏写的话铃声键也会控制播放音量模拟器上听不出真机上答辩会被老师抓破绽。setOnErrorListener返回true表示错误已被消费返回false会继续触发onCompletion造成「根本没播完却收到完成回调」的假象这是排查播放闪退时第一眼看的地方。4.2 通知栏控制与进度更新绑定前台服务生命周期图片展示里还要准备「锁屏通知控制」的截图这一步的关键是把通知栏按钮通过PendingIntent发回 Service。NotificationCompat.MediaStyle能把控制按钮放进系统媒体通知区域锁屏也能操作。// 通知点击后回到 Service而不是重启 Activity val playPauseIntent PendingIntent.getService( this, 0, Intent(this, PlaybackService::class.java).setAction(ACTION_PLAY_PAUSE), PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE ) NotificationCompat.Builder(this, CHANNEL_ID) .setSmallIcon(R.drawable.ic_music_note) .setContentTitle(title) .setContentText(artist) .setVisibility(NotificationCompat.VISIBILITY_PUBLIC) .addAction(R.drawable.ic_prev, 上一首, prevIntent) .addAction(R.drawable.ic_play_pause, 播放/暂停, playPauseIntent) .addAction(R.drawable.ic_next, 下一首, nextIntent) .setStyle(androidx.media.app.NotificationCompat.MediaStyle() .setShowActionsInCompactView(0, 1, 2) .setMediaSession(token)) .setOngoing(isPlaying) .build()FLAG_IMMUTABLE是 API 23 的强制要求课程设计里经常漏Android 12 以上直接抛异常。VISIBILITY_PUBLIC表示锁屏上显示通知内容。setOngoing(true)让播放中的通知不可滑动删除暂停后要再notify一条setOngoing(false)的通知否则用户没法清理残留通知。通知渠道CHANNEL_ID要在 Service 的onCreate里先createNotificationChannel创建低版本系统会忽略高版本不创建则通知不显示。4.3 耳机插拔与蓝牙断开ACTION_AUDIO_BECOMING_NOISY拔耳机、断开蓝牙耳机时系统会发ACTION_AUDIO_BECOMING_NOISY广播需要在 Manifest 里注册接收器收到就调pause()。注意这个广播不能用静态注册必须在onStartCommand里动态注册、onDestroy里反注册。// 该广播不带 extrareceived 即表示音频路由被切断 private val noisyReceiver object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { if (intent.action AudioManager.ACTION_AUDIO_BECOMING_NOISY) { playbackManager.pause() updateNotification(false) } } } registerReceiver(noisyReceiver, IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY))这个广播不携带数据onReceive不需要判断 extra收到就暂停。配合第二章的焦点处理「拔耳机 → 暂停 → 再插回 → 恢复播放 → 重新获得焦点」这条链路的完整实现在源码注释里写清楚答辩老师看到这里基本就会给到「完整度高」的评价。5. 排错与高分交付content:// 路径、进程回收和答辩图片清单5.1 别把 content:// 转成 /storage/emulated/0 绝对路径Android 10 分区存储后媒体文件既有content://media/external/audio/media/xxx这种系统媒体库 URI也可能是文件管理器分享过来的content://com.ss.android.uri.key/external_root/android/data/...。最常见翻车操作是把 URI 尾巴剪下来拼成/storage/emulated/0/...再用MediaPlayer.setDataSource(String)播放结果稳定抛 permission denied。正确做法是让 ContentResolver 代理val pfd contentResolver.openFileDescriptor(uri, r) mediaPlayer.setDataSource(pfd.fileDescriptor) // pfd 要等 prepareAsync 完成后才 close两个易错点pfd提前 close 会让播放直接失败第三方分享的 URI 属于临时授权重启后若还要播放先在onCreate里takePersistableUriPermission(uri, FLAG_GRANT_READ_URI_PERMISSION)持久化。这也是为什么代码里始终传 Uri 而不是 StringMediaPlayer.setDataSource(Context, Uri)内部会走 ContentResolver权限与生命周期都交给系统管理轮到自己处理时反而少了很多判断。5.2 用三条 adb 命令把后台稳定性测出来答辩前至少模拟三组场景adb shell am kill com.example.musicplayer验证强杀后重进能恢复列表开发者选项里开「不保留活动」切后台再回来验证进度条没丢在模拟器上切换蓝牙或拔出耳机验证收到ACTION_AUDIO_BECOMING_NOISY后暂停且通知栏同步。这三条命令能暴露「播放器对象放在 Activity 里还是 Service 里」这个课程设计最核心的架构问题。5.3 交付检查单源码 图片展示的取舍标题里的「图片展示」按四类素材准备播放列表页、正在播放页加专辑封面、通知栏加锁屏控件、Banner 轮播加错误态。截图用adb exec-out screencap -p screen.png取真机 1:1 原图封面图先压缩再提交避免仓库里混入十几 MB 的 PNG。检查项对照检查项验证方式图片素材权限申请首次启动弹窗拒绝后出现引导权限弹窗截图歌曲扫描列表条数变化进度条转圈后消失扫描前/后对比后台播放Home 键回桌面音乐继续通知栏控制截图封面加载有封面显示清晰无封面走占位图两种状态对比异常处理断网/无存储不崩溃错误提示页本文还有配套的精品资源点击获取