Recientemente un cliente me pidió, como parte de los requerimientos del proyecto, que para realizar ciertas acciones en su aplicación de Windows Mobile se encendiera y apagara el teléfono automáticamente, sin que el usuario tuviera que intervenir. Concretamente, la aplicación tiene que abrir una conexión de datos GPRS, conectarse a un webservice situado en un servidor de Internet, e intercambiar cierta información con éste. El teléfono no se utiliza para comunicaciones de voz, sólo de datos.

Como era una tarea que nunca antes había realizado, tuve que recurrir a Google para intentar encontrar la solución, alguna solución cercana, a alguna pista que me llevara hacia ella. Pronto la decepción se apropió de mí. Por más que buscaba y buscaba cómo encender el teléfono de Windows Mobile con C#, no encontraba nada, a pesar de que la búsqueda la realizaba en Inglés, el idioma más extendido en la red.

Sin embargo, aunque lentamente, poco a poco me fui acercando a la solución. La causa de la falta de respuestas era que no estaba escribiendo la pregunta correcta. Para un usuario común puede que la frase “encender el teléfono” le resultara natural, pero en términos más técnicos el enfoque correcto es “encender la radio del dispositivo móvil”. Y en Inglés. Algo así como: turn radio on and off windows mobile c#. Aunque en este contexto existen otros posibles sinónimos de turn, como switch o toggle.

Resulta que en la ROM del dispositivo existe una dll no documentada llamada ossvcs.dll, que exporta funciones para controlar los Dispositivos de Radio (Radio Devices). Es decir, los módulos de Bluetooth, Teléfono y Red Inalámbrica (WiFi). Ossvcs.dll exporta las funciones por un número de orden y no por su nombre. Estas funciones pertenecen a un API no administrado, por lo que para invocarlas desde nuestro código C# necesitaremos declarar los prototipos mediante p/Invoke. Las funciones que necesitamos son las siguientes:

[DllImport("ossvcs.dll", EntryPoint = "#276", CharSet = CharSet.Unicode)]
private static extern uint GetWirelessDevice(ref IntPtr pDevice, int pDevVal);

[DllImport("ossvcs.dll", EntryPoint = "#273", CharSet = CharSet.Unicode)]
private static extern uint ChangeRadioState(ref RDD pDevice, int dwState, int saveAction);

[DllImport("ossvcs.dll", EntryPoint = "#280", CharSet = CharSet.Unicode)]
private static extern uint FreeDeviceList(IntPtr pDevice);

Nótese cómo EntryPoint contiene el número de orden que identifica a la función invocada.

De las tres funciones, la que realmente nos interesa es ChangeRadioState(), porque justamente es la que nos permite cambiar el estado de la radio. Es decir, encenderla o apagarla. O dicho de forma llana, encender o apagar el teléfono.

He creado una clase llamada MobileRadio, que expone un único método público estático: SetDeviceState(). Este método acepta dos argumentos de tipo entero. El primero indica el tipo de dispositivo, y el segundo informa el estado al que se desea cambiar. El tipo de dispositivo puede ser uno de los siguientes: Bluetooth, el Teléfono o la Red Inalámbrica (WiFi). No necesitas conocer de memoria los valores enteros que se pueden traspasar. La clase MobileRadio exporta también dos estructuras (RADIODEVTYPE y RADIODEVSTATE) que contienen las constantes necesarias.

Para encender el teléfono basta la siguiente línea de código:

MobileRadio.SetDeviceState(MobileRadio.RADIODEVTYPE.PHONE, MobileRadio.RADIODEVSTATE.ON);

Y para apagarlo, ¿lo adivinas?

Para conocer el estado actual del teléfono, si está encendido o apagado, utilizamos la propiedad booleana PhoneRadioOff de la clase SystemState, situada en el espacio de nombres Microsoft.WindowsMobile.Status:

Microsoft.WindowsMobile.Status.SystemState.PhoneRadioOff

Esta propiedad es verdadera (true) si la radio del dispositivo está apagada, y falsa (false) en caso contrario.

Puedes descargar el proyecto completo desde aquí.

Enlaces de interés:

Cómo encender el teléfono en Windows Mobile con C#
El código fuente del proyecto

Turn radio on and off as needed
http://community.intermec.com/t5/General-Development-Developer/Turn-radio-on-and-off-as-needed/m-p/138

Controlling the Radio Devices
http://www.teksoftco.com/articles/article%20007/radiodevices.htm

Toggle WiFi/BT/Phone using .NET code only!!!
http://forum.xda-developers.com/showthread.php?t=413159

PInvoke.net: A wiki for .NET developers
http://www.pinvoke.net/

Un teléfono móvil moderno, provisto de Windows Mobile, nos permite abrir archivos de MS Office, leer PDFs, hacer fotos, leer el correo electrónico, acceder a contenidos online por RSS, llevar la agenda de actividades, gestionar nuestros contactos, escuchar música, ver vídeos, chatear, jugar, ejecutar aplicaciones de un amplio rango… Además, por si no fuera suficiente, también sirve para hacer llamadas telefónicas.

Realizar una llamada telefónica mediante código C# desde una aplicación nuestra de Windows Mobile es algo ridículamente simple, gracias a un recurso que Microsoft ha puesto a nuestra disposición: la clase Phone. Esta clase se encuentra definida dentro del ensamblado Microsoft.WindowsMobile.Telephony (en la DLL microsoft.windowsmobile.telephony.dll), por lo que debemos agregar una referencia a este ensamblado en nuestro proyecto de Visual Studio.

Ahora sólo nos resta declarar y crear un objeto de la clase Phone, y llamar a su método mágico: Talk().

Phone p = new Phone();
p.Talk(numero);

Este método recibe como parámetro un texto (string) que representa el número al cual se desea llamar: public void Talk(string number).

El proceso no es silencioso. Realmente lo que hace es ejecutar (y mostrar) el programa Teléfono del sistema operativo. Delega en él todas las operaciones, como por ejemplo, colgar la llamada.

Puedes descargarte el proyecto completo desde aquí.

¿Y por qué necesitaríamos realizar llamadas telefónicas desde una aplicación propia? ¿Acaso para escribir una versión mejorada del programa nativo? Yo conozco al menos un caso en que sí es necesario acudir a esta funcionalidad. Hace algunos años tuve que desarrollar una aplicación de telecomunicaciones que necesitaba, como parte de su funcionamiento, realizar llamadas automáticamente a un cierto número. La aplicación OIGAA convierte los teléfonos móviles en extensiones de la centralita corporativa, permitiendo a sus usuarios responder desde cualquier lugar como si estuvieran en la oficina, y ofreciendo además diversas funcionalidades de valor añadido. Aquí te dejo algunas capturas de pantalla de la aplicación ejecutándose en el emulador de dispositivos móviles.

• OIGAA: Pantalla de autenticación
• OIGAA: Conexión y actualización inicial de datos
• OIGAA: Agenda de contactos. Posibilidad de iniciar una conexión de VoIP
• OIGAA: Configuración del tipo de llamada y el mensaje de presencia

Enlaces de interés:
Código completo del ejemplo