Efetuando liga��es a partir de aplica��es para Windows Phone

Quando desenvolvermos aplicaç�es para dispositivos m�veis, sejam para Android, iOS, Windows Phone, BlackBerry ou qualquer outra plataforma, � comum (e natural) querer (e precisar) utilizar os recursos do aparelho, tais como c�mera, aceler�metro, entre outros.

Por mais que n�o se implemente tais funcionalidades inicialmente, n�o demora muito at� o cliente solicitar alguma alteraç�o nesse sentido. E por se tratar de um smartphone (no fundo, um celular), n�o � de se estranhar se nos for solicitado que o usu�rio possa efetuar ligaç�es a partir da aplicaç�o, sem precisar minimiza-la e acessar a lista de contatos ou a menu de chamadas telef�nicas.

Com base nisso, este artigo explicar� como realizar ligaç�es a partir de aplicaç�es pr�prias para Windows Phone. Aqui ser� utilizada a linguagem C# e a vers�o escolhida ser� a 7.x, de forma que o a aplicaç�o aqui desenvolvida possa ser executada tanto no Windows Phone 7, quanto no 8.

Leia tamb�m: Rumo ao Desenvolvimento Mobile - Iniciaç�o com Windows Phone

Iniciando a aplicaç�o

Inicialmente devemos acessar o menu FILE > New > Project... no Visual Studio (nesse caso, o 2012 com o SDK para Windows Phone devidamente instalado). Na categoria Windows Phone, selecionamos o template Windows Phone App e na caixa de di�logo que ser� exibida, devemos selecionar a opç�o Windows Phone OS 7.1, conforme explicado anteriormente.

Na p�gina inicial, MainPage.xaml, vamos inserir alguns controles que dar�o forma � nossa aplicaç�o. O Grid de nome ContentPanel deve ficar como o c�digo constante na Listagem 1, que insere um ListBox e um Button que ser�o utilizados posteriormente.

<!--ContentPanel - place additional content here-->
<Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">
    <StackPanel>
        <ListBox x:Name="lbxClientes">
            <ListBox.ItemTemplate>
                <DataTemplate>
                    <StackPanel>
                        <TextBlock Text="{Binding Path=Nome}" FontSize="30"/>
                        <TextBlock Text="{Binding Path=Telefone}" FontSize="20"/>
                    </StackPanel>
                </DataTemplate>
            </ListBox.ItemTemplate>
        </ListBox>
        <Button x:Name="btnLigar" Content="Ligar"/>
    </StackPanel>
</Grid>

Listagem 1. C�digo XAML inserido na p�gina principal

Essa ListBox ser� utilizada para listar alguns objetos que criaremos a seguir, simulando uma lista de clientes de uma aplicaç�o comercial qualquer. Clicando no bot�o Ligar, o usu�rio poder� efetuar uma chamada para o telefone do cliente selecionado na lista.

Criemos ent�o uma nova classe chamada Cliente, clicando com a direita no projeto, no Solution Explorer, e em Add > Class. Essa classe possuir� apenas dois atributos: nome e telefone, conforme vemos na Listagem 2.

public class Cliente
{
    private string _nome;
    private string _telefone;

    public string Nome
    {
        get { return _nome; }
        set { _nome = value; }
    }        

    public string Telefone
    {
        get { return _telefone; }
        set { _telefone = value; }
    }
}

Listagem 2. Classe Cliente

Em seguida, no evento Loaded da MainPage, vamos instanciar alguns clientes e lista-los na ListBox. O c�digo para realizar tal tarefa � apresentado na Listagem 3.

private void PhoneApplicationPage_Loaded_1(object sender, RoutedEventArgs e)
{
    List<Cliente> clientes = new List<Cliente>();
    clientes.Add(new Cliente() {
        Nome = "Jos�",
        Telefone = "32322323"
    });

    clientes.Add(new Cliente()
    {
        Nome = "Maria",
        Telefone = "87123456"
    });

    clientes.Add(new Cliente()
    {
        Nome = "Carlos",
        Telefone = "91987654"
    });

    lbxClientes.ItemsSource = clientes;
}

Listagem 3. Evento Loaded da p�gina MainPage

Executando a aplicaç�o no emulador j� podemos ver os clientes listados, conforme ilustra a Figura 1.

Figura 1. Clientes listados na ListBox

Agora precisamos implementar o evento Click do bot�o Ligar, dando duplo clique sobre o mesmo no design, o que deve nos levar ao c�digo C# da p�gina. O c�digo desse evento deve ficar como mostrado na Listagem 4, a seguir.

private void btnLigar_Click(object sender, RoutedEventArgs e)
{
    Cliente cliente = (Cliente)lbxClientes.SelectedItem;

    PhoneCallTask ligacao = new PhoneCallTask()
    {
        DisplayName = cliente.Nome,
        PhoneNumber = cliente.Telefone
    };

    ligacao.Show();
}

Listagem 4. Evento Click do bot�o Ligar

No c�digo acima utilizamos a classe PhoneCallTask, respons�vel por realizar ligaç�es a partir da nossa aplicaç�o. Ao invocar o m�todo Show, o usu�rio � questionado se deseja realmente efetuar uma ligaç�o para o n�mero selecionado. Essa confirmaç�o � necess�ria pois ao efetuar uma ligaç�o, o cliente ser� cobrado por isso, de acordo com os serviços da sua operadora de telefonia m�vel.

Podemos agora executar a aplicaç�o, selecionar um cliente na lista e pressionar o bot�o Ligar. A Figura 2 ilustra essa aç�o.

Figura 2. Ligando para o n�mero selecionado

Aceitando a solicitaç�o e pressionando o bot�o call (ligar), a ligaç�o � iniciada normalmente, como se v� na Figura 3.

Figura 3. Ligaç�o em andamento

Conclus�o

Esse tipo de funcionalidade � muito comum em aplicaç�es para dispositivos m�veis e, muitas vezes, pode at� se apresentar como um diferencial, pois tende a facilitar a vida do usu�rio, que n�o precisar� sair da aplicaç�o para ligar para um n�mero que est� ali na sua tela.

Como vimos, a respons�vel pelo serviço � a classe PhoneCallTask do namespace Microsoft.Phone.Tasks. Essa classe recebe os valores para os atributos DisplayName e PhoneNumber, que representam, respectivamente, o nome e o n�mero para o qual se deseja ligar.

Caso o n�mero discado j� esteja registrado na lista de contatos do usu�rio, o nome que ser� exibido durante a ligaç�o (Figura 3) ser� o do contato salvo na agenda e n�o o nome informado na propriedade DisplayName do objeto PhoneCallTask.

Outro ponto importante � que o formato do n�mero informado deve ser v�lido, caso contr�rio, a ligaç�o n�o poder� ser efetuada.

Efetuando liga��es a partir de aplica��es para Windows Phone

Veja neste artigo como efetuar ligações telefônicas a partir de suas próprias aplicações para Windows Phone.

Iniciando a aplicaç�o

Conclus�o

Artigos relacionados