文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS 5

DLNA相关接口好像是DMR相关的播放控制的?有没有搜索局域网的DMS并浏览DMS上的媒体文件的接口?

DLNA相关接口好像是DMR相关的播放控制的?有没有搜索局域网的DMS并浏览DMS上的媒体文件的接口?
点赞
收藏
回复
5
分享
举报
浏览146 发布于2025-12-22 09:59湖北
全部评论
最多点赞
最新发布
最早发布
|
技术支持

开发者您好,目前没有搜索局域网的DMS并浏览DMS上的媒体文件的接口。您可以先查看是否有满足需求的三方库,参考C/C++三方库交叉编译。如不满足,麻烦完善一下以下信息:

请问您是在什么样的业务场景中使用该能力,交互流程是怎样的,在哪一个环节遇到了问题?另外请您说明能力不满足可能带来的影响:什么时间用到?是否高频?有无三方库可以做到?若提供该能力,是否会造成大工作量返工?请您注意提供的内容不要包含您或第三方的非公开信息,如给您带来不便,敬请谅解。

2
3楼编辑于2026-01-05 03:24 来自广东
  • 我的胡子一点点
    好的,我这边找一下三方库
    2026-01-08 08:24 来自湖北
  • 雷霆击碎黑暗回复我的胡子一点点
    好的呢
    2026-01-08 08:42 来自广东
一、设备发现实现方案
  • SSDP协议搜索DMS设备

使用@kit.ConnectivityKit中的UDP通信能力进行局域网设备探测:

收起
自动换行
深色代码主题
复制
import { socket } from '@kit.ConnectivityKit';

// 创建UDP Socket
let udpSocket = socket.constructUDPSocketInstance();
udpSocket.bind().then(() => {
  // 发送M-SEARCH广播
  const ssdpRequest = '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:MediaServer:1\r\n\r\n';
  udpSocket.send({ data: ssdpRequest, address: '239.255.255.250', port: 1900 });
});

// 监听响应
udpSocket.on('message', (msg) => {
  console.log(`收到设备响应: ${msg.data}`);
  // 解析LOCATION字段获取设备描述URL
});
  • 解析设备信息

通过HTTP请求获取设备描述文件(XML格式),提取DMS服务地址和控制URL:

收起
自动换行
深色代码主题
复制
import http from '@kit.NetworkKit';

http.createHttp().request(
  "http://[DMS_IP]/description.xml",
  { method: 'GET' },
  (err, data) => {
    if (data) {
      // 解析XML中的<serviceType>urn:schemas-upnp-org:service:ContentDirectory:1</serviceType>
    }
  }
);

二、媒体文件浏览实现

调用ContentDirectory服务

使用SOAP协议发送Browse动作请求获取媒体列表:

收起
自动换行
深色代码主题
复制
const soapBody = `<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <u:Browse xmlns:u="urn:schemas-upnp-org:service:ContentDirectory:1">
      <ObjectID>0</ObjectID>
      <BrowseFlag>BrowseDirectChildren</BrowseFlag>
      <Filter>*</Filter>
      <StartingIndex>0</StartingIndex>
      <RequestedCount>100</RequestedCount>
      <SortCriteria></SortCriteria>
    </u:Browse>
  </s:Body>
</s:Envelope>`;

http.createHttp().request(
  "http://[DMS_IP]/Control/ContentDirectory",
  {
    method: 'POST',
    header: { 'Content-Type': 'text/xml; charset="utf-8"' },
    extraData: soapBody
  },
  (err, data) => {
    // 解析返回的DIDL-Lite格式媒体信息
  }
);

三、关键注意事项

权限配置

在module.json5中添加网络权限:

收起
自动换行
深色代码主题
复制
"requestPermissions": [{
  "name": "ohos.permission.INTERNET"
}]
  • 协议兼容性处理
  • 需处理不同DMS厂商的XML响应差异
  • 对didl:Lite格式的媒体元数据进行解析
  • 性能优化建议
  • 使用@kit.TaskPoolKit创建后台任务防止主线程阻塞
  • 对频繁的SSDP搜索做节流控制

四、替代方案参考

若需简化开发流程,可考虑:

  • 集成第三方C++ DLNA库(如CyberLink),通过Native API调用
  • 使用@kit.DistributedDataKit实现自定义设备发现协议
展开全部
2楼回复于2025-12-25 06:48 来自广东

鸿蒙 DLNA DMS 搜索 / 媒体浏览接口说明

核心结论

鸿蒙原生 DLNA 相关 API仅聚焦 DMR(数字媒体渲染器)的播放控制(如投屏、播放 / 暂停),无内置的 DMS(数字媒体服务器)搜索、浏览媒体文件的官方接口;需通过「自定义实现 SSDP 协议 + 解析 UPnP/HTTP 请求」或适配开源库完成 DMS 相关操作。

一、鸿蒙原生 DLNA 接口现状

鸿蒙官方提供的 DLNA 能力(如@ohos.multimedia.dlna模块)仅覆盖 DMR 侧:

  • 支持:发现 DMR 设备、控制 DMR 播放 / 暂停 / 停止、投屏本地媒体到 DMR;
  • 不支持:搜索 DMS 设备、遍历 DMS 上的媒体文件列表、读取 DMS 媒体元数据。

