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

2022-08-09 浏览 (1028)

@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

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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

参数：

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

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getISOCountryCodeForNetwork7+

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getISOCountryCodeForNetwork7+

getISOCountryCodeForNetwork(slotId: number): Promise<string>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getISOCountryCodeForNetworkSync10+

getISOCountryCodeForNetworkSync(slotId: number): string

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

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽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.getPrimarySlotId7+

getPrimarySlotId(callback: AsyncCallback<number>): void

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getPrimarySlotId7+

getPrimarySlotId(): Promise<number>

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

系统能力：SystemCapability.Telephony.CoreService

返回值：

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

错误码：

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

错误码ID错误信息
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getSignalInformation7+

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
callbackAsyncCallback<Array<SignalInformation>>是回调函数，返回SignalInformation对象的数组。

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getSignalInformation7+

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getSignalInformationSync10+

getSignalInformationSync(slotId: number): Array<SignalInformation>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽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

参数：

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

返回值：

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

示例：

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

radio.isNRSupported9+

isNRSupported(): boolean

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

系统能力：SystemCapability.Telephony.CoreService

返回值：

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

示例：

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

radio.isNRSupported9+

isNRSupported(slotId: number): boolean

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

示例：

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

radio.isRadioOn7+

isRadioOn(callback: AsyncCallback<boolean>): void

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.isRadioOn7+

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.isRadioOn7+

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

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

需要权限：ohos.permission.GET_NETWORK_INFO

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getOperatorName7+

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getOperatorName7+

getOperatorName(slotId: number): Promise<string>

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getOperatorNameSync10+

getOperatorNameSync(slotId: number): string

获取运营商名称。

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽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.setPrimarySlotId8+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

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

示例：

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

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

radio.setPrimarySlotId8+

setPrimarySlotId(slotId: number): Promise<void>

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

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

getIMEI(callback: AsyncCallback<string>): void

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getIMEI8+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getIMEI8+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getMEID8+

getMEID(callback: AsyncCallback<string>): void

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getMEID8+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getMEID8+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getUniqueDeviceId8+

getUniqueDeviceId(callback: AsyncCallback<string>): void

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getUniqueDeviceId8+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getUniqueDeviceId8+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.sendUpdateCellLocationRequest8+

sendUpdateCellLocationRequest(callback: AsyncCallback<void>): void

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

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

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

示例：

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

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

radio.sendUpdateCellLocationRequest8+

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

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

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

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

示例：

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

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

radio.sendUpdateCellLocationRequest8+

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

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

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getCellInformation8+

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

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

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getCellInformation8+

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

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

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getCellInformation8+

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

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

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

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

参数：

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

错误码：

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

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

参数：

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

返回值：

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

错误码：

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

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

参数：

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

错误码：

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

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

参数：

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

返回值：

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

错误码：

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

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

参数：

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

错误码：

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

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

参数：

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

错误码：

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

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

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.turnOnRadio7+

turnOnRadio(callback: AsyncCallback<void>): void

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

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

示例：

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

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

radio.turnOnRadio7+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

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

示例：

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

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

radio.turnOnRadio7+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.turnOffRadio7+

turnOffRadio(callback: AsyncCallback<void>): void

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

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

示例：

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

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

radio.turnOffRadio7+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

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

示例：

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

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

radio.turnOffRadio7+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.setPreferredNetwork8+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
networkModePreferredNetworkMode是设置首选网络模式。
callbackAsyncCallback<void>是回调函数。

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.setPreferredNetwork8+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getPreferredNetwork8+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getPreferredNetwork8+

getPreferredNetwork(slotId: number): Promise<PreferredNetworkMode>

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getImsRegInfo9+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
imsTypeImsServiceType是IMS服务类型。
callbackAsyncCallback<ImsRegInfo>是回调函数。

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getImsRegInfo9+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
imsTypeImsServiceType是IMS服务类型。

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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')9+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
typestring是监听IMS注册状态的变化。
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
imsTypeImsServiceType是IMS服务类型。
callbackCallback<ImsRegInfo>是回调函数。

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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')9+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
typestring是取消监听IMS注册状态的变化。
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
imsTypeImsServiceType是IMS服务类型。
callbackCallback<ImsRegInfo>否回调函数。不填该参数不影响取消订阅。

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getBasebandVersion10+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getBasebandVersion10+

