1# 媒体子系统<a name="ZH-CN_TOPIC_0000001078026808"></a> 2 3- [简介](#section11660541593) 4- [系统架构](#section11660541594) 5- [目录](#section161941989596) 6- [约束](#section119744591305) 7- [使用说明](#section1312121216216) 8- [安装](#section11914418405) 9- [相关仓](#section1371113476307) 10 11## 简介<a name="section11660541593"></a> 12 13媒体子系统为开发者提供一套简单且易于理解的接口,使得开发者能够方便接入系统并使用系统的媒体资源。 14 15媒体子系统包含了音视频、相机相关媒体业务,提供以下常用功能: 16 17- 音频播放和录制。 18- 视频播放和录制。 19- 相机拍照和录制。 20 21## 系统架构<a name="section11660541594"></a> 22 23**图 1** OpenHarmony媒体子系统架构图<a name="fig99659301300"></a> 24 25![](figures/OpenHarmony媒体架构图.png) 26 27- **Media**: 为应用提供播放、录制等接口,通过跨进程调用或直接调用方式,调用媒体引擎Gstreamer、Histreamer或其它引擎。 28 - mini设备上,Media部件调用Histreamer支持音频播放等功能。 29 - small设备上,Media部件调用recorder_lite支持音视频录制,默认调用player_lite支持音视频播放,通过设置系统属性变量debug.media_service.histreamer为1使用histreamer。详细设置方法参见[syspara系统属性组件使用说明](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-boot-init-sysparam.md)或者参见[syspara模块代码](https://gitee.com/openharmony/startup_syspara_lite)。 30 - standard设备上,Media部件调用Gstreamer支持音视频播放、音视频录制。 31- **Audio**: Audio部件支持音频输入输出、策略管理、音频焦点管理等功能。 32- **Camera**: Camera部件提供相机操作接口,支持预览、拍照、录像。 33- **Image**: Image部件支持常见图片格式的编解码。 34- **MediaLibrary**: MediaLibrary支持本地和分布式媒体数据访问管理。 35- **Histreamer**: 轻量级媒体引擎,支持文件/网络流媒体输入,支持音视频解码播放,支持音视频编码录制,支持插件扩展。 36- **Gstreamer**: 开源GStreamer引擎,支持流媒体、音视频播放、录制等功能。 37 38## 目录<a name="section161941989596"></a> 39 40仓目录结构如下: 41 42``` 43/foundation/multimedia # 媒体子系统业务代码 44├── audio_lite # 小型系统音频模块 45│ ├── figures # 小型系统音频架构和流程图 46│ ├── frameworks # 小型系统音频框架实现 47│ └── interfaces # 小型系统音频模块接口 48├── audio_standard # 标准系统音频模块 49│ ├── figures # 标准系统音频架构和流程图 50│ ├── frameworks # 标准系统音频框架实现 51│ ├── interfaces # 标准系统音频模块接口 52│ ├── sa_profile # 标准系统音频服务配置 53│ └── services # 标准系统音频服务实现 54├── camera_lite # 小型系统相机模块 55│ ├── figures # 小型系统相机架构和流程图 56│ ├── frameworks # 小型系统相机框架实现 57│ └── interfaces # 小型系统相机模块接口 58├── camera_standard # 标准系统相机模块 59│ ├── figures # 标准系统相机架构和流程图 60│ ├── frameworks # 标准系统相机框架实现 61│ └── interfaces # 标准系统相机模块接口 62├── media_lite # 小型系统播放录制模块 63│ ├── figures # 小型系统播放录制架构和流程图 64│ ├── frameworks # 小型系统播放录制框架实现 65│ ├── interfaces # 小型系统播放录制模块接口 66│ └── services # 小型系统播放录制模块服务 67├── media_standard # 标准系统播放录制模块 68│ ├── figures # 标准系统播放录制架构和流程图 69│ ├── frameworks # 标准系统播放录制框架实现 70│ └── interfaces # 标准系统播放录制模块接口 71├── histreamer # HiStreamer媒体引擎 72│ └── engine # 媒体引擎 73│ ├── player # 播放器封装 74│ ├── foundation # 基础工具 75│ ├── pipeline # Pipeline框架 76│ └── plugin # 插件框架 77│ └── plugins # 平台软件插件 78└── utils # 媒体公共模块 79 └── lite # 小型系统媒体公共模块 80 ├── figures # 小型系统媒体公共模块架构和流程图 81 ├── hals # 小型系统媒体公共硬件抽象接口 82 ├── interfaces # 小型系统媒体公共模块接口 83 └── src # 小型系统媒体公共模块框架实现 84``` 85 86## 约束<a name="section119744591305"></a> 87 88部分音视频格式的硬件编码、解码功能依赖设备的支持。 89 90## 使用说明<a name="section1312121216216"></a> 91 92如架构图示意,媒体提供了三大类功能接口,开发者可以根据使用诉求,综合使用一类或多类接口: 93 94- 应用开发者使用媒体接口实现录像、预览和播放音视频,使用可以参考[多媒体开发指南](../application-dev/media)。 95- 当使用简单播放录制功能时,可以使用Player和Recorder快速完成播放和录制功能。 96- 提供了一组控制相机的有效接口,可以让用户方便开发使用相机。 97- 开发者先创建camerakit组件对象,注册各种事件回调,这些事件回调是用来响应多媒体模块中事件响应的,之后调用创建camera就可以创建一个操作camera资源的对象,使用这个对象可以启动预览、录像或抓拍取流,及设置取流的相关参数。 98 99## 安装<a name="section11914418405"></a> 100 101请提前加载内核及相关驱动,参考内核及驱动子系统readme。 102 103## 相关仓<a name="section1371113476307"></a> 104 105[multimedia\_camera\_lite](https://gitee.com/openharmony/multimedia_camera_lite) 106 107[multimedia\_audio\_lite](https://gitee.com/openharmony/multimedia_audio_lite) 108 109[multimedia\_media\_lite](https://gitee.com/openharmony/multimedia_media_lite) 110 111[multimedia\_utils\_lite](https://gitee.com/openharmony/multimedia_utils_lite) 112 113[multimedia\_histreamer](https://gitee.com/openharmony/multimedia_histreamer) 114 115[multimedia\_camera\_standard](https://gitee.com/openharmony/multimedia_camera_standard) 116 117[multimedia\_audio\_standard](https://gitee.com/openharmony/multimedia_audio_standard) 118 119[multimedia\_media\_standard](https://gitee.com/openharmony/multimedia_media_standard) 120 121