一、概述统一互联是鸿蒙生态中实现设备间互联互通的核心技术体系旨在打破平台壁垒、消除设备隔阂、贯通数据流与控制流构建可互操作、可协同、可信任的全域数字网络。通过统一互联技术能够打通 OpenHarmony 设备与消费类领域 HarmonyOS Next 标准设备的互联生态实现跨厂商设备互联互通。本指导文档聚焦于富对富投屏场景系统讲解从 Source 端发屏/控制端到 Sink 端收屏/渲染端开发的核心技术路径涵盖 Miracast 镜像投屏、DLNA 内容投屏、投播管理框架CastEngine Framework以及 SystemUI / Settings / 各模块应用的完整开发指南。当前支持 OpenHarmony 标准设备间的跨协议投屏以及与 HarmonyOS Next、第三方影音应用的标准 DLNA / Miracast 互操作。该特性提供两大核心投屏能力投屏类型说明Miracast 镜像投屏基于 Wi-Fi Direct Wi-Fi Display 标准支持整屏镜像传输适配演示、游戏等场景OpenHarmony 设备可作为 Source 向标准 Miracast 设备投屏也可作为 Sink 接收各类 Miracast Source 的投屏内容DLNA 内容投屏遵循 DLNA/UPnP 协议支持将在线视频、本地媒体推送到大屏播放适配影音娱乐场景OpenHarmony 设备作为 SinkDMR可被 HarmonyOS、OpenHarmony 及第三方影音应用发现并投屏1.1 系统框图投屏系统架构遵循OpenHarmony技术架构从上到下依次为应用层、框架层、系统服务层。投屏能力模块如图中蓝色标识。1.2 DLNA投屏架构图1.3 Miracast投屏架构图二、技术架构总览2.1 核心组成组件说明SystemUI 应用MiracastSource入口控制中心/状态栏无线投屏开关、设备列表与连接状态展示Settings 应用系统配置入口DLNA DMR 开关与设备名 persist.dlnadmr.*、Miracast 相关设置Cast 应用applications_castMiracastSink端应用负责 setDiscoverable、连接确认、镜像画面播放MirrorPlayerDLNA 应用applications_dlnaDLNASource端示例通过 AVSessionKit 发起设备发现、投屏与播控投播管理框架castengine_cast_frameworkCastEngine 中间层SA5526统一管理会话与设备发现对外提供 ohos.cast NAPI内部分发DlnaManager/WifiDisplayManagerWi-Fi Displaycastengine_wifi_displayMiracast 协议服务SA5527/5528WfdSource/WfdSinkP2P 建链、RTSP/RTP 音视频传输DLNA 服务castengine_dlnaDLNA DMR 协议服务SA1603SSDP 广播、SOAP 播控、媒体渲染2.2 投屏模式模式说明Miracast Source 端从本设备向大屏发起镜像投屏模块中由SystemUI MiracastService 负责发现、addDevice 建链底层自动完成屏幕采集与发流Miracast Sink 端接收对端投屏请求模块中由applications_cast负责可发现、连接确认与 MirrorPlayer 渲染DLNA DMCDigital Media Controller控制端发现 DMR 并下发媒体 URL 与播控指令模块 中由applications_dlna AVSessionKit 体现DLNA DMRDigital Media Renderer渲染端接收并播放音视频由castengine_dlna实现Settings 负责开关与设备名配置三、开发指南章节索引3.1 基础概念与概述章节内容简介富对富投屏简要介绍核心能力、源码获取、仓库列表富对富投屏 README文档总览与场景索引3.2 投播管理服务模块CastEngine Framework投播管理框架是 DLNA 与 Miracast 共用的中间层对上暴露统一 NAPI对下按协议调度不同底层引擎。章节内容简介投播管理服务模块介绍SA 5526 架构、公共能力、DLNA/Miracast 分支、与各模块分工3.3 DLNA 投屏开发3.3.1 框架设计章节内容简介DLNA 投屏工作原理DLNA 协议架构、SSDP 发现、DMC/DMR 协作流程DLNA 框架设计内容投屏总体架构、三层分层、DMC/DMR 双角色3.3.2 Source 端开发DLNA Source 通常通过AVSessionKit触发发现与投屏经 framework 的 DlnaManager 完成 DMC 侧逻辑。章节内容简介DLNA 应用Source 端设备发现、startCasting、播控与 UI 交互3.3.3 Sink 端开发DLNA Sink 侧 DMR 开关与设备名在 Settings 配置协议与播放在 castengine_dlna 完成。章节内容简介系统设置应用DLNApersist.dlnadmr.enable、friendlyname 等配置投屏核心服务DMRDmrManager、SSDP、SOAP 播控、播放器对接3.3.4 接口设计章节内容简介DLNA Source 端接口说明AVSessionKit、CastSession、DlnaManager 关键接口DLNA Sink 端接口说明DMR 配置、dmrnapi、连接确认与播放3.3.5 示例使用说明章节内容简介DLNA 示例使用说明开发依赖、编译烧录、使用流程、调试方法3.4 Miracast 投屏开发3.4.1 框架设计章节内容简介Miracast 框架设计镜像投屏总体架构、分层设计、与 CastEngine 协作3.4.2 Source 端开发Miracast Source 由SystemUI承担入口与流程调度applications_cast(source).md 文档描述 Source 端关键 API 与调用链。章节内容简介SystemUI 应用Miracast Source控制中心开关、MiracastService、设备列表与连接Miracast Source 端开发说明startDiscovery、createCastSession、addDevice 等 Source 流程3.4.3 Sink 端开发章节内容简介Miracast Sink 端应用setDiscoverable、deviceRequest、accept、createMirrorPlayer3.4.4 底层协议服务章节内容简介Wi-Fi Display 模块WfdSource/WfdSink、P2P 建链、RTSP/RTP、与 framework 桥接3.4.5 接口设计章节内容简介Miracast Source 端接口说明CastSessionManager、WifiDisplayManager、Source 会话接口Miracast Sink 端接口说明Sink 可发现、连接确认、MirrorPlayer 接口3.4.6 示例使用说明章节内容简介Miracast 示例使用说明开发依赖、编译烧录、双端联调步骤四、开发流程指引4.1 源码获取repo init -u https://gitee.com/ohos-oneconnect/manifest -b OpenHarmony-5.0.0-Release -m m_miracast.xml repo sync -c repo forall -cgit lfs pullrepo forall -cgit checkout OneConnect-v1.2.0-Releaserepo forall -cgit lfs pull# 下载预编译包bash build/prebuilts_download.sh# 编译以 rk3568 为例./build.sh--product-namerk3568--ccache4.2 DLNA Source 端开发流程集成 AVSessionKit 投屏能力获取 DLNA 应用源码applications_dlna参考DLNA Source 端接口说明实现 startCastDeviceDiscovery(TYPE_DLNA) 触发 framework 的 DlnaManager 发现监听 deviceAvailable用户选设备后调用 startCasting 建立投屏会话媒体播控通过 getAVCastController 获取控制器调用 prepare / start 下发媒体 URL使用 sendControlCommand 实现 play / pause / seek / volume 等与 framework 的关系Source 应用层多经AVSessionKit不直接调用 ohos.cast设备发现与会话由 castengine_cast_framework5526内的 DlnaManager 调度底层 DMR 协议在 castengine_dlna1603完成4.3 DLNA Sink 端开发流程Settings 集成 DMR 配置获取设置应用源码applications_settings参考系统设置应用DLNA实现 DMR 开关写入 persist.dlnadmr.enable配置设备显示名persist.dlnadmr.friendlynameDMR 协议与播放理解castengine_dlna中 DmrOpen、SSDP 广播、SOAP 指令处理Sink 播放经 ohos.dmrnapi / dlnaplayer不经 Cast NAPI 主路径接受投屏Source 端选择设备后Sink 建立 DLNA 会话并进入待播状态接收 SetAVTransportURI 后开始渲染4.4 Miracast Source 端开发流程SystemUI 集成投屏入口获取 SystemUI 源码applications_systemui参考SystemUI 应用与Source 端开发说明在控制中心实现投屏开关调用 MiracastService.startDiscovery([8])注册 deviceFound / deviceState 更新设备列表与连接状态连接目标设备用户选择设备后调用 connectToTarget()内部 createCastSession(CAST_SOURCE) addDevice注意无 connect(device) 伪接口连接统一用 castSession.addDevice(device)连接成功后屏幕捕获与发流由 castengine_wifi_displayWfdSource自动完成应用层无需再调 Mirror API结束投屏通过控制中心关闭投屏或 removeDevice / stopDiscovery 断开4.5 Miracast Sink 端开发流程开发 Cast Sink 应用获取 Cast 应用源码applications_cast参考Miracast Sink 端应用调用 cast.setDiscoverable(true) 进入可发现状态监听 deviceRequest用户确认后调用 castSession.accept(deviceId, true)镜像播放连接成功后 createMirrorPlayer()绑定 XComponent Surface调用 mirrorPlayer.setSurface / play 开始渲染Settings 可选集成可在设置页提供 Miracast 相关开关与 Cast 应用联动4.6 联合调试Miracast 双端联调编译并烧录固件到两台设备RK3568 或其他标准系统设备Sink 端打开 Cast 应用或调用 setDiscoverable(true)Source 端从控制中心进入无线投屏触发 startDiscoverySource 端在设备列表中选择 Sink 设备等待 Sink 端 accept观察镜像画面与音视频同步验证断开与重连DLNA 双端联调Sink 端在 Settings 中打开 DLNA 投屏DMR开关Source 端使用 HarmonyOS / OpenHarmony 第三方影音应用或 applications_dlna 模块点击投屏按钮在设备列表中选择 Sink 端 DMR验证播放、暂停、进度拖动等播控同步结束投屏后会话关闭Sink 恢复待机或本地界面五、代码仓库索引仓库名称仓库地址用途说明SystemUI 应用https://gitcode.com/ohos-oneconnect/applications_systemuiMiracast Source 入口控制中心/状态栏投屏系统设置https://gitcode.com/ohos-oneconnect/applications_settingsDLNA DMR 开关与设备名、投屏相关设置Cast 应用https://gitcode.com/ohos-oneconnect/applications_castMiracastSink端连接确认与镜像播放投播管理框架https://gitcode.com/ohos-oneconnect/castengine_cast_frameworkCastEngine 中间层SA 5526统一 NAPI 与会话管理Wi-Fi Displayhttps://gitcode.com/ohos-oneconnect/castengine_wifi_displayMiracast WFD 协议SA 5527/5528DLNA 投屏核心https://gitcode.com/ohos-oneconnect/castengine_dlnaDLNA DMR 协议SA 1603DLNA Source 应用https://gitcode.com/ohos-oneconnect/applications_dlnaDLNA Source 端示例AVSessionKit