getBasebandVersion(slotId: number): Promise<string>

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.setNROptionMode10+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
modeNROptionMode是NR的选择模式。
callbackAsyncCallback<void>是回调函数。

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.setNROptionMode10+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getNROptionMode10+

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

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

错误码：

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

错误码ID错误信息
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getNROptionMode10+

getNROptionMode(slotId: number): Promise<NROptionMode>

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

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

系统能力：SystemCapability.Telephony.CoreService

参数：

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

返回值：

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

错误码：

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

错误码ID错误信息
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getNetworkCapability10+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
typeNetworkCapabilityType是网络能力类型。
callbackAsyncCallback<NetworkCapabilityState>是回调函数。

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.getNetworkCapability10+

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

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

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

需要权限：ohos.permission.GET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
typeNetworkCapabilityType是网络能力类型。

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.setNetworkCapability10+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
typeNetworkCapabilityType是网络能力类型。
stateNetworkCapabilityState是网络能力状态。
callbackAsyncCallback<void>是回调函数。

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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.setNetworkCapability10+

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

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

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

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
typeNetworkCapabilityType是网络能力类型。
stateNetworkCapabilityState是网络能力状态。

返回值：

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

错误码：

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

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error.
8300001Invalid parameter value.
8300002Operation failed. Cannot connect to service.
8300003System internal error.
8300999Unknown 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_UNKNOWN0未知无线接入技术（RAT）。
RADIO_TECHNOLOGY_GSM1无线接入技术GSM（Global System For Mobile Communication）。
RADIO_TECHNOLOGY_1XRTT2无线接入技术1XRTT（Single-Carrier Radio Transmission Technology）。
RADIO_TECHNOLOGY_WCDMA3无线接入技术WCDMA（Wideband Code Division Multiple Access）。
RADIO_TECHNOLOGY_HSPA4无线接入技术HSPA（High Speed Packet Access）。
RADIO_TECHNOLOGY_HSPAP5无线接入技术HSPAP（High Speed packet access (HSPA+) ）。
RADIO_TECHNOLOGY_TD_SCDMA6无线接入技术TDSCDMA（TimeDivision-Synchronous Code Division Multiple Access）。
RADIO_TECHNOLOGY_EVDO7无线接入技术EVDO（Evolution Data Only）。
RADIO_TECHNOLOGY_EHRPD8无线接入技术EHRPD（Evolved High Rate Package Data）。
RADIO_TECHNOLOGY_LTE9无线接入技术LTE（Long Term Evolution）。
RADIO_TECHNOLOGY_LTE_CA10无线接入技术LTE_CA（Long Term Evolution_Carrier Aggregation）。
RADIO_TECHNOLOGY_IWLAN11无线接入技术IWLAN（Industrial Wireless LAN）。
RADIO_TECHNOLOGY_NR12无线接入技术NR（New Radio）。

SignalInformation

网络信号强度信息对象。

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
signalTypeNetworkType是网络信号强度类型。
signalLevelnumber是网络信号强度等级。
dBm9+number是网络信号强度。

NetworkType

网络类型。

系统能力：SystemCapability.Telephony.CoreService

名称值说明
NETWORK_TYPE_UNKNOWN0未知网络类型。
NETWORK_TYPE_GSM1网络类型为GSM（Global System For Mobile Communication）。
NETWORK_TYPE_CDMA2网络类型为CDMA（Code Division Multiple Access）。
NETWORK_TYPE_WCDMA3网络类型为WCDMA（Wideband Code Division Multiple Access）。
NETWORK_TYPE_TDSCDMA4网络类型为TDSCDMA（TimeDivision-Synchronous Code Division Multiple Access）。
NETWORK_TYPE_LTE5网络类型为LTE（Long Term Evolution）。
NETWORK_TYPE_NR6网络类型为5G NR（New Radio）。

NetworkState

网络注册状态。

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
longOperatorNamestring是注册网络的长运营商名称。
shortOperatorNamestring是注册网络的短运营商名称。
plmnNumericstring是注册网络的PLMN码。
isRoamingboolean是是否处于漫游状态。
regStateRegState是设备的网络注册状态。
cfgTech8+RadioTechnology是设备的无线接入技术。
nsaStateNsaState是设备的NSA网络注册状态。
isCaActiveboolean是CA的状态。
isEmergencyboolean是此设备是否只允许拨打紧急呼叫。

