目录

使用MDNS访问局域网服务

简介

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

MDNS管理的典型场景有：

为了保证应用的运行效率，大部分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';

  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)}`);
  })
  // ...

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

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

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

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

发现本地服务

  1. 设备连接Wi-Fi。

  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';

  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);

  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));
  // ...
});

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

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

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

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

  7. 取消订阅的MDNS服务。

    // 取消订阅的MDNS服务。不传入callback时，取消订阅该事件的所有回调。
discoveryService.off('discoveryStart');
discoveryService.off('discoveryStop');
discoveryService.off('serviceFound');
discoveryService.off('serviceLost');