鸿蒙开发网络管理：ohos.net.connection之网络连接管理

jf_46214456 2024-06-18 591

电子说

1.3w人已加入

描述

网络连接管理

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import connection from '@ohos.net.connection'

connection.getDefaultNet

getDefaultNet(callback: AsyncCallback): void

获取默认激活的数据网络，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
callbackAsyncCallback<[NetHandle]>是回调函数。

示例：

connection.getDefaultNet(function (error, netHandle) {
    console.log(JSON.stringify(error))
    console.log(JSON.stringify(netHandle))
})

connection.getDefaultNet

getDefaultNet(): Promise

获取默认激活的数据网络，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

返回值：

类型说明
Promise<[NetHandle]>以Promise形式返回默认激活的数据网络。

示例：

connection.getDefaultNet().then(function (netHandle) {
    console.log(JSON.stringify(netHandle))
})

connection.hasDefaultNet

hasDefaultNet(callback: AsyncCallback): void

检查默认数据网络是否被激活，使用callback方式作为异步方法。

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

参数：

参数名类型必填说明
callbackAsyncCallback是回调函数，默认数据网络被激活返回true。

示例：

connection.hasDefaultNet(function (error, has) {
    console.log(JSON.stringify(error))
    console.log(has)
})

connection.hasDefaultNet

hasDefaultNet(): Promise

检查默认数据网络是否被激活，使用Promise方式作为异步方法。

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

返回值：

类型说明
Promise以Promise形式返回，默认数据网络被激活返回true。

示例：

connection.hasDefaultNet().then(function (has) {
    console.log(has)
})

connection.getAllNets

getAllNets(callback: AsyncCallback>): void

获取全部激活的数据网络列表，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
callbackAsyncCallback>是回调函数。

示例：

connection.getAllNets(function (error, nets) {
    console.log(JSON.stringify(error))
    console.log(JSON.stringify(nets))
});

connection.getAllNets

getAllNets(): Promise>

获取全部激活的数据网络列表，使用promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

返回值：

类型说明
Promise>以Promise形式返回激活的数据网络列表。

示例：

connection.getAllNets().then(function (nets) {
    console.log(JSON.stringify(nets))
});

connection.getConnectionProperties

getConnectionProperties(netHandle: NetHandle, callback: AsyncCallback): void

获取netHandle对应的网络的连接信息，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄。
callbackAsyncCallback<[ConnectionProperties]>是回调函数。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getConnectionProperties(netHandle, function (error, info) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(info))
    })
})

connection.getConnectionProperties

getConnectionProperties(netHandle: NetHandle): Promise

获取netHandle对应的网络的连接信息，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄。

返回值：

类型说明
Promise<[ConnectionProperties]>以Promise形式返回网络的连接信息。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getConnectionProperties(netHandle).then(function (info) {
        console.log(JSON.stringify(info))
    })
})

connection.getNetCapabilities

getNetCapabilities(netHandle: NetHandle, callback: AsyncCallback): void

获取netHandle对应的网络的能力信息，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄。
callbackAsyncCallback<[NetCapabilities]>是回调函数。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getNetCapabilities(netHandle, function (error, info) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(info))
    })
})

connection.getNetCapabilities

getNetCapabilities(netHandle: NetHandle): Promise

获取netHandle对应的网络的能力信息，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄。

返回值：

类型说明
Promise<[NetCapabilities]>以Promise形式返回网络的能力信息。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getNetCapabilities(netHandle).then(function (info) {
        console.log(JSON.stringify(info))
    })
})

connection.reportNetConnected

reportNetConnected(netHandle: NetHandle, callback: AsyncCallback): void

报告网络状态已连接，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄，参考[NetHandle]。
callbackAsyncCallback是回调函数。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetConnected(netHandle, function (error) {
        console.log(JSON.stringify(error))
    });
});

connection.reportNetConnected

reportNetConnected(netHandle: NetHandle): Promise

报告网络状态已连接，使用promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄，参考[NetHandle]。

返回值：

类型说明
Promise以Promise形式返回执行结果。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetConnected(netHandle).then(function () {
        console.log(`report success`)
    });
});

connection.reportNetDisconnected

reportNetDisconnected(netHandle: NetHandle, callback: AsyncCallback): void

报告网络状态已断开，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄，参考[NetHandle]。
callbackAsyncCallback是回调函数。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetDisconnected(netHandle, function (error) {
        console.log(JSON.stringify(error))
    });
});

connection.reportNetDisconnected

reportNetDisconnected(netHandle: NetHandle): Promise

报告网络状态已断开，使用promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

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

参数：

参数名类型必填说明
netHandle[NetHandle]是数据网络的句柄，参考[NetHandle]。