RegState

网络注册状态。

系统能力：SystemCapability.Telephony.CoreService

名称值说明
REG_STATE_NO_SERVICE0设备不能使用任何服务，包括数据业务、短信、通话等。
REG_STATE_IN_SERVICE1设备可以正常使用服务，包括数据业务、短信、通话等。
REG_STATE_EMERGENCY_CALL_ONLY2设备只能使用紧急呼叫业务。
REG_STATE_POWER_OFF3蜂窝无线电已关闭，modem下电，无法和网侧进行通信。

NsaState

非独立组网状态。

系统能力：SystemCapability.Telephony.CoreService

名称值说明
NSA_STATE_NOT_SUPPORT1设备在不支持NSA的LTE小区下处于空闲状态或连接状态。
NSA_STATE_NO_DETECT2在支持NSA但不支持NR覆盖检测的LTE小区下，设备处于空闲状态。
NSA_STATE_CONNECTED_DETECT3设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。
NSA_STATE_IDLE_DETECT4支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。
NSA_STATE_DUAL_CONNECTED5设备在支持NSA的LTE小区下连接到LTE + NR网络。
NSA_STATE_SA_ATTACHED6设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。

NetworkSelectionMode

选网模式。

系统能力：SystemCapability.Telephony.CoreService

名称值说明
NETWORK_SELECTION_UNKNOWN0未知选网模式。
NETWORK_SELECTION_AUTOMATIC1自动选网模式。
NETWORK_SELECTION_MANUAL2手动选网模式。

PreferredNetworkMode8+

首选网络模式。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
PREFERRED_NETWORK_MODE_GSM1首选GSM网络模式。
PREFERRED_NETWORK_MODE_WCDMA2首选WCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE3首选LTE网络模式。
PREFERRED_NETWORK_MODE_LTE_WCDMA4首选LTE WCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM5首选LTE WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_WCDMA_GSM6首选WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_CDMA7首选CDMA网络模式。
PREFERRED_NETWORK_MODE_EVDO8首选EVDO网络模式。
PREFERRED_NETWORK_MODE_EVDO_CDMA9首选EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_WCDMA_GSM_EVDO_CDMA10首选WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_EVDO_CDMA11首选LTE EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM_EVDO_CDMA12首选LTE WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA13首选TDSCDMA网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_GSM14首选TDSCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA15首选TDSCDMA_WCDMA网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM16首选TDSCDMA_WCDMA_GSM网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA17首选LTE TDSCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_GSM18首选LTE TDSCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA19首选LTE TDSCDMA WCDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM20首选LTE TDSCDMA WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM_EVDO_CDMA21首选TDSCDMA WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA22首选LTE TDSCDMA WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_NR31首选NR网络模式。
PREFERRED_NETWORK_MODE_NR_LTE32首选NR LTE网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA33首选NR LTE WCDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM34首选NR LTE WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_EVDO_CDMA35首选NR LTE EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM_EVDO_CDMA36首选NR LTE WCDMA GSM EVDO CDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA37首选NR LTE TDSCDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_GSM38首选NR LTE TDSCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA39首选NR LTE TDSCDMA WCDMA网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM40首选NR LTE TDSCDMA WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA41首选NR LTE TDSCDMA WCDMA GSM网络模式。
PREFERRED_NETWORK_MODE_MAX_VALUE99首选网络模式最大值。

CellInformation8+

小区信息。

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
networkTypeNetworkType是获取服务单元的网络类型。
isCampedboolean是获取服务单元的状态。
系统接口： 此接口为系统接口。
timeStampnumber是获取单元格信息时获取时间戳。
系统接口： 此接口为系统接口。
signalInformationSignalInformation是信号信息。
dataCdmaCellInformation |GsmCellInformation |LteCellInformation |NrCellInformation |TdscdmaCellInformation是Cdma小区信息 |Gsm小区信息|Lte小区信息|Nr小区信息|Tdscdma小区信息
系统接口： 此接口为系统接口。

CdmaCellInformation8+

CDMA小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
baseIdnumber是基站Id。
latitudenumber是经度。
longitudenumber是纬度。
nidnumber是网络识别码。
sidnumber是系统识别码。

GsmCellInformation8+

GSM小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
lacnumber是位置区编号。
cellIdnumber是小区号。
arfcnnumber是绝对无线频率信道号。
bsicnumber是基站识别号。
mccstring是移动国家码。
mncstring是移动网号。

