WebAPI/WebSMS/Multi-SIM

Proposal: WebSms/WebMms for multi-SIM

The only difference is a new optional parameter is added for send() and sendMMS(). If API user didn't specify a value, then the default service Id is going to be used.

• nsIDOMMozMobileMessageManager

interface nsIDOMMozMobileMessageManager : nsIDOMEventTarget { nsIDOMDOMRequest getSegmentInfoForText(in DOMString text); 

 /** * Function to send SMS. * * @param number * Either a DOMString (only one number) or an array of numbers. * @param message * The text message to be sent. * @param sendParameters * An SmsSendParameters object. * @param return * A DOMRequest object indicating the sending result if one number * has been passed; an array of DOMRequest objects otherwise. */ [implicit_jscontext, optional_argc] jsval send(in jsval number, in DOMString message, [optional] in jsval sendParameters); /* New parameter for multi-SIM */ 

 /** * Function to send MMS. * * @param parameters * An MmsParameters object. * @param sendParameters * An MmsSendParameters object. * @param return * A DOMRequest object indicating the sending result. */ [implicit_jscontext, optional_argc] nsIDOMDOMRequest sendMMS(in jsval parameters, [optional] in jsval sendParameters); /* New parameter for multi-SIM */ 

 [binaryname(GetMessageMoz)] nsIDOMDOMRequest getMessage(in long id); 

 // The parameter can be either a message id or a nsIDOMMoz{Mms,Sms}Message. nsIDOMDOMRequest delete(in jsval param); 

 // Iterates through nsIDOMMoz{Mms,Sms}Message. nsIDOMDOMCursor getMessages(in nsIDOMMozSmsFilter filter, in boolean reverse); 

 nsIDOMDOMRequest markMessageRead(in long id, in boolean value); 

 // Iterates through nsIDOMMozMobileMessageThread. nsIDOMDOMCursor getThreads(); 

 nsIDOMDOMRequest retrieveMMS(in long id); 

 [implicit_jscontext] attribute jsval onreceived; [implicit_jscontext] attribute jsval onretrieving; [implicit_jscontext] attribute jsval onsending; [implicit_jscontext] attribute jsval onsent; [implicit_jscontext] attribute jsval onfailed; [implicit_jscontext] attribute jsval ondeliverysuccess; [implicit_jscontext] attribute jsval ondeliveryerror; }; 

Regarding nsIDOMMozSmsMessage and nsIDOMMozMmsMessage, a new attribute 'iddId' is added. 'iccId' is a unique id to record which SIM the message is coming from or sent out.

• nsIDOMMozSmsMessage

interface nsIDOMMozSmsMessage : nsISupports { /** * |type| is always "sms". */ readonly attribute DOMString type; 

 readonly attribute long id; 

 readonly attribute unsigned long long threadId; 

 /** * Integrated Circuit Card Identifier. * * Will be null if ICC is not available. */ readonly attribute DOMString iccId; /* New attribute for multi-SIM */ 

 /** * Should be "received", "sending", "sent" or "error". */ readonly attribute DOMString delivery; 

 /** * Possible delivery status values for above delivery states are: * * "received": "success" * "sending" : "pending", or "not-applicable" if the message was sent without * status report requisition. * "sent"  : "pending", "success", "error", or "not-applicable" * if the message was sent without status report requisition. * "error"  : "error" */ readonly attribute DOMString deliveryStatus; 

 readonly attribute DOMString sender; readonly attribute DOMString receiver; readonly attribute DOMString body; 

 /** * Should be "normal", "class-0", "class-1", "class-2" or "class-3". */ readonly attribute DOMString messageClass; 

 [implicit_jscontext] readonly attribute jsval timestamp; // jsval is for Date. readonly attribute boolean read; }; 

• nsIDOMMozMmsMessage

interface nsIDOMMozMmsMessage : nsISupports { /** * |type| is always "mms". */ readonly attribute DOMString type; 

 readonly attribute long id; 

 readonly attribute unsigned long long threadId; 

 /** * Integrated Circuit Card Identifier. * * Will be null if ICC is not available. */ readonly attribute DOMString iccId; /* New attribute for multi-SIM */ 

 /** * Should be "not-downloaded", "received", "sending", "sent" or "error". */ readonly attribute DOMString delivery; 

 [implicit_jscontext] readonly attribute jsval deliveryStatus; // DOMString[] 

 readonly attribute DOMString sender; 

 [implicit_jscontext] readonly attribute jsval receivers; // DOMString[] 

 [implicit_jscontext] readonly attribute jsval timestamp; // Date object 

 readonly attribute boolean read; readonly attribute DOMString subject; readonly attribute DOMString smil; 

 [implicit_jscontext] readonly attribute jsval attachments; // MmsAttachment[] 

 [implicit_jscontext] readonly attribute jsval expiryDate; // Date object // Expiry date for an MMS to be // manually downloaded. };