当前位置: 首页 > article >正文

HarmonyOS NEXT 技术实践-实现音乐服务卡片

本项目展示了如何在 HarmonyOS Next 中实现音乐服务卡片,集成歌曲播放、歌词展示、歌单推荐等功能。通过使用服务卡片,用户无需进入完整的音乐应用即可通过简洁的界面进行播放控制和内容浏览,从而提高了操作的便捷性与效率。本文将详细介绍项目的实现过程,包括核心功能的实现、代码结构以及最终效果的展示,帮助开发者快速掌握如何在 HarmonyOS Next 中创建高效的音乐服务卡片应用。
在这里插入图片描述


一、项目背景与目标

1. 框架介绍

音乐服务卡片是 HarmonyOS Next 中 服务卡片 的一种具体应用形式,它将音乐APP的核心功能(如歌曲播放、歌单推荐、歌词展示等)以简洁的卡片形式呈现给用户。用户无需打开完整应用,就能够在卡片上完成基本操作(如播放、暂停、切换歌曲、查看歌词等),大大提高了使用的便捷性和用户体验。本示例旨在通过音乐服务卡片的实现,展示如何利用 HarmonyOS Next 的服务卡片功能快速集成音乐相关的操作和展示,提升用户与设备的交互体验。

在这里插入图片描述

2. 项目目标

本项目的目标是创建一个功能完备的音乐服务卡片,支持以下功能:

  • 歌曲播放控制:提供播放、暂停、上一曲、下一曲等控制操作。
  • 歌词展示:实时显示当前播放歌曲的歌词。
  • 歌单推荐:基于用户的历史偏好,推荐个性化的歌曲列表。
  • 简洁交互:通过卡片展示核心功能,提升用户体验,减少切换应用的频率。

二、项目结构

以下是项目的目录结构,展示了各个功能模块的分布:

├──entry/src/main/ets                     // 代码区
│  ├──components                          // 自定义组件
│  │  ├──CustomTabBar.ets                 // 首页自定义导航Tabbar
│  │  ├──PlayController.ets               // 首页底部音乐播控组件
│  │  ├──PlayerView.ets                   // 音乐播放界面
│  │  ├──PlayList.ets                     // 歌曲播放列表
│  │  ...                                 
│  │  └──SongListItem.ets                 // 音乐列表列表项目
│  ├──database                            // 数据库工具类
│  │  ├──FormRdbHelper.ets                // 卡片数据库工具类
│  │  ├──PreferencesUtil.ets              // 首选项工具类
│  │  ├──RdbUtils.ets                     // 关系型数据工具类
│  │  └──SongRdbHelper.ets                // 歌曲数据库工具类
│  ├──entryability
│  │  └──EntryAbility.ets                 // 程序入口类
│  ├──entrybackupability                  
│  │  └──EntryBackupAbility.ets           // 应用数据备份和恢复类
│  ├──entryformability
│  │  └──EntryFormAbility.ets             // 卡片生命周期类
│  ├──lyric                               // 歌曲歌词实现模块
│  ├──pages
│  │  └──MainPage.ets                     // 应用主界面
│  ├──utils                               // 工具类
│  │  ├──BackgroundUtil.ets               // 后台任务管理类
│  │  ├──FormUtils.ets                    // 卡片管理类
│  │  ├──ImageUtils.ets                   // 图片工具类
│  │  ├──MediaService.ets                 // 音频播控管理类
│  │  ...                                 
│  │  └──WindowUtils.ets                  // 窗口工具类
│  ├──view
│  │  ├──CollectedMusic.ets               // 收藏歌曲视图
│  │  ├──HotPlaylist.ets                  // 热门歌单视图
│  │  └──RecommendedMusic.ets             // 推荐歌曲视图
│  ├──viewmodel                           // 数据model
│  └──widget
│     ├──model
│     │  ├──ActionUtils.ets               // 卡片事件交互方法封装类
│     │  └──FormCardConstant.ets          // 卡片常量封装类
│     └──pages
│        ├──LyricsCard.ets                // 歌词卡片
│        ├──PlayControlCard2x2.ets        // 2x2音乐播控卡片
│        ├──PlayControlCard2x4.ets        // 2x4音乐播控卡片
│        ├──RecommendedMusic1x2.ets       // 1x2歌单推荐卡片
│        └──RecommendedMusic2x4.ets       // 2x4歌单推荐卡片
└──entry/src/main/resources               // 应用静态资源目录

本示例仅支持标准系统上运行,支持设备:华为手机。
HarmonyOS系统:HarmonyOS Next及以上。
DevEco Studio版本:DevEco Studio Next及以上。
HarmonyOS SDK版本:HarmonyOS Next SDK及以上。


三、项目实现

整体项目代码量过多,此处以核心代码为例:

1. 播放控制操作

ActionUtils.ets 中,playByAction 方法用于控制音乐播放的动作(播放、暂停、上一曲、下一曲)。通过接收 type 参数,playByAction 方法能够根据传入的动作类型发送相应的控制请求,操作音乐卡片的播放状态。

