@ohos.telephony.radio (网络搜索)

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

说明：

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

导入模块

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

radio.getRadioTech

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getRadioTech

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getNetworkState

getNetworkState(callback: AsyncCallback<NetworkState>): void

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getNetworkState

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getNetworkState

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getNetworkSelectionMode

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number): Promise<NetworkSelectionMode>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getISOCountryCodeForNetwork⁷⁺

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getISOCountryCodeForNetwork⁷⁺

getISOCountryCodeForNetwork(slotId: number): Promise<string>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getPrimarySlotId⁷⁺

getPrimarySlotId(callback: AsyncCallback<number>): void

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

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getPrimarySlotId⁷⁺

getPrimarySlotId(): Promise<number>

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

系统能力：SystemCapability.Telephony.CoreService

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getSignalInformation⁷⁺

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getSignalInformation⁷⁺

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.isNrSupported^(deprecated)

isNrSupported(): boolean

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

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用isNRSupported替代。

系统能力：SystemCapability.Telephony.CoreService

返回值：

示例：

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

radio.isNrSupported^(deprecated)

isNrSupported(slotId: number): boolean

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

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用isNRSupported替代。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

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

radio.isNRSupported⁹⁺

isNRSupported(): boolean

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

系统能力：SystemCapability.Telephony.CoreService

返回值：

示例：

let result = radio.isNRSupported();
console.log("Result: "+ result);

radio.isNRSupported⁹⁺

isNRSupported(slotId: number): boolean

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

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

let slotId = 0;
let result = radio.isNRSupported(slotId);
console.log("Result: "+ result);

radio.isRadioOn⁷⁺

isRadioOn(callback: AsyncCallback<boolean>): void

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.isRadioOn⁷⁺

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.isRadioOn⁷⁺

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getOperatorName⁷⁺

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getOperatorName⁷⁺

getOperatorName(slotId: number): Promise<string>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.setPrimarySlotId⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.setPrimarySlotId⁸⁺

setPrimarySlotId(slotId: number): Promise<void>

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

let slotId = 0;
let promise = radio.setPrimarySlotId(slotId);
promise.then(() => {
    console.log(`setPrimarySlotId success.`);
}).catch((err) => {
    console.log(`setPrimarySlotId failed, promise: err->${JSON.stringify(err)}`);
});

radio.getIMEI⁸⁺

getIMEI(callback: AsyncCallback<string>): void

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getIMEI⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getIMEI⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getMEID⁸⁺

getMEID(callback: AsyncCallback<string>): void

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getMEID⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getMEID⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getUniqueDeviceId⁸⁺

getUniqueDeviceId(callback: AsyncCallback<string>): void

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getUniqueDeviceId⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getUniqueDeviceId⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.sendUpdateCellLocationRequest⁸⁺

sendUpdateCellLocationRequest(callback: AsyncCallback<void>): void

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.sendUpdateCellLocationRequest⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.sendUpdateCellLocationRequest⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

let slotId = 0;
radio.sendUpdateCellLocationRequest(slotId).then(() => {
    console.log(`sendUpdateCellLocationRequest success.`);
}).catch((err) => {
    console.log(`sendUpdateCellLocationRequest failed, promise: err->${JSON.stringify(err)}`);
});

radio.getCellInformation⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getCellInformation⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getCellInformation⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.setNetworkSelectionMode

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

radio.setNetworkSelectionMode

setNetworkSelectionMode(options: NetworkSelectionModeOptions): Promise<void>

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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(() => {
    console.log(`setNetworkSelectionMode success.`);
}).catch((err) => {
    console.log(`setNetworkSelectionMode failed, promise: err->${JSON.stringify(err)}`);
});

radio.getNetworkSearchInformation

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getNetworkSearchInformation

getNetworkSearchInformation(slotId: number): Promise<NetworkSearchResult>

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getNrOptionMode⁸⁺

getNrOptionMode(callback: AsyncCallback<NrOptionMode>): void

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

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getNrOptionMode⁸⁺

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

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

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getNrOptionMode⁸⁺

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

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

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.turnOnRadio⁷⁺

turnOnRadio(callback: AsyncCallback<void>): void

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.turnOnRadio⁷⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.turnOnRadio⁷⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

let slotId = 0;
radio.turnOnRadio(slotId).then(() => {
    console.log(`turnOnRadio success.`);
}).catch((err) => {
    console.error(`turnOnRadio failed, promise: err->${JSON.stringify(err)}`);
});

radio.turnOffRadio⁷⁺

turnOffRadio(callback: AsyncCallback<void>): void

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.turnOffRadio⁷⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.turnOffRadio⁷⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

let slotId = 0;
radio.turnOffRadio(slotId).then(() => {
    console.log(`turnOffRadio success.`);
}).catch((err) => {
    console.error(`turnOffRadio failed, promise: err->${JSON.stringify(err)}`);
});

radio.setPreferredNetwork⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

let slotId = 0;
radio.setPreferredNetwork(slotId, radio.PreferredNetworkMode.PREFERRED_NETWORK_MODE_GSM, (err) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

radio.setPreferredNetwork⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

let slotId = 0;
radio.setPreferredNetwork(slotId, radio.PreferredNetworkMode.PREFERRED_NETWORK_MODE_GSM).then(() => {
    console.log(`setPreferredNetwork success.`);
}).catch((err) => {
    console.log(`setPreferredNetwork failed, promise: err->${JSON.stringify(err)}`);
});

radio.getPreferredNetwork⁸⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getPreferredNetwork⁸⁺

getPreferredNetwork(slotId: number): Promise<PreferredNetworkMode>

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.getImsRegInfo⁹⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.getImsRegInfo⁹⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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)}`);
});

radio.on('imsRegStateChange')⁹⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

radio.off('imsRegStateChange')⁹⁺

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

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

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码错误码。

示例：

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

RadioTechnology

无线接入技术。

系统能力：SystemCapability.Telephony.CoreService

SignalInformation

网络信号强度信息对象。

系统能力：SystemCapability.Telephony.CoreService

NetworkType

网络类型。

系统能力：SystemCapability.Telephony.CoreService

NetworkState

网络注册状态。

系统能力：SystemCapability.Telephony.CoreService

RegState

网络注册状态。

系统能力：SystemCapability.Telephony.CoreService

NsaState

非独立组网状态。

系统能力：SystemCapability.Telephony.CoreService

NetworkSelectionMode

选网模式。

系统能力：SystemCapability.Telephony.CoreService

PreferredNetworkMode⁸⁺

首选网络模式。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

CellInformation⁸⁺

小区信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

CdmaCellInformation⁸⁺

CDMA小区信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

GsmCellInformation⁸⁺

GSM小区信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

LteCellInformation⁸⁺

LTE小区信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

NrCellInformation⁸⁺

NR小区信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

TdscdmaCellInformation⁸⁺

TD-SCDMA小区信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

WcdmaCellInformation⁸⁺

WCDMA小区信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

NrOptionMode⁸⁺

NR的选择模式。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

NetworkSearchResult

网络搜索结果。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

NetworkInformation

网络信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

NetworkInformationState

网络信息状态。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

NetworkSelectionModeOptions

网络选择模式选项。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

ImsRegState⁹⁺

IMS注册状态。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

ImsRegTech⁹⁺

IMS注册技术。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

ImsRegInfo⁹⁺

IMS注册信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService

ImsServiceType⁹⁺

IMS服务类型。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService