harmony 鸿蒙@ohos.net.sharing (网络共享管理)
@ohos.net.sharing (网络共享管理)
网络共享管理分享设备已有网络给其他连接设备,支持 Wi-Fi 热点共享、蓝牙共享和 USB 共享,同时提供网络共享状态、共享流量查询功能。
说明:
本模块首批接口从 API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import sharing from '@ohos.net.sharing';
sharing.isSharingSupported9+
isSharingSupported(callback: AsyncCallback<boolean>): void
判断是否支持网络共享,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回调函数,返回 true 代表支持网络共享。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing.isSharingSupported((error: BusinessError, data: boolean) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.isSharingSupported9+
isSharingSupported(): Promise<boolean>
判断是否支持网络共享,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
返回值:
类型 | 说明 |
---|---|
Promise<boolean> | 以 Promise 形式返回是否支持共享结果。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing
.isSharingSupported()
.then((data: boolean) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.isSharing9+
isSharing(callback: AsyncCallback<boolean>): void
获取当前网络共享状态,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回调函数,返回 true 代表网络共享中。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing.isSharing((error: BusinessError, data: boolean) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.isSharing9+
isSharing(): Promise<boolean>
获取当前网络共享状态,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
返回值:
类型 | 说明 |
---|---|
Promise<boolean> | 以 Promise 形式返回网络共享状态结果,返回 true 代表网络共享中。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing
.isSharing()
.then((data: boolean) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.startSharing9+
startSharing(type: SharingIfaceType, callback: AsyncCallback<void>): void
开启指定类型共享,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
callback | AsyncCallback<void> | 是 | 回调函数,返回开启网络共享结果。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202004 | Try to share an unavailable iface. |
2202005 | WiFi sharing failed. |
2202006 | Bluetooth sharing failed. |
2202009 | Network share enable forwarding error. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing.startSharing(SHARING_WIFI, (error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.startSharing9+
startSharing(type: SharingIfaceType): Promise<void>
开启指定类型共享,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
返回值:
类型 | 说明 |
---|---|
Promise<void> | 以 Promise 形式返回开启共享执行结果。 |
错误码:
错误码 ID | 错误信息 |
---|---|
202 | Non-system applications use system APIs. |
201 | Permission denied. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202004 | Try to share an unavailable iface. |
2202005 | WiFi sharing failed. |
2202006 | Bluetooth sharing failed. |
2202009 | Network share enable forwarding error. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing
.startSharing(SHARING_WIFI)
.then(() => {
console.log('start wifi sharing successful');
})
.catch((error: BusinessError) => {
console.log('start wifi sharing failed');
});
sharing.stopSharing9+
stopSharing(type: SharingIfaceType, callback: AsyncCallback<void>): void
关闭指定类型共享,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
callback | AsyncCallback<void> | 是 | 回调函数,返回停止网络共享结果。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202004 | Try to share an unavailable iface. |
2202005 | WiFi sharing failed. |
2202006 | Bluetooth sharing failed. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing.stopSharing(SHARING_WIFI, (error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.stopSharing9+
stopSharing(type: SharingIfaceType): Promise<void>
关闭指定类型共享,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
返回值:
类型 | 说明 |
---|---|
Promise<void> | 以 Promise 形式返回关闭共享执行结果。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
2202004 | Try to share an unavailable iface. |
2202005 | WiFi sharing failed. |
2202006 | Bluetooth sharing failed. |
2202011 | Cannot get network sharing configuration. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing
.stopSharing(SHARING_WIFI)
.then(() => {
console.log('stop wifi sharing successful');
})
.catch((error: BusinessError) => {
console.log('stop wifi sharing failed');
});
sharing.getStatsRxBytes9+
getStatsRxBytes(callback: AsyncCallback<number>): void
获取共享网络接收数据量,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback<number> | 是 | 回调函数,number 代表数据量,单位:KB。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing.getStatsRxBytes((error: BusinessError, data: number) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.getStatsRxBytes9+
getStatsRxBytes(): Promise<number>
获取共享网络接收数据量,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
返回值:
类型 | 说明 |
---|---|
Promise<number> | 以 Promise 形式返回共享网络接收数据量,单位:KB。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing
.getStatsRxBytes()
.then((data: number) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.getStatsTxBytes9+
getStatsTxBytes(callback: AsyncCallback<number>): void
获取共享网络发送数据量,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback<number> | 是 | 回调函数,number 代表数据量,单位:KB。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing.getStatsTxBytes((error: BusinessError, data: number) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.getStatsTxBytes9+
getStatsTxBytes(): Promise<number>
获取共享网络发送数据量,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
返回值:
类型 | 说明 |
---|---|
Promise<number> | 以 Promise 形式返回共享网络发送数据量,单位:KB。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing
.getStatsTxBytes()
.then((data: number) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.getStatsTotalBytes9+
getStatsTotalBytes(callback: AsyncCallback<number>): void
获取共享网络总数据量,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback<number> | 是 | 回调函数,number 代表数据量,单位:KB。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing.getStatsTotalBytes((error: BusinessError, data: number) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.getStatsTotalBytes9+
getStatsTotalBytes(): Promise<number>
获取共享网络总数据量,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
返回值:
类型 | 说明 |
---|---|
Promise<number> | 以 Promise 形式返回共享网络总数据量,单位:KB。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
sharing
.getStatsTotalBytes()
.then((data: number) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.getSharingIfaces9+
getSharingIfaces(state: SharingIfaceState, callback: AsyncCallback<Array<string>>): void
获取指定状态的网卡名称列表,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
state | SharingIfaceState | 是 | 网络共享状态。 |
callback | AsyncCallback<Array<string>> | 是 | 回调函数,返回指定状态的网卡名称列表。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_BLUETOOTH = 2;
sharing.getSharingIfaces(SHARING_BLUETOOTH, (error: BusinessError, data: string[]) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.getSharingIfaces9+
getSharingIfaces(state: SharingIfaceState): Promise<Array<string>>
获取指定状态的网卡名称列表,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
state | SharingIfaceState | 是 | 网络共享状态。 |
返回值:
类型 | 说明 |
---|---|
Promise<Array<string>> | 以 Promise 形式返回指定状态网卡名称列表。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_BLUETOOTH = 2;
sharing
.getSharingIfaces(SHARING_BLUETOOTH)
.then((data: string[]) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.getSharingState9+
getSharingState(type: SharingIfaceType, callback: AsyncCallback<SharingIfaceState>): void
获取指定类型网络共享状态,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
callback | AsyncCallback<SharingIfaceState> | 是 | 回调函数,返回指定类型网络共享状态。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing.getSharingState(SHARING_WIFI, (error: BusinessError, data: object) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.getSharingState9+
getSharingState(type: SharingIfaceType): Promise<SharingIfaceState>
获取指定类型网络共享状态,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
返回值:
类型 | 说明 |
---|---|
Promise<SharingIfaceState> | 以 Promise 形式返回定类型网络共共享状态。 |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing
.getSharingState(SHARING_WIFI)
.then((data: object) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.getSharableRegexes9+
getSharableRegexes(type: SharingIfaceType, callback: AsyncCallback<Array<string>>): void
获取指定类型网卡名称正则表达式列表,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
callback | AsyncCallback<Array<string>> | 是 | 回调函数,返回指定类型网卡名称正则表达式列表。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing.getSharableRegexes(SHARING_WIFI, (error: BusinessError, data: string[]) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
sharing.getSharableRegexes9+
getSharableRegexes(type: SharingIfaceType): Promise<Array<string>>
获取指定类型网卡名称正则表达式列表,使用 Promise 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | SharingIfaceType | 是 | 共享类型,0:Wi-Fi 1:USB 2:BLUETOOTH。 |
返回值:
类型 | 说明 |
---|---|
Promise<Array<string>> | 以 Promise 形式返回正则表达式列表。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
2200001 | Invalid parameter value. |
2200002 | Operation failed. Cannot connect to service. |
2200003 | System internal error. |
示例:
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';
let SHARING_WIFI = 0;
sharing
.getSharableRegexes(SHARING_WIFI)
.then((data: string[]) => {
console.log(JSON.stringify(data));
})
.catch((error: BusinessError) => {
console.log(JSON.stringify(error));
});
sharing.on(‘sharingStateChange’)9+
on(type: ‘sharingStateChange’, callback: Callback<boolean>): void
注册网络共享状态变化事件,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 事件名称。 |
callback | AsyncCallback<boolean> | 是 | 回调函数,返回网络共享状态。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
示例:
import sharing from '@ohos.net.sharing';
sharing.on('sharingStateChange', (data: boolean) => {
console.log('on sharingStateChange: ' + JSON.stringify(data));
});
sharing.off(‘sharingStateChange’)9+
off(type: ‘sharingStateChange’, callback?: Callback<boolean>): void
注销网络共享状态变化事件,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 事件名称。 |
callback | AsyncCallback<boolean> | 否 | 回调函数,返回网络共享状态。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
示例:
import sharing from '@ohos.net.sharing';
sharing.off('sharingStateChange', (data: boolean) => {
console.log(JSON.stringify(data));
});
sharing.on(‘interfaceSharingStateChange’)9+
on(type: ‘interfaceSharingStateChange’, callback: Callback<{ type: SharingIfaceType, iface: string, state: SharingIfaceState }>): void
注册网卡网络共享状态变化事件,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 事件名称。 |
callback | AsyncCallback<{ type: SharingIfaceType, iface: string, state: SharingIfaceState(#sharingifacestate) }> | 是 | 回调函数,指定网卡共享状态变化时调用。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
示例:
import sharing from '@ohos.net.sharing';
sharing.on('interfaceSharingStateChange', (data: object) => {
console.log('on interfaceSharingStateChange:' + JSON.stringify(data));
});
sharing.off(‘interfaceSharingStateChange’)9+
off(type: ‘interfaceSharingStateChange’, callback?: Callback<{ type: SharingIfaceType, iface: string, state: SharingIfaceState }>): void
注销网卡网络共享状态变化事件,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 事件名称。 |
callback | AsyncCallback<{ type: SharingIfaceType, iface: string, state: SharingIfaceState(#sharingifacestate) }> | 否 | 回调函数,注销指定网卡共享状态变化通知。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
示例:
import sharing from '@ohos.net.sharing';
sharing.off('interfaceSharingStateChange', (data: object) => {
console.log(JSON.stringify(data));
});
sharing.on(‘sharingUpstreamChange’)9+
on(type: ‘sharingUpstreamChange’, callback: Callback<NetHandle>): void
注册上行网络变化事件,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 事件名称。 |
callback | AsyncCallback<NetHandle> | 是 | 回调函数,上行网络变化时调用。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
示例:
import sharing from '@ohos.net.sharing';
sharing.on('sharingUpstreamChange', (data: object) => {
console.log('on sharingUpstreamChange:' + JSON.stringify(data));
});
sharing.off(‘sharingUpstreamChange’)9+
off(type: ‘sharingUpstreamChange’, callback?: Callback<NetHandle>): void
注销上行网络变化事件,使用 callback 方式作为异步方法。
系统接口:此接口为系统接口。
需要权限:ohos.permission.CONNECTIVITY_INTERNAL
系统能力:SystemCapability.Communication.NetManager.NetSharing
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 事件名称。 |
callback | AsyncCallback<NetHandle> | 否 | 回调函数,注销上行网络变化事件。 |
错误码:
错误码 ID | 错误信息 |
---|---|
201 | Permission denied. |
202 | Non-system applications use system APIs. |
401 | Parameter error. |
示例:
import sharing from '@ohos.net.sharing';
sharing.off('sharingUpstreamChange', (data: object) => {
console.log(JSON.stringify(data));
});
SharingIfaceState9+
网络共享状态。
系统接口:此接口为系统接口。
系统能力:SystemCapability.Communication.NetManager.NetSharing
名称 | 值 | 说明 |
---|---|---|
SHARING_NIC_SERVING | 1 | 正在网络共享。 |
SHARING_NIC_CAN_SERVER | 2 | 可提供网络共享。 |
SHARING_NIC_ERROR | 3 | 网络共享错误。 |
SharingIfaceType9+
网络共享类型。
系统接口:此接口为系统接口。
系统能力:SystemCapability.Communication.NetManager.NetSharing
名称 | 值 | 说明 |
---|---|---|
SHARING_WIFI | 0 | 网络共享类型 Wi-Fi。 |
SHARING_USB | 1 | 网络共享类型 USB。 |
SHARING_BLUETOOTH | 2 | 网络共享类型蓝牙。 |
你可能感兴趣的鸿蒙文章
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)
harmony 鸿蒙@ohos.distributedBundle (分布式包管理)
harmony 鸿蒙@ohos.bundle (Bundle模块)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