API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ITAPI

Brew Release
Brew MP 1.0.2
See Also
AEEEvent Events ISHELL_CreateInstance ITAPI_SendSMS NMASK_TAPI_STATUS NMASK_TAPI_WAP_PUSH STRTOUL
Description
ITAPI is a deprecated interface. Refer to the ITelephone, ICallMgr, and ISMS interfaces instead.
ITAPI is a simple interface to the telephony layer in the device. It provides the following services:
- Retrieving telephony status.

- Placing voice calls.

- Extracting SMS text from SMS messages.

- Obtaining caller ID on incoming/in-progress calls.

- Registering for SMS messages.

- Sending SMS messages.

The ITAPI interface is obtained via the ISHELL_CreateInstance() mechanism.

Notifications sent by this class:


The AEECLSID_TAPI class allows applications to register for the following Notifications:

Receiving SMS messages:


A Brew applet can receive: - Brew-directed SMS Messages targeted to that applet. They are sent as:

//BREW::.
Where is used to determine the class ID of the destination applet using STRTOUL(), and thus is subject to the success or failure of STRTOUL() in determination of the destination class ID.

ITAPI_SendSMS() internally formats messages to this type when the destination Brew applet class ID is specified
- All text messages
- All messages of specific TeleServiceID
- All text messages that have a specific prefix

Receiving an applet-directed message:


No registration is required for receiving an applet-directed message. An applet-directed message is received as EVT_APP_MESSAGE event. dwParam contains pointer to the message payload which can be accessed as...
 char * pszMsgTxt = (char *)dwParam;

Receiving any text message:


An applet must register with the AEECLSID_TAPI class using the NMASK_TAPI_SMS_TEXT mask. Text messages are received as EVT_NOTIFY event where dwParam contains a pointer to AEENotify. Messages can be accessed as...
 AEENotify * pNotify = (AEENotify*)dwParam;
 AEESMSTextMsg * pTextMsg = (AEESMSTextMsg*)pNotify->pData;

Receiving a TeleService-specific message:


An applet must register with the AEECLSID_TAPI class using the following as a mask...
 uint32 mask = (NMASK_TAPI_SMS_TS |(SMS_TELESERVICE_ID << 16));

Messages are received as EVT_NOTIFY event where dwParam contains a pointer to AEENotify. A message can be accessed as...
 AEENotify * pNotify = (AEENotify*)dwParam;
 AEESMSMsg *pMsg = (AEESMSMsg *)pNotify->pData;

Receiving text messages with a specific prefix:


The message format is //:. An applet must register as a handler for . Messages are aeceived as EVT_APP_BROWSE_URL. dwParam contains pointer to //:.

Registering for device status change:


Applications can use the AEECLSID_TAPI class to be notified whenever there is a change in the telephony status of the device. To register for this notification, applications must use the mask NMASK_TAPI_STATUS.
Whenever there is a status-change, applications receive the EVT_NOTIFY event. The dwParam of this event is of type AEENotify.
The pData member inside this AEENotify structure is of type TAPIStatus and contains detailed information about the current telephony status of the device.

Receiving WAP push messages:


An applet must register with AEECLSID_TAPI class using NMASK_TAPI_WAP_PUSH mask. A message is received as EVT_NOTIFY event where dwParam contains pointer to AEENotify. A message can be accessed as...
      AEENotify * pNotify = (AEENotify*)dwParam;
      AEESMSTextMsg * pTextMsg = (AEESMSTextMsg*)pNotify->pData;


List of Header files to be included: AEETapi.h