【中工开发者】基于鸿蒙系统开发简朴音乐播放器

涛声依旧在  论坛元老 | 3 天前 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 1704|帖子 1704|积分 5112

一、前言

在本教程中，我们将使用 鸿蒙系统（HarmonyOS） 实现一个简朴的音乐播放器应用。该播放器支持基本功能，如播放、停息、上一首、下一首，具有精良的用户界面，风格模仿网易云音乐。
二、功能特点


  • 播放功能：实现播放、停息、上一首、下一首切换。
  • 播放进度：显示当前播放时间及总时长，并支持进度条拖动。
  • 音量调节：通过滑块控制播放音量。
  • UI 优化：采用简洁风格布局，用户体验友爱。
三、开发环境



  • 开发工具：DevEco Studio
  • 鸿蒙版本：API Version 8+
  • 设备要求：鸿蒙模拟器或鸿蒙支持设备
四、具体步调

步调 1：添加依赖

在 build.gradle 文件中，添加媒体和布局依赖：
  1. dependencies {
  2.     implementation fileTree(dir: 'libs', include: ['*.jar', '*.so'])
  3.     implementation 'ohos.media:media:1.0.0'
  4.     implementation 'ohos.agp:agp:1.0.0'
  5. }
复制代码
同时，配置 config.json 文件，声明所需权限：
  1. "permissions": [
  2.     "ohos.permission.MEDIA_LOCATION",
  3.     "ohos.permission.READ_MEDIA"
  4. ]
复制代码
步调 2：完备代码

2.1 主活动文件：MainAbility.java

主活动控制界面显示和用户交互逻辑。
  1. package com.example.musicplayer;
  3. import ohos.aafwk.ability.Ability;
  4. import ohos.aafwk.content.Intent;
  5. import ohos.agp.components.Slider;
  6. import ohos.agp.components.Text;
  7. import ohos.agp.components.Button;
  9. public class MainAbility extends Ability {
  10.     private PlayerController playerController;
  11.     private PlaylistManager playlistManager;
  13.     @Override
  14.     public void onStart(Intent intent) {
  15.         super.onStart(intent);
  16.         setUIContent(ResourceTable.Layout_ability_main);
  18.         playlistManager = new PlaylistManager();
  19.         playerController = new PlayerController(this, playlistManager);
  21.         setupUI();
  22.     }
  24.     private void setupUI() {
  25.         // 界面组件绑定
  26.         Text trackName = (Text) findComponentById(ResourceTable.Id_track_name);
  27.         Text currentTime = (Text) findComponentById(ResourceTable.Id_current_time);
  28.         Text totalTime = (Text) findComponentById(ResourceTable.Id_total_time);
  30.         Button playButton = (Button) findComponentById(ResourceTable.Id_button_play);
  31.         Button nextButton = (Button) findComponentById(ResourceTable.Id_button_next);
  32.         Button prevButton = (Button) findComponentById(ResourceTable.Id_button_previous);
  34.         Slider volumeSlider = (Slider) findComponentById(ResourceTable.Id_volume_slider);
  35.         Slider progressSlider = (Slider) findComponentById(ResourceTable.Id_progress_slider);
  37.         // 绑定事件
  38.         playButton.setClickedListener(component -> playerController.togglePlayPause());
  39.         nextButton.setClickedListener(component -> playerController.playNextTrack());
  40.         prevButton.setClickedListener(component -> playerController.playPreviousTrack());
  42.         // 更新播放进度和时间
  43.         playerController.setTrackChangeListener((name, duration) -> {
  44.             trackName.setText(name);
  45.             totalTime.setText(formatTime(duration));
  46.         });
  48.         playerController.setTimeUpdateListener((current, duration) -> {
  49.             currentTime.setText(formatTime(current));
  50.             progressSlider.setProgress((int) (current * 100 / duration));
  51.         });
  53.         // 音量控制
  54.         volumeSlider.setValueChangedListener((slider, value, fromUser) -> {
  55.             if (fromUser) playerController.setVolume(value / 100.0f);
  56.         });
  58.         // 播放进度控制
  59.         progressSlider.setValueChangedListener((slider, value, fromUser) -> {
  60.             if (fromUser) playerController.seekTo(value / 100.0f);
  61.         });
  62.     }
  64.     private String formatTime(long timeInMs) {
  65.         int minutes = (int) (timeInMs / 60000);
  66.         int seconds = (int) ((timeInMs % 60000) / 1000);
  67.         return String.format("%02d:%02d", minutes, seconds);
  68.     }
  69. }
