简介
MDNS即多播DNS(Multicast DNS),提供局域网内的本地服务添加、移除、发现、解析等能力。
- 本地服务:局域网内服务的提供方,比如打印机、扫描器等。
MDNS管理的典型场景有:
- 管理本地服务,通过对本地服务的创建,删除和解析等,管理本地服务。
- 发现本地服务,通过DiscoveryService对象,对指定类型的本地服务状态变化进行监听。
说明
为了保证应用的运行效率,大部分API调用都是异步的,对于异步调用的API均提供了callback和Promise两种方式,以下示例均采用promise函数
以下分别介绍具体开发方式。
接口说明
接口名 | 描述 |
---|---|
addLocalService(context: Context, serviceInfo: LocalServiceInfo, callback: AsyncCallback<LocalServiceInfo>): void | 添加一个MDNS服务,使用callback方式作为异步方法。 |
removeLocalService(context: Context, serviceInfo: LocalServiceInfo, callback: AsyncCallback<LocalServiceInfo>): void | 移除一个MDNS服务,使用callback方式作为异步方法。 |
createDiscoveryService(context: Context, serviceType: string): DiscoveryService | 返回一个DiscoveryService对象,该对象用于发现指定服务类型的MDNS服务。 |
resolveLocalService(context: Context, serviceInfo: LocalServiceInfo, callback: AsyncCallback<LocalServiceInfo>): void | 解析一个MDNS服务,使用callback方式作为异步方法。 |
startSearchingMDNS(): void | 开始搜索局域网内的MDNS服务。 |
stopSearchingMDNS(): void | 停止搜索局域网内的MDNS服务。 |
on(type: 'discoveryStart', callback: Callback<{serviceInfo: LocalServiceInfo, errorCode?: MdnsError}>): void | 订阅开启监听MDNS服务的通知。 |
off(type: 'discoveryStart', callback?: Callback<{ serviceInfo: LocalServiceInfo, errorCode?: MdnsError }>): void | 取消开启监听MDNS服务的通知。 |
on(type: 'discoveryStop', callback: Callback<{serviceInfo: LocalServiceInfo, errorCode?: MdnsError}>): void | 订阅停止监听MDNS服务的通知。 |
off(type: 'discoveryStop', callback?: Callback<{ serviceInfo: LocalServiceInfo, errorCode?: MdnsError }>): void | 取消停止监听MDNS服务的通知。 |
on(type: 'serviceFound', callback: Callback<LocalServiceInfo>): void | 订阅发现MDNS服务的通知。 |
off(type: 'serviceFound', callback?: Callback<LocalServiceInfo>): void | 取消发现MDNS服务的通知。 |
on(type: 'serviceLost', callback: Callback<LocalServiceInfo>): void | 订阅移除MDNS服务的通知。 |
off(type: 'serviceLost', callback?: Callback<LocalServiceInfo>): void | 取消移除MDNS服务的通知。 |
管理本地服务
- 设备连接WiFi。
- 从@kit.NetworkKit里导入mdns的命名空间。
- 调用addLocalService方法,添加本地服务。
- 通过resolveLocalService方法,解析本地网络的IP地址(非必要,根据需求使用)。
- 通过removeLocalService方法,移除本地服务。
// 从@kit.NetworkKit中导入mdns命名空间
import { mdns } from '@kit.NetworkKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { featureAbility } from '@kit.AbilityKit';
let context = getContext(this) as Context;
class ServiceAttribute {
key: string = "111"
value: Array<number> = [1]
}
// 建立LocalService对象
let localServiceInfo: mdns.LocalServiceInfo = {
serviceType: "_print._tcp",
serviceName: "servicename",
port: 5555,
host: {
address: "10.14.**.***"
},
serviceAttribute: [{key: "111", value: [1]}]
}
// addLocalService添加本地服务
mdns.addLocalService(context, localServiceInfo).then((data: mdns.LocalServiceInfo) => {
console.log(JSON.stringify(data));
});
// resolveLocalService解析本地服务对象(非必要,根据需求使用)
mdns.resolveLocalService(context, localServiceInfo).then((data: mdns.LocalServiceInfo) => {
console.log(JSON.stringify(data));
});
// removeLocalService移除本地服务
mdns.removeLocalService(context, localServiceInfo).then((data: mdns.LocalServiceInfo) => {
console.log(JSON.stringify(data));
});
发现本地服务
- 设备连接WiFi。
- 从@kit.NetworkKit里导入mdns的命名空间。
- 创建DiscoveryService对象,用于发现指定服务类型的MDNS服务。
- 订阅MDNS服务发现相关状态变化。
- 启动搜索局域网内的MDNS服务。
- 停止搜索局域网内的MDNS服务。
- 取消订阅的MDNS服务。
// 从@kit.NetworkKit中导入mdns命名空间 import { common, featureAbility, UIAbility } from '@kit.AbilityKit'; import { mdns } from '@kit.NetworkKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { window } from '@kit.ArkUI'; // 构造单例对象 export class GlobalContext { private constructor() {} private static instance: GlobalContext; private _objects = new Map<string, Object>(); public static getContext(): GlobalContext { if (!GlobalContext.instance) { GlobalContext.instance = new GlobalContext(); } return GlobalContext.instance; } getObject(value: string): Object | undefined { return this._objects.get(value); } setObject(key: string, objectClass: Object): void { this._objects.set(key, objectClass); } } // Stage模型获取context class EntryAbility extends UIAbility { value:number = 0; onWindowStageCreate(windowStage: window.WindowStage): void{ GlobalContext.getContext().setObject("value", this.value); } } let context = GlobalContext.getContext().getObject("value") as common.UIAbilityContext; // 创建DiscoveryService对象,用于发现指定服务类型的MDNS服务 let serviceType = "_print._tcp"; let discoveryService = mdns.createDiscoveryService(context, serviceType); // 订阅MDNS服务发现相关状态变化 discoveryService.on('discoveryStart', (data: mdns.DiscoveryEventInfo) => { console.log(JSON.stringify(data)); }); discoveryService.on('discoveryStop', (data: mdns.DiscoveryEventInfo) => { console.log(JSON.stringify(data)); }); discoveryService.on('serviceFound', (data: mdns.LocalServiceInfo) => { console.log(JSON.stringify(data)); }); discoveryService.on('serviceLost', (data: mdns.LocalServiceInfo) => { console.log(JSON.stringify(data)); }); // 启动搜索局域网内的MDNS服务 discoveryService.startSearchingMDNS(); // 停止搜索局域网内的MDNS服务 discoveryService.stopSearchingMDNS(); // 取消订阅的MDNS服务 discoveryService.off('discoveryStart', (data: mdns.DiscoveryEventInfo) => { console.log(JSON.stringify(data)); }); discoveryService.off('discoveryStop', (data: mdns.DiscoveryEventInfo) => { console.log(JSON.stringify(data)); }); discoveryService.off('serviceFound', (data: mdns.LocalServiceInfo) => { console.log(JSON.stringify(data)); }); discoveryService.off('serviceLost', (data: mdns.LocalServiceInfo) => { console.log(JSON.stringify(data)); });