返回值：

类型说明
Promise以Promise形式返回执行结果。

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetDisconnected(netHandle).then(function () {
        console.log(`report success`)
    });
});

connection.getAddressesByName

getAddressesByName(host: string, callback: AsyncCallback>): void

使用默认网络解析主机名以获取所有IP地址，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
hoststring是需要解析的主机名。
callbackAsyncCallback>是回调函数。

示例：

let host = "xxxx";
connection.getAddressesByName(host, function (error, addresses) {
    console.log(JSON.stringify(error))
    console.log(JSON.stringify(addresses))
})

connection.getAddressesByName

getAddressesByName(host: string): Promise>

使用默认网络解析主机名以获取所有IP地址，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
hoststring是需要解析的主机名。

返回值：

类型说明
Promise>以Promise形式返回所有IP地址。

示例：

let host = "xxxx";
connection.getAddressesByName(host).then(function (addresses) {
    console.log(JSON.stringify(addresses))
})

connection.createNetConnection

createNetConnection(netSpecifier?: NetSpecifier, timeout?: number): NetConnection

获取一个netSpecifier指定的网络的句柄。

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

参数：

参数名类型必填说明
netSpecifier[NetSpecifier]否指定网络的各项特征，不指定则关注默认网络。
timeoutnumber否获取netSpecifier指定的网络时的超时时间，仅netSpecifier存在时生效。

返回值：

类型说明
[NetConnection]所关注的网络的句柄。

示例：

// 关注默认网络
let netConnection = connection.createNetConnection()

// 关注蜂窝网络
let netConnectionCellular = connection.createNetConnection({
    netCapabilities: {
        bearerTypes: [NetBearType.BEARER_CELLULAR]
    }
})

NetConnection

网络连接的句柄。

on('netAvailable')

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

订阅网络可用事件。

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

参数：

参数名类型必填说明
typestring是订阅事件，固定为'netAvailable'。 netAvailable：数据网络可用事件。
callbackCallback<[NetHandle]>是回调函数。

示例：

netConnection.on('netAvailable', function (data) {
    console.log(JSON.stringify(data))
})

on('netCapabilitiesChange')

on(type: 'netCapabilitiesChange', callback: Callback<{ netHandle: NetHandle, netCap: NetCapabilities }>): void

订阅网络能力变化事件。

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

参数：

参数名类型必填说明
typestring是订阅事件，固定为'netCapabilitiesChange'。 netCapabilitiesChange：网络能力变化事件。
callbackCallback<{ netHandle: [NetHandle], netCap: [NetCapabilities]}>是回调函数。

示例：

netConnection.on('netCapabilitiesChange', function (data) {
    console.log(JSON.stringify(data))
})

on('netConnectionPropertiesChange')

on(type: 'netConnectionPropertiesChange', callback: Callback<{ netHandle: NetHandle, connectionProperties: ConnectionProperties }>): void

订阅网络连接信息变化事件。

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

参数：

参数名类型必填说明
typestring是订阅事件，固定为'netConnectionPropertiesChange'。 netConnectionPropertiesChange：网络连接信息变化事件。
callbackCallback<{ netHandle: [NetHandle], connectionProperties: [ConnectionProperties]}>是回调函数。

示例：

netConnection.on('netConnectionPropertiesChange', function (data) {
    console.log(JSON.stringify(data))
})

on('netBlockStatusChange')

on(type: 'netBlockStatusChange', callback: Callback<{ netHandle: NetHandle, blocked: boolean }>): void

订阅网络阻塞状态事件，使用callback方式作为异步方法。

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

参数：

参数名类型必填说明
typestring是订阅事件，固定为'netBlockStatusChange'。 netBlockStatusChange：网络阻塞状态事件。
callbackCallback<{ netHandle: [NetHandle], blocked: boolean }>是回调函数。

示例：

netConnection.on('netBlockStatusChange', function (data) {
    console.log(JSON.stringify(data))
})

on('netLost')

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

订阅网络丢失事件。

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

参数：

参数名类型必填说明
typestring是订阅事件，固定为'netLost'。 netLost：网络严重中断或正常断开事件。
callbackCallback<[NetHandle]>是回调函数。

示例：

let netConnection1 = connection.createNetConnection()
netConnection1.on('netLost', function (data) {
    console.log(JSON.stringify(data))
})

on('netUnavailable')

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

订阅网络不可用事件。

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

参数：

参数名类型必填说明
typestring是订阅事件，固定为'netUnavailable'。 netUnavailable：网络不可用事件。
callbackCallback是回调函数。

示例：

netConnection.on('netUnavailable', function (data) {
    console.log(JSON.stringify(data))
})

