程序包 ohos.telephony

类 RadioInfoManager

java.lang.Object

ohos.telephony.RadioInfoManager

public class RadioInfoManager
extends Object

Provides interfaces for applications to obtain the network state, cell information, signal information, and device ID of the wireless cellular network (WCN), and provides a callback registration mechanism to listen for changes of the network, cell, and signal status of the WCN.

This class is a singleton class. Applications can use the getInstance method to obtain an instance and then use the instance to invoke the method for obtaining WCN information and registering a listener.

从以下版本开始:

1

方法概要

限定符和类型	方法	说明
void	addObserver(RadioStateObserver observer, int mask)	Registers an observer to receive notifications of changes in a specified radio state.
int	getCsRadioTech(int slotId)	Obtains RAT of the CS domain on the registered network.
String	getImei(int slotId)	Obtains the IMEI of a specified card slot of the device.
String	getImeiSv(int slotId)	Obtains the international mobile station equipment identity and software version (IMEISV) of a specified card slot of the device.
static RadioInfoManager	getInstance(Context context)	Obtains an instance of RadioInfoManager.
String	getIsoCountryCodeForNetwork(int slotId)	Obtains the ISO-defined country code of the country where the registered network is deployed.
String	getManufacturerCode(int slotId)	Obtains the manufacturer code of a specified card slot of the device.
String	getMeid(int slotId)	Obtains the MEID of a specified card slot of the device.
int	getNetworkSelectionMode(int slotId)	Obtains the network search mode of the SIM card in a specified slot.
NetworkState	getNetworkState(int slotId)	Obtains the network state of the registered network.
String	getOperatorName(int slotId)	Obtains the operator name of the registered network.
String	getPesn(int slotId)	Obtains the pseudo-Electronic Serial Number (PESN) of the device based on a specified slot ID.
String	getPlmnNumeric(int slotId)	Obtains the public land mobile network (PLMN) code of the registered network.
int	getPrimarySlotId()	Obtains the index number of the card slot where the primary card is located if multiple SIM cards are inserted.
int	getPsRadioTech(int slotId)	Obtains RAT of the PS domain on the registered network.
int	getRadioTech(int slotId)	Obtains radio access technology (RAT) of the registered network.
String	getRadioTechName(int radioTech)	Obtains the radio access technology (RAT) name of the registered network.
List<SignalInformation>	getSignalInfoList(int slotId)	Obtains the list of signal strength information of the registered network corresponding to a specified SIM card.
String	getTypeAllocationCode(int slotId)	Obtains the type allocation code (TAC) of a specified card slot of the device.
String	getUniqueDeviceId(int slotId)	Obtains the unique device ID of a specified card slot of the device.
boolean	isNrSupported()	Checks whether the device supports 5G New Radio (NR).
boolean	isNsaState()	Checks whether the device is registered with a 5G non-standalone (NSA) network.
boolean	isRoaming(int slotId)	Checks whether the device is registered with a roaming network.
void	removeObserver(RadioStateObserver observer)	Unregisters an observer.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

getInstance

public static RadioInfoManager getInstance(Context context)

Obtains an instance of RadioInfoManager.

参数:

context - Indicates the context of the application.

返回:

Returns the instance of RadioInfoManager.

从以下版本开始:

1

getRadioTech

public int getRadioTech(int slotId)

Obtains radio access technology (RAT) of the registered network. The system preferentially returns RAT of the packet service (PS) domain. If the device has not registered with the PS domain, the system returns RAT of the circuit service (CS) domain.

Requires Permission: ohos.permission.GET_NETWORK_INFO.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns an integer indicating the RAT in use. The values are as follows:

