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
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0 y superior)
- iPhone
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
- Obtiene el nombre del producto en vez del nombre del modelo.
- El nombre del producto es con frecuencia el nombre en clave dado durante la producción.
- Ejemplo: El Nexus One retorna "Passion", Motorola Droid retorna "voles"
Peculiaridades iPhone
- Obtiene el nombre personalizado en vez del nombre del modelo.
- El nombre personalizado es puesto por el usuario en iTunes.
- Ejemplo: "iPhone de Juan"
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
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0 y superior)
- iPhone
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
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0 y superior)
- iPhone
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
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0 y superior)
- iPhone
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
- Android 2.1+
- BlackBerry
- BlackBerry WebWorks (OS 5.0 y superior)
- iPhone
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>