Join Our Discussion

3.1.3 API Servicios

        Un servicio es un servidor presente en el dispositivo que nos ofrece diversos recursos, datos, o prácticamente cualquier otra cosa que podamos necesitar. Cada vez que se accede  a un servicio, se le especifica un Uniform Resource Locator (URL) a este método, junto con otra información.

         Por ejemplo, digamos que queremos obtener la hora del sistema. Podemos hacerlo utilizando el servicio  con la URI de palm: / / com.palm.systemservice, que nos ofrece los servicios del nivel de sistema de varios tipos.

La sintaxis para llamar a ese servicio es la siguiente: 

 

this.controller.serviceRequest("palm://com.palm.systemservice",{

        method : "time/getSystemTime",

        parameters : { },

        onSuccess : function(inResp) {

            $("divOutputGood").innerHTML = "TIME: " + Object.toJSON(inResp);},

        onFailure : function(inResp) {

            $("divOutputBad").innerHTML = "ERROR: " + Object.toJSON(inResp);}  

}  );

 

        Como puede ver, el primer argumento del método es la URI de los servicios a los que estamos llamando. El segundo argumento es un objeto que contiene las opciones para el método específico del servicio que deseamos ejecutar. El atributo método, con un valor de time / GetSystemTime en este caso, es el método utilizado para obtener la hora actual del sistema. Los parámetros de atributos pueden contener los parámetros específicos para el método, en este caso, no hay ninguno, por lo que sólo tenemos que pasar un objeto vacío. El atributo onSuccess es una referencia a una función que será llamada cuando se reciba una respuesta satisfactoria. En este caso, sólo volcaremos la respuesta en un <div> en el “scene” para mostrarla (el método Object.toJSON () nos devuelve una representación en String de un objeto, para poder visualizarlo). Lo mismo se hace en la llamada onFailure, que, como estoy seguro de que puedes adivinar, se llama, si la solicitud de servicio no tiene éxito.

 

        Un posible tercer argumento que puede ser un booleano o un objeto, se puede utilizar para especificar qué hacer cuando ocurre un error. Si pasas el argumento “true”, entonces los servicios serán "resubscribed" si se produce un error, que es una forma elegante de decir que se llamará de nuevo después de un breve retraso. Si pasas un objeto, entonces se pueden dar algunas opciones de la solicitud, incluido el atributo de la “rellamada” del servicio que , cuando se establece en true, hace lo mismo "volverse a llamarse en caso de error" truco, que acabamos de describir, y el atributo useNativeParsed que, cuando son “true”, se solicitar el uso de un analizador de JSON nativo, si está disponible.

 
En la siguiente tabla, podemos ver todos los servicios:


Service

Description

Accelerometer

Acceso a los datos de los eventos de orientacion y el acelerómetro.

Accounts

Devuelve informacion sobre las cuentas de usuario establecidas para usarlas con Palm® Synergy™.

Alarms

Establece un temporizador que se activara en el dispositivo tras un intervalo específico o en una fecha u hora determinada.

Application Manager

Invoca a los manejadores por defecto para los recursos de tipo común o las operaciones básicas de dispositivo.

Audio

Reproduce audio, con formatos de audio comunes.

Browser

Carga y muestra una pagina web de una URL especificada.

Calendar

Varios métodos para acceder o crear datos de Calendario.

Camera

Lanza la aplicación de la cámara para sacar una foto.

Connection Manager

Obtiene el estado de la conexión e informa de las posibles notificaciones por cambios en el estado de la conexión.

Contacts

Varios métodos para acceder o crear datos de Contactos.

Display Manager

Obtiene los eventos relacionados con el estado del dispositivo.

Document Viewers

Lanza el visor de documentos al navegador y muestra los archivos de tipos comunes.

Download Manager

Descarga y sube archivos en HTTP.

Email

Manda emails, e incluye opciones para los contenidos de los emails.

GPS

Obtiene las coordenadas de la localización actual y registra continuas actualizaciones.

Keys

Obtiene los eventos de las pulsaciones de teclas del teclado y los botones del volumen.

Maps

Muestra un mapa basado en varias opciones que podemos seleccionar.

Messaging

Manda IM/SMS/MMS, e incluye opciones para los contenidos de los mensajes.

Mojo Messaging Service

Es un sevicio basado en  XMPP para mandar peticiones asíncronas, informacion y contenido de los contenedores basados en "nubes".

People Picker

Muestra una lista de contactos para que el usuario pueda hacer una selección.

Phone

Hace una llamada de teléfono.

Photos

Muestra una imagen en varios formatos comunes de imágenes.

Power Management

Entra en modo "Hibernar" tras un tiempo de inactividad.

System Properties

Obtiene las propiedades del sistema, incluido el ID del dispositivo.

System Service

Accede a varias configuraciones del sistema, incluido el systemTime.

System Sounds

Reproduce archivos de audio en respuesta a la acción del usuario. Los sonidos pueden reproducirse cuando llega un mensaje o cuando queda poca batería.

Video

Reproduce video de los formatos comunes de video.

View File

Descarga o/y muestra un archivo en varios formatos o varios tipos de recursos.




Comments