En este módulo, aprenderás a utilizar la API del dispositivo en Apache Cordova para acceder a diversas funcionalidades del hardware del dispositivo, como la información del dispositivo, la batería, la brújula, y más. Este conocimiento es fundamental para crear aplicaciones móviles que interactúen de manera efectiva con el hardware del dispositivo.

Conceptos Clave

  1. API del Dispositivo: Conjunto de interfaces que permiten a las aplicaciones acceder a las funcionalidades del hardware del dispositivo.
  2. Plugins de Cordova: Extensiones que proporcionan acceso a las funcionalidades nativas del dispositivo desde JavaScript.
  3. Eventos del Dispositivo: Eventos que se disparan en respuesta a cambios en el estado del dispositivo, como la carga de la batería o la orientación.

Instalación del Plugin del Dispositivo

Para utilizar la API del dispositivo, primero necesitas instalar el plugin correspondiente. El plugin cordova-plugin-device proporciona acceso a la información básica del dispositivo.

cordova plugin add cordova-plugin-device

Accediendo a la Información del Dispositivo

Una vez instalado el plugin, puedes acceder a la información del dispositivo utilizando el objeto device. Aquí hay un ejemplo práctico:

document.addEventListener("deviceready", function() {
    var deviceInfo = {
        model: device.model,
        platform: device.platform,
        version: device.version,
        manufacturer: device.manufacturer,
        isVirtual: device.isVirtual,
        serial: device.serial
    };

    console.log("Device Information: ", deviceInfo);
});

Explicación del Código

  1. document.addEventListener("deviceready", function() {...});: Asegura que el código se ejecute solo después de que Cordova haya inicializado completamente.
  2. device.model: Devuelve el modelo del dispositivo.
  3. device.platform: Devuelve el sistema operativo del dispositivo.
  4. device.version: Devuelve la versión del sistema operativo.
  5. device.manufacturer: Devuelve el fabricante del dispositivo.
  6. device.isVirtual: Indica si el dispositivo es virtual (emulador) o físico.
  7. device.serial: Devuelve el número de serie del dispositivo.

Ejercicio Práctico

Ejercicio 1: Mostrar Información del Dispositivo en la Interfaz de Usuario

Objetivo: Crear una aplicación que muestre la información del dispositivo en la interfaz de usuario.

Instrucciones:

  1. Crea un nuevo proyecto de Cordova.
  2. Instala el plugin cordova-plugin-device.
  3. Modifica el archivo index.html para incluir un contenedor donde se mostrará la información del dispositivo.
  4. Modifica el archivo index.js para obtener y mostrar la información del dispositivo en el contenedor.

Código de Ejemplo:

index.html:

<!DOCTYPE html>
<html>
<head>
    <title>Device Info</title>
</head>
<body>
    <div id="deviceInfo"></div>
    <script src="cordova.js"></script>
    <script src="js/index.js"></script>
</body>
</html>

index.js:

document.addEventListener("deviceready", function() {
    var deviceInfo = `
        <p>Model: ${device.model}</p>
        <p>Platform: ${device.platform}</p>
        <p>Version: ${device.version}</p>
        <p>Manufacturer: ${device.manufacturer}</p>
        <p>Is Virtual: ${device.isVirtual}</p>
        <p>Serial: ${device.serial}</p>
    `;

    document.getElementById("deviceInfo").innerHTML = deviceInfo;
});

Solución del Ejercicio

  1. Crea un nuevo proyecto de Cordova:

    cordova create DeviceInfoApp
    cd DeviceInfoApp
    cordova platform add android
    cordova plugin add cordova-plugin-device
    
  2. Modifica el archivo index.html:

    <!DOCTYPE html>
    <html>
    <head>
        <title>Device Info</title>
    </head>
    <body>
        <div id="deviceInfo"></div>
        <script src="cordova.js"></script>
        <script src="js/index.js"></script>
    </body>
    </html>
    
  3. Modifica el archivo index.js:

    document.addEventListener("deviceready", function() {
        var deviceInfo = `
            <p>Model: ${device.model}</p>
            <p>Platform: ${device.platform}</p>
            <p>Version: ${device.version}</p>
            <p>Manufacturer: ${device.manufacturer}</p>
            <p>Is Virtual: ${device.isVirtual}</p>
            <p>Serial: ${device.serial}</p>
        `;
    
        document.getElementById("deviceInfo").innerHTML = deviceInfo;
    });
    
  4. Ejecuta la aplicación:

    cordova run android
    

Resumen

En esta sección, aprendiste a utilizar la API del dispositivo en Apache Cordova para acceder a la información del hardware del dispositivo. Instalaste el plugin cordova-plugin-device, accediste a la información del dispositivo y la mostraste en la interfaz de usuario. Estos conocimientos te permitirán crear aplicaciones móviles que interactúen de manera efectiva con el hardware del dispositivo.

En el próximo módulo, exploraremos cómo acceder al almacenamiento del dispositivo utilizando las APIs de Cordova.

© Copyright 2024. Todos los derechos reservados