二、实现 DMS 搜索 + 媒体浏览的解决方案(极简版)

1. 核心原理

DMS 的发现依赖SSDP 协议(简单服务发现协议),媒体浏览依赖 UPnP 的ContentDirectory服务(HTTP/XML 接口),需手动实现这两层逻辑:

2. 关键步骤(鸿蒙 6/api20 适配)

步骤 1:实现 SSDP 搜索 DMS 设备

SSDP 通过 UDP 组播(239.255.255.250:1900)发送搜索请求,解析响应获取 DMS 设备信息:

typescript

运行

收起
自动换行
深色代码主题
复制
import udp from '@ohos.net.udp';
import { BusinessError } from '@ohos.base';

// 1. 创建UDP Socket
const udpSocket = udp.constructUDPSocketInstance();
// 2. 绑定端口
udpSocket.bind({ port: 0 }).then(async () => {
  // 3. 发送SSDP搜索DMS请求
  const ssdpMsg = `M-SEARCH * HTTP/1.1\r
HOST: 239.255.255.250:1900\r
MAN: "ssdp:discover"\r
MX: 3\r
ST: urn:schemas-upnp-org:device:MediaServer:1\r
USER-AGENT: HarmonyOS/6.0 UPnP/1.0\r
\r`;
  await udpSocket.sendTo({
    data: new TextEncoder().encode(ssdpMsg),
    address: { ip: '239.255.255.250', port: 1900, family: udp.AddressFamily.AF_INET }
  });
  // 4. 监听DMS响应
  udpSocket.on('message', (res) => {
    const resp = new TextDecoder().decode(res.message);
    // 解析响应获取DMS设备的URL(Location字段)
    if (resp.includes('MediaServer')) {
      const location = resp.match(/Location: (.*)\r/)?.[1];
      console.log('发现DMS设备:', location);
      // 下一步:通过Location URL调用UPnP接口浏览媒体
    }
  });
}).catch((err: BusinessError) => {
  console.error('SSDP搜索失败:', err.message);
});
步骤 2:调用 DMS 的 UPnP 接口浏览媒体文件

通过 SSDP 获取的 DMS 设备Location URL,调用ContentDirectory服务的Browse方法,解析 XML 响应得到媒体文件列表:

typescript

运行

收起
自动换行
深色代码主题
复制
import http from '@ohos.net.http';

// 浏览DMS媒体文件(示例)
async function browseDmsMedia(dmsLocation: string) {
  // 1. 先请求DMS的设备描述文件,获取ContentDirectory服务地址
  const deviceResp = await http.createHttp().request(dmsLocation, { method: http.RequestMethod.GET });
  const deviceXml = new TextDecoder().decode(deviceResp.result as ArrayBuffer);
  // 解析XML获取ContentDirectory的控制URL(controlURL)
  const controlUrl = deviceXml.match(/<controlURL>(.*)<\/controlURL>/)?.[1];
  if (!controlUrl) return;

  // 2. 发送UPnP Browse请求(获取根目录媒体)
  const browseBody = `<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <s:Body>
    <u:Browse xmlns:u="urn:schemas-upnp-org:service:ContentDirectory:1">
      <ObjectID>0</ObjectID>
      <BrowseFlag>BrowseDirectChildren</BrowseFlag>
      <Filter>*</Filter>
      <StartingIndex>0</StartingIndex>
      <RequestedCount>100</RequestedCount>
      <SortCriteria></SortCriteria>
    </u:Browse>
  </s:Body>
</s:Envelope>`;

  const httpClient = http.createHttp();
  const resp = await httpClient.request(controlUrl, {
    method: http.RequestMethod.POST,
    header: {
      'Content-Type': 'text/xml; charset=utf-8',
      'SOAPAction': 'urn:schemas-upnp-org:service:ContentDirectory:1#Browse'
    },
    extraData: browseBody
  });
  // 3. 解析XML响应,提取媒体文件的URL、名称、类型等
  const mediaXml = new TextDecoder().decode(resp.result as ArrayBuffer);
  console.log('DMS媒体列表XML:', mediaXml);
}

3. 简化方案:适配开源 DLNA 库

无需从零实现,可适配鸿蒙兼容的开源 DLNA 库(如Cling/CyberGarage的鸿蒙移植版),直接调用封装好的 DMS 搜索、媒体浏览接口,减少重复开发。

三、关键注意事项

  1. 权限配置:需在module.json5中添加ohos.permission.INTERNET(网络)、ohos.permission.ACCESS_WIFI_STATE(局域网访问);
  2. 线程要求:UDP/HTTP 操作需放在TaskPool(非 UI 线程)执行,避免阻塞;
  3. 兼容性:不同品牌 DMS 的 UPnP 接口可能略有差异,需兼容 XML 解析逻辑;
  4. 商用注意:开源库需遵守开源协议,鸿蒙侧需适配 API20/6.0 的接口规范。
展开全部
1楼回复于2025-12-24 03:15 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。