LteCellInformation8+

LTE小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
cginumber是小区全球标识。
pcinumber是物理小区识别。
tacnumber是跟踪区域代码。
earfcnnumber是绝对无线频率信道号。
bandwidthnumber是带宽。
mccstring是移动国家码。
mncstring是移动网号。
isSupportEndcboolean是是否支持新无线电_双连接

NrCellInformation8+

NR小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
nrArfcnnumber是5G频点号。
pcinumber是物理小区识别。
tacnumber是跟踪区域代码。
ncinumber是5G网络小区标识。
mccstring是移动国家码。
mncstring是移动网号。

TdscdmaCellInformation8+

TD-SCDMA小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
lacnumber是位置区编号。
cellIdnumber是小区号。
cpidnumber是小区参数Id。
uarfcnnumber是绝对射频号。
mccstring是移动国家码。
mncstring是移动网号。

WcdmaCellInformation8+

WCDMA小区信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
lacnumber是位置区编号。
cellIdnumber是小区号。
pscnumber是主扰码。
uarfcnnumber是绝对射频号。
mccstring是移动国家码。
mncstring是移动网号。

NrOptionMode(deprecated)

NR的选择模式。

说明：

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

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
NR_OPTION_UNKNOWN0未知的NR选择模式。
NR_OPTION_NSA_ONLY1仅非独立组网的NR选择模式。
NR_OPTION_SA_ONLY2仅独立组网的NR选择模式。
NR_OPTION_NSA_AND_SA3非独立组网和独立组网的NR选择模式。

NROptionMode10+

NR的选择模式。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
NR_OPTION_UNKNOWN0未知的NR选择模式。
NR_OPTION_NSA_ONLY1仅非独立组网的NR选择模式。
NR_OPTION_SA_ONLY2仅独立组网的NR选择模式。
NR_OPTION_NSA_AND_SA3非独立组网和独立组网的NR选择模式。

NetworkSearchResult

网络搜索结果。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
isNetworkSearchSuccessboolean是网络搜索成功。
networkSearchResultArray<NetworkInformation>是网络搜索结果。

NetworkInformation

网络信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
operatorNamestring是运营商的名称。
operatorNumericstring是运营商数字。
stateNetworkInformationState是网络信息状态。
radioTechstring是无线电技术。

NetworkInformationState

网络信息状态。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
NETWORK_UNKNOWN0网络状态未知。
NETWORK_AVAILABLE1网络可用于注册。
NETWORK_CURRENT2已在网络中注册。
NETWORK_FORBIDDEN3网络无法注册。

NetworkSelectionModeOptions

网络选择模式选项。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1
- 1：卡槽2
selectModeNetworkSelectionMode是网络选择模式。
networkInformationNetworkInformation是网络信息。
resumeSelectionboolean是继续选择。

ImsRegState9+

IMS注册状态。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
IMS_UNREGISTERED0未注册。
IMS_REGISTERED1已注册。

ImsRegTech9+

IMS注册技术。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
REGISTRATION_TECH_NONE0无注册技术。
REGISTRATION_TECH_LTE1LTE注册技术。
REGISTRATION_TECH_IWLAN2IWLAN注册技术。
REGISTRATION_TECH_NR3NR注册技术。

ImsRegInfo9+

IMS注册信息。

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

系统能力：SystemCapability.Telephony.CoreService

名称类型必填说明
imsRegStateImsRegState是IMS注册状态。
imsRegTechImsRegTech是IMS注册技术。

ImsServiceType9+

IMS服务类型。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
TYPE_VOICE0语音服务。
TYPE_VIDEO1视频服务。
TYPE_UT2UT服务。
TYPE_SMS3短讯服务。

NetworkCapabilityType10+

网络能力类型。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
SERVICE_TYPE_LTE0LTE服务类型。
SERVICE_TYPE_NR1NR服务类型。

NetworkCapabilityState10+

网络能力开关状态。

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

系统能力：SystemCapability.Telephony.CoreService

名称值说明
SERVICE_CAPABILITY_OFF0网络能力关闭。
SERVICE_CAPABILITY_ON1网络能力打开。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

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

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

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

harmony 鸿蒙BundleStatusCallback

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

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

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

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

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/946b929eb64a456ab6420e5cdacd74f7