From 8cd6021cb46cdcafb864fc834e546ced65161dbe Mon Sep 17 00:00:00 2001 From: liyufan Date: Fri, 21 Apr 2023 15:11:43 +0800 Subject: [PATCH] fix comments Signed-off-by: liyufan --- .../application-dev/connectivity/Readme-CN.md | 1 + .../application-dev/connectivity/net-mdns.md | 19 ++++--------------- .../connectivity/net-mgmt-overview.md | 1 + .../reference/apis/js-apis-net-connection.md | 6 +++--- 4 files changed, 9 insertions(+), 18 deletions(-) diff --git a/zh-cn/application-dev/connectivity/Readme-CN.md b/zh-cn/application-dev/connectivity/Readme-CN.md index b9d8b96bc4..bd3425cd84 100755 --- a/zh-cn/application-dev/connectivity/Readme-CN.md +++ b/zh-cn/application-dev/connectivity/Readme-CN.md @@ -9,6 +9,7 @@ - [网络共享](net-sharing.md) - [以太网连接](net-ethernet.md) - [网络连接管理](net-connection-manager.md) + - [MDNS管理](net-mdns.md) - IPC与RPC通信 - [IPC与RPC通信概述](ipc-rpc-overview.md) - [IPC与RPC通信开发指导](ipc-rpc-development-guideline.md) diff --git a/zh-cn/application-dev/connectivity/net-mdns.md b/zh-cn/application-dev/connectivity/net-mdns.md index 5f229f0675..df2b69eb51 100644 --- a/zh-cn/application-dev/connectivity/net-mdns.md +++ b/zh-cn/application-dev/connectivity/net-mdns.md @@ -3,32 +3,21 @@ ## 简介 MDNS即多播DNS（Multicast DNS），提供局域网内的本地服务添加、移除、发现、解析等能力。 - -> **说明：** -> 为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅[API参考](../reference/apis/js-apis-net-mdns.md)。 - -## 基本概念 - - 本地服务：局域网内服务的提供方，比如打印机、扫描器等。 -## 约束 - -- 开发语言：C++ JS -- 系统：linux内核 -- 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - -## 场景介绍 - MDNS管理的典型场景有： - 管理本地服务，通过对本地服务的创建，删除和解析等，管理本地服务。 - 发现本地服务，通过DiscoveryService对象，对指定类型的本地服务状态变化进行监听。 +> **说明：** +> 为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅[API参考](../reference/apis/js-apis-net-mdns.md)。 + 以下分别介绍具体开发方式。 ## 接口说明 -完整的JS API说明以及实例代码请参考：[以太网连接](../reference/apis/js-apis-net-mdns.md)。 +完整的JS API说明以及实例代码请参考：[mDNS链接](../reference/apis/js-apis-net-mdns.md)。 | 类型 | 接口 | 功能说明 | | ---- | ---- | ---- | diff --git a/zh-cn/application-dev/connectivity/net-mgmt-overview.md b/zh-cn/application-dev/connectivity/net-mgmt-overview.md index 30846a21c5..d60ad51de9 100644 --- a/zh-cn/application-dev/connectivity/net-mgmt-overview.md +++ b/zh-cn/application-dev/connectivity/net-mgmt-overview.md @@ -9,6 +9,7 @@ - [网络共享](net-sharing.md)：分享设备已有网络给其他连接设备，支持Wi-Fi热点共享、蓝牙共享和USB共享，同时提供网络共享状态、共享流量查询功能。 - [以太网连接](net-ethernet.md)：以太网连接主要提供有线网络能力，提供设置有线网络的IP地址，子网掩码，网关，DNS等信息。 - [网络连接管理](net-connection-manager.md)：网络连接管理提供管理网络一些基础能力，包括WiFi/蜂窝/Ethernet等多网络连接优先级管理、网络质量评估、订阅默认/指定网络连接状态变化、查询网络连接信息、DNS解析等功能。 +- [MDNS管理](net-mdns.md)：MDNS即多播DNS（Multicast DNS），提供局域网内的本地服务添加、移除、发现、解析等能力。 ## 约束与限制 diff --git a/zh-cn/application-dev/reference/apis/js-apis-net-connection.md b/zh-cn/application-dev/reference/apis/js-apis-net-connection.md index 38b90f491c..bd367fc4d2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-net-connection.md +++ b/zh-cn/application-dev/reference/apis/js-apis-net-connection.md @@ -1170,9 +1170,9 @@ connection.getAddressesByName(host).then(function (data) { 网络连接的句柄。 > **说明：** -> 设备从无网络到有网络会触发netAvailable、netCapabilitiesChange和netConnectionPropertiesChange； -> 设备从有网络到无网络状态会触发netLost； -> 设备从WiFi到蜂窝会触发netLost（WiFi丢失）-> netAvaliable（蜂窝可用）； +> 设备从无网络到有网络会触发netAvailable事件、netCapabilitiesChange事件和netConnectionPropertiesChange事件； +> 设备从有网络到无网络状态会触发netLost事件； +> 设备从WiFi到蜂窝会触发netLost事件（WiFi丢失）之后触发 netAvaliable事件（蜂窝可用）； ### register -- GitLab