com.motorola.iden.call
Class GenericCall

java.lang.Object
  com.motorola.iden.call.GenericCall

public class GenericCall

extends java.lang.Object

This class is a place holder for the static method to initiate phone call.

Example using GenericCall

GenericCall.makeCall(String number) is used to make a phone call. and a response code as int is returned.

Return value can be: CALL_RESPONSE_OK if request to make phone call is made. CALL_RESPONSE_FAILURE if request is failed. CALL_RESPONSE_ERROR if error occured during request. CALL_RESPONSE_RF_OFF if Airplane Mode is ON CALL_UNKNOWN_ERROR if unknown error took place while requesting.

   try { 
         int x = GenericCall.makeCall(number);
   }catch(Exception e) {
   }
 

where number can be one of the following Strings. "9547233333" or "(954) 723-3333 or with tag "PHON9547233333" where tag PHON is not case sensetive.

To use Pause dialing use P ( case sensetive ) or , in number. For e.g. "9547233333P4444" or "(954) 723-3333P4444" or PHON9547233333P4444".

Length of phone number excluding tag and including Pause character can not be more then 20 digit. Any # of blank spaces in the number will be ignored.

If number contains any invalid character IllegalArgumentException will be thrown. Or when phone call is in use Exception will be thrown.

User will be prompted and action of pressing send key is required to make the phone call. Application will be suspended while placing call and will be resumed itself after call. Application will also be autometically resumed if user action is not received in 3 second.

Field Summary

static int	CALL_RESPONSE_ERROR Call response error.
static int	CALL_RESPONSE_FAILURE Call failure.
static int	CALL_RESPONSE_OK Call response ok.
static int	CALL_RESPONSE_RF_OFF Call response error.
static int	CALL_UNKNOWN_ERROR Call unknown error

Method Summary

static int

makeCall(java.lang.String number) Allows to make a phone call.

Methods inherited from class java.lang.Object

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

Field Detail

CALL_RESPONSE_OK

public static final int CALL_RESPONSE_OK

Call response ok. Request to make phone call has been made.

See Also:

Constant Field Values

CALL_RESPONSE_FAILURE

public static final int CALL_RESPONSE_FAILURE

Call failure. Feature not available.

See Also:

Constant Field Values

CALL_RESPONSE_ERROR

public static final int CALL_RESPONSE_ERROR

Call response error. When number is incorrect.

See Also:

Constant Field Values

CALL_RESPONSE_RF_OFF

public static final int CALL_RESPONSE_RF_OFF

Call response error. When Airplane Mode is ON.

See Also:

Constant Field Values

CALL_UNKNOWN_ERROR

public static final int CALL_UNKNOWN_ERROR

Call unknown error

See Also:

Constant Field Values

Method Detail

makeCall

public static int makeCall(java.lang.String number)
                    throws java.lang.Exception

Allows to make a phone call.

Parameters:

number - the number to place a call.

Returns:

int CALL_RESPONSE_OK, CALL_RESPONSE_FAILURE, CALL_RESPONSE_ERROR, CALL_UNKNOWN_ERROR

Throws:

java.lang.IllegalArgumentException - if number is null or "" or number contains invalid characters.

java.lang.Exception - if call is in use.