Collapse all Symbian^3 Product Developer Library

Alternative Line Settings Tutorial

This tutorial describes how to get and set the alternative line settings using RMobilePhone functions.

The Alternate Line Service (ALS) provides a subscriber with two voice lines, that is the primary and auxiliary lines. The phones that support ALS allow clients to get and set ALS settings irrespective of the current mode or network. ALS is a GSM-specific service available only on DCS 1800 networks. The ALS setting operates when the mobile station is registered to a DCS 1800 network. At other times, the primary voice line is used.

When ALS is available, the user can have separate supplementary service profiles for the voice and auxiliary voice services. Incoming calls are received on either lines irrespective of the line selection. Outgoing calls are made on the selected line.

Get the current setting using RMobilePhone::GetALSLine(). ALS settings are described in the RMobilePhone::TMobilePhoneALSLine enum.
Set a voice line as the active line for outgoing voice calls using RMobilePhone::SetALSLine()
Use RMobilePhone::NotifyALSLineChange() to get the notification of any changes in the selected ALS line.

Alternative line settings example

The following code gets the current ALS settings, and checks if the ALS is available.

The code assumes iMobilePhone is an RMobilePhone object.

RMobilePhone::TMobilePhoneALSLine ALSLine;

User::LeaveIfError(iMobilePhone.GetALSLine(ALSLine));

if (ALSLine != RMobilePhone::EAlternateLineNotAvailable)
    {
        //do something

    }

Parent topic: Multimode Phone Sub-session Tutorials