• TelephonyConstants#RADIO_TECHNOLOGY_UNKNOWN
• TelephonyConstants#RADIO_TECHNOLOGY_GSM
• TelephonyConstants#RADIO_TECHNOLOGY_1XRTT
• TelephonyConstants#RADIO_TECHNOLOGY_WCDMA
• TelephonyConstants#RADIO_TECHNOLOGY_HSPA
• TelephonyConstants#RADIO_TECHNOLOGY_HSPAP
• TelephonyConstants#RADIO_TECHNOLOGY_TD_SCDMA
• TelephonyConstants#RADIO_TECHNOLOGY_EVDO
• TelephonyConstants#RADIO_TECHNOLOGY_EHRPD
• TelephonyConstants#RADIO_TECHNOLOGY_LTE
• TelephonyConstants#RADIO_TECHNOLOGY_LTE_CA
• TelephonyConstants#RADIO_TECHNOLOGY_IWLAN
• TelephonyConstants#RADIO_TECHNOLOGY_NR

从以下版本开始:

1

getPsRadioTech

public int getPsRadioTech(int slotId)

Obtains RAT of the PS domain on the registered network.

Requires Permission: ohos.permission.GET_NETWORK_INFO.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns an integer indicating the RAT in use. For details on the meaning of each value, see getRadioTech(int).

从以下版本开始:

1

getCsRadioTech

public int getCsRadioTech(int slotId)

Obtains RAT of the CS domain on the registered network.

Requires Permission: ohos.permission.GET_NETWORK_INFO.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns an integer indicating the RAT in use. For details on the meaning of each value, see getRadioTech(int).

从以下版本开始:

1

getIsoCountryCodeForNetwork

public String getIsoCountryCodeForNetwork(int slotId)

Obtains the ISO-defined country code of the country where the registered network is deployed.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the country code defined in ISO 3166-2; returns an empty string if the device is not registered with any network.

从以下版本开始:

1

getNetworkState

public NetworkState getNetworkState(int slotId)

Obtains the network state of the registered network.

Requires Permission: ohos.permission.GET_NETWORK_INFO.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns a NetworkState object.

从以下版本开始:

1

getPlmnNumeric

public String getPlmnNumeric(int slotId)

Obtains the public land mobile network (PLMN) code of the registered network.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the PLMN code; returns an empty string if the device is not registered with any network.

从以下版本开始:

1

getOperatorName

public String getOperatorName(int slotId)

Obtains the operator name of the registered network.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the operator name; returns an empty string if the device is not registered with any network.

从以下版本开始:

1

isRoaming

public boolean isRoaming(int slotId)

Checks whether the device is registered with a roaming network.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns true if the device is registered with a roaming network; returns false otherwise.

从以下版本开始:

1

getSignalInfoList

public List<SignalInformation> getSignalInfoList(int slotId)

Obtains the list of signal strength information of the registered network corresponding to a specified SIM card.

If the specified SIM card camps on one or more networks, the signal strength of these networks is reported, as listed below:

• GsmSignalInformation
• CdmaSignalInformation
• TdscdmaSignalInformation
• LteSignalInformation
• WcdmaSignalInformation
• NrSignalInformation

For example, if the device camps on both the CDMA and LTE networks, CdmaSignalInformation and LteSignalInformation instances are returned. If an empty list is returned, there is no signal.

A device can use SignalInformation#getNetworkType() to obtain RAT of the signal instance and then use the corresponding child class to obtain detailed signal information.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the instance list of the child classes derived from SignalInformation.

从以下版本开始:

1

getUniqueDeviceId

public String getUniqueDeviceId(int slotId)

Obtains the unique device ID of a specified card slot of the device.

If the device is registered with a 3GPP-compliant network, the international mobile equipment identity (IMEI) is returned. If the device is registered with a 3GPP2-compliant network, the mobile equipment identifier (MEID) is returned.

Requires Permission: ohos.permission.GET_TELEPHONY_STATE.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the unique device ID; returns an empty string if the unique device ID does not exist.

从以下版本开始:

1

getImei

public String getImei(int slotId)

Obtains the IMEI of a specified card slot of the device.

Requires Permission: ohos.permission.GET_TELEPHONY_STATE.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the IMEI; returns an empty string if the IMEI does not exist.

从以下版本开始:

1

getImeiSv

public String getImeiSv(int slotId)

Obtains the international mobile station equipment identity and software version (IMEISV) of a specified card slot of the device.

