#HarmonyOS NEXT体验官#鸿蒙原生应用开发项目实战：音乐播放器原创

鱼弦CTO

发布于 2024-8-26 18:02

浏览

0收藏

鸿蒙原生应用开发项目实战：音乐播放器

介绍

本项目旨在开发一个基于鸿蒙系统的音乐播放器应用，具备如下功能：

实现本地音乐文件播放。
支持播放列表管理。
音量控制。
播放进度拖动。
自定义 Notification 实现后台播放。

应用使用场景

个人娱乐：用户可以使用该音乐播放器在日常生活中进行音频娱乐。
学习辅助：用户可以通过播放音频课程、录音笔记等进行学习。
背景音乐：商家或用户可以将此应用用于播放背景音乐。

原理解释

音乐播放器的核心功能主要依赖于鸿蒙的MediaPlayer API。同时，通过自定义 Notification 实现音乐播放的后台运行，以增加用户体验。

算法原理流程图

graph TD
    A[启动应用] --> B[选择音乐文件]
    B --> C[加入播放列表]
    C --> D[点击播放按钮]
    D --> E{MediaPlayer调用}
    E --> F[加载音乐文件]
    F --> G[开始播放]
    G --> H[控制音量/播放进度]
    H --> I[后台播放通知]
    I --> J[结束播放]

算法原理解释

初始化：应用启动时，初始化MediaPlayer实例并设置相关监听器。
选择音乐文件：用户通过界面选择本地音频文件，并将其加入播放列表。
播放控制：点击播放按钮后，MediaPlayer开始加载并播放选中的音频文件。
音量和进度控制：用户可以通过滑动条调整音量和播放进度。
后台播放：自定义 Notification 显示当前播放状态，并允许用户在其他应用中继续操作播放。
结束播放：当音乐播放完毕或用户停止播放时，释放MediaPlayer资源。

实际应用代码示例实现

主Activity代码

public class MusicPlayerActivity extends Ability {
    private MediaPlayer mediaPlayer;
    private List<String> playlist = new ArrayList<>();
    private int currentTrackIndex = 0;

    @Override
    protected void onStart(Intent intent) {
        super.onStart(intent);
        setUIContent(ResourceTable.Layout_ability_music_player);

        mediaPlayer = new MediaPlayer();
        initListeners();

        // Example to add files to the playlist
        playlist.add("dataability:///audio/song1.mp3");
        playlist.add("dataability:///audio/song2.mp3");
    }

    private void initListeners() {
        findComponentById(ResourceTable.Id_play_button).setClickedListener(listener -> playMusic());
        findComponentById(ResourceTable.Id_pause_button).setClickedListener(listener -> pauseMusic());

        Slider volumeSlider = (Slider) findComponentById(ResourceTable.Id_volume_slider);
        volumeSlider.setValueChangedListener((slider, value, fromUser) -> setVolume(value));
        
        Slider progressSlider = (Slider) findComponentById(ResourceTable.Id_progress_slider);
        progressSlider.setValueChangedListener((slider, value, fromUser) -> seekTo(value));
    }

    private void playMusic() {
        if (!mediaPlayer.isNowPlaying()) {
            mediaPlayer.reset();
            mediaPlayer.setSource(playlist.get(currentTrackIndex));
            mediaPlayer.prepare();
            mediaPlayer.play();
            showNotification();
        }
    }

    private void pauseMusic() {
        if (mediaPlayer.isNowPlaying()) {
            mediaPlayer.pause();
        }
    }

    private void setVolume(int value) {
        mediaPlayer.setVolume((float) value / 100);
    }

    private void seekTo(int value) {
        mediaPlayer.seekTo(value);
    }

    private void showNotification() {
        NotificationRequest notificationRequest = new NotificationRequest(1);
        notificationRequest.setContentTitle("Music Player");
        notificationRequest.setContentText("Playing: " + playlist.get(currentTrackIndex));
        getSystemService(NotificationManager.class).notify(1, notificationRequest);
    }

    @Override
    protected void onStop() {
        super.onStop();
        if (mediaPlayer.isNowPlaying()) {
            mediaPlayer.stop();
        }
        mediaPlayer.release();
    }
}

测试代码

单元测试

@Test
public void testPlayMusic() {
    MusicPlayerActivity activity = new MusicPlayerActivity();
    activity.onStart(null);
    activity.playMusic();
    assertTrue(activity.mediaPlayer.isNowPlaying());
}

@Test
public void testPauseMusic() {
    MusicPlayerActivity activity = new MusicPlayerActivity();
    activity.onStart(null);
    activity.playMusic();
    activity.pauseMusic();
    assertFalse(activity.mediaPlayer.isNowPlaying());
}