介绍
本示例主要展示了媒体会话（媒体提供方）的相关功能，使用@ohos.multimedia.avsession等接口实现媒体提供方与媒体控制方自定义信息的交互功能。
注意： 此示例仅展示媒体提供方的相关功能，如果需要媒体会话提供的完整的自定义信息交互功能，请将本示例与媒体提供方示例共同使用。
效果预览
使用说明
基础操作
- 打开媒体提供方示例应用。
- 点击播放按钮，应用的播放状态发生变化，歌词开始更新。
- 点击暂停按钮，应用的播放状态开始变化，歌词停止更新。
- 点击上一首按钮，应用界面展示播放列表中的上一首歌曲的信息。
- 点击下一首按钮，应用界面展示播放列表中的下一首歌曲的信息。
进阶操作（与媒体控制方一起使用）
- 点击本应用播放、暂停、上一首、下一首按钮，可以发现媒体控制方中，该会话的状态同步改变。
- 点击媒体控制方按钮，可以发现本应用中播放状态同步改变。
- 媒体控制方可以获取到本应用的播放列表、自定义数据包、歌词等信息。
工程目录
给出项目中关键的目录结构并描述它们的作用，示例如下：
entry/src/main/ets/
|---common
|---|---Log.ets //日志打印封装
|---|---MediaData.ets //歌曲相关信息
|---|---Utils.ets //通用的工具类
|---feature
|---|---ProviderFeature.ets //逻辑实现
|---pages
|---|---Index.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);
}
依赖
此示例仅展示媒体提供方的相关功能，如果需要媒体会话提供的完整的自定义信息交互功能，请将本示例与媒体提供方示例共同使用。
约束与限制
- 本示例仅支持标准系统上运行，支持设备：RK3568。
- 本示例为Stage模型，支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0Release)
- 本示例需要使用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
如果大家还没有掌握鸿蒙，现在想要在最短的时间里吃透它，我这边特意整理了《鸿蒙语法ArkTS、TypeScript、ArkUI等…视频教程》以及《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
鸿蒙语法ArkTS、TypeScript、ArkUI等…视频教程：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
OpenHarmony APP开发教程步骤：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
《鸿蒙开发学习手册》：
如何快速入门：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.……
鸿蒙生态应用开发白皮书V2.0PDF：https://docs.qq.com/doc/DZVVkRGRUd3pHSnFG
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