复制代码
2.2 播放器控制：PlayerController.java

播放器控制逻辑包括播放、停息、音量和进度控制。
  1. package com.example.musicplayer;
  3. import ohos.app.Context;
  4. import ohos.media.audio.AudioPlayer;
  5. import java.util.Timer;
  6. import java.util.TimerTask;
  8. public class PlayerController {
  9.     private final AudioPlayer audioPlayer;
  10.     private final PlaylistManager playlistManager;
  11.     private final Timer timer;
  13.     private TimeUpdateListener timeUpdateListener;
  14.     private TrackChangeListener trackChangeListener;
  16.     public PlayerController(Context context, PlaylistManager playlistManager) {
  17.         this.audioPlayer = new AudioPlayer(context);
  18.         this.playlistManager = playlistManager;
  19.         this.timer = new Timer();
  21.         setupPlayer();
  22.         startUpdatingTime();
  23.     }
  25.     private void setupPlayer() {
  26.         audioPlayer.setPlayerStateChangedListener((player, state) -> {
  27.             if (state == AudioPlayer.PlayerState.PLAYING) {
  28.                 notifyTrackChange();
  29.             }
  30.         });
  31.     }
  33.     public void playNextTrack() {
  34.         playlistManager.nextTrack();
  35.         playCurrentTrack();
  36.     }
  38.     public void playPreviousTrack() {
  39.         playlistManager.previousTrack();
  40.         playCurrentTrack();
  41.     }
  43.     public void togglePlayPause() {
  44.         if (audioPlayer.isPlaying()) {
  45.             audioPlayer.pause();
  46.         } else {
  47.             playCurrentTrack();
  48.         }
  49.     }
  51.     private void playCurrentTrack() {
  52.         audioPlayer.setSource(playlistManager.getCurrentTrack());
  53.         audioPlayer.prepare();
  54.     }
  56.     public void setVolume(float volume) {
  57.         audioPlayer.setVolume(volume);
  58.     }
  60.     public void seekTo(float progress) {
  61.         long position = (long) (audioPlayer.getDuration() * progress);
  62.         audioPlayer.seekTo(position);
  63.     }
  65.     private void startUpdatingTime() {
  66.         timer.scheduleAtFixedRate(new TimerTask() {
  67.             @Override
  68.             public void run() {
  69.                 if (timeUpdateListener != null && audioPlayer.isPlaying()) {
  70.                     timeUpdateListener.onTimeUpdate(audioPlayer.getCurrentPosition(), audioPlayer.getDuration());
  71.                 }
  72.             }
  73.         }, 0, 1000);
  74.     }
  76.     public void setTimeUpdateListener(TimeUpdateListener listener) {
  77.         this.timeUpdateListener = listener;
  78.     }
  80.     public void setTrackChangeListener(TrackChangeListener listener) {
  81.         this.trackChangeListener = listener;
  82.     }
  84.     private void notifyTrackChange() {
  85.         if (trackChangeListener != null) {
  86.             trackChangeListener.onTrackChange(playlistManager.getCurrentTrackName(), audioPlayer.getDuration());
  87.         }
  88.     }
  90.     public interface TimeUpdateListener {
  91.         void onTimeUpdate(long currentTime, long totalTime);
  92.     }
  94.     public interface TrackChangeListener {
  95.         void onTrackChange(String trackName, long duration);
  96.     }
  97. }
