Phone

From Pointui

This is a Global object. You must not create an instance of it as one is always available for your use.

Provides access to the phone functionality on the device. NOTE: this is a global object so an instance is always available to use – you do not need to ever create additional instances.

Methods

void ShowCallLog(String filter)

Displays the native OS call history screen.

PARAMETERS

• filter – must be one of the following String values:
  • “” (default) – no filter is applied
  • “Missed” – only missed calls will be displayed
  • “Incoming” – only incoming calls will be displayed
  • “Outgoing” – only outgoing calls will be displayed

void Call(String number)

void Call(String number, String contactName)

Initiates a phone call on the device. The number is what is dialed, and the contactName if provided is stored in the call history exactly as provided.

EXAMPLE

Phone.Call(“0123 4567 8901”, “Contact Name”);

int GetSignalStrength()

Returns the current signal strength and is a value between 0 and 100.

bool GetIsRadioOff()

Returns true if the phone is off.

bool GetIsRadioPresent()

Returns true if the device has phone capabilities.

bool GetIsRingerOff()

Returns true if the ringer is off.

bool GetIsRoaming()

Returns true if the device is roaming.

bool GetIsActiveDataCall()

Returns true if there is an active data call.

bool GetIsIncomingCall()

Returns true if there is currently an incoming call.

bool GetIsCalling()

Returns true if the device is currently dialing a number.

bool GetIsNoService()

Returns true if there is no phone service available.

bool GetIsSearchingForService()

Returns true if the phone is searching for service.

bool GetIsHomeService()

Returns true if currently utilizing the home service.

bool GetIsTalking()

Returns true if the phone is currently connected to a call.

void SetFlightMode(bool flightModeOn)

Turns flight mode on or off.

bool GetFlightMode()

Returns true if flight mode is enabled.

bool GetIsNoSim()

Returns true if there is no SIM. This may be unreliable on certain devices.

bool GetIsSimBlocked()

Returns true if the SIM is blocked.

bool GetIsInvalidSim()

Returns true if the SIM is invalid.

bool GetSimCardSupported()

AVAILABLE SINCE: 2.0.18b Returns true if the device supports a SIM card.

bool GetLockFacilitySupported()

AVAILABLE SINCE: 2.0.18b Returns true if the device supports displaying a screen for the user to enter a password to unlock the SIM card.

bool GetIsPasswordScreenShowing()

AVAILABLE SINCE: 2.0.18b Returns true if the device is currently requiring the user to enter a password for the SIM card.

void DisplayApp()

AVAILABLE SINCE: 2.0.18b Shows the default OS phone application. Well it does for us :) Hopefully there is some consistency across devices.

void SetRadioStatus(bool on)

AVAILABLE SINCE: 2.1 Switches the phone on or off.