harmony 鸿蒙@ohos.telephony.radio (网络搜索)

2022-08-09
浏览 (725)

@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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
class Tech {
    psRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN;
    csRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN;
}
radio.getRadioTech(slotId, (err: BusinessError, data: Tech) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
class Tech {
    psRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN;
    csRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN;
}
radio.getRadioTech(slotId).then((data: Tech) => {
    console.log(`getRadioTech success, data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.log(`getRadioTech failed, err->${JSON.stringify(err)}`);
});

radio.getNetworkState

getNetworkState(callback: AsyncCallback<NetworkState>): void

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getNetworkState((err: BusinessError, data: radio.NetworkState) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getNetworkState(slotId, (err: BusinessError, data: radio.NetworkState) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getNetworkSelectionMode

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number): Promise<NetworkSelectionMode>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getISOCountryCodeForNetwork⁷⁺

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
callback	AsyncCallback<string>	是	回调函数。返回国家码，例如：CN（中国）。

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getISOCountryCodeForNetwork⁷⁺

getISOCountryCodeForNetwork(slotId: number): Promise<string>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getISOCountryCodeForNetworkSync¹⁰⁺

getISOCountryCodeForNetworkSync(slotId: number): string

获取注册网络所在国家的ISO国家码。

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

类型	说明
string	返回注册网络所在国家的ISO国家码，例如CN（中国）。

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let countryISO: string = radio.getISOCountryCodeForNetworkSync(slotId);
console.log(`the country ISO is:` + countryISO);

radio.getPrimarySlotId⁷⁺

getPrimarySlotId(callback: AsyncCallback<number>): void

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getPrimarySlotId⁷⁺

getPrimarySlotId(): Promise<number>

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

系统能力：SystemCapability.Telephony.CoreService

返回值：

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

错误码：

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

错误码ID	错误信息
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getPrimarySlotId().then((data: number) => {
    console.log(`getPrimarySlotId success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getPrimarySlotId failed, promise: err->${JSON.stringify(err)}`);
});

radio.getSignalInformation⁷⁺

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对象的数组。

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getSignalInformation⁷⁺

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getSignalInformation(slotId).then((data: Array<radio.SignalInformation>) => {
    console.log(`getSignalInformation success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSignalInformation failed, promise: err->${JSON.stringify(err)}`);
});

radio.getSignalInformationSync¹⁰⁺

getSignalInformationSync(slotId: number): Array<SignalInformation>

获取指定SIM卡槽对应的注册网络信号强度信息列表。

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let signalInfo: Array<radio.SignalInformation> = radio.getSignalInformationSync(slotId);
console.log(`signal information size is:` + signalInfo.length);

radio.isNrSupported^(deprecated)

isNrSupported(): boolean

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

说明：

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

系统能力：SystemCapability.Telephony.CoreService

返回值：

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

示例：

let result: boolean = 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

参数：

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

返回值：

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

示例：

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

radio.isNRSupported⁹⁺

isNRSupported(): boolean

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

系统能力：SystemCapability.Telephony.CoreService

返回值：

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

示例：

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

radio.isNRSupported⁹⁺

isNRSupported(slotId: number): boolean

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

示例：

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

radio.isRadioOn⁷⁺

isRadioOn(callback: AsyncCallback<boolean>): void

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.isRadioOn((err: BusinessError, data: boolean) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.isRadioOn(slotId, (err: BusinessError, data: boolean) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getOperatorName⁷⁺

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getOperatorName⁷⁺

getOperatorName(slotId: number): Promise<string>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getOperatorNameSync¹⁰⁺

getOperatorNameSync(slotId: number): string

获取运营商名称。

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

类型	说明
string	返回运营商名称，例如：中国移动。

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let operatorName: string = radio.getOperatorNameSync(slotId);
console.log(`operator name is:` + operatorName);

radio.setPrimarySlotId⁸⁺

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>	是	回调函数。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300004	Do not have sim card.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.setPrimarySlotId⁸⁺

setPrimarySlotId(slotId: number): Promise<void>

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300004	Do not have sim card.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.setPrimarySlotId(slotId).then(() => {
    console.log(`setPrimarySlotId success.`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getIMEI((err: BusinessError, data: string) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getIMEI(slotId, (err: BusinessError, data: string) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getIMEI(slotId).then((data: string) => {
    console.log(`getIMEI success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getMEID((err: BusinessError, data: string) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getMEID(slotId, (err: BusinessError, data: string) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getMEID(slotId).then((data: string) => {
    console.log(`getMEID success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getUniqueDeviceId((err: BusinessError, data: string) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getUniqueDeviceId(slotId, (err: BusinessError, data: string) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getUniqueDeviceId(slotId).then((data: string) => {
    console.log(`getUniqueDeviceId success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.sendUpdateCellLocationRequest((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.sendUpdateCellLocationRequest(slotId, (err: BusinessError) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.sendUpdateCellLocationRequest(slotId).then(() => {
    console.log(`sendUpdateCellLocationRequest success.`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getCellInformation((err: BusinessError, data: Array<radio.CellInformation>) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getCellInformation(slotId, (err: BusinessError, data: Array<radio.CellInformation>) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getCellInformation(slotId).then((data: Array<radio.CellInformation>) => {
    console.log(`getCellInformation success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let networkInformation: radio.NetworkInformation = {
    operatorName: "中国移动",
    operatorNumeric: "898600",
    state: radio.NetworkInformationState.NETWORK_AVAILABLE,
    radioTech: "CS"
}
let networkSelectionModeOptions: radio.NetworkSelectionModeOptions = {
    slotId: 0,
    selectMode: radio.NetworkSelectionMode.NETWORK_SELECTION_AUTOMATIC,
    networkInformation: networkInformation,
    resumeSelection: true
}
radio.setNetworkSelectionMode(networkSelectionModeOptions, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

radio.setNetworkSelectionMode

setNetworkSelectionMode(options: NetworkSelectionModeOptions): Promise<void>

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let networkInformation: radio.NetworkInformation = {
    operatorName: "中国移动",
    operatorNumeric: "898600",
    state: radio.NetworkInformationState.NETWORK_AVAILABLE,
    radioTech: "CS"
}
let networkSelectionModeOptions: radio.NetworkSelectionModeOptions = {
    slotId: 0,
    selectMode: radio.NetworkSelectionMode.NETWORK_SELECTION_AUTOMATIC,
    networkInformation: networkInformation,
    resumeSelection: true
}
radio.setNetworkSelectionMode(networkSelectionModeOptions).then(() => {
    console.log(`setNetworkSelectionMode success.`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getNetworkSearchInformation(0, (err: BusinessError, data: radio.NetworkSearchResult) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.getNetworkSearchInformation(0).then((data: radio.NetworkSearchResult) => {
    console.log(`getNetworkSearchInformation success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.log(`getNetworkSearchInformation failed, promise: err->${JSON.stringify(err)}`);
});

radio.getNrOptionMode^(deprecated)

getNrOptionMode(callback: AsyncCallback<NrOptionMode>): void

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

说明：

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getNrOptionMode^(deprecated)

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

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

说明：

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getNrOptionMode^(deprecated)

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

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

说明：

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getNrOptionMode(slotId).then((data: radio.NrOptionMode) => {
    console.log(`getNrOptionMode success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.turnOnRadio((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.turnOnRadio⁷⁺

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形式返回结果。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.turnOnRadio(slotId).then(() => {
    console.log(`turnOnRadio success.`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

radio.turnOffRadio((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.turnOffRadio⁷⁺

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形式返回结果。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.turnOffRadio(slotId).then(() => {
    console.log(`turnOffRadio success.`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let mode: radio.PreferredNetworkMode = radio.PreferredNetworkMode.PREFERRED_NETWORK_MODE_GSM;
radio.setPreferredNetwork(slotId, mode, (err: BusinessError) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let mode: radio.PreferredNetworkMode = radio.PreferredNetworkMode.PREFERRED_NETWORK_MODE_GSM;
radio.setPreferredNetwork(slotId, mode).then(() => {
    console.log(`setPreferredNetwork success.`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getPreferredNetwork(slotId, (err: BusinessError, data: radio.PreferredNetworkMode) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
radio.getPreferredNetwork(slotId).then((data: radio.PreferredNetworkMode) => {
    console.log(`getPreferredNetwork success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let mode: radio.ImsServiceType = radio.ImsServiceType.TYPE_VIDEO;
radio.getImsRegInfo(slotId, mode, (err: BusinessError, data: radio.ImsRegInfo) => {
    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

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let mode: radio.ImsServiceType = radio.ImsServiceType.TYPE_VIDEO;
radio.getImsRegInfo(slotId, mode).then((data: radio.ImsRegInfo) => {
    console.log(`getImsRegInfo success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    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

参数：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let mode: radio.ImsServiceType = radio.ImsServiceType.TYPE_VIDEO;
radio.on('imsRegStateChange', slotId, mode, (data: radio.ImsRegInfo) => {
    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

参数：

参数名	类型	必填	说明
type	string	是	取消监听IMS注册状态的变化。
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
imsType	ImsServiceType	是	IMS服务类型。
callback	Callback<ImsRegInfo>	否	回调函数。不填该参数不影响取消订阅。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getBasebandVersion¹⁰⁺

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

获取设备的基带版本号。使用callback异步回调。

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
callback	AsyncCallback<string>	是	回调函数。获取的基带版本号。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getBasebandVersion¹⁰⁺

getBasebandVersion(slotId: number): Promise<string>

获取设备的基带版本号。使用Promise异步回调。

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

类型	说明
Promise<string>	以Promise形式返回设备的基带版本号。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.setNROptionMode¹⁰⁺

setNROptionMode(slotId: number, mode: NROptionMode, callback: AsyncCallback<void>): void

设置Nr选项模式。使用callback异步回调。

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
mode	NROptionMode	是	NR的选择模式。
callback	AsyncCallback<void>	是	回调函数。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let mode: radio.NROptionMode = radio.NROptionMode.NR_OPTION_NSA_ONLY;
radio.setNROptionMode(slotId, mode, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

radio.setNROptionMode¹⁰⁺

setNROptionMode(slotId: number, mode: NROptionMode): Promise<void>

设置Nr选项模式。使用Promise异步回调。

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
mode	NROptionMode	是	NR的选择模式。

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getNROptionMode¹⁰⁺

getNROptionMode(slotId: number, callback: AsyncCallback<NROptionMode>): void

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID	错误信息
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getNROptionMode¹⁰⁺

getNROptionMode(slotId: number): Promise<NROptionMode>

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID	错误信息
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

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

radio.getNetworkCapability¹⁰⁺

getNetworkCapability(slotId: number, type: NetworkCapabilityType, callback: AsyncCallback<NetworkCapabilityState>): void

获取指定网络类型的开关状态。使用callback异步回调。

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
type	NetworkCapabilityType	是	网络能力类型。
callback	AsyncCallback<NetworkCapabilityState>	是	回调函数。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR;
radio.getNetworkCapability(slotId, type, (err: BusinessError, data: radio.NetworkCapabilityState) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

radio.getNetworkCapability¹⁰⁺

getNetworkCapability(slotId: number, type: NetworkCapabilityType): Promise<NetworkCapabilityState>

获取指定网络类型的开关状态。使用Promise异步回调。

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
type	NetworkCapabilityType	是	网络能力类型。

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR;
radio.getNetworkCapability(slotId, type).then((data: radio.NetworkCapabilityState) => {
    console.log(`getNetworkCapability success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.log(`getNetworkCapability failed, promise: err->${JSON.stringify(err)}`);
});

radio.setNetworkCapability¹⁰⁺

setNetworkCapability(slotId: number, type: NetworkCapabilityType, state: NetworkCapabilityState, callback: AsyncCallback<void>): void

设置指定网络类型的开关状态。使用callback异步回调。

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
type	NetworkCapabilityType	是	网络能力类型。
state	NetworkCapabilityState	是	网络能力状态。
callback	AsyncCallback<void>	是	回调函数。

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR;
let state: radio.NetworkCapabilityState = radio.NetworkCapabilityState.SERVICE_CAPABILITY_ON;
radio.setNetworkCapability(slotId, type, state, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

radio.setNetworkCapability¹⁰⁺

setNetworkCapability(slotId: number, type: NetworkCapabilityType, state: NetworkCapabilityState): Promise<void>

设置指定网络类型的开关状态。使用Promise异步回调。

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
type	NetworkCapabilityType	是	网络能力类型。
state	NetworkCapabilityState	是	网络能力状态。

返回值：

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

错误码：

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

错误码ID	错误信息
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

示例：

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR;
let state: radio.NetworkCapabilityState = radio.NetworkCapabilityState.SERVICE_CAPABILITY_ON;
radio.setNetworkCapability(slotId, type, state).then(() => {
    console.log(`setNetworkCapability success`);
}).catch((err: BusinessError) => {
    console.log(`setNetworkCapability failed, promise: err->${JSON.stringify(err)}`);
});

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	是	网络信号强度等级。
dBm⁹⁺	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	是	设备的网络注册状态。
cfgTech⁸⁺	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	手动选网模式。

PreferredNetworkMode⁸⁺

首选网络模式。

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

系统能力：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	首选网络模式最大值。

CellInformation⁸⁺

小区信息。

系统能力：SystemCapability.Telephony.CoreService

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

CdmaCellInformation⁸⁺

CDMA小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

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

GsmCellInformation⁸⁺

GSM小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

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

LteCellInformation⁸⁺

LTE小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

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

NrCellInformation⁸⁺

NR小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

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

TdscdmaCellInformation⁸⁺

TD-SCDMA小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

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

WcdmaCellInformation⁸⁺

WCDMA小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

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

NrOptionMode^(deprecated)

NR的选择模式。

说明：

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

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

系统能力：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选择模式。

NROptionMode¹⁰⁺

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	是	继续选择。

ImsRegState⁹⁺

IMS注册状态。

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

系统能力：SystemCapability.Telephony.CoreService

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

ImsRegTech⁹⁺

IMS注册技术。

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

系统能力：SystemCapability.Telephony.CoreService

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

ImsRegInfo⁹⁺

IMS注册信息。

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

系统能力：SystemCapability.Telephony.CoreService

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

ImsServiceType⁹⁺

IMS服务类型。

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

系统能力：SystemCapability.Telephony.CoreService

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

NetworkCapabilityType¹⁰⁺

网络能力类型。

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

系统能力：SystemCapability.Telephony.CoreService

名称	值	说明
SERVICE_TYPE_LTE	0	LTE服务类型。
SERVICE_TYPE_NR	1	NR服务类型。

NetworkCapabilityState¹⁰⁺

网络能力开关状态。

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

系统能力：SystemCapability.Telephony.CoreService

名称	值	说明
SERVICE_CAPABILITY_OFF	0	网络能力关闭。
SERVICE_CAPABILITY_ON	1	网络能力打开。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0 赞

所属分类： 后端技术
本文标签： 软件鸿蒙
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/946b929eb64a456ab6420e5cdacd74f7

harmony 鸿蒙@ohos.telephony.radio (网络搜索)

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

导入模块

radio.getRadioTech

radio.getRadioTech

radio.getNetworkState

radio.getNetworkState

radio.getNetworkState

radio.getNetworkSelectionMode

radio.getNetworkSelectionMode

radio.getISOCountryCodeForNetwork7+

radio.getISOCountryCodeForNetwork7+

radio.getISOCountryCodeForNetworkSync10+

radio.getPrimarySlotId7+

radio.getPrimarySlotId7+

radio.getSignalInformation7+

radio.getSignalInformation7+

radio.getSignalInformationSync10+

radio.isNrSupported(deprecated)

radio.isNrSupported(deprecated)

radio.isNRSupported9+

radio.isNRSupported9+

radio.isRadioOn7+

radio.isRadioOn7+

radio.isRadioOn7+

radio.getOperatorName7+

radio.getOperatorName7+

radio.getOperatorNameSync10+

radio.setPrimarySlotId8+

radio.setPrimarySlotId8+

radio.getIMEI8+

radio.getIMEI8+

radio.getIMEI8+

radio.getMEID8+

radio.getMEID8+

radio.getMEID8+

radio.getUniqueDeviceId8+

radio.getUniqueDeviceId8+

radio.getUniqueDeviceId8+

radio.sendUpdateCellLocationRequest8+

radio.sendUpdateCellLocationRequest8+

radio.sendUpdateCellLocationRequest8+

radio.getCellInformation8+

radio.getCellInformation8+

radio.getCellInformation8+

radio.setNetworkSelectionMode

radio.setNetworkSelectionMode

radio.getNetworkSearchInformation

radio.getNetworkSearchInformation

radio.getNrOptionMode(deprecated)

radio.getNrOptionMode(deprecated)

radio.getNrOptionMode(deprecated)

radio.turnOnRadio7+

radio.turnOnRadio7+

radio.turnOnRadio7+

radio.turnOffRadio7+

radio.turnOffRadio7+

radio.turnOffRadio7+

radio.setPreferredNetwork8+

radio.setPreferredNetwork8+

radio.getPreferredNetwork8+

radio.getPreferredNetwork8+

radio.getImsRegInfo9+

radio.getImsRegInfo9+

radio.on(‘imsRegStateChange’)9+

radio.off(‘imsRegStateChange’)9+

radio.getBasebandVersion10+

radio.getBasebandVersion10+

radio.setNROptionMode10+

radio.setNROptionMode10+

radio.getNROptionMode10+

radio.getNROptionMode10+

radio.getNetworkCapability10+

radio.getNetworkCapability10+

radio.setNetworkCapability10+

radio.setNetworkCapability10+

RadioTechnology

SignalInformation

NetworkType

NetworkState

radio.getISOCountryCodeForNetwork⁷⁺

radio.getISOCountryCodeForNetwork⁷⁺

radio.getISOCountryCodeForNetworkSync¹⁰⁺

radio.getPrimarySlotId⁷⁺

radio.getPrimarySlotId⁷⁺

radio.getSignalInformation⁷⁺

radio.getSignalInformation⁷⁺

radio.getSignalInformationSync¹⁰⁺

radio.isNrSupported^(deprecated)

radio.isNrSupported^(deprecated)

radio.isNRSupported⁹⁺

radio.isNRSupported⁹⁺

radio.isRadioOn⁷⁺

radio.isRadioOn⁷⁺

radio.isRadioOn⁷⁺

radio.getOperatorName⁷⁺

radio.getOperatorName⁷⁺

radio.getOperatorNameSync¹⁰⁺

radio.setPrimarySlotId⁸⁺

radio.setPrimarySlotId⁸⁺

radio.getIMEI⁸⁺

radio.getIMEI⁸⁺

radio.getIMEI⁸⁺

radio.getMEID⁸⁺

radio.getMEID⁸⁺

radio.getMEID⁸⁺

radio.getUniqueDeviceId⁸⁺

radio.getUniqueDeviceId⁸⁺

radio.getUniqueDeviceId⁸⁺

radio.sendUpdateCellLocationRequest⁸⁺

radio.sendUpdateCellLocationRequest⁸⁺

radio.sendUpdateCellLocationRequest⁸⁺

radio.getCellInformation⁸⁺

radio.getCellInformation⁸⁺

radio.getCellInformation⁸⁺

radio.getNrOptionMode^(deprecated)

radio.getNrOptionMode^(deprecated)

radio.getNrOptionMode^(deprecated)

radio.turnOnRadio⁷⁺

radio.turnOnRadio⁷⁺

radio.turnOnRadio⁷⁺

radio.turnOffRadio⁷⁺

radio.turnOffRadio⁷⁺

radio.turnOffRadio⁷⁺

radio.setPreferredNetwork⁸⁺

radio.setPreferredNetwork⁸⁺

radio.getPreferredNetwork⁸⁺

radio.getPreferredNetwork⁸⁺

radio.getImsRegInfo⁹⁺

radio.getImsRegInfo⁹⁺

radio.on(‘imsRegStateChange’)⁹⁺

radio.off(‘imsRegStateChange’)⁹⁺

radio.getBasebandVersion¹⁰⁺

radio.getBasebandVersion¹⁰⁺

radio.setNROptionMode¹⁰⁺

radio.setNROptionMode¹⁰⁺

radio.getNROptionMode¹⁰⁺

radio.getNROptionMode¹⁰⁺

radio.getNetworkCapability¹⁰⁺

radio.getNetworkCapability¹⁰⁺

radio.setNetworkCapability¹⁰⁺

radio.setNetworkCapability¹⁰⁺

PreferredNetworkMode⁸⁺

CellInformation⁸⁺

CdmaCellInformation⁸⁺

GsmCellInformation⁸⁺

LteCellInformation⁸⁺

NrCellInformation⁸⁺

TdscdmaCellInformation⁸⁺

WcdmaCellInformation⁸⁺

NrOptionMode^(deprecated)

NROptionMode¹⁰⁺

ImsRegState⁹⁺

ImsRegTech⁹⁺

ImsRegInfo⁹⁺

ImsServiceType⁹⁺

NetworkCapabilityType¹⁰⁺

NetworkCapabilityState¹⁰⁺