Changes

TelephonyCall dial(DOMString number); // Returns a object in "dialing" state attribute boolean muted; // Should these live on the call/group? attribute boolean speakerEnabled;

attribute any active; // Active call, for now. Could be a group in the future.

readonly attribute TelephonyCall[] calls;

void startTone(DOMString tone); void stopTone();

attribute Function onincoming; attribute Function oncallschanged;

readonly attribute DOMString number;

readonly attribute DOMString state; // "dialing", "ringing", "busy", "connecting", "connected", "disconnecting", "disconnected", "incoming"

attribute Function onstatechange; attribute Function onringing; attribute Function onbusy; attribute Function onconnecting; attribute Function onconnected; attribute Function ondisconnecting; attribute Function ondisconnected;

void answer(); // Should this make the call the active one? void hangUp();

readonly attribute TelephonyCall call;

*Scenario #2: There is already a call on-line<br>When the third party dials, a new call is generated with the state of CALL_STATE_INCOMING. Since there is already a call on-line, the new call's index is no. 2. <br>When user answers the new call (call no. 2), its state is going to be transferred to CALL_STATE_CONNECTED. In the meanwhile, the state of the originally connected call (call no. 1) should be forced to CALL_STATE_HELD. <br>

&nbsp;[[Image:Proposal_TelephonyCallStates_v2Proposal TelephonyCallStates v2.png|842x936px|Proposal of telephony call states to support call holding]]<br>

interface nsIDOMTelephony&nbsp;: nsIDOMEventTarget

nsIDOMTelephonyCall dial(in DOMString number);

attribute boolean muted; attribute boolean speakerEnabled;

// The call that is "active", i.e. receives microphone input and tones // generated via startTone. readonly attribute jsval active;

// Array of all calls that are currently connected. readonly attribute jsval calls;

void startTone(in DOMString tone); void stopTone();

attribute nsIDOMEventListener onincoming; attribute nsIDOMEventListener oncallschanged;

readonly attribute DOMString number; // "dialing", "ringing", "busy", "connecting", "connected", "disconnecting", "disconnected", "incoming" // Add new states: "holding", "held", "resuming" readonly attribute DOMString state;

void answer(); void hangUp(); //make a "dialing", "ringing", "busy", "connecting", "connected" call into , "disconnecting", "disconnected", "heldincoming" void holdCall(); //make a Add new states: "holding", "held" call back to , "connectedresuming" void resumeCall() readonly attribute DOMString state;

attribute nsIDOMEventListener onstatechange void answer(); void hangUp();

attribute nsIDOMEventListener ondialing; attribute nsIDOMEventListener onringing; attribute nsIDOMEventListener onbusy; attribute nsIDOMEventListener onconnecting; //make a "connected" call into "held" attribute nsIDOMEventListener onconnected void holdCall(); attribute nsIDOMEventListener ondisconnecting; //make a "held" call back to "connected" attribute nsIDOMEventListener ondisconnected void resumeCall();

attribute nsIDOMEventListener onstatechange; attribute nsIDOMEventListener ondialing; attribute nsIDOMEventListener onringing; attribute nsIDOMEventListener onbusy; attribute nsIDOMEventListener onconnecting; attribute nsIDOMEventListener onconnected; attribute nsIDOMEventListener ondisconnecting; attribute nsIDOMEventListener ondisconnected; // attribute nsIDOMEventListener onincoming; /* new events */ attribute nsIDOMEventListener onholding; attribute nsIDOMEventListener onheld; attribute nsIDOMEventListener onresuming;