Developers guide

Chapter 22: Wireless Wide-Area Networking
Voice Over WWAN Events
Psion Teklogix Mobile Devices SDK Developers Guide 229
Use StopRepeatingWave to stop playing the tone. This is shown in this example:
Setting The Speaker Volume
Use SetSpeakerVolume to control the volume of the speaker on the Psion Teklogix computer. 0
(zero) is the minimum volume of the speaker on the Psion Teklogix computer, and 100 is the
maximum volume of the speaker. The sound level is hardware dependent; on different
Psion Teklogix computers the same setting gives different apparent sound levels. Zero volume
does not turn the speaker off; it is the lowest sound level available.
The volume can take one of the following values: 0, 20, 40, 60, 80,100. Setting any other value
results in rounding to the nearest valid value.
In order to set the speaker volume, there must be an active call when the volume is set.
Configuring The Microphone
At this time (April 2008), the only available microphone operation is muting.
Muting The Microphone
Use SetMicrophoneMute to mute the microphone on the Psion Teklogix computer. When mute is
enabled, the other parties cannot hear you even if the call is in the active state: You can still hear
the other parties.
Use GetMicrophoneMute to check the mote status of the microphone.
In order to mute the microphone, there must be an active call when mute is set.
22.12.14 Voice Over WWAN Events
22.12.14.1 Voice Call Status Changed Event
A voice call status changed event is generated when one of the following changes for a voice call:
• The voice call state. See “Voice Service States” on page 217
for details.
• The voice call flag.
Voice Call Flags
The voice call flags define the type of voice call.
Incoming
This is an incoming call. Another party initiated this voice call.
Conference
This call is part of a multiparty call. See “Multiparty Calls (Conference Calls)” on page 226.
Last Event
The voice call is terminated—no more events will be generated for this call. See “Terminating
Voice Calls” on page 227 for details.
Withheld Incoming Number
This is an incoming call where the caller withheld the phone number. See “Blocking Caller ID On
Outgoing Calls” on page 228 for details.
Example 22.20 Stopping A Repeating Tone In C++
// The user responded, don't need to play the ring tone any more.
// From the PsionTeklogix::Sound namespace.
StopRepeatingWave();