Device
El objeto
deviceproporciona 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>