复制代码
2.3 播放器列表：PlaylistManager.java

  1. package com.example.musicplayer;
  3. import java.util.ArrayList;
  4. import java.util.List;
  6. public class PlaylistManager {
  7.     private final List<String> playlist;
  8.     private int currentIndex;
  10.     public PlaylistManager() {
  11.         this.playlist = new ArrayList<>();
  12.         loadPlaylist();
  13.     }
  15.     private void loadPlaylist() {
  16.         playlist.add("/data/accounts/account_0/appdata/com.example.musicplayer/res/raw/song1.mp3");
  18.         playlist.add("/data/accounts/account_0/appdata/com.example.musicplayer/res/raw/song2.mp3");
  19.         playlist.add("/data/accounts/account_0/appdata/com.example.musicplayer/res/raw/song3.mp3");
  20.     }
  22.     public String getCurrentTrack() {
  23.         return playlist.get(currentIndex);
  24.     }
  26.     public String getCurrentTrackName() {
  27.         return "歌曲：" + playlist.get(currentIndex).substring(playlist.get(currentIndex).lastIndexOf("/") + 1);
  28.     }
  30.     public void nextTrack() {
  31.         currentIndex = (currentIndex + 1) % playlist.size();
  32.     }
  34.     public void previousTrack() {
  35.         currentIndex = (currentIndex - 1 + playlist.size()) % playlist.size();
  36.     }
  37. }
复制代码
2.4 布局文件：ability_main.xml

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <DirectionalLayout
  3.     xmlns:ohos="http://schemas.huawei.com/res/ohos"
  4.     ohos:width="match_parent"
  5.     ohos:height="match_parent"
  6.     ohos:orientation="vertical">
  8.     <Text
  9.         ohos:id="$+id:track_name"
  10.         ohos:width="match_parent"
  11.         ohos:height="match_content"
  12.         ohos:text="当前无音乐播放"
  13.         ohos:text_size="18fp"
  14.         ohos:margin="16vp"
  15.         ohos:text_alignment="center"/>
  17.     <Text
  18.         ohos:id="$+id:current_time"
  19.         ohos:width="match_content"
  20.         ohos:height="match_content"
  21.         ohos:text="00:00"
  22.         ohos:margin="8vp"/>
  24.     <Slider
  25.         ohos:id="$+id:progress_slider"
  26.         ohos:width="match_parent"
  27.         ohos:height="50vp"/>
  29.     <Text
  30.         ohos:id="$+id:total_time"
  31.         ohos:width="match_content"
  32.         ohos:height="match_content"
  33.         ohos:text="00:00"
  34.         ohos:margin="8vp"/>
  36.     <DirectionalLayout
  37.         ohos:width="match_parent"
  38.         ohos:height="match_content"
  39.         ohos:orientation="horizontal"
  40.         ohos:alignment="center">
  42.         <Button
  43.             ohos:id="$+id:button_previous"
  44.             ohos:width="100vp"
  45.             ohos:height="50vp"
  46.             ohos:text="上一首"/>
  48.         <Button
  49.             ohos:id="$+id:button_play"
  50.             ohos:width="100vp"
  51.             ohos:height="50vp"
  52.             ohos:text="播放/暂停"/>
  54.         <Button
  55.             ohos:id="$+id:button_next"
  56.             ohos:width="100vp"
  57.             ohos:height="50vp"
  58.             ohos:text="下一首"/>
  59.     </DirectionalLayout>
  61.     <Slider
  62.         ohos:id="$+id:volume_slider"
  63.         ohos:width="match_parent"
  64.         ohos:height="50vp"
  65.         ohos:progress="50"/>
  66. </DirectionalLayout>
复制代码
五、运行效果

在完成代码编写后，运行此鸿蒙音乐播放器应用，可以实现以下效果：

  • 主界面展示：

    • 显示当前播放的歌曲名称、播放时间（当前时间与总时间）。
    • 显示进度条，可以根据歌曲进度实时更新，支持拖动调整进度。
    • 显示音量滑块，控制音量巨细。

  • 基本控制功能：

    • 点击播放/停息按钮时，播放器会停息或继续播放。
    • 点击上一首或下一首按钮时，播放器会切换到上一首或下一首歌曲。
    • 音量通过滑块调整，调整后的音量实时生效。

  • 音频播放控制：

    • 播放器能够正常读取 .mp3 文件并进行播放。
    • 播放进度和时间显示精确，支持拖动进度条控制播放进度。

