Network Data and Metrics

Methods mentioned in this section call upon the relevant methods on Android's TelephonyManager class.

Check Android Develop Docs for more details on how these methods function.

isSmsCapable

Returns Future<bool>

Checks if the device has necessary features to send and receive SMS.

bool isSmsCapable = await telephony.isSmsCapable;

cellularDataState

Returns Future<DataState>

Returns a constant indicating the current data connection state (cellular).

DataState state = await telephony.cellularDataState;

callState

Returns Future<CallState>

Returns a constant that represents the current state of all phone calls.

CallState state = await telephony.callState;

dataActivity

Returns Future<DataActivity>

Returns a constant indicating the type of activity on a data connection (cellular).

DataActivity activity = await telephony.dataActivity;

networkOperator

Returns Future<String>

Returns the numeric name (MCC+MNC) of current registered operator.

Availability: Only when user is registered to a network.

Result may be unreliable on CDMA networks (use phoneType to determine if on a CDMA network).

String networkOperator = await telephony.networkOperator;

networkOperatorName

Returns Future<String>

Returns the alphabetic name of current registered operator.

Availability: Only when user is registered to a network.

Result may be unreliable on CDMA networks (use phoneType to determine if on a CDMA network).

String operatorName = await telephony.networkOperatorName;

dataNetworkType

Returns Future<NetworkType>

Requires READ_PHONE_STATE permission.

Add the following in your AndroidManifest.xml

<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

Returns a constant indicating the radio technology (network type) currently in use on the device for data transmission.

NetworkType type = await telephony.dataNetworkType;

phoneType

Returns Future<PhoneType>

Returns a constant indicating the device phone type. This indicates the type of radio used to transmit voice calls.

PhoneType type = await telephony.phoneType;

simOperator

Returns Future<String>

Returns the MCC+MNC (mobile country code + mobile network code) of the provider of the SIM. 5 or 6 decimal digits.

Availability: SimState must be SIM_STATE_READY

String simOperator = await telephony.simOperator;

simOperatorName

Returns Future<String>

Returns the Service Provider Name (SPN).

Availability: SimState must be SIM_STATE_READY

String simOperatorName = await telephony.simOperatorName;

simState

Returns Future<SimState>

Returns a constant indicating the state of the default SIM card.

SimState state = await telephony.simState;

isNetworkRoaming

Returns Future<bool>

Returns true if the device is considered roaming on the current network, for GSM purposes.

Availability: Only when user registered to a network.

bool isNetworkRoaming = await telephony.isNetworkRoaming;

signalStrengths

Returns Future<List<SignalStrength>>

Requires Android build version 29 --> Android Q

Returns a List of SignalStrength or an empty List if there are no valid measurements.

List<SignalStrength> strenghts = await telephony.signalStrengths;

serviceState

Returns Future<ServiceState>

Requires Android build version 26 --> Android O

Requires permissions ACCESS_COARSE_LOCATION and READ_PHONE_STATE

Add the following in your AndroidManifest.xml

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

Returns current voice service state.

ServiceState state = await telephony.serviceState;

DataState

Values

DISCONNECTED

CONNECTING

CONNECTED

SUSPENDED

UNKNOWN

CallState

Values

IDLE

RINGING

OFFHOOK

DataActivity

Values

NONE

IN

OUT

INOUT

DORMANT

NetworkType

Values

UNKNOWN

GPRS

EDGE

UMTS

CDMA

EVDO_0

EVDO_A

TYPE_1xRTT

HSDPA

HSUPA

HSPA

IDEN

EVDO_B

LTE

EHRPD

HSPAP

GSM

TD_SCDMA

IWLAN

LTE_CA

NR

PhoneType

Values

NONE

GSM

CDMS

SIP

SimState

Values

UNKNOWN

ABSENT

PIN_REQUIRED

PUK_REQUIRED

NETWORK_LOCKED

READY

NOT_READY

PERM_DISABLED

CARD_IO_ERROR

CARD_RESTRICTED

LOADED

PRESENT

SignalStrength

Values

NONE_OR_UNKNOWN

POOR

MODERATE

GOOD

GREAT

ServiceState

Values

IN_SERVICE

OUT_OF_SERVICE

EMERGENCY_ONLY

POWER_OFF