@ohos.net.mdns (MDNS管理)

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

说明： 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import mdns from '@ohos.net.mdns'

mdns.addLocalService

addLocalService(context: Context, serviceInfo: LocalServiceInfo, callback: AsyncCallback<LocalServiceInfo>): void

添加一个mDNS服务，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

错误码：

错误码说明： 以上错误码的详细介绍参见MDNS错误码。

示例：

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;

let localServiceInfo: mdns.LocalServiceInfo = {
  serviceType: "_print._tcp",
  serviceName: "servicename",
  port: 5555,
  host: {
  address: "10.14.**.***",
  },
  serviceAttribute: [{key: "111", value: [1]}]
}

mdns.addLocalService(context, localServiceInfo, (error:BusinessError, data:mdns.LocalServiceInfo) =>  {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

mdns.addLocalService

addLocalService(context: Context, serviceInfo: LocalServiceInfo): Promise<LocalServiceInfo>

添加一个mDNS服务，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

返回值：

错误码：

错误码说明： 以上错误码的详细介绍参见MDNS错误码。

示例：

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;

let localServiceInfo: mdns.LocalServiceInfo = {
  serviceType: "_print._tcp",
  serviceName: "servicename",
  port: 5555,
  host: {
    address: "10.14.**.***",
  },
  serviceAttribute: [{key: "111", value: [1]}]
}

mdns.addLocalService(context, localServiceInfo).then((data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

mdns.removeLocalService

removeLocalService(context: Context, serviceInfo: LocalServiceInfo, callback: AsyncCallback<LocalServiceInfo>): void

移除一个mDNS服务，使用callback方式作为异步方法。

系统能力: SystemCapability.Communication.NetManager.MDNS

参数

错误码：

错误码说明： 以上错误码的详细介绍参见MDNS错误码。

示例：

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;

let localServiceInfo: mdns.LocalServiceInfo = {
  serviceType: "_print._tcp",
  serviceName: "servicename",
  port: 5555,
  host: {
  address: "10.14.**.***",
  },
  serviceAttribute: [{key: "111", value: [1]}]
}

mdns.removeLocalService(context, localServiceInfo, (error: BusinessError, data: mdns.LocalServiceInfo) =>  {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

mdns.removeLocalService

removeLocalService(context: Context, serviceInfo: LocalServiceInfo): Promise<LocalServiceInfo>

移除一个mDNS服务. 使用Promise方式作为异步方法。

系统能力: SystemCapability.Communication.NetManager.MDNS

参数

返回值：

错误码：

错误码说明： 以上错误码的详细介绍参见MDNS错误码。

示例：

Stage模型示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;

let localServiceInfo: mdns.LocalServiceInfo = {
  serviceType: "_print._tcp",
  serviceName: "servicename",
  port: 5555,
  host: {
  address: "10.14.**.***",
  },
  serviceAttribute: [{key: "111", value: [1]}]
}

mdns.removeLocalService(context, localServiceInfo).then((data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

mdns.createDiscoveryService

createDiscoveryService(context: Context, serviceType: string): DiscoveryService

返回一个DiscoveryService对象，该对象用于发现指定服务类型的mDNS服务。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

返回值：

错误码：

示例

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;

let serviceType = "_print._tcp";
let discoveryService : Object = mdns.createDiscoveryService(context, serviceType);

mdns.resolveLocalService

resolveLocalService(context: Context, serviceInfo: LocalServiceInfo, callback: AsyncCallback<LocalServiceInfo>): void

解析一个mDNS服务，使用callback方式作为异步方法。

系统能力: SystemCapability.Communication.NetManager.MDNS

参数：

错误码：

错误码说明： 以上错误码的详细介绍参见MDNS错误码。

示例：

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;

let localServiceInfo: mdns.LocalServiceInfo = {
  serviceType: "_print._tcp",
  serviceName: "servicename",
  port: 5555,
  host: {
  address: "10.14.**.***",
  },
  serviceAttribute: [{key: "111", value: [1]}]
}

mdns.resolveLocalService(context, localServiceInfo, (error: BusinessError, data: mdns.LocalServiceInfo) =>  {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

mdns.resolveLocalService

resolveLocalService(context: Context, serviceInfo: LocalServiceInfo): Promise<LocalServiceInfo>

解析一个mDNS服务，使用Promise方式作为异步方法。

系统能力: SystemCapability.Communication.NetManager.MDNS

参数：

返回值：

错误码：

错误码说明： 以上错误码的详细介绍参见MDNS错误码。

示例：

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;

let localServiceInfo: mdns.LocalServiceInfo = {
  serviceType: "_print._tcp",
  serviceName: "servicename",
  port: 5555,
  host: {
  address: "10.14.**.***",
  },
  serviceAttribute: [{key: "111", value: [1]}]
}

mdns.resolveLocalService(context, localServiceInfo).then((data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

DiscoveryService

指定服务类型的发现服务对象。

startSearchingMDNS

startSearchingMDNS(): void

开始搜索局域网内的mDNS服务。

系统能力：SystemCapability.Communication.NetManager.MDNS

示例：

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

stopSearchingMDNS

stopSearchingMDNS(): void

停止搜索局域网内的mDNS服务。

系统能力：SystemCapability.Communication.NetManager.MDNS

示例：

Stage模型示例：

// 获取context
import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.stopSearchingMDNS();

on('discoveryStart')

on(type: 'discoveryStart', callback: Callback): void

订阅开启监听mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('discoveryStart', (data: mdns.DiscoveryEventInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

off('discoveryStart')

off(type: 'discoveryStart', callback?: Callback<DiscoveryEventInfo>): void

取消开启监听mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('discoveryStart', (data: mdns.DiscoveryEventInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

discoveryService.off('discoveryStart', (data: mdns.DiscoveryEventInfo) => {
  console.log(JSON.stringify(data));
});

on('discoveryStop')

on(type: 'discoveryStop', callback: Callback<DiscoveryEventInfo>): void

订阅停止监听mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('discoveryStop', (data: mdns.DiscoveryEventInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

off('discoveryStop')

off(type: 'discoveryStop', callback?: Callback<DiscoveryEventInfo>): void

取消订阅停止监听mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('discoveryStop', (data: mdns.DiscoveryEventInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

discoveryService.off('discoveryStop', (data: mdns.DiscoveryEventInfo) => {
  console.log(JSON.stringify(data));
});

on('serviceFound')

on(type: 'serviceFound', callback: Callback<LocalServiceInfo>): void

订阅发现mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('serviceFound', (data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

off('serviceFound')

off(type: 'serviceFound', callback?: Callback<LocalServiceInfo>): void

取消订阅发现mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('serviceFound', (data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

discoveryService.off('serviceFound', (data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

on('serviceLost')

on(type: 'serviceLost', callback: Callback<LocalServiceInfo>): void

订阅移除mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('serviceLost', (data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

off('serviceLost')

off(type: 'serviceLost', callback?: Callback<LocalServiceInfo>): void

取消订阅移除mDNS服务的通知。

系统能力：SystemCapability.Communication.NetManager.MDNS

参数：

示例：

import mdns from '@ohos.net.mdns'
import { BusinessError } from '@ohos.base';

// 参考mdns.createDiscoveryService
let context = getContext(this) as Context;
let serviceType = "_print._tcp";
let discoveryService = mdns.createDiscoveryService(context, serviceType);
discoveryService.startSearchingMDNS();

discoveryService.on('serviceLost', (data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

discoveryService.stopSearchingMDNS();

discoveryService.off('serviceLost', (data: mdns.LocalServiceInfo) => {
  console.log(JSON.stringify(data));
});

LocalServiceInfo

mDNS服务信息

系统能力：SystemCapability.Communication.NetManager.MDNS

ServiceAttribute

mDNS服务属性信息

系统能力：SystemCapability.Communication.NetManager.MDNS

MdnsError

mDNS错误信息。

系统能力：SystemCapability.Communication.NetManager.MDNS