Device

Device

El objeto device proporciona información sobre el hardware y software del dispositivo.

Atributos

Ámbito de la variable

Desde que device fue asignada al objeto window, se encuentra en el espacio global.

// Estas variables apuntan al mismo `device`
//
var phoneName = window.device.name;
var phoneName = device.name;

device.name

Obtiene el modelo del dispositivo.

var string = device.name;

Descripción

device.name retorna el nombre del modelo o producto. Este valor lo asigna el fabricante y puede diferir en las diferentes versiones del mismo producto.

Plataformas Soportadas

Ejemplo Rápido

// Android:    Nexus One            retorna "Passion" (nombre en clave del Nexus One)
//             Motorola Droid       retorna "voles"
// BlackBerry: Bold 8900            retorna "8900"
// iPhone:     Todos los dispositivos   retorna el nombre de iTunes. "iPhone de Juan"
//
var name = device.name;

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Device</title>

    <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
        var element = document.getElementById('deviceProperties');

        element.innerHTML = 'Nombre del dispositivo: '  + device.name     + '<br />' + 
                            'Versión Phonegap: '       + device.phonegap + '<br />' + 
                            'Plataforma: '              + device.platform + '<br />' + 
                            'UUID: '                + device.uuid     + '<br />' + 
                            'Versión: '            + device.version  + '<br />';
    }

    </script>
  </head>
  <body>
    <p id="deviceProperties">Cargando...</p>
  </body>
</html>

Peculiaridades Android

Peculiaridades iPhone


device.phonegap

Obtiene la versión PhoneGap del dispositivo.

var string = device.phonegap;

Descripción

device.phonegap retorna la versión phonegap que esta corriendo en el dispositivo.

Plataformas Soportadas

Ejemplo Rápido

var name = device.phonegap;

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Device</title>

    <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
        var element = document.getElementById('deviceProperties');

        element.innerHTML = 'Nombre del dispositivo: '  + device.name     + '<br />' + 
                            'Versión Phonegap: '       + device.phonegap + '<br />' + 
                            'Plataforma: '          + device.platform + '<br />' + 
                            'UUID: '            + device.uuid     + '<br />' + 
                            'Versión: '            + device.version  + '<br />';
    }

    </script>
  </head>
  <body>
    <p id="deviceProperties">Cargando...</p>
  </body>
</html>

device.platform

Obtiene el nombre del sistema operativo.

var string = device.platform;

Plataformas Soportadas

Ejemplo Rápido

// Dependiendo del dispositivo, estos son algunos ejemplos:
//   - "Android"
//   - "BlackBerry"
//   - "iPhone"
//   - "webOS"
//
var devicePlatform = device.platform;

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Device</title>

    <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
        var element = document.getElementById('deviceProperties');

        element.innerHTML = 'Nombre del dispositivo: '  + device.name     + '<br />' + 
                            'Versión Phonegap: '       + device.phonegap + '<br />' + 
                            'Plataforma: '          + device.platform + '<br />' + 
                            'UUID: '            + device.uuid     + '<br />' + 
                            'Versión: '            + device.version  + '<br />';
    }

    </script>
  </head>
  <body>
    <p id="deviceProperties">Cargando atributos Device...</p>
  </body>
</html>

Peculiaridades iPhone

Todos los dispositivos retornan iPhone como plataforma. Es impreciso debido que Apple rebautizo el sistema operativo como iOS.

Peculiaridades BlackBerry

Pueden devolver la versión de plataforma en lugar de la plataforma. Por ejemplo, el Storm2 9550 retornaría '2.13.0.95' o similar.


device.uuid

Obtiene el Identificador Universal Único (UUID).

var string = device.uuid;

Descripción

Los detalles de como se genera un UUID es determinado por el fabricante y especificaciones de la plataforma o modelo.

Plataformas Soportadas

Ejemplo Rápido

// Android: Retorna un entero aleatorio de 64-bit (como string, también!)
//          El entero es generado en el dispositivo en el primer encendido.
//
// BlackBerry: Retorna el numero PIN del dispositivo
//             Es un entero único de 9 dígitos (como string, para variar!)
//
// iPhone: (Resumen de la documentación, UIDevice )
//         Retorna una string hash creada usando los múltiples id's del hardware.
//         Se garantiza que sea único para cada dispositivo y no puede estar
//         vinculada a la cuenta de usuario
//
var deviceID = device.uuid;

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Device</title>

    <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
        var element = document.getElementById('deviceProperties');

        element.innerHTML = 'Nombre del dispositivo: '  + device.name     + '<br />' + 
                            'Versión Phonegap: '       + device.phonegap + '<br />' + 
                            'Plataforma: '          + device.platform + '<br />' + 
                            'UUID: '            + device.uuid     + '<br />' + 
                            'Versión: '            + device.version  + '<br />';
    }

    </script>
  </head>
  <body>
    <p id="deviceProperties">Cargando...</p>
  </body>
</html>

device.version

Obtiene la versión del sistema operativo.

var string = device.version;

Plataformas Soportadas

Ejemplo Rápido

// Android:    Froyo OS retornara "2.2"
//             Eclair OS retornara "2.1", "2.0.1", o "2.0"
//             La versión también puede retornar la actualización "2.1-update1" 
//
// BlackBerry: Bold 9000 usando OS 4.6 retornara "4.6.0.282"
//
// iPhone:     iOS 3.2 retorna "3.2"
//
var deviceVersion = device.version;

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Device</title>

    <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
        var element = document.getElementById('deviceProperties');

        element.innerHTML = 'Nombre del dispositivo: '  + device.name     + '<br />' + 
                            'Versión Phonegap: '       + device.phonegap + '<br />' + 
                            'Plataforma: '          + device.platform + '<br />' + 
                            'UUID: '            + device.uuid     + '<br />' + 
                            'Versión: '            + device.version  + '<br />';
    }

    </script>
  </head>
  <body>
    <p id="deviceProperties">Cargando...</p>
  </body>
</html>