Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QModemCall Class Reference
[QtCellModule]

The QModemCall class implements phone call functionality for AT-based modems. More...

    #include <QModemCall>

Inherits QPhoneCallImpl.

Inherited by QModemDataCall.

• List of all members, including inherited members

Public Functions

• QModemCall ( QModemCallProvider * provider, const QString & identifier, const QString & callType )
• ~QModemCall ()
• uint modemIdentifier () const
• QModemCallProvider * provider () const
• void setConnected ()
• void setModemIdentifier ( uint id )

• 22 public functions inherited from QPhoneCallImpl
• 29 public functions inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 4 signals inherited from QPhoneCallImpl
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QModemCall class implements phone call functionality for AT-based modems.

QModemCall inherits from QPhoneCallImpl to provide the back end server infrastructure for QPhoneCall.

Client applications should use QPhoneCall and QPhoneCallManager to make and receive phone calls. The QModemCall class is intended for the server-side modem telephony service.

QModemCall instances are created by the QModemCallProvider::create() function. If a modem vendor plug-in needs to change some of the functionality in this class, they should do the following:

• Inherit from QModemCall and override the functionality that is different.
• Inherit from QModemCallProvider and override QModemCallProvider::create() to instantiate the new class that inherits from QModemCall.

The following example demonstrates overriding the hold() method to use a proprietary modem command instead of the standard AT+CHLD=2:

    class MyModemCall : public QModemCall
    {
        Q_OBJECT
    public:
        MyModemCall( QModemCallProvider *provider,
                     const QString& identifier,
                     const QString& callType )
            : QModemCall( provider, identifier, callType ) {}

        void hold();
    }

    void MyModemCall::hold()
    {
        if ( state() == QPhoneCall::Connected ) {
            provider()->atchat()->chat( "AT*XHLD=2" );
            setActions( QPhoneCallImpl::ActivateCall );
            setState( QPhoneCall::Hold );
        }
    }

For voice calls, there is an alternative way to modify the AT commands that correspond to voice call operations. Methods in QModemCallProvider() such as QModemCallProvider::dialVoiceCommand(), QModemCallProvider::putOnHoldCommand(), etc. can be overridden to change just the AT command without modifying the rest of the logic in QModemCall. This will usually be an easier way to modify the AT commands than inheriting from QModemCall.

See also QPhoneCallImpl, QPhoneCall, QModemDataCall, and QModemCallProvider.

Member Function Documentation

QModemCall::QModemCall ( QModemCallProvider * provider, const QString & identifier, const QString & callType )

Constructs a new modem call that is attached to provider and is associated with a globally-unique identifier. The callType specifies the type of call (Voice, Data, Fax, etc).

This constructor is called from QModemCallProvider::create() or from a subclass implementation that overrides QModemCallProvider::create().

QModemCall::~QModemCall ()

Destroys this modem call object.

uint QModemCall::modemIdentifier () const

Returns the modem identifier associated with this call. Modem identifiers are used with commands like AT+CHLD to identify specific calls. Returns zero if the modem identifier has not been assigned yet.

See also setModemIdentifier() and QPhoneCall::modemIdentifier().

QModemCallProvider * QModemCall::provider () const

Returns the QModemCallProvider instance associated with this call object.

void QModemCall::setConnected ()

Called by modem vendor plug-ins to indicate that a call has transitioned from Dialing or Alerting to Connected.

The QModemCall class adjusts the call's state() and actions() appropriately and emits the relevant signals. The state() and actions() on other calls may also be affected, indicating new actions that can be taken now that there are several calls in the system.

See also state() and actions().

void QModemCall::setModemIdentifier ( uint id )

Sets the modem identifier associated with this call to id. The QModemCallProvider::nextModemIdentifier() function can be used to assign the next call identifier in rotation.

See also modemIdentifier() and QPhoneCall::modemIdentifier().