![]() Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference |
![]() |
VoIP is a Qtopia application integrated with the Qtopia server. The key features are:
An overview of the VoIP Framework Architecture is provided in the following diagram:
The handler interface communicates with vendor SIP stacks via the vendor wrapper software. For integration information refer to VoIP Integration.
Qtopia VoIP is integrated with the following applications:
Call History is a Qtopia module providing the history of all calls received, missed and dialled. VoIP call details are displayed and calls can be initiated from the Call History screen.
Qtopia provides a basic settings application for VoIP. However, integration of a settings application and design of the settings GUI is largely the responsibility of the vendor. The following describes commonly supported functionality:
The screen displays comprising the settings application are described in the following table:
Display Name | Description |
---|---|
Display | Displays the:
|
Identity | Allows the user to set
|
SIP Settings | Allows the user to set:
|
Socket | Allows the user to set socket parameters for SIP protocol including:
|
Audio Preferences | Allows the user to specify OSS Device mode
|
Quick Dial component is a Qtopia module that provides a dialing facility from the Home screen and is integrated with the Qtopia phone edition. VoIP identifiers are taken as input Call History matches are presented and the VoIP call is initiated.
The Contacts application stores, edits, and displays the VoIP identifier and status of a contact. It interacts with the VoIP framework for:
The Contact application receives updates from VoIP server regarding VoIP user status (online/offline) and is responsible for keeping it up-to-date in its database.
In a standard telephony application, the phone manager/dial control components interact on the behalf of Call History, Quick Dialer and Contact dialing applications with the phone server using Phone line and Phone call objects.
The Qtopia VoIP application uses these components to support VoIP Line and VoIP Call objects. When a VoIP service is registered, the user is prompted to check if the dialled call needs to be made on VoIP or
VoIP Line and Call APIs provide line and call management functionality on the VoIP line as described in the following tables:
Name | Description |
---|---|
acceptCall | Configures the user-profile in the stack. |
closeCall | Closes the call |
feedTone | Feeds the tone to the specified call. |
hangupCall | Saves the user-profile. |
makeCall | Retrieves the saved user-profile. |
notification | Call-back to communicate notifications. |
statusUpdate | Call-back to communicate call status. |
VoIP Query APIs provide functionality to retrieve information based on a database query.
Name | Description |
---|---|
query | Retrieves the information queried based on query type. |
VoIP configuration APIs are used by the setting application to configure:
Name | Description |
---|---|
commandStatus | Call-back indicating the status of initStack/deInitStack operation. |
deInitStack | De-initializes the VoIP stack. |
getStackdetails | Details the VoIP stack information. |
initStack | Initializes the VoIP stack. |
Name | Description |
---|---|
addContact | Configures the SIP stack to function with an added contact. |
configureUserProfile | Configures the user-profile in the stack. |
deleteContact | Deletes a specified contact from the SIP stack. |
getUserProfile | Retrieves the saved user-profile. |
setUserProfile | Saves the user-profile. |
statusUpdate | Callback to communicate the contact status as updated from the presence server. |
Name | Description |
---|---|
register | Registers the client with the SIP server. |
logout | Logs out the client from SIP server. |
commandStatus | Call-back indicating the status of register/logout operation. |
Name | Description |
---|---|
getSipPreferences | Retrieves the saved SIP preferences. |
setSipPreferences | Saves the specified SIP preferences. |
getAudioPreferences | Retrieves the audio preferences. |
setAudioPreferences | Saves the specified audio preferences. |
After adding VoIP functionality, the outgoing call control flow of a phone application will be as shown below:
Copyright © 2005 Trolltech | Trademarks | Qtopia version 2.2.0
|