mobicontrol.cellular

This namespace provides access to the cellular functionality.
Since:
  • Version 1.1 (API level 2)

Classes

Subscription

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 is false.
This property is null 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 is null 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 or null 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));