输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API
开发与测试开放能力API系统网络Network Kit（网络服务）访问网络使用MDNS访问局域网服务

使用MDNS访问局域网服务

更新时间: 2026-08-29 09:41
本文导读

简介

MDNS即多播DNS（Multicast DNS），提供局域网内的本地服务添加、移除、发现、解析等能力。

  • 本地服务：局域网内服务的提供方，比如打印机、扫描仪等。

MDNS管理的典型场景有：

  • 管理本地服务，通过对本地服务的创建，删除和解析等管理本地服务。
  • 发现本地服务，通过DiscoveryService对象，对指定类型的本地服务状态变化进行监听。
说明

为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用Promise函数，更多方式可以查阅@ohos.net.mdns (MDNS管理)。

以下分别介绍具体开发方式。

说明

在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需在页面中使用UIAbilityContext提供的能力，请参见获取UIAbility的上下文信息。

管理本地服务

  1. 设备连接Wi-Fi。

  2. 从@kit.NetworkKit里导入mdns、错误码、以及common命名空间。

    // 从@kit.NetworkKit中导入mdns命名空间。
import { mdns } from '@kit.NetworkKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
    Index.ets

  3. 调用addLocalService方法，添加本地服务。

    // 建立LocalService对象。
private localServiceInfo: mdns.LocalServiceInfo = {
  serviceType: '_print._tcp',
  serviceName: 'servicename',
  port: 5555,
  host: {
    address: '127.0.0.1'
  },
  serviceAttribute: [{ key: '111', value: [1] }]
};
// ...
  let context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
  // addLocalService添加本地服务。
  mdns.addLocalService(context, this.localServiceInfo).then((data) => {
    // ...
    hilog.info(0x0000, 'testTag', `Local Service Added: ${JSON.stringify(data)}`);
  })
  // ...
    Index.ets

  4. 通过resolveLocalService方法，解析本地网络的IP地址（非必要，根据需求使用）。

    // resolveLocalService解析本地服务对象（非必要，根据需求使用）。
mdns.resolveLocalService(context, this.localServiceInfo).then((data: mdns.LocalServiceInfo) => {
  // ...
  hilog.info(0x0000, 'testTag', `Resolved Local Service: ${JSON.stringify(data)}`);
})
    Index.ets

  5. 通过removeLocalService方法，移除本地服务。

    // removeLocalService移除本地服务。
mdns.removeLocalService(context, this.localServiceInfo).then((data: mdns.LocalServiceInfo) => {
  // ...
  hilog.info(0x0000, 'testTag', `Local Service Removed: ${JSON.stringify(data)}`);
})
    Index.ets

发现本地服务

  1. 设备连接WiFi。

  2. 从@kit.NetworkKit里导入mdns的命名空间。

    // 从@kit.NetworkKit中导入mdns命名空间。
import { mdns } from '@kit.NetworkKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
    Index.ets

  3. 创建DiscoveryService对象，用于发现指定服务类型的MDNS服务。

    let context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
    
// ...
// 创建DiscoveryService对象，用于发现指定服务类型的MDNS服务。
let serviceType = '_print._tcp';
let discoveryService = mdns.createDiscoveryService(context, serviceType);
    Index.ets

  4. 订阅MDNS服务发现相关状态变化。

    // 订阅MDNS服务发现相关状态变化。
discoveryService.on('discoveryStart', (data: mdns.DiscoveryEventInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
});
discoveryService.on('discoveryStop', (data: mdns.DiscoveryEventInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
});
discoveryService.on('serviceFound', (data: mdns.LocalServiceInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
  // ...
});
discoveryService.on('serviceLost', (data: mdns.LocalServiceInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
  // ...
});
    Index.ets

  5. 启动搜索局域网内的MDNS服务。

    // 启动搜索局域网内的MDNS服务。
discoveryService.startSearchingMDNS();
    Index.ets

  6. 停止搜索局域网内的MDNS服务。

    // 停止搜索局域网内的MDNS服务。
discoveryService.stopSearchingMDNS();
    Index.ets

  7. 取消订阅的MDNS服务。

    // 取消订阅的MDNS服务。
discoveryService.off('discoveryStart', (data: mdns.DiscoveryEventInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
});
discoveryService.off('discoveryStop', (data: mdns.DiscoveryEventInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
});
discoveryService.off('serviceFound', (data: mdns.LocalServiceInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
  // ...
});
discoveryService.off('serviceLost', (data: mdns.LocalServiceInfo) => {
  hilog.info(0x0000, 'testTag', JSON.stringify(data));
  // ...
});
    Index.ets
使用Socket访问网络
使用DNS解析域名
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词