Android DLNA 开发实战：DMR、DMC、DMS 三件套落地与避坑指南-北京尧图网络

简介这是一份面向Android开发者的DLNA协议实现参考项目基于Cling开源框架在移动端完整落地DMR、DMC、DMS三类角色DMR负责接收并播放媒体流DMC用于发现设备、浏览内容并下发播放控制指令DMS则将本地音视频与图片目录共享给家庭网络中的其他设备。资源包共7234个文件约53.73MB以class、dex、flat等编译产物为主同时保留607个java源码、294个xml布局与配置、164个jar依赖及若干gradle构建脚本便于对照阅读与二次编译。项目结构包含gradlew构建脚本、build.gradle与settings.gradle配置、README说明及LICENSE授权文件目录组织清晰。目前已有2333人学习下载适合希望理解UPnP/DLNA设备发现、内容浏览与媒体渲染流程并计划在Android应用中集成投屏与多屏互动能力的开发者参考。1. DLNA 三件套在 Android 上到底怎么落地DMR、DMC、DMS 的角色分工很多人第一次接触 DLNA脑子里只有一句模糊的印象手机能把视频投到电视上。但真到 Android 端动手才发现协议里塞了三个角色——DMR、DMC、DMS而且它们不是三个独立 App而是同一套 UPnP 栈上的三种能力组合。DMS 是媒体服务器负责把本地文件通过 HTTP 暴露出去并对外描述内容目录DMR 是渲染器负责接收指令、拉流、解码、播放DMC 是控制器负责发现设备、浏览目录、下发播放控制。三者之间靠 SSDP 发现、HTTP 描述、SOAP 控制、GENA 事件四条通道串起来。这篇文章面向的是要在 Android 上真正把 DLNA 跑通的开发者你可能想让手机当遥控器去控制电视也可能想让手机当接收端被别的设备投屏或者让手机当媒体库把本地视频共享出去。下面按「先立协议模型、再拆三个角色、最后落到排错」的顺序讲每一步都给可复现的配置和代码骨架参数怎么设、坑在哪都会点出来。2. 先把 UPnP 四层通信模型立住SSDP、描述、SOAP、GENADLNA 本质是 UPnP 的一个应用规范所以不理解 UPnP 的四层通信后面写 DMC 或 DMR 都会变成玄学调参。这四层分别是设备发现SSDP、设备与服务的 XML 描述、动作调用SOAP、事件订阅GENA。任何一次「手机点一下电视开始播」的背后都是这四层按顺序走了一遍。2.1 SSDP 发现M-SEARCH 报文和 NOTIFY 广播SSDP 跑在 UDP 239.255.255.250:1900 上。控制点DMC主动发现设备时发 M-SEARCH设备上线时发 NOTIFY 广播。M-SEARCH 的关键是 STSearch Target头找媒体服务器用urn:schemas-upnp-org:device:MediaServer:1找渲染器用urn:schemas-upnp-org:device:MediaRenderer:1。# 用 nc 手动发一条 M-SEARCH验证局域网里有没有 DLNA 设备响应 # -u 走 UDP目标组播地址和端口是 SSDP 固定值 printf M-SEARCH * HTTP/1.1\r\nHOST: 239.255.255.250:1900\r\nMAN: ssdp:discover\r\nMX: 3\r\nST: urn:schemas-upnp-org:device:MediaRenderer:1\r\n\r\n \ | nc -u -w 5 239.255.255.250 1900MX 是设备随机延迟响应的最大秒数设 3 表示设备会在 0 到 3 秒内随机回避免所有设备同时应答造成风暴。ST 决定你只收渲染器还是收全部设备写ssdp:all会收到所有 UPnP 设备调试时方便但生产环境要收窄。如果这条命令没有任何响应先别怀疑代码检查手机和电视是否在同一网段、路由器是否开了 AP 隔离——这是最常见的翻车点。2.2 描述、SOAP 与 GENA从 device description 到事件回调设备响应 M-SEARCH 时会带一个 LOCATION 头指向它的 device description XML。这个 XML 里有 deviceType、friendlyName、serviceList每个 service 又有 serviceType、controlURL、eventSubURL、SCPDURL。controlURL 是 SOAP 控制入口eventSubURL 是 GENA 事件订阅入口SCPDURL 描述这个服务支持哪些 action 和 state variable。SOAP 调用长这样POST 到 controlURLbody 里是 action 名和参数头里带SOAPACTION。GENA 则是你向 eventSubURL 发 SUBSCRIBE带 CALLBACK 和 TIMEOUT设备之后用 NOTIFY 把状态变化推给你。DMR 的 AVTransport 和 RenderingControl 两个服务几乎全靠 GENA 回传播放进度和音量不订阅事件就只能靠轮询体验差一大截。2.3 Android 上选型自己撸 UPnP 栈还是用现成库常见做法是不要从零写 SSDP 和 SOAP 解析用成熟 UPnP 库打底自己只写 DLNA 业务层。选型时看三点是否支持 Android 的 MulticastLock不加锁收不到组播、是否内置 GENA 订阅管理、是否方便替换 HTTP 客户端。自己撸栈的代价主要在 SSDP 的 socket 复用和 GENA 的订阅续期上这两块最容易出玄学 bug。// Android 收 SSDP 组播前必须拿 MulticastLock否则系统会过滤组播包 val wifiManager applicationContext.getSystemService(Context.WIFI_SERVICE) as WifiManager val lock wifiManager.createMulticastLock(dlna-ssdp).apply { setReferenceCounted(true) acquire() } // 用完务必 release长期持有会明显增加耗电 // lock.release()MulticastLock 是 Android 特有的坑不 acquireM-SEARCH 的响应包会被内核直接丢掉表现为「电视明明在线却搜不到」。setReferenceCounted(true) 允许嵌套 acquire适合多个模块共用。用完不 release 会导致 WiFi 芯片持续唤醒耗电肉眼可见。3. DMS 实现把本地媒体变成可被浏览的 ContentDirectoryDMS 的核心是两件事用 HTTP 提供媒体文件下载用 ContentDirectory 服务对外描述目录结构。别的设备DMR 或另一个 DMC通过 Browse action 拿到你目录里的对象再根据 res 里的 URL 去拉流。Android 上当 DMS难点不在协议而在文件扫描和 URL 可达性。3.1 ContentDirectory 的 Browse 与对象层级ContentDirectory 用树形结构组织内容根容器 ID 固定是0。Browse action 的关键参数ObjectID 是要浏览的容器BrowseFlag 取BrowseDirectMetadata拿元数据StartingIndex 和 RequestedCount 做分页SortCriteria 一般传空。返回的 DIDL-Lite XML 里每个 object 有 id、parentID、title、class如object.item.videoItem以及一个或多个 res 节点。res 节点是重点protocolInfo 形如http-get:*:video/mp4:*说明这个资源通过 HTTP GET 获取、MIME 是 video/mp4。DMR 就是靠 protocolInfo 判断自己能不能播。如果你给的 MIME 和实际文件不符DMR 可能直接拒绝播放或者播到一半黑屏。!-- Browse 返回的 DIDL-Lite 片段一个视频对象 -- DIDL-Lite xmlnsurn:schemas-upnp-org:metadata-1-0/DIDL-Lite/ item idvideo-001 parentID1 restricted1 dc:title示例视频/dc:title upnp:classobject.item.videoItem/upnp:class res protocolInfohttp-get:*:video/mp4:* size104857600 duration0:05:30.000 resolution1920x1080http://192.168.1.20:8192/media/video-001.mp4/res /item /DIDL-Litesize 和 duration 尽量填准部分 DMR 依赖它们做进度条和缓冲判断。resolution 不是必填但填了能帮 DMR 提前决定是否硬解。URL 里的 IP 必须是局域网内其他设备能访问到的地址不能用 127.0.0.1。3.2 用 NanoHTTPD 起一个最小媒体服务Android 上起 HTTP 服务NanoHTTPD 是轻量选择。它单文件、无依赖适合只做媒体分发。下面是一个最小实现支持 Range 请求——这点很关键DMR 拖动进度条时会发 Range 头不支持 Range 就只能从头播。// 最小媒体 HTTP 服务支持 Range供 DMR 拉流 public class MediaHttpServer extends NanoHTTPD { private final File mediaDir; public MediaHttpServer(int port, File mediaDir) { super(port); this.mediaDir mediaDir; } Override public Response serve(IHTTPSession session) { String uri session.getUri(); File file new File(mediaDir, uri.substring(/media/.length())); if (!file.exists()) return newFixedLengthResponse(Response.Status.NOT_FOUND, text/plain, not found); String range session.getHeaders().get(range); long fileLen file.length(); try { if (range ! null range.startsWith(bytes)) { // 解析 Range: bytesstart-endend 可省略 String[] parts range.substring(6).split(-); long start Long.parseLong(parts[0]); long end parts.length 1 !parts[1].isEmpty() ? Long.parseLong(parts[1]) : fileLen - 1; long len end - start 1; FileInputStream fis new FileInputStream(file); fis.skip(start); Response resp newFixedLengthResponse(Response.Status.PARTIAL_CONTENT, video/mp4, fis, len); resp.addHeader(Content-Range, bytes start - end / fileLen); resp.addHeader(Accept-Ranges, bytes); return resp; } Response resp newFixedLengthResponse(Response.Status.OK, video/mp4, new FileInputStream(file), fileLen); resp.addHeader(Accept-Ranges, bytes); return resp; } catch (Exception e) { return newFixedLengthResponse(Response.Status.INTERNAL_ERROR, text/plain, e.getMessage()); } } }Range 解析要处理bytes0-这种只有起点的情况end 默认取 fileLen-1。返回 206 而不是 200并带 Content-Range 头DMR 才知道支持拖动。MIME 这里写死 video/mp4 是简化生产环境要按扩展名映射否则音频、图片会播不了。端口选 8192 这类高位端口避免和系统服务冲突。3.3 媒体扫描与 MIME 映射的边界Android 10 以后分区存储收紧扫描本地视频要么用 MediaStore要么申请 MANAGE_EXTERNAL_STORAGE。用 MediaStore 更合规但拿到的 content:// URI 不能直接给 DMR必须转成你自己的 HTTP URL。做法是维护一张 id 到文件路径的映射表Browse 时输出 HTTP URLserve 时再按 id 找到真实文件。MIME 映射别偷懒。常见视频 mp4→video/mp4、mkv→video/x-matroska、avi→video/x-msvideo音频 mp3→audio/mpeg、flac→audio/flac。映射错了DMR 的 protocolInfo 匹配失败表现是「设备能发现、目录能浏览、就是点播放没反应」这个坑我踩过不止一次。4. DMR 实现接收指令、拉流、把播放状态回传DMR 是被控制的一方要暴露 AVTransport 和 RenderingControl 两个服务接收 SetAVTransportURI、Play、Pause、Stop、Seek 等 action同时通过 GENA 把 TransportState、CurrentTrackDuration、Volume 等状态推给订阅者。Android 上当 DMR播放器选型和控制状态机是两大难点。4.1 AVTransport 状态机与必实现的 actionAVTransport 有一套状态机STOPPED、PLAYING、PAUSED_PLAYBACK、TRANSITIONING、NO_MEDIA_PRESENT。DMC 发 Play 之前必须先 SetAVTransportURI 把当前媒体 URL 设进去否则 Play 无效。Seek 要区分 seek modeREL_TIME 是按时间点TRACK_NR 是按轨道号视频一般只用 REL_TIME。必实现的 action 至少包括SetAVTransportURI、Play、Pause、Stop、Seek、GetTransportInfo、GetPositionInfo、GetMediaInfo。少一个某些 DMC 就会在对应操作上报错。GetPositionInfo 返回的 RelTime 是进度条的数据源必须实时更新不能返回固定值。// AVTransport 的 SOAP action 分发骨架 public String handleAvTransport(String action, MapString, String args) { switch (action) { case SetAVTransportURI: // 第二个参数 CurrentURIMetaData 是 DIDL-Lite解析出真实 URL String uri args.get(CurrentURI); String meta args.get(CurrentURIMetaData); player.setDataSource(uri); currentState STOPPED; notifyEvent(AVTransport, AVTransportURI, uri); return soapResponse(SetAVTransportURI); case Play: player.start(); currentState PLAYING; notifyEvent(AVTransport, TransportState, PLAYING); return soapResponse(Play); case Pause: player.pause(); currentState PAUSED_PLAYBACK; notifyEvent(AVTransport, TransportState, PAUSED_PLAYBACK); return soapResponse(Pause); case Seek: // Unit 为 REL_TIME 时 Target 是 HH:MM:SS 格式 long ms parseDuration(args.get(Target)); player.seekTo(ms); return soapResponse(Seek); default: return soapFault(401, Invalid Action); } }每次状态变化都要 notifyEvent把新状态推给所有订阅了 eventSubURL 的控制点。不推事件DMC 的播放按钮状态就不会更新用户会以为卡死。Seek 的 Target 格式是HH:MM:SS解析时注意补零和毫秒换算。4.2 用 ExoPlayer 承接拉流与渲染ExoPlayer 对 HTTP 拉流、Range、常见封装格式支持都比较全适合做 DMR 的播放内核。关键是把 ExoPlayer 的播放状态回调映射到 AVTransport 状态机并在 onPositionDiscontinuity 或定时器里更新 RelTime。// ExoPlayer 状态映射到 AVTransport 状态 player.addListener(object : Player.Listener { override fun onPlaybackStateChanged(state: Int) { val avState when (state) { Player.STATE_BUFFERING - TRANSITIONING Player.STATE_READY - if (player.playWhenReady) PLAYING else PAUSED_PLAYBACK Player.STATE_ENDED - STOPPED else - NO_MEDIA_PRESENT } currentState avState notifyEvent(AVTransport, TransportState, avState) } }) // 进度回传建议 1 秒一次太频繁会拖垮 GENA handler.postDelayed(object : Runnable { override fun run() { notifyEvent(AVTransport, RelTime, formatDuration(player.currentPosition)) handler.postDelayed(this, 1000) } }, 1000)状态映射要处理 TRANSITIONING缓冲时 DMC 会显示加载中直接报 PLAYING 会让进度条乱跳。RelTime 回传频率别太高GENA 是 HTTP 回调一秒一次已经够用100ms 一次会让低端设备卡顿。4.3 RenderingControl 的音量与静音RenderingControl 主要管音量Volume和静音Mute。GetVolume 返回当前值SetVolume 设置范围通常是 0 到 100。注意这是 DMR 自身的音量不是手机系统音量两者要分开管理。有些 DMC 会在播放前先 SetVolume 到某个值如果你的实现忽略这个调用用户会发现「投屏后音量不受控」。音量变化同样要 notifyEvent事件名是 Volume带 Channel 和 Val 两个 state variable。Mute 用DesiredMute参数取值 0 或 1。实现时把音量值持久化避免进程被杀后丢失。5. DMC 实现发现、浏览、控制三件事的完整链路DMC 是用户直接操作的一端链路最长SSDP 发现设备 → 拉 device description → 解析 service → Browse 目录 → 选媒体 → SetAVTransportURI → Play → 订阅事件更新 UI。任何一环断了用户看到的就是「搜不到」「点不动」「没反应」。5.1 设备发现与描述解析发现阶段收 M-SEARCH 响应后从 LOCATION 拉 XML解析出 deviceType 和 serviceList。要按 deviceType 区分 DMS 和 DMRMediaServer 用来浏览目录MediaRenderer 用来投屏。一个设备可能同时是两者别假设一台设备只有一个角色。// 解析 device description提取 controlURL 和 eventSubURL fun parseDeviceDescription(location: String): DeviceInfo { val xml URL(location).readText() val doc DocumentBuilderFactory.newInstance().newDocumentBuilder() .parse(xml.byteInputStream()) val device doc.getElementsByTagName(device).item(0) as Element val friendlyName device.getElementsByTagName(friendlyName).item(0).textContent val services mutableMapOfString, ServiceInfo() val serviceNodes device.getElementsByTagName(service) for (i in 0 until serviceNodes.length) { val svc serviceNodes.item(i) as Element val type svc.getElementsByTagName(serviceType).item(0).textContent val control svc.getElementsByTagName(controlURL).item(0).textContent val event svc.getElementsByTagName(eventSubURL).item(0).textContent // controlURL 可能是相对路径要基于 LOCATION 的 base 拼成绝对地址 services[type] ServiceInfo(absoluteUrl(location, control), absoluteUrl(location, event)) } return DeviceInfo(friendlyName, services) }controlURL 和 eventSubURL 经常是相对路径比如/upnp/control/AVTransport必须基于 LOCATION 的 scheme、host、port 拼成绝对地址。直接拿相对路径去 POST 会 404这是新手最常见的错误之一。5.2 Browse 分页与 DIDL-Lite 解析Browse 要处理分页先拿 TotalMatches再按 StartingIndex 和 RequestedCount 循环拉。RequestedCount 设 0 表示要全部但大目录一次拉全部会超时建议每页 50 到 100。解析 DIDL-Lite 时res 节点可能有多个要按 protocolInfo 挑 DMR 支持的格式。// 分页 Browse直到拿满 TotalMatches fun browseAll(controlUrl: String, objectId: String): ListMediaItem { val result mutableListOfMediaItem() var start 0 val pageSize 50 while (true) { val resp soapCall(controlUrl, Browse, mapOf( ObjectID to objectId, BrowseFlag to BrowseDirectChildren, StartingIndex to start.toString(), RequestedCount to pageSize.toString(), SortCriteria to )) val didl parseDidl(resp[Result]) result.addAll(didl) val total resp[TotalMatches]!!.toInt() start pageSize if (start total) break } return result }BrowseFlag 用BrowseDirectChildren只拿直接子节点BrowseMetadata拿当前节点自身信息。分页循环要有退出条件TotalMatches 为 0 时直接返回否则会死循环。解析 DIDL 时注意命名空间dc:title 和 upnp:class 前缀不能丢。5.3 投屏控制与 GENA 事件订阅投屏流程SetAVTransportURI 传媒体 URL 和 DIDL-Lite 元数据然后 Play。之后向 eventSubURL 发 SUBSCRIBE 订阅 AVTransport 和 RenderingControl 事件回调地址是 DMC 自己起的 HTTP 服务。收到 NOTIFY 后更新 UI 的播放状态和进度。# 手动订阅 DMR 的 AVTransport 事件验证 GENA 通道 # CALLBACK 指向控制点自己的 HTTP 服务TIMEOUT 用 Second-N 格式 curl -X SUBSCRIBE http://192.168.1.30:49152/upnp/event/AVTransport \ -H CALLBACK: http://192.168.1.20:9999/notify \ -H NT: upnp:event \ -H TIMEOUT: Second-1800订阅成功会返回 SID 和 TIMEOUT。TIMEOUT 到期前要续订续订用 SID 头再发一次 SUBSCRIBE。不续订事件通道会静默失效UI 状态就停在最后一次更新上。CALLBACK 的地址必须是 DMR 能访问到的用 127.0.0.1 会收不到通知。6. 避坑与排查DLNA 联调里最容易翻车的五件事DLNA 联调的问题往往不在协议本身而在网络、权限、格式这些边角。下面五条是我实际项目里反复遇到的按「现象 → 原因 → 解决」写清楚。现象M-SEARCH 发了但一个设备都搜不到。原因通常是 Android 没拿 MulticastLock或者手机和电视不在同一网段再或者路由器开了 AP 隔离。解决先 acquire MulticastLock再用 nc 手动发 M-SEARCH 验证网络最后检查路由器是否隔离了无线客户端。三者按顺序排能省很多时间。现象设备能发现、目录能浏览点播放没反应。原因多半是 protocolInfo 的 MIME 和实际文件不符DMR 匹配失败直接拒绝。解决抓 DMR 的 SOAP 响应看有没有 714Illegal MIME-Type错误把 DMS 的 MIME 映射表按扩展名补全视频音频图片分开处理。现象播放能开始但拖进度条就卡死或重头播。原因是 DMS 的 HTTP 服务不支持 Range 请求或者返回了 200 而不是 206。解决在 serve 里解析 Range 头返回 206 加 Content-Range并带 Accept-Ranges: bytes。用 curl 带-H Range: bytes100-200验证返回码。现象DMC 上播放状态不更新按钮一直是灰色。原因是 GENA 事件没订阅成功或者订阅过期没续订。解决检查 SUBSCRIBE 是否返回 SIDCALLBACK 地址是否可达TIMEOUT 到期前是否续订。用 curl 手动订阅一次看能不能收到 NOTIFY。现象投屏后音量不受控调 DMC 没反应。原因是 DMR 没实现 RenderingControl 的 SetVolume或者把 DMR 音量和系统音量混在一起。解决单独维护 DMR 音量变量SetVolume 后 notifyEvent范围按 0 到 100 处理别直接映射到系统音量。7. 进阶用一套代码同时扮演 DMR 和 DMS 的取舍实际项目里手机往往既要当 DMR 被投屏又要当 DMS 共享本地文件甚至还要当 DMC 去控制电视。一套代码同时扮演三个角色最大的挑战是端口管理、SSDP 响应冲突和状态隔离。端口上DMS 的 HTTP 服务、DMC 的事件回调服务、DMR 的 description 服务各占一个端口建议用配置表统一管理避免硬编码。SSDP 上一个进程同时发 NOTIFY 和收 M-SEARCH 时要注意 socket 的 SO_REUSEADDR否则绑定 1900 会失败。状态隔离上DMR 的播放状态和 DMS 的目录状态必须分开存别用一个全局单例否则投屏时浏览目录会互相干扰。// 三角色共存的端口与状态配置骨架 data class DlnaConfig( val dmsHttpPort: Int 8192, // DMS 媒体分发 val dmcCallbackPort: Int 9999, // DMC 收 GENA 事件 val dmrHttpPort: Int 49152 // DMR 描述与控制 ) class DlnaRoleManager(private val config: DlnaConfig) { // 三个角色各自持有独立状态互不共享 private val dmsState DmsState() private val dmrState DmrState() private val dmcState DmcState() fun startAll() { // 启动顺序先起 HTTP 服务再发 SSDP NOTIFY最后订阅事件 startDmsServer(config.dmsHttpPort) startDmrServer(config.dmrHttpPort) startDmcCallback(config.dmcCallbackPort) sendSsdpNotify() } }验证三角色是否都正常有个简单办法用另一台手机装一个通用 DLNA 客户端分别测试「发现这台手机」「浏览它的目录」「投屏到它」。三个都通说明 DMR 和 DMS 都立住了再用这台手机去控制电视通了说明 DMC 也立住了。我自己的习惯是每加一个 action 实现先用 curl 手动发一次 SOAP 请求验证再接到 UI 上。DLNA 的 SOAP 报文格式容错很低少一个命名空间就报 500手动验证比在 App 里打断点快得多。还有一点血泪经验GENA 的订阅续期一定要用独立定时器别塞在播放进度回调里否则播放一暂停事件通道也跟着过期了。希望帮到你。本文还有配套的精品资源点击获取

Android DLNA 开发实战：DMR、DMC、DMS 三件套落地与避坑指南

相关推荐

内网离线部署RAG知识库问答机器人：从硬件选型到检索调优实践

Vue 项目中修改 Cesium 工具栏提示文字的三种方法与实操记录

多智能体协同架构：MCP协议与A2A通信实战指南

更多资讯

Unity序列帧播放器全解：从素材准备到组件实现与性能优化

电力物资招标全流程解析与中标策略

单片机计算机毕设之基于单片机的成人身高体重体脂秤设计与实现基于STM32的150KG体脂秤身高体重BMI测量装置设计（032503）

蚁群算法工具箱实战：从原理、参数调优到避坑指南

微信小程序模拟炒股实战：从K线图到模拟交易完整实现

C++引用详解：从指针到引用的本质、用法与区别

今日更新

小波包能量谱原理与MATLAB实现：从频带分解到故障特征提取

基于LSTM的网易云音乐评论情感分析：数据清洗与模型调优实战

Alpha-Beta剪枝与极大极小值算法：博弈树搜索原理与实战优化

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？