Phone

Request all of the current active calls

Active calls are tracked when the application is running. When launched, only the current active call might be retrieved.

Returns an array of current active calls

<script type="text/javascript">
  // Retrieve an array of active calls and display the details of the call at index specified
  var res = blackberry.phone.Phone.activeCalls();
  if (res == null || res.length == 0) {
    alert("There are no active calls");
  }
  else {
    alert("There are " + res.length + " active calls");
    var index = 0;
    displayCallDetails(res[index]);
  }

  function displayCallDetails(call) {
    alert(("Is OnHold: " + call.isOnHold() + "\n") +
    ("Is Outgoing: " + call.outgoing + "\n") +
    ("Recipient name: " + call.recipientName + "\n") +
    ("Recipient number: " + call.recipientNumber + "\n"));
  }
</script>

Registers PhoneListener of different type events

To subscribe to PhoneListener, a callback and an eventType (one of enumerated PhoneListener event types) should be specified.

When subscribing a different callback with the same eventType, the new callback will overwrite the previous one. To unsubscribe from a phone call event, pass null as a callback parameter, along with proper eventType.

To unsubscribe from ALL events, pass null. All invoked callback functions will receive a 'callid' of type 'int' as a parameter, which is the ID of the Call. A callback registered with eventType 'CB_CALL_FAILED', in addition to the 'callid' parameter, will get code as a second parameter describing the reason for the failure. It would be equal to one of CALL_ERROR_* constants.

Returns true if the listener was successfully assigned

<script type="text/javascript">
  // Adding three listeners differ by their type.
  addListenerByType(callEndedByUserCB, blackberry.phone.Phone.CB_CALL_ENDED_BYUSER);
  addListenerByType(callDisconnectedCB, blackberry.phone.Phone.CB_CALL_DISCONNECTED);
  addListenerByType(callConnectedCB, blackberry.phone.Phone.CB_CALL_CONNECTED);

  // Removing one of the previously added listeners
  addListenerByType(null, blackberry.phone.Phone.CB_CALL_CONNECTED);

  function addListenerByType(callback, type) {
    var res = blackberry.phone.Phone.addPhoneListener(callback, type);
    if (callback != null) {
      alert("Registered for phone listener type " + type + " : " + res);
    }
    else {
      alert("Unregistered from phone listener type " + type + " : " + res);
    }
  }

  function callEndedByUserCB(id) {
    alert("Call ended by user!");
  }

  function callDisconnectedCB(id) {
    alert("The id of diconnected call is: " + id);
  }

  function callConnectedCB(id) {
    alert("Call is connected!");
  }
</script>

Determines whether or not the phone is currently in an active call

Returns true if the phone is currently in an active call

<script type="text/javascript">
  // Check if in active call
  var res = blackberry.phone.Phone.inActiveCall();
  alert("Currently in active call? " + res);
</script>

Invoked when a call has been initiated by the device (outbound).

Invoked when a call is waiting.

Invoked when a new call is arriving.

Invoked when the user answers a call (user driven).

Invoked when the network indicates a connected event (network driven).

Invoked when a conference call has been established.

Invoked when a conference call is terminated (all members disconnected).

Invoked when a call is disconnected.

Invoked when a direct-connect call is connected.

Invoked when a direct-connect call is disconnected.

Invoked when the user ends the call.

Invoked when a call fails.

Invoked when a call goes from 'held' to 'resumed' state.

Invoked when a call goes into the 'held' state.

Invoked when a call gets added to a conference call

Invoked when a call gets removed from a conference call.

Subscriber busy.

Congestion.

Radio path unavailable.

Number unobtainable.

Authorization failure.

Emergency calls only.

Hold error.

Outgoing call barred.

General call error.

Maintenance required.

Service not available.

Call failed because of signal fading.

Call lost because of signal fading.

Call failed, please try again.

Fixed dialing number mismatch.

Connection denied by network.

Number not in service (IDEN specific).

Please try call later (IDEN specific).

Service conflict TI (IDEN specific).

System busy, try later (IDEN specific).

User busy in private (IDEN specific).

User busy in data (IDEN specific).

User not authorized (IDEN specific).

User not available (IDEN specific).

User unknown (IDEN specific).

User not reachable (IDEN specific).

Incoming call barred.

Call replaced by STK (GSM SIM specific).

Call blocked by STK error (GSM SIM specific).