This namespace provides access to the cellular functionality.
- Since:
- Version 1.1 (API level 2)
Classes
Members
-
static, readonly, nullable carrier :string
-
Cellular carrier name. This property is
null
if the device has no SIM or if the carrier cannot be determined.- Since:
- Version 1.1 (API level 2)
Example
var carrierName = mobicontrol.cellular.carrier; if (carrierName != null) { mobicontrol.log.info("The device is connected to " + carrierName + " network"); }
-
static, readonly, nullable imei :string
-
International Mobile Equipment Identity (IMEI). This property is an empty string if the device has no IMEI or
null
if it cannot be determined whether it has an IMEI.- Since:
- Version 1.2 (API level 3)
Example
mobicontrol.log.info('The device\'s IMEI is ' + mobicontrol.cellular.imei);
-
static, readonly, nullable isRoaming :boolean
-
Roaming status of cellular network. If the device is considered roaming on the current network, the status is
true
, otherwise it isfalse
.
This property isnull
if the roaming status cannot be determined.- Since:
- Version 1.1 (API level 2)
Example
if (mobicontrol.cellular.isRoaming) { mobicontrol.log.info("The device is on roaming network"); }
-
static, readonly, nullable meid :string
-
Mobile Equipment Identifier (MEID). This property is an empty string if the device has no MEID or
null
if it cannot be determined whether it has an MEID.- Since:
- Version 1.2 (API level 3)
Example
mobicontrol.log.info('The device\'s MEID is ' + mobicontrol.cellular.meid);
-
static, readonly, nullable phoneNumber :string
-
Phone number. This property is
null
if the device has no SIM or if the phone number cannot be determined.- Since:
- Version 1.1 (API level 2)
Example
mobicontrol.log.info('The device\'s phone number is ' + mobicontrol.cellular.phoneNumber);
-
static, readonly, nullable signalStrength :number
-
Cellular signal strength, from 0 to 1. This property is
null
if the device has no SIM or if the signal strength cannot be determined.- Since:
- Version 1.1 (API level 2)
Example
mobicontrol.log.info('The strength of the signal is ' + mobicontrol.cellular.signalStrength);
-
static, readonly, nullable signalStrengthInAsu :number
-
Cellular signal strength in Arbitrary Strength Units. This property is
null
if the device has no SIM or if the signal strength cannot be determined.- Since:
- Version 1.1 (API level 2)
Example
mobicontrol.log.info('The strength of the signal is ' + mobicontrol.cellular.signalStrengthInAsu);
-
static, readonly, nullable simSerialNumber :string
-
SIM serial number. This property is
null
if the device has no SIM or if the SIM serial number cannot be determined.- Since:
- Version 1.1 (API level 2)
Example
var simSerialNumber = mobicontrol.cellular.simSerialNumber; if (simSerialNumber != null) { mobicontrol.log.info("The sim serial number is " + simSerialNumber); }
-
static, readonly, nullable subscriberId :string
-
Subscriber ID. A unique subscriber ID; for example, the IMSI for a GSM phone.
This property isnull
if the device has no SIM or if the subscriber ID cannot be determined.- Since:
- Version 1.1 (API level 2)
Example
var subscriberId = mobicontrol.cellular.subscriberId; if (subscriberId != null) { mobicontrol.log.info("The subscriberId is " + subscriberId); }
-
static, readonly, nullable subscriptions :Array.<mobicontrol.cellular.Subscription>
-
Active subscriptions. List of active subscriptions or
null
if it cannot be obtained.- Since:
- Version 1.5 (API level 6)
Example
var subscriptions = mobicontrol.cellular.subscriptions; var subscriptionsString = subscriptions .map(subscription => "ICCID of subscription in slot " + subscription.slotIndex +" is " + subscription.simSerialNumber) .join('|'); mobicontrol.log.info(subscriptionsString);
Methods
-
static getImei(slotIndex) → {string}
-
Get International Mobile Equipment Identity (IMEI) for a SIM slot.
Parameters:
Name Type Description slotIndex
number SIM slot index. Returns:
string - IMEI of the specific SIM slot or an empty string if the slot has no IMEI ornull
if it cannot be determined whether the slot has an IMEI.- Since:
- Version 1.5 (API level 6)
Example
mobicontrol.log.info('The IMEI of the second sim slot is ' + mobicontrol.cellular.getImei(1));