HarmonyOS实战开发-如何实现媒体会话（媒体提供方）的相关功能

介绍

本示例主要展示了媒体会话（媒体提供方）的相关功能，使用@ohos.multimedia.avsession等接口实现媒体提供方与媒体控制方自定义信息的交互功能。

注意： 此示例仅展示媒体提供方的相关功能，如果需要媒体会话提供的完整的自定义信息交互功能，请将本示例与媒体提供方示例共同使用。

效果预览

使用说明

基础操作

1. 打开媒体提供方示例应用。
2. 点击播放按钮，应用的播放状态发生变化，歌词开始更新。
3. 点击暂停按钮，应用的播放状态开始变化，歌词停止更新。
4. 点击上一首按钮，应用界面展示播放列表中的上一首歌曲的信息。
5. 点击下一首按钮，应用界面展示播放列表中的下一首歌曲的信息。

进阶操作（与媒体控制方一起使用）

1. 点击本应用播放、暂停、上一首、下一首按钮，可以发现媒体控制方中，该会话的状态同步改变。
2. 点击媒体控制方按钮，可以发现本应用中播放状态同步改变。
3. 媒体控制方可以获取到本应用的播放列表、自定义数据包、歌词等信息。

工程目录

给出项目中关键的目录结构并描述它们的作用，示例如下：

entry/src/main/ets/
|---common
|---|---Log.ets                             //日志打印封装
|---|---MediaData.ets                       //歌曲相关信息
|---|---Utils.ets                           //通用的工具类
|---feature
|---|---ProviderFeature.ets                 //逻辑实现
|---pages
|---|---Index.ets                           //界面实现

具体实现

• 界面相关的实现都封装在pages/Index.ets下
• 使用@StorageLink来设置与逻辑代码同步更新的变量，当逻辑代码中对应的变量更新时，界面会同步的刷新。
• 通过引入逻辑代码对应的类，创建出对象，实现对onClick事件的响应，关键代码段：

import { ProviderFeature } from '../feature/ProviderFeature'; private providerFeature: ProviderFeature = new ProviderFeature(); // 创建对象 Button() { // 按钮的内容 } .onClick(async () => { this.providerFeature.play(); // 通过类的对象来调用逻辑代码 })

• 逻辑相关的实现都封装在feature/ProviderFeature.ets下

应用的初始化相关操作

• 链接变量

通过AppStorage.SetAndLink()将逻辑代码中的变量与界面代码中使用@StorageLink声明的变量连接起来，通过set()与get()操作来修改或获取变量的值，关键代码段：

private isPlayLink: SubscribedAbstractProperty<boolean> = null; this.isPlayLink = AppStorage.SetAndLink('IsPlaying', false); this.isPlayLink.set(false); // 设置变量的值 let currentState : boolean = this.isPlayLink.get(); // 获取变量的值

• 创建并设置媒体会话

通过接口createAVSession()创建媒体会话；

通过接口activate()激活媒体会话；

通过接口setAVQueueItems()设置播放列表，设置后媒体控制方可以读取使用该信息；

通过接口setAVQueueTitle()设置播放列表标题，设置后媒体控制方可以读取使用该信息；

通过接口setAVMetadata()设置当前媒体的元数据，设置后媒体控制方可以读取使用此信息；

通过接口on()开启对媒体控制方控制命令的监听，对媒体控制方的命令进行处理；

应用在运行中相关的操作

• 切换歌曲

在切换歌曲时，除了需要设置媒体提供方自身的状态，还需要使用接口setAVPlaybackState()与接口setAVMetadata()将当前播放状态与元数据同步给媒体控制方。

• 发送自定义数据包

媒体提供方可以使用接口dispatchSessionEvent()与接口setExtras()来发送自定义数据包。

相关权限

1. 长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING

如果需要让媒体提供方应用在后台运行或响应命令，需要注册长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING

请在需要后台运行的Ability的module.json5中添加以下配置：

{ "module": { "requestPermissions": [ { "name": "ohos.permission.KEEP_BACKGROUND_RUNNING" } ] } }

添加配置后，需要在逻辑代码中进行申请长时任务的操作，示例代码如下：

async startContinuousTask(){ let wantAgentInfo = { wants:[ { bundleName:"com.samples.mediaprovider", abilityName:"com.samples.mediaprovider.EntryAbility" } ], operationType : WantAgent.OperationType.START_ABILITY, requestCode: 0, wantAgentFlags: [WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] }; let want = await WantAgent.getWantAgent(wantAgentInfo); await backgroundTaskManager.startBackgroundRunning(globalThis.context, backgroundTaskManager.BackgroundMode.AUDIO_PLAYBACK,want); }

依赖

此示例仅展示媒体提供方的相关功能，如果需要媒体会话提供的完整的自定义信息交互功能，请将本示例与媒体提供方示例共同使用。

约束与限制

1. 本示例仅支持标准系统上运行，支持设备：RK3568。
2. 本示例为Stage模型，支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0Release)
3. 本示例需要使用DevEco Studio 版本号(4.0 Release)及以上版本才可编译运行。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/BasicFeature/Media/AVSession/MediaProvider > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master

为了帮助大家更深入有效的学习到鸿蒙开发知识点，小编特意给大家准备了一份全套最新版的HarmonyOS NEXT学习资源，获取完整版方式请点击→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

HarmonyOS教学视频：语法ArkTS、TypeScript、ArkUI等…视频教程

鸿蒙生态应用开发白皮书V2.0PDF： 获取完整版白皮书方式请点击→https://docs.qq.com/doc/DZVVkRGRUd3pHSnFG?u=a42c4946d1514235863bb82a7b2ac128

鸿蒙 (Harmony OS)开发学习手册

一、入门必看→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.应用开发导读(ArkTS)
2………

二、HarmonyOS 概念→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.系统定义
2.技术架构
3.技术特性
4.系统安全
5.…

三、如何快速入门？→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.基本概念
2.构建第一个ArkTS应用
3………

四、开发基础知识→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

五、基于ArkTS 开发→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……

更多了解更多鸿蒙开发的相关知识可以参考：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3