网络搜索


网络搜索

网络搜索模块提供管理网络搜索的一些基础功能,包括获取当前接入的CS域和PS域无线接入技术、获取网络状态、获取当前选网模式、获取注册网络所在国家的ISO国家码、获取主卡所在卡槽的索引号、获取指定SIM卡槽对应的注册网络信号强度信息列表、获取运营商名称、获取设备的指定卡槽的IMEI、获取设备的指定卡槽的MEID、获取设备的指定卡槽的唯一设备ID,判断当前设备是否支持5G(NR)、判断主卡的Radio是否打开等。

说明:

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

导入模块

import radio from '@ohos.telephony.radio'
1

radio.getRadioTech

getRadioTech(slotId: number, callback: AsyncCallback<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}>): void

获取当前接入的CS域和PS域无线接入技术。使用callback异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<{psRadioTech: RadioTechnology, csRadioTech:RadioTechnology}> 回调函数。

示例:

let slotId = 0;
radio.getRadioTech(slotId, (err, data) =>{ 
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getRadioTech

getRadioTech(slotId: number): Promise<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}>

获取当前接入的CS域和PS域无线接入技术。使用Promise异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}> 以Promise形式返回获取当前接入的CS域和PS域技术。

示例:

let slotId = 0;
let promise = radio.getRadioTech(slotId);
promise.then(data => {
    console.log(`getRadioTech success, data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getRadioTech failed, err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getNetworkState

getNetworkState(callback: AsyncCallback<NetworkState>): void

获取网络状态。使用callback异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<NetworkState> 回调函数。

示例:

radio.getNetworkState((err, data) =>{
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getNetworkState

getNetworkState(slotId: number, callback: AsyncCallback<NetworkState>): void

获取网络状态。使用callback异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<NetworkState> 回调函数。

示例:

let slotId = 0;
radio.getNetworkState(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getNetworkState

getNetworkState(slotId?: number): Promise<NetworkState>

获取网络状态。使用Promise异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<NetworkState> 以Promise形式返回网络状态。

示例:

let slotId = 0;
let promise = radio.getNetworkState(slotId);
promise.then(data => {
    console.log(`getNetworkState success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getNetworkState failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number, callback: AsyncCallback<NetworkSelectionMode>): void

获取当前选网模式。使用callback异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<NetworkSelectionMode> 回调函数。

示例:

let slotId = 0;
radio.getNetworkSelectionMode(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number): Promise<NetworkSelectionMode>

获取当前选网模式。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<NetworkSelectionMode> 以Promise形式返回当前选网模式。

示例:

let slotId = 0;
let promise = radio.getNetworkSelectionMode(slotId);
promise.then(data => {
    console.log(`getNetworkSelectionMode success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getNetworkSelectionMode failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getISOCountryCodeForNetwork7+

getISOCountryCodeForNetwork(slotId: number, callback: AsyncCallback<string>): void

获取注册网络所在国家的ISO国家码。使用callback异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<string> 回调函数。返回国家码,例如:CN(中国)。

示例:

let slotId = 0;
radio.getISOCountryCodeForNetwork(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getISOCountryCodeForNetwork7+

getISOCountryCodeForNetwork(slotId: number): Promise<string>

获取注册网络所在国家的ISO国家码。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<string> 以Promise形式返回注册网络所在国家的ISO国家码,例如CN(中国)。

示例:

let slotId = 0;
let promise = radio.getISOCountryCodeForNetwork(slotId);
promise.then(data => {
    console.log(`getISOCountryCodeForNetwork success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getISOCountryCodeForNetwork failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getPrimarySlotId7+

getPrimarySlotId(callback: AsyncCallback<number>): void

获取主卡所在卡槽的索引号。使用callback异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<number> 回调函数

示例:

radio.getPrimarySlotId((err, data) => {
   console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getPrimarySlotId7+

getPrimarySlotId(): Promise<number>

获取主卡所在卡槽的索引号。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CoreService

返回值:

类型 说明
Promise<number> 以Promise形式返回获取设备主卡所在卡槽的索引号的结果。

示例:

let promise = radio.getPrimarySlotId();
promise.then(data => {
    console.log(`getPrimarySlotId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getPrimarySlotId failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6

radio.getSignalInformation7+

getSignalInformation(slotId: number, callback: AsyncCallback<Array<SignalInformation>>): void

获取指定SIM卡槽对应的注册网络信号强度信息列表。使用callback异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<Array<SignalInformation>> 回调函数,返回SignalInformation对象的数组。

示例:

let slotId = 0;
radio.getSignalInformation(slotId, (err, data) => {
   console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getSignalInformation7+

getSignalInformation(slotId: number): Promise<Array<SignalInformation>>

获取指定SIM卡槽对应的注册网络信号强度信息列表。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<Array<SignalInformation>> 以Promise形式返回网络信号强度SignalInformation对象的数组。

示例:

let slotId = 0;
let promise = radio.getSignalInformation(slotId);
promise.then(data => {
    console.log(`getSignalInformation success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getSignalInformation failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.isNrSupported7+

isNrSupported(): boolean

判断当前设备是否支持5G(NR)。

系统能力:SystemCapability.Telephony.CoreService

返回值:

类型 说明
boolean - true:支持
- false:不支持

示例:

let result = radio.isNrSupported();
console.log("Result: "+ result);
1
2

radio.isNrSupported8+

isNrSupported(slotId: number): boolean

判断当前设备是否支持5G(NR)。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
boolean - true:支持
- false:不支持

示例:

let slotId = 0;
let result = radio.isNrSupported(slotId);
console.log("Result: "+ result);
1
2
3

radio.isRadioOn7+

isRadioOn(callback: AsyncCallback<boolean>): void

判断主卡的Radio是否打开。使用callback异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<boolean> 回调函数。
- true:Radio打开
- false:Radio关闭

示例:

radio.isRadioOn((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.isRadioOn7+

isRadioOn(slotId: number, callback: AsyncCallback<boolean>): void

判断指定卡槽位的Radio是否打开。使用callback异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<boolean> 回调函数。
- true:Radio打开
- false:Radio关闭

示例:

let slotId = 0;
radio.isRadioOn(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.isRadioOn7+

isRadioOn(slotId?: number): Promise<boolean>

判断Radio是否打开。使用Promise异步回调。

需要权限:ohos.permission.GET_NETWORK_INFO

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
如果不指定slotId,默认判断主卡Radio是否打开

返回值:

类型 说明
Promise<boolean> 以Promise形式返回判断Radio是否打开的结果。
- true:Radio打开
- false:Radio关闭

示例:

let slotId = 0;
let promise = radio.isRadioOn(slotId);
promise.then(data => {
    console.log(`isRadioOn success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`isRadioOn failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getOperatorName7+

getOperatorName(slotId: number, callback: AsyncCallback<string>): void

获取运营商名称。使用callback异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<string> 回调函数,返回运营商名称,例如:中国移动。

示例:

let slotId = 0;
radio.getOperatorName(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getOperatorName7+

getOperatorName(slotId: number): Promise<string>

获取运营商名称。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<string> 以Promise形式返回运营商名称,例如:中国移动。

示例:

let slotId = 0;
let promise = radio.getOperatorName(slotId);
promise.then(data => {
    console.log(`getOperatorName success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getOperatorName failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.setPrimarySlotId8+

setPrimarySlotId(slotId: number, callback: AsyncCallback<void>): void

设置主卡所在卡槽的索引号。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<void> 回调函数。

示例:

let slotId = 0;
radio.setPrimarySlotId(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.setPrimarySlotId8+

setPrimarySlotId(slotId: number): Promise<void>

设置主卡所在卡槽的索引号。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<void> 以Promise形式异步返回设置结果。

示例:

let slotId = 0;
let promise = radio.setPrimarySlotId(slotId);
promise.then(data => {
    console.log(`setPrimarySlotId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`setPrimarySlotId failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getIMEI8+

getIMEI(callback: AsyncCallback<string>): void

获取设备的指定卡槽的IMEI。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<string> 回调函数,如果IMEI不存在,则返回空字符串。

示例:

radio.getIMEI((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getIMEI8+

getIMEI(slotId: number, callback: AsyncCallback<string>): void

获取设备的指定卡槽的IMEI。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<string> 回调函数,如果IMEI不存在,则返回空字符串。

示例:

let slotId = 0;
radio.getIMEI(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getIMEI8+

getIMEI(slotId?: number): Promise<string>

获取设备的指定卡槽的IMEI。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<string> 以Promise形式异步返回IMEI;如果IMEI不存在,则返回空字符串。

示例:

let slotId = 0;
let promise = radio.getIMEI(slotId);
promise.then(data => {
    console.log(`getIMEI success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getIMEI failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getMEID8+

getMEID(callback: AsyncCallback<string>): void

获取设备的指定卡槽的MEID。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<string> 回调函数。

示例:

radio.getMEID((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getMEID8+

getMEID(slotId: number, callback: AsyncCallback<string>): void

获取设备的指定卡槽的MEID。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<string> 回调函数。

示例:

let slotId = 0;
radio.getMEID(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getMEID8+

getMEID(slotId?: number): Promise<string>

获取设备的指定卡槽的MEID。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<string> 以Promise形式返回设备的指定卡槽的MEID。

示例:

let slotId = 0;
let promise = radio.getMEID(slotId);
promise.then(data => {
    console.log(`getMEID success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getMEID failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getUniqueDeviceId8+

getUniqueDeviceId(callback: AsyncCallback<string>): void

获取设备的指定卡槽的唯一设备ID。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<string> 回调函数。

示例:

radio.getUniqueDeviceId((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getUniqueDeviceId8+

getUniqueDeviceId(slotId: number, callback: AsyncCallback<string>): void

获取设备的指定卡槽的唯一设备ID。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<string> 回调函数。

示例:

let slotId = 0;
radio.getUniqueDeviceId(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getUniqueDeviceId8+

getUniqueDeviceId(slotId?: number): Promise<string>

获取设备的指定卡槽的唯一设备ID。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<string> 以Promise形式返回设备的指定卡槽的唯一设备ID。

示例:

let slotId = 0;
let promise = radio.getUniqueDeviceId(slotId);
promise.then(data => {
    console.log(`getUniqueDeviceId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getUniqueDeviceId failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.sendUpdateCellLocationRequest8+

sendUpdateCellLocationRequest(callback: AsyncCallback<void>): void

发送更新小区位置请求。使用callback异步回调。

此接口为系统接口。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 回调函数。

示例:

radio.sendUpdateCellLocationRequest((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.sendUpdateCellLocationRequest8+

sendUpdateCellLocationRequest(slotId: number, callback: AsyncCallback<void>): void

发送更新小区位置请求。使用callback异步回调。

此接口为系统接口。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<void> 回调函数。

示例:

let slotId = 0;
radio.sendUpdateCellLocationRequest(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.sendUpdateCellLocationRequest8+

sendUpdateCellLocationRequest(slotId?: number): Promise<void>

发送更新小区位置请求。使用Promise异步回调。

此接口为系统接口。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<void> 以Promise形式返回结果。

示例:

let slotId = 0;
let promise = radio.sendUpdateCellLocationRequest(slotId);
promise.then(data => {
    console.log(`sendUpdateCellLocationRequest success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`sendUpdateCellLocationRequest failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.getCellInformation8+

getCellInformation(callback: AsyncCallback<Array<CellInformation>>): void

获取小区信息。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.LOCATION

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<Array<CellInformation>> 回调函数。

示例:

radio.getCellInformation((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getCellInformation8+

getCellInformation(slotId: number, callback: AsyncCallback<Array<CellInformation>>): void

获取小区信息。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.LOCATION

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<Array<CellInformation>> 回调函数。

示例:

let slotId = 0;
radio.getCellInformation(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getCellInformation8+

getCellInformation(slotId?: number): Promise<Array<CellInformation>>

获取小区信息。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.LOCATION

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<Array<CellInformation>> 以Promise形式返回结果。

示例:

let slotId = 0;
let promise = radio.getCellInformation(slotId);
promise.then(data => {
    console.log(`getCellInformation success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getCellInformation failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.setNetworkSelectionMode

setNetworkSelectionMode(options: NetworkSelectionModeOptions, callback: AsyncCallback<void>): void

设置网络选择模式。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
options NetworkSelectionModeOptions 网络选择模式选项。
callback AsyncCallback<void> 回调函数。

示例:

let networkInformation={
    operatorName: "中国移动",
    operatorNumeric: "898600",
    state: radio.NetworkInformationState.NETWORK_AVAILABLE,
    radioTech: "CS"
}
let networkSelectionModeOptions={
    slotId: 0,
    selectMode: radio.NetworkSelectionMode.NETWORK_SELECTION_AUTOMATIC,
    networkInformation: networkInformation,
    resumeSelection: true
}
radio.setNetworkSelectionMode(networkSelectionModeOptions, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

radio.setNetworkSelectionMode

setNetworkSelectionMode(options: NetworkSelectionModeOptions): Promise<void>

设置网络选择模式。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
options NetworkSelectionModeOptions 网络选择模式选项。

返回值:

类型 说明
Promise<void> 以Promise形式返回结果。

示例:

let networkInformation={
    operatorName: "中国移动",
    operatorNumeric: "898600",
    state: radio.NetworkInformationState.NETWORK_AVAILABLE,
    radioTech: "CS"
}
let networkSelectionModeOptions={
    slotId: 0,
    selectMode: radio.NetworkSelectionMode.NETWORK_SELECTION_AUTOMATIC,
    networkInformation: networkInformation,
    resumeSelection: true
}
let promise = radio.setNetworkSelectionMode(networkSelectionModeOptions);
promise.then(data => {
    console.log(`setNetworkSelectionMode success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`setNetworkSelectionMode failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

radio.getNetworkSearchInformation

getNetworkSearchInformation(slotId: number, callback: AsyncCallback<NetworkSearchResult>): void

获取网络搜索信息。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<NetworkSearchResult> 回调函数。

示例:

radio.getNetworkSearchInformation(0, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getNetworkSearchInformation

getNetworkSearchInformation(slotId: number): Promise<NetworkSearchResult>

获取网络搜索信息。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<NetworkSearchResult> 以Promise形式返回结果。

示例:

let promise = radio.getNetworkSearchInformation(0);
promise.then(data => {
    console.log(`getNetworkSearchInformation success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getNetworkSearchInformation failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6

radio.getNrOptionMode8+

getNrOptionMode(callback: AsyncCallback<NrOptionMode>): void

获取Nr选项模式 。使用callback异步回调。

此接口为系统接口。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<NrOptionMode> 回调函数。

示例:

radio.getNrOptionMode((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getNrOptionMode8+

getNrOptionMode(slotId: number, callback: AsyncCallback<NrOptionMode>): void

获取Nr选项模式 。使用callback异步回调。

此接口为系统接口。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<NrOptionMode> 回调函数。

示例:

let slotId = 0;
radio.getNrOptionMode(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.getNrOptionMode8+

getNrOptionMode(slotId?: number): Promise<NrOptionMode>

获取Nr选项模式 。使用Promise异步回调。

此接口为系统接口。

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<NrOptionMode> 以Promise形式返回结果。

示例:

let slotId = 0;
let promise = radio.getNrOptionMode(slotId);
promise.then(data => {
    console.log(`getNrOptionMode success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getNrOptionMode failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.turnOnRadio7+

turnOnRadio(callback: AsyncCallback<void>): void

打开Radio。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 回调函数。

示例:

radio.turnOnRadio((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.turnOnRadio7+

turnOnRadio(slotId: number, callback: AsyncCallback<void>): void

打开Radio。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<void> 回调函数。

示例:

let slotId = 0;
radio.turnOnRadio(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.turnOnRadio7+

turnOnRadio(slotId?: number): Promise<void>

打开Radio。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<void> 以Promise形式返回结果。

示例:

let slotId = 0;
let promise = radio.turnOnRadio(slotId);
promise.then(data => {
    console.log(`turnOnRadio success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`turnOnRadio failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.turnOffRadio7+

turnOffRadio(callback: AsyncCallback<void>): void

关闭Radio。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 回调函数。

示例:

radio.turnOffRadio((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.turnOffRadio7+

turnOffRadio(slotId: number, callback: AsyncCallback<void>): void

关闭Radio。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<void> 回调函数。

示例:

let slotId = 0;
radio.turnOffRadio(slotId, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3
4

radio.turnOffRadio7+

turnOffRadio(slotId?: number): Promise<void>

关闭Radio。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<void> 以Promise形式返回结果。

示例:

let slotId = 0;
let promise = radio.turnOffRadio(slotId);
promise.then(data => {
    console.log(`turnOffRadio success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`turnOffRadio failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6
7

radio.setPreferredNetwork8+

setPreferredNetwork(slotId: number, networkMode: PreferredNetworkMode, callback: AsyncCallback<void>): void

设置首选网络。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
networkMode PreferredNetworkMode 设置首选网络模式。
callback AsyncCallback<void> 回调函数。

示例:

radio.setPreferredNetwork(0, 1, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.setPreferredNetwork8+

setPreferredNetwork(slotId: number, networkMode: PreferredNetworkMode): Promise<void>

设置首选网络。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
networkMode PreferredNetworkMode 设置首选网络模式。

返回值:

类型 说明
Promise<void> 以Promise形式返回结果。

示例:

let promise = radio.setPreferredNetwork(0, 1);
promise.then(data => {
    console.log(`setPreferredNetwork success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`setPreferredNetwork failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6

radio.getPreferredNetwork8+

getPreferredNetwork(slotId: number, callback: AsyncCallback<PreferredNetworkMode>): void

获取首选网络。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<PreferredNetworkMode> 回调函数。

示例:

radio.getPreferredNetwork(0, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getPreferredNetwork8+

getPreferredNetwork(slotId: number): Promise<PreferredNetworkMode>

获取首选网络。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2

返回值:

类型 说明
Promise<void> 以Promise形式返回结果。

示例:

let promise = radio.getPreferredNetwork(0);
promise.then(data => {
    console.log(`getPreferredNetwork success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getPreferredNetwork failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6

radio.getImsRegInfo9+

getImsRegInfo(slotId: number, imsType: ImsServiceType, callback: AsyncCallback<ImsRegInfo>): void

获取特定IMS服务类型的IMS注册状态信息。使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
imsType ImsServiceType IMS服务类型。
callback AsyncCallback<ImsRegInfo> 回调函数。

示例:

radio.getImsRegInfo(0, radio.ImsServiceType.TYPE_VIDEO, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.getImsRegInfo9+

getImsRegInfo(slotId: number, imsType: ImsServiceType): Promise<ImsRegInfo>

获取特定IMS服务类型的IMS注册状态信息。使用Promise异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
imsType ImsServiceType IMS服务类型。

返回值:

类型 说明
Promise<ImsRegInfo> 以Promise形式返回结果。

示例:

let promise = radio.getImsRegInfo(0, radio.ImsServiceType.TYPE_VIDEO);
promise.then(data => {
    console.log(`getImsRegInfo success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.log(`getImsRegInfo failed, promise: err->${JSON.stringify(err)}`);
});
1
2
3
4
5
6

radio.on('imsRegStateChange')9+

on(type: 'imsRegStateChange', slotId: number, imsType: ImsServiceType, callback: Callback<ImsRegInfo>): void

订阅imsRegStateChange事件,使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
type string 监听IMS注册状态的变化。
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
imsType ImsServiceType IMS服务类型。
callback Callback<ImsRegInfo> 回调函数。

示例:

radio.on('imsRegStateChange', 0, radio.ImsServiceType.TYPE_VIDEO, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

radio.off('imsRegStateChange')9+

off(type: 'imsRegStateChange', slotId: number, imsType: ImsServiceType, callback?: Callback<ImsRegInfo>): void

取消订阅imsRegStateChange事件,使用callback异步回调。

此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CoreService

参数:

参数名 类型 必填 说明
type string 通话结束时取消监听通话详情的变化。
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
imsType ImsServiceType IMS服务类型。
callback Callback<ImsRegInfo> 回调函数。

示例:

radio.off('imsRegStateChange', 0, radio.ImsServiceType.TYPE_VIDEO, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
1
2
3

RadioTechnology

无线接入技术。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
RADIO_TECHNOLOGY_UNKNOWN 0 未知无线接入技术(RAT)。
RADIO_TECHNOLOGY_GSM 1 无线接入技术GSM(Global System For Mobile Communication)。
RADIO_TECHNOLOGY_1XRTT 2 无线接入技术1XRTT(Single-Carrier Radio Transmission Technology)。
RADIO_TECHNOLOGY_WCDMA 3 无线接入技术WCDMA(Wideband Code Division Multiple Access)。
RADIO_TECHNOLOGY_HSPA 4 无线接入技术HSPA(High Speed Packet Access)。
RADIO_TECHNOLOGY_HSPAP 5 无线接入技术HSPAP(High Speed packet access (HSPA+) )。
RADIO_TECHNOLOGY_TD_SCDMA 6 无线接入技术TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。
RADIO_TECHNOLOGY_EVDO 7 无线接入技术EVDO(Evolution Data Only)。
RADIO_TECHNOLOGY_EHRPD 8 无线接入技术EHRPD(Evolved High Rate Package Data)。
RADIO_TECHNOLOGY_LTE 9 无线接入技术LTE(Long Term Evolution)。
RADIO_TECHNOLOGY_LTE_CA 10 无线接入技术LTE_CA(Long Term Evolution_Carrier Aggregation)。
RADIO_TECHNOLOGY_IWLAN 11 无线接入技术IWLAN(Industrial Wireless LAN)。
RADIO_TECHNOLOGY_NR 12 无线接入技术NR(New Radio)。

SignalInformation

网络信号强度信息对象。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

参数名 类型 说明
signalType NetworkType 网络信号强度类型。
signalLevel number 网络信号强度等级。

NetworkType

网络类型。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
NETWORK_TYPE_UNKNOWN 0 未知网络类型。
NETWORK_TYPE_GSM 1 网络类型为GSM(Global System For Mobile Communication)。
NETWORK_TYPE_CDMA 2 网络类型为CDMA(Code Division Multiple Access)。
NETWORK_TYPE_WCDMA 3 网络类型为WCDMA(Wideband Code Division Multiple Access)。
NETWORK_TYPE_TDSCDMA 4 网络类型为TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。
NETWORK_TYPE_LTE 5 网络类型为LTE(Long Term Evolution)。
NETWORK_TYPE_NR 6 网络类型为5G NR(New Radio)。

NetworkState

网络注册状态。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
longOperatorName string 注册网络的长运营商名称。
shortOperatorName string 注册网络的短运营商名称。
plmnNumeric string 注册网络的PLMN码。
isRoaming boolean 是否处于漫游状态。
regState RegState 设备的网络注册状态。
cfgTech8+ RadioTechnology 设备的无线接入技术。
nsaState NsaState 设备的NSA网络注册状态。
isCaActive boolean CA的状态。
isEmergency boolean 此设备是否只允许拨打紧急呼叫。

RegState

网络注册状态。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
REG_STATE_NO_SERVICE 0 设备不能使用任何服务,包括数据业务、短信、通话等。
REG_STATE_IN_SERVICE 1 设备可以正常使用服务,包括数据业务、短信、通话等。
REG_STATE_EMERGENCY_CALL_ONLY 2 设备只能使用紧急呼叫业务。
REG_STATE_POWER_OFF 3 蜂窝无线电已关闭,modem下电,无法和网侧进行通信。

NsaState

非独立组网状态。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
NSA_STATE_NOT_SUPPORT 1 设备在不支持NSA的LTE小区下处于空闲状态或连接状态。
NSA_STATE_NO_DETECT 2 在支持NSA但不支持NR覆盖检测的LTE小区下,设备处于空闲状态。
NSA_STATE_CONNECTED_DETECT 3 设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。
NSA_STATE_IDLE_DETECT 4 支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。
NSA_STATE_DUAL_CONNECTED 5 设备在支持NSA的LTE小区下连接到LTE + NR网络。
NSA_STATE_SA_ATTACHED 6 设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。

NetworkSelectionMode

选网模式。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
NETWORK_SELECTION_UNKNOWN 0 未知选网模式。
NETWORK_SELECTION_AUTOMATIC 1 自动选网模式。
NETWORK_SELECTION_MANUAL 2 手动选网模式。

PreferredNetworkMode8+

首选网络模式。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
PREFERRED_NETWORK_MODE_GSM 1 首选GSM网络模式。
PREFERRED_NETWORK_MODE_WCDMA 2 首选WCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE 3 首选LTE网络模式。
PREFERRED_NETWORK_MODE_LTE_WCDMA 4 首选LTE WCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM 5 首选LTE WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_WCDMA_GSM 6 首选WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_CDMA 7 首选CDMA网络模式。
PREFERRED_NETWORK_MODE_EVDO 8 首选EVDO网络模式。
PREFERRED_NETWORK_MODE_EVDO_CDMA 9 首选EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_WCDMA_GSM_EVDO_CDMA 10 首选WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_EVDO_CDMA 11 首选LTE EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM_EVDO_CDMA 12 首选LTE WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA 13 首选TDSCDMA网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_GSM 14 首选TDSCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA 15 首选TDSCDMA_WCDMA网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM 16 首选TDSCDMA_WCDMA_GSM网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA 17 首选LTE TDSCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_GSM 18 首选LTE TDSCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA 19 首选LTE TDSCDMA WCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM 20 首选LTE TDSCDMA WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM_EVDO_CDMA 21 首选TDSCDMA WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA 22 首选LTE TDSCDMA WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_NR 31 首选NR网络模式。
PREFERRED_NETWORK_MODE_NR_LTE 32 首选NR LTE网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA 33 首选NR LTE WCDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM 34 首选NR LTE WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_EVDO_CDMA 35 首选NR LTE EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM_EVDO_CDMA 36 首选NR LTE WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA 37 首选NR LTE TDSCDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_GSM 38 首选NR LTE TDSCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA 39 首选NR LTE TDSCDMA WCDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM 40 首选NR LTE TDSCDMA WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA 41 首选NR LTE TDSCDMA WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_MAX_VALUE 99 首选网络模式最大值。

CellInformation8+

小区信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
networkType NetworkType 获取服务单元的网络类型。
isCamped boolean 获取服务单元的状态。
timeStamp number 获取单元格信息时获取时间戳。
signalInformation SignalInformation 信号信息。
data CdmaCellInformation | GsmCellInformation | LteCellInformation | NrCellInformation | TdscdmaCellInformation Cdma小区信息 |Gsm小区信息|Lte小区信息|Nr小区信息|Tdscdma小区信息

CdmaCellInformation8+

CDMA小区信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
baseId number 基站Id。
latitude number 经度。
longitude number 纬度。
nid number 网络识别码。
sid number 系统识别码。

GsmCellInformation8+

GSM小区信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
lac number 位置区编号。
cellId number 小区号。
arfcn number 绝对无线频率信道号。
bsic number 基站识别号。
mcc string 移动国家码。
mnc string 移动网号。

LteCellInformation8+

LTE小区信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
cgi number 小区全球标识。
pci number 物理小区识别。
tac number 跟踪区域代码。
earfcn number 绝对无线频率信道号。
bandwidth number 带宽。
mcc string 移动国家码。
mnc string 移动网号。
isSupportEndc boolean 是否支持新无线电_双连接

NrCellInformation8+

NR小区信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
nrArfcn number 5G频点号。
pci number 物理小区识别。
tac number 跟踪区域代码。
nci number 5G网络小区标识。
mcc string 移动国家码。
mnc string 移动网号。

TdscdmaCellInformation8+

TD-SCDMA小区信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
lac number 位置区编号。
cellId number 小区号。
cpid number 小区参数Id。
uarfcn number 绝对射频号。
mcc string 移动国家码。
mnc string 移动网号。

WcdmaCellInformation8+

WCDMA小区信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
lac number 位置区编号。
cellId number 小区号。
psc number 主扰码。
uarfcn number 绝对射频号。
mcc string 移动国家码。
mnc string 移动网号。

NrOptionMode8+

NR的选择模式。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
NR_OPTION_UNKNOWN 0 未知的NR选择模式。
NR_OPTION_NSA_ONLY 1 仅非独立组网的NR选择模式。
NR_OPTION_SA_ONLY 2 仅独立组网的NR选择模式。
NR_OPTION_NSA_AND_SA 3 非独立组网和独立组网的NR选择模式。

NetworkSearchResult

网络搜索结果。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
isNetworkSearchSuccess boolean 网络搜索成功。
networkSearchResult Array<NetworkInformation> 网络搜索结果。

NetworkInformation

网络信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
operatorName string 运营商的名称。
operatorNumeric string 运营商数字。
state NetworkInformationState 网络信息状态。
radioTech string 无线电技术。

NetworkInformationState

网络信息状态。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
NETWORK_UNKNOWN 0 网络状态未知。
NETWORK_AVAILABLE 1 网络可用于注册。
NETWORK_CURRENT 2 已在网络中注册。
NETWORK_FORBIDDEN 3 网络无法注册。

NetworkSelectionModeOptions

网络选择模式选项。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
selectMode NetworkSelectionMode 网络选择模式。
networkInformation NetworkInformation 网络信息。
resumeSelection boolean 继续选择。

ImsRegState9+

IMS注册状态。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
IMS_UNREGISTERED 0 未注册。
IMS_REGISTERED 1 已注册。

ImsRegTech9+

IMS注册技术。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
REGISTRATION_TECH_NONE 0 无注册技术。
REGISTRATION_TECH_LTE 1 LTE注册技术。
REGISTRATION_TECH_IWLAN 2 IWLAN注册技术。
REGISTRATION_TECH_NR 3 NR注册技术。

ImsRegInfo9+

IMS注册信息。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 类型 说明
imsRegState ImsRegState IMS注册状态。
imsRegTech ImsRegTech IMS注册技术。

ImsServiceType9+

IMS服务类型。

此接口为系统接口。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称 说明
TYPE_VOICE 0 语音服务。
TYPE_VIDEO 1 视频服务。
TYPE_UT 2 UT服务。
TYPE_SMS 3 短讯服务。