public playByAction(component: Object, type: PlayActionType, formId: string) {
  postCardAction(component, {
    action: FormCarAction.CALL,
    abilityName: ENTRY_ABILITY,
    params: {
      method: CallMethod.PLAY_BY_ACTION,
      playActionType: type,
      formId: formId
    }
  });
}

2. 更新卡片状态

当用户对音乐控制卡片进行操作时,可能需要更新卡片的显示状态。updateControlCardAction 方法通过 postCardAction 请求更新卡片的显示内容(如歌曲封面、播放进度条等),确保卡片内容与当前播放状态一致。

public updateControlCardAction(component: Object, formId: string) {
  postCardAction(component, {
    action: FormCarAction.CALL,
    abilityName: ENTRY_ABILITY,
    params: {
      method: CallMethod.REQUEST_UPDATE_CARD,
      formId: formId
    }
  });
}

3. 表单信息管理

EntryFormAbility.ets 中,onAddForm 方法处理了音乐卡片表单的添加。它通过从 want.parameters 中提取 formIdformDimensionformName,创建并保存 FormInfo 对象,并根据 formName 进行相应的操作。

onAddForm(want: Want) {
  Logger.info(TAG, 'onAddForm');
  if (want.parameters) {
    let formId = want.parameters['ohos.extra.param.key.form_identity'] as string;
    let formDimension = want.parameters['ohos.extra.param.key.form_dimension'] as string;
    let formName = want.parameters['ohos.extra.param.key.form_name'] as string;

    let formInfo = new FormInfo();
    formInfo.formId = formId;
    formInfo.formDimension = formDimension;
    formInfo.formName = formName;
    Logger.info(TAG, `onAddForm formInfo: ${JSON.stringify(formInfo)}`);
    FormRdbHelper.getInstance(this.context).insertForm(formInfo);

    if (formName.includes('PlayControlCard')) {
      // 音乐控制卡片的初始化或操作逻辑
    }
  }
}

四、效果预览

1. 播放界面

展示当前播放的歌曲信息、封面图、播放进度条以及播放/暂停按钮。

在这里插入图片描述

2. 播控卡片

提供基础的音乐播放控制功能,包括播放、暂停、上一曲、下一曲等按钮,用户可随时进行音乐控制。

在这里插入图片描述

3. 歌词卡片

显示当前播放歌曲的实时歌词,用户可以一边听歌一边跟随歌词。

在这里插入图片描述

4. 推荐卡片

基于用户的听歌习惯和历史记录,推荐个性化的歌单或歌曲,帮助用户发现新音乐。

在这里插入图片描述


五、总结

通过本项目实现的音乐服务卡片,展示了如何将常用的音乐功能通过卡片的形式高效集成到 HarmonyOS Next 应用中。通过简洁的交互界面,用户无需进入完整的应用即可完成常见操作,如播放、暂停、切换歌曲和查看歌词。此项目不仅提升了用户体验,也充分发挥了 HarmonyOS Next 服务卡片的优势,为开发者提供了更加便捷的音乐控制方案。

此外,项目中的核心代码展示了如何通过 ActionUtils.etsEntryFormAbility.ets 实现音乐卡片的动态控制和数据管理,帮助开发者快速实现类似功能,并灵活地扩展和定制更多交互体验。


http://www.kler.cn/a/448303.html

相关文章:

  • GESP CCF C++八级编程等级考试认证真题 2024年12月
  • 华为IPD流程6大阶段370个流程活动详解_第一阶段:概念阶段 — 81个活动
  • WPF Binding 绑定
  • 服务器数据恢复—V7000存储中多块磁盘出现故障导致业务中断的数据恢复案例
  • 使用qemu搭建armv7嵌入式开发环境
  • 如何使用Edu邮箱获取免费福利
  • 简单介绍一下缓慢渐变维
  • java篇-maven配置阿里云仓库(图文详解)
  • sass、scss、less、的区别
  • 文献阅读+ARIMA模型学习
  • Fluss 写入数据湖实战
  • 在 docker 内运行命令的一个大坑
  • Centos7 系统初始化
  • MySQL LIST Partitioning 问题求解/吐槽
  • 解锁大数据治理的“密码”与应用奥秘
  • ApacheStruts2 目录遍历与文件上传漏洞复现(CVE-2024-53677,S2-067)(附脚本)
  • 《测试开发方法论》-追踪溯源
  • 【钉钉群聊机器人定时发送消息功能实现】
  • C++ 哈希表封装unordered_map 和 unordered_set
  • 浅谈ORACLE中间件SOA BPM,IDM,OID,UCM,WebcenterPortal服务器如何做迁移切换
  • FLV视频封装格式详解
  • SSM 驱动的 JAVA 网络直播带货查询系统设计及 JSP 成功实现解析
  • 如何确保Java爬虫不超出API使用限制:策略示例
  • Vue 环境变量配置、使用方法、注意事项
  • HTML综合案例
  • C++设计模式:享元模式 (附文字处理系统中的字符对象案例)