界面截图示例

   主界面：
  

  • 中部有歌曲名和歌手名称
  • 下方有播放、停息、上一首、下一首按钮，音量滑块位于界面底部。
  

  歌词界面：
  

  • 顶部展示歌曲名和歌手信息。
  • 中部展示歌曲歌词。
  • 下方有播放、停息、上一首、下一首按钮，音量滑块位于界面底部。
  

  
六、常见报错及办理方案

在开发和运行过程中，大概会遇到以下一些常见问题：
1. 找不到音频文件

错误信息：FileNotFoundException: Could not find the file ...
办理方案：确保音频文件已经正确放入项目的 resources/raw 目录中，并且文件路径在代码中正确配置。


  • 比方，查抄 playlistManager.addTrack 中路径是否正确设置：
    1. playlist.add("/data/accounts/account_0/appdata/com.example.musicplayer/res/raw/song1.mp3");
    复制代码
2. 权限问题

错误信息：Permission denied 或无法访问媒体文件。
办理方案：确保已经在 config.json 文件中声明白相关权限，如：
  1. "permissions": [
  2.     "ohos.permission.MEDIA_LOCATION",
  3.     "ohos.permission.READ_MEDIA"
  4. ]
复制代码
如果音频文件未能读取或访问，确认模拟器或设备是否已授予这些权限。
3. UI 显示非常

错误信息：UI 布局未能正确显示或相应。
办理方案：确保 ability_main.xml 中的布局组件已正确配置，并且界面组件的 ID 匹配代码中的 findComponentById 方法。


  • 确保每个组件的 width 和 height 设置正确，避免出现元素重叠或不显示的情况。
4. 播放器未相应播放操作

错误信息：点击播放按钮无反应。
办理方案：查抄 audioPlayer.setSource 和 audioPlayer.prepare() 是否成功调用，并确保播放器资源路径正确。


  • 调试时可以打印日志，确认播放器是否成功加载并开始播放。
    1. audioPlayer.setSource(playlistManager.getCurrentTrack());
    2. audioPlayer.prepare();
    3. Log.info("Player", "Track prepared: " + playlistManager.getCurrentTrack());
    复制代码

5. 内存走漏或资源未释放

错误信息：步调运行时间过长时，大概出现内存占用过高。
办理方案：确保 AudioPlayer 在不需要时被正确释放。可以在活动销毁时调用 audioPlayer.release()。
  1. @Override
  2. protected void onStop() {
  3.     super.onStop();
  4.     audioPlayer.release();
  5. }
复制代码
七、总结

在本教程中，我们使用鸿蒙系统（HarmonyOS）开发了一个简朴的音乐播放器，涵盖了基本的音频播放功能，如播放、停息、上一首、下一首、音量控制、播放进度等功能。通过学习和实现这些功能，能够资助开发者认识鸿蒙系统的 音频播放、UI 计划 和 事件相应 机制。
主要学习点：


  • 鸿蒙音频播放 API：通过 AudioPlayer 实现音频的加载、播放、停息和进度控制。
  • UI 计划与相应：通过 Button、Slider 等组件计划了播放器的用户界面，并相应用户交互。
  • 事件驱动编程：通过事件监听和回调机制实现动态更新界面状态，如播放进度、音量控制等。
未来改进：


  • 支持更多格式的音频文件：现在我们只支持 .mp3 格式，未来可以添加对 .wav、.flac 等格式的支持。
  • 实现播放列表功能：现在播放器只能播放单曲，未来可以添加播放列表功能，支持用户选择差别的歌曲进行播放。
  • 增强用户体验：可以进一步优化 UI 计划，比方添加动画效果、歌曲封面显示等，提拔整体用户体验。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看，没有账号？立即注册

x
回复

使用道具 举报

0 个回复

正序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

涛声依旧在

论坛元老
这个人很懒什么都没写!

楼主热帖

标签云

渠道 国产数据库 集成商 AI 运维 CIO 存储 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表