Requires Permission: ohos.permission.GET_TELEPHONY_STATE.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the IMEISV; returns an empty string if the IMEISV does not exist.

从以下版本开始:

1

getTypeAllocationCode

public String getTypeAllocationCode(int slotId)

Obtains the type allocation code (TAC) of a specified card slot of the device.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the TAC; returns an empty string if the TAC does not exist.

从以下版本开始:

1

getMeid

public String getMeid(int slotId)

Obtains the MEID of a specified card slot of the device.

Requires Permission: ohos.permission.GET_TELEPHONY_STATE.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the MEID; returns an empty string if the MEID does not exist.

从以下版本开始:

1

getManufacturerCode

public String getManufacturerCode(int slotId)

Obtains the manufacturer code of a specified card slot of the device.

参数:

slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.

返回:

Returns the manufacturer code; returns an empty string if the manufacturer code does not exist.

从以下版本开始:

1

getPrimarySlotId

public int getPrimarySlotId()

Obtains the index number of the card slot where the primary card is located if multiple SIM cards are inserted.

The primary card is the SIM card inserted in the card slot that uses data services by default.

返回:

Returns the index number of the primary card slot.

从以下版本开始:

4

isNrSupported

public boolean isNrSupported()

Checks whether the device supports 5G New Radio (NR).

返回:

Returns true if the device supports 5G NR; returns false otherwise.

从以下版本开始:

1

isNsaState

public boolean isNsaState()

Checks whether the device is registered with a 5G non-standalone (NSA) network.

Requires Permission: ohos.permission.GET_NETWORK_INFO.

返回:

Returns true if the device is registered with a 5G NSA network; returns false otherwise.

从以下版本开始:

1

addObserver

public void addObserver(RadioStateObserver observer,
                        int mask)

Registers an observer to receive notifications of changes in a specified radio state.

To register an observer, pass a RadioStateObserver and an observer mask of the concerned state. When the specified state changes, the callback method in RadioStateObserver is invoked. It is also invoked upon the first registration of the observer.

NOTE: The slot ID that you want to observe is declared in RadioStateObserver.

Requires Permission: OBSERVE_MASK_SERVICE_STATE needs ohos.permission.GET_NETWORK_INFO and OBSERVE_MASK_CELL_INFO needs ohos.permission.LOCATION.

参数:

observer - Indicates the RadioStateObserver to register.

mask - Indicates the mask of the concerned state, as specified in RadioStateObserver.

抛出:

SecurityException - Throws this exception if the caller does not have the permission.

从以下版本开始:

1

removeObserver

public void removeObserver(RadioStateObserver observer)

Unregisters an observer.

To unregister an observer, pass the same RadioStateObserver as in RadioInfoManager#addObserver.

参数:

observer - Indicates the RadioStateObserver to unregister.

从以下版本开始:

1

getRadioTechName

public String getRadioTechName(int radioTech)

Obtains the radio access technology (RAT) name of the registered network.

参数:

radioTech - Indicates the RAT of the registered network.

返回:

Returns the RAT name; returns UNKNOWN if the name is not found.

从以下版本开始:

3

getNetworkSelectionMode

public int getNetworkSelectionMode(int slotId)

Obtains the network search mode of the SIM card in a specified slot.

参数:

slotId - Indicates the ID of the SIM card slot.

返回:

Returns the network search mode of the SIM card. Available values are as follows:

• TelephonyConstants#NETWORK_SELECTION_UNKNOWN
• TelephonyConstants#NETWORK_SELECTION_AUTOMATIC
• TelephonyConstants#NETWORK_SELECTION_MANUAL

从以下版本开始:

4

getPesn

public String getPesn(int slotId)

Obtains the pseudo-Electronic Serial Number (PESN) of the device based on a specified slot ID.

Permissions: SystemPermission.GET_TELEPHONY_STATE

参数:

slotId - Indicates the ID of the specified slot.

返回:

Returns a PESN if obtained; returns an empty string otherwise.

从以下版本开始:

5