Developers guide

Chapter 22: Wireless Wide-Area Networking
Voice Over WWAN API Elements
230 Psion Teklogix Mobile Devices SDK Developers Guide
22.12.14.2 Voice Call Manager Incoming Call Event
A voice call manager incoming call event is generated when a new voice call is received. Events
are processed in the order that they are received. The application does not receive the next event
until the handler returns from the previous one. For this reason, it is recommended that there is a
lightweight handler that returns quickly.
22.12.15 Voice Over WWAN API Elements
C++: The phone book on all Psion Teklogix computers is controlled using the VoiceCall class and
the VoiceCallManager class in the PsionTeklogix::WWAN namespace.
Java: Not available.
.NET: WWAN on all Psion Teklogix computers is controlled using the VoiceCall class and the
VoiceCallManager class in the PsionTeklogix.WWAN namespace.
22.13 Phone Books
The Mobile Devices SDK allows an application to access and manipulate the phone books built
into a SIM card or WWAN modem.
Each phone book entry consists of one name and one phone number. The maximum number of
bytes for a name and for a phone number is determined by the network provider. The number of
characters that can be stored depends on the alphabet used for the entry. 16-bit alphabets allow
fewer characters to be stored in the available space than do 7-bit, and 8-bit alphabets. A name
entry that is too long for the allocated space is automatically truncated. The number can only
contain the following characters: 0 (zero) to 9, *, #, and +. Hyphens and brackets are automatically
stripped from numbers before they are stored.
Reading Phone Book Entries
Use the following steps to read the entries from a phone book:
1. Get a list of all phone books—on both SIM cards and the modem—using GetPhonebooks.
2. Get the entries in a phone book using GetPhonebookEntries.
Example 22.21 Adding Contacts From A SIM Card To A Combo Box in C++
if (!InitWwanVoiceApi())
{
return false;
}
Phonebook[] phonebooks = Phonebook.GetPhonebooks();
foreach (Phonebook phonebook in phonebooks)
{
if (phonebook.StoredOnSim)
{
PhonebookEntry[] entries = phonebook.GetPhonebookEntries();
foreach (PhonebookEntry entry in entries)
{
// Some phonebook entries are duplicates, or
// they have zero length names. This example filters these out.
if (
(!number_combo.Items.Contains(entry.GetName())) &&
(entry.GetName().Length > 0)
)