138 lines
4.3 KiB
Plaintext
138 lines
4.3 KiB
Plaintext
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
interface nsIVoicemailProvider;
|
|
|
|
[scriptable, uuid(6a8b0133-960d-409d-88cd-583239e45f9f)]
|
|
interface nsIVoicemailListener : nsISupports
|
|
{
|
|
/**
|
|
* Called when a voicemail status (hasMessages, messageCount, returnNumber,
|
|
* returnMessage) changed.
|
|
*/
|
|
void notifyStatusChanged(in nsIVoicemailProvider provider);
|
|
|
|
/**
|
|
* Called when a voicemail info (number, displayName) changed.
|
|
*/
|
|
void notifyInfoChanged(in nsIVoicemailProvider provider);
|
|
};
|
|
|
|
%{C++
|
|
#define NS_VOICEMAIL_SERVICE_CID \
|
|
{ 0xcdd8fd72, 0x7d55, 0x496b, \
|
|
{ 0xab, 0x1d, 0x74, 0x9f, 0xbc, 0x44, 0x56, 0x32 } }
|
|
#define NS_VOICEMAIL_SERVICE_CONTRACTID \
|
|
"@mozilla.org/voicemail/voicemailservice;1"
|
|
%}
|
|
|
|
/**
|
|
* XPCOM component (in the content process) that provides the voicemail
|
|
* information.
|
|
*/
|
|
[scriptable, uuid(8ffd16c7-a614-4c4a-81f0-2a95e807152d)]
|
|
interface nsIVoicemailService : nsISupports
|
|
{
|
|
readonly attribute unsigned long numItems;
|
|
|
|
nsIVoicemailProvider getItemByServiceId(in unsigned long serviceId);
|
|
|
|
nsIVoicemailProvider getDefaultItem();
|
|
|
|
/**
|
|
* Called when any one who is interested in receiving unsolicited messages.
|
|
*/
|
|
void registerListener(in nsIVoicemailListener listener);
|
|
void unregisterListener(in nsIVoicemailListener listener);
|
|
};
|
|
|
|
%{C++
|
|
template<typename T> struct already_AddRefed;
|
|
|
|
already_AddRefed<nsIVoicemailService>
|
|
NS_CreateVoicemailService();
|
|
%}
|
|
|
|
[scriptable, uuid(a0bc19a2-3216-4f3f-89d3-8976a48cb829)]
|
|
interface nsIVoicemailProvider : nsISupports
|
|
{
|
|
readonly attribute unsigned long serviceId;
|
|
|
|
/**
|
|
* Voicemail center number. When changed, |notifyInfoChanged| of registered
|
|
* nsIVoicemailListener instances are called.
|
|
*
|
|
* Default: null
|
|
*
|
|
* @see 3GPP TS 31.102 subclause 4.2.63 "EFmwis (Message Waiting Indication Status)"
|
|
* @see 3GPP TS 51.011 subclause 10.3.45 "EFmwis (Message Waiting Indication Status)"
|
|
*/
|
|
readonly attribute DOMString number;
|
|
|
|
/**
|
|
* Voicemail center display name. When changed, |notifyInfoChanged| of
|
|
* registered nsIVoicemailListener instances are called.
|
|
*
|
|
* Default: null
|
|
*
|
|
* @see 3GPP TS 31.102 subclause 4.2.63 "EFmwis (Message Waiting Indication Status)"
|
|
* @see 3GPP TS 51.011 subclause 10.3.45 "EFmwis (Message Waiting Indication Status)"
|
|
*/
|
|
readonly attribute DOMString displayName;
|
|
|
|
/**
|
|
* Whether or not there are messages waiting in the voicemail box. When
|
|
* changed, |notifyStatusChanged| of registered nsIVoicemailListener instances
|
|
* are called.
|
|
*
|
|
* Default: false
|
|
*
|
|
* @see 3GPP TS 23.038 chapter 4 "SMS Data Coding Scheme"
|
|
* @see 3GPP TS 23.040 subclause 9.2.3.24.2 "Special SMS Message Indication"
|
|
*/
|
|
readonly attribute boolean hasMessages;
|
|
|
|
/**
|
|
* When #hasMessages is true, #messageCount should be a positive number for
|
|
* the messages waiting, or -1 if the exact number is not available. When
|
|
* changed, |notifyStatusChanged| of registered nsIVoicemailListener instances
|
|
* are called.
|
|
*
|
|
* Default: 0
|
|
*
|
|
* @see 3GPP TS 23.040 subclause 9.2.3.24.2 "Special SMS Message Indication"
|
|
*/
|
|
readonly attribute long messageCount;
|
|
|
|
/**
|
|
* A Return Call Message indicates to the MS to inform the user that a call
|
|
* (e.g. a telephone call) can be established to the address specified within
|
|
* the #returnNumber. The #returnMessage (if present) gives displayable
|
|
* information (e.g. the number of waiting voice messages).
|
|
*
|
|
* When #hasMessages is true this may contain a non-null string as the phone
|
|
* number of a Return Call Message. When changed, |notifyStatusChanged| of
|
|
* registered nsIVoicemailListener instances are called.
|
|
*
|
|
* Default: null
|
|
*
|
|
* @see 3GPP TS 23.040 subclause 9.2.3.9 "TPProtocolIdentifier (TPPID)"
|
|
*/
|
|
readonly attribute DOMString returnNumber;
|
|
|
|
/**
|
|
* When #hasMessages is true this may contain a non-null string as the
|
|
* notification message of a Return Call Message. When changed,
|
|
* |notifyStatusChanged| of registered nsIVoicemailListener instances are
|
|
* called.
|
|
*
|
|
* Default: null
|
|
*
|
|
* @see 3GPP TS 23.040 subclause 9.2.3.9 "TPProtocolIdentifier (TPPID)"
|
|
*/
|
|
readonly attribute DOMString returnMessage;
|
|
};
|