register

register(callback: AsyncCallback): void

订阅指定网络状态变化的通知。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
callbackAsyncCallback是回调函数。

示例：

netConnection.register(function (error) {
    console.log(JSON.stringify(error))
})

unregister

unregister(callback: AsyncCallback): void

取消订阅默认网络状态变化的通知。

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

参数：

参数名类型必填说明
callbackAsyncCallback是回调函数。

示例：

netConnection.unregister(function (error) {
    console.log(JSON.stringify(error))
})

NetHandle

数据网络的句柄。

在调用NetHandle的方法之前，需要先获取NetHandle对象。

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

属性

参数名类型说明
netIdnumber网络ID，必须大于等于100。

getAddressesByName

getAddressesByName(host: string, callback: AsyncCallback>): void

使用对应网络解析主机名以获取所有IP地址，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
hoststring是需要解析的主机名。
callbackAsyncCallback>是回调函数

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressesByName(host, function (error, addresses) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(addresses))
    })
})

getAddressesByName

getAddressesByName(host: string): Promise>

使用对应网络解析主机名以获取所有IP地址，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
hoststring是需要解析的主机名。

返回值：

类型说明
Promise>以Promise形式返回所有IP地址。

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressesByName(host).then(function (addresses) {
        console.log(JSON.stringify(addresses))
    })
})

getAddressByName

getAddressByName(host: string, callback: AsyncCallback): void

使用对应网络解析主机名以获取第一个IP地址，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
hoststring是需要解析的主机名。
callbackAsyncCallback<[NetAddress]>是回调函数。

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressByName(host, function (error, address) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(address))
    })
})

getAddressByName

getAddressByName(host: string): Promise

使用对应网络解析主机名以获取第一个IP地址，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.GET_NETWORK_INFO

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

参数：

参数名类型必填说明
hoststring是需要解析的主机名。

返回值：

类型说明
Promise<[NetAddress]>以Promise形式返回第一个IP地址。

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressByName(host).then(function (address) {
        console.log(JSON.stringify(address))
    })
})

NetSpecifier

提供承载数据网络能力的实例。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

参数名类型说明
netCapabilities[NetCapabilities]存储数据网络的传输能力和承载类型。
bearerPrivateIdentifierstring网络标识符，WIFI网络的标识符是"wifi"，蜂窝网络的标识符是"slot0"（对应SIM卡1）。

NetCapabilities

网络的能力集。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

参数名类型说明
linkUpBandwidthKbpsnumber上行（设备到网络）带宽。
linkDownBandwidthKbpsnumber下行（网络到设备）带宽。
networkCapArray<[NetCap]>网络具体能力。
bearerTypesArray<[NetBearType]>网络类型。

NetCap

网络具体能力。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

参数名值说明
NET_CAPABILITY_MMS0表示网络可以访问运营商的MMSC（Multimedia Message Service，多媒体短信服务）发送和接收彩信。
NET_CAPABILITY_NOT_METERED11表示网络流量未被计费。
NET_CAPABILITY_INTERNET12网络可以访问Internet。
NET_CAPABILITY_NOT_VPN15表示网络不使用VPN（Virtual Private Network，虚拟专用网络）。
NET_CAPABILITY_VALIDATED16网络可用。

NetBearType

网络类型。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

名称值说明
BEARER_CELLULAR0蜂窝网络。
BEARER_WIFI1Wi-Fi网络。
BEARER_ETHERNET3以太网网络。

ConnectionProperties

网络连接信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

参数名类型说明
interfaceNamestring网卡名称。
domainsstring所属域，默认""。
linkAddressesArray<[LinkAddress]>链路信息。
routesArray<[RouteInfo]>路由信息。
dnsesArray<[NetAddress]>网络地址，参考[NetAddress]。
mtunumber最大传输单元。

LinkAddress

网络链路信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

参数名类型说明
address[NetAddress]链路地址。
prefixLengthnumber链路地址前缀的长度。

RouteInfo

网络路由信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

参数名类型说明
interfacestring网卡名称。
destination[LinkAddress]目的地址。
gateway[NetAddress]网关地址。
hasGatewayboolean是否有网关。
isDefaultRoutebooleanHarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿是否为默认路由。

鸿蒙

NetAddress

网络地址。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。

参数名类型说明
addressstring地址。
familynumberIPv4 = 1，IPv6 = 2，默认IPv4。
portnumber端口，取值范围[0, 65535]。

审核编辑 黄宇

打开APP阅读更多精彩内容
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

下载APP
|投诉反馈|电子发烧友网
© 2021 elecfans.com
湘ICP备2023018690号
×
20
完善资料，
赚取积分