文章来自:http://blog.csdn.net/phonegapcn/article/details/6702333
device对象描述设备的硬件和软件。
属性：
- device.name
- device.phonegap
- device.platform
- device.uuid
- device.version
变量作用域：
由于device被分配到window对象，隐含说明其作用域为全局范围。
// 下面两句引用了相同的“device”对象
var phoneName = window.device.name;
var phoneName = device.name;
device.name
获得设备的型号名称。
说明：
device.name返回设备的型号或产品名称。这个值是由设备制造商设定，可能同一产品的不同版本之间有所不同。
支持的平台：
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
简单的范例：
// Android: Nexus One 返回 "Passion" (Nexus One的代码名)
// Motorola Droid 返回"voles"
// BlackBerry: Bold 8900 返回 "8900"
// iPhone: 所有设备都返回由iTunes设置的名称，如 "Joe's iPhone"
var name = device.name;
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Device Properties Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完成
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
'Device PhoneGap: ' + device.phonegap + '<br />' +
'Device Platform: ' + device.platform + '<br />' +
'Device UUID: ' + device.uuid + '<br />' +
'Device Version: ' + device.version + '<br />';
}
</script>
</head>
<body>
<p id="deviceProperties">Loading device properties...</p>
</body>
</html>
Android 的特异情况：
-
获得产品名称而非型号名称。
- 产品名称一般是在生产过程中设定的代码名称。
- 例如：Nexus One返回“Passion”，Motorola Droid返回“voles”。
iPhone 的特异情况：
-
获得设备的定制名字而非设备型号名称。
- 定制名称是由所有者在iTunes中定制的。
device.phonegap
获取设备上正在运行的PhoneGap版本信息。
说明：
device.phonegap返回设备上正在运行的PhoneGap的版本号。
支持的平台：
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Device Properties Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
element.innerHTML = 'Device Name: ' + device.name + '' +
'Device PhoneGap: ' + device.phonegap + '' +
'Device Platform: ' + device.platform + '' +
'Device UUID: ' + device.uuid + '' +
'Device Version: ' + device.version + '';
}
</script>
</head>
<body>
<p id="deviceProperties">Loading device properties...</p>
</body>
</html>
device.platform
获得设备使用的操作系统名称。
支持的平台：
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Device Properties Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
'Device PhoneGap: ' + device.phonegap + '<br />' +
'Device Platform: ' + device.platform + '<br />' +
'Device UUID: ' + device.uuid + '<br />' +
'Device Version: ' + device.version + '<br />';
}
</script>
</head>
<body>
<p id="deviceProperties">Loading device properties...</p>
</body>
</html>
iPhone的特异情况：
- 所有设备均返回iPhone，但这是不准确的，因为Apple已经将iPhone的操作系统更名为iOS。
BlackBerry 的特异情况：
- 设备会返回设备的平台版本号而非平台名。例如Storm2 9550将返回“2.13.0.95” 或类似的信息。
device.uuid
获得设备的全球唯一标识符（UUID）。
说明：
UUID是由设备生产商及特定设备平台或型号所决定的。
支持的平台：
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
简单的范例：
// Android: 返回随机的64位整数（作为字符串）
// 这个整数在设备第一次启动时生成
// BlackBerry: 返回设备的PIN码
// 这是一个九位数的唯一证书(作为字符串)
// iPhone: （从UIDevice类文档中转述）
// 返回由多个硬件设备标示所生成的哈希值。
// 这是为了保证每一台设备是唯一的，因此不能和用户账号相关联。
var deviceID = device.uuid;
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Device Properties Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
'Device PhoneGap: ' + device.phonegap + '<br />' +
'Device Platform: ' + device.platform + '<br />' +
'Device UUID: ' + device.uuid + '<br />' +
'Device Version: ' + device.version + '<br />';
}
</script>
</head>
<body>
<p id="deviceProperties">Loading device properties...</p>
</body>
</html>
device.version
获得操作系统的版本号
支持的平台：
- Android
- BlackBerry
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Device Properties Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
'Device PhoneGap: ' + device.phonegap +'<br />' +
'Device Platform: ' + device.platform + '<br />' +
'Device UUID: ' + device.uuid + '<br />' +
'Device Version: ' + device.version +'<br />';
}
</script>
</head>
<body onload="onLoad()">
<p id="deviceProperties">Loading device properties...</p>
</body>
</html>
相关推荐
这个"PhoneGap API帮助文档.zip"压缩包显然包含了关于如何使用PhoneGap API的详细指南，对于开发者来说是非常宝贵的资源。下面我们将深入探讨PhoneGap API中的关键组件及其功能。 1. **加速度计（Accelerometer）**...
知识点：PhoneGap设备API及其应用 一、PhoneGap设备API概览 PhoneGap是一个开源框架，允许开发者使用HTML、CSS和JavaScript开发跨平台移动应用程序。设备API是PhoneGap提供的核心功能之一，它允许开发者访问设备的...
网上的phonegap中文帮助文档尚少，翻译也不太好，在此收集了一些翻译优秀的文章，并制作成chm的帮助文档，以帮助各位学习,此文档包含了phonegap的主要使用功能，并提供了完整示例
标题：PhoneGap,API帮助文档翻译整理4-Compass(指南针) 描述：本文档将深入探讨PhoneGap中Compass API的功能与应用，包括如何获取设备的指南针方向、监听指南针变化以及如何处理相关事件。 ### 一、Compass API...
PhoneGap（现称Cordova）为开发者提供了一套丰富的API，使得跨平台应用能够访问底层设备的各种特性。其中，Contacts API就是用于访问设备通讯录的重要接口之一。 #### 二、Contacts API概述 **Contacts API** 是...
PhoneGap API 提供了一系列的事件，这些事件可以帮助开发者响应移动设备上的特定操作，从而实现更丰富的用户体验。本文将详细介绍 PhoneGap 中的事件类型及其使用方法。 1. **backbutton**：当用户在 Android 设备...
在本篇文档中，我们关注的是 PhoneGap 的 Media API，它提供了对移动设备媒体（如音频）的访问和控制能力。 Media API 提供了对音频文件的操作，包括播放、暂停、停止以及获取当前播放位置等功能。以下是对 Media ...
Camera API是PhoneGap提供的一个用于访问设备摄像头的重要功能。它允许开发者调用设备的默认相机应用，拍摄照片或从设备的相册中选择照片，并以Base64编码的字符串或图像文件URI的形式返回结果。 二、Camera API的...
最新的Phonegap api 中文翻译版。让你快速入门。
本文档主要介绍**PhoneGap**中的**Capture API**，该API提供了访问音频、图片和视频采集设备的功能。 #### 二、核心概念 ##### 1. 对象 **Capture API**定义了几种关键对象用于配置和处理捕捉任务： - **...
在本文中，我们将围绕PhoneGap框架的API文档进行探讨，特别是在处理移动设备上的通讯录（Contacts）数据时所使用的一系列方法。根据提供的文件信息，我们将会详细解释如何使用PhoneGap API来创建和查找通讯录中的...
PhoneGap 的 API 提供了一系列接口，使得开发者可以通过 JavaScript 访问设备的功能，其中包括对文件系统的操作。在本篇文档中，我们将重点关注与“文件”相关的 API，包括 `File`、`DirectoryEntry`、`FileReader` ...
这个 API 允许应用获取设备的地理坐标，如经度、纬度、海拔、速度等信息。 `geolocation.getCurrentPosition` 是 Geolocation API 的关键方法，用于获取设备的当前位置。这个方法是异步的，意味着它不会立即返回...
1. **设备信息** (Device): PhoneGap提供了一个`device`对象，可以获取设备的唯一标识、型号、操作系统版本等信息。 2. **网络状态** (Connection): 通过`navigator.connection`对象，开发者可以检测设备的网络连接...
总结，PhoneGap提供的`Accelerometer` API 使得开发者能够轻松地访问和利用设备的加速度数据，这对于开发与运动相关的应用非常有用。通过上述方法和示例代码，你可以更好地理解如何在实际项目中使用这一功能。
本手册为PhoneGap API的中文版指南，旨在为开发者提供全面、详细的API使用指导，帮助其利用PhoneGap框架开发跨平台移动应用。PhoneGap是一款基于HTML、CSS和JavaScript的技术栈，允许开发者构建适用于多个移动操作...
2. **设备事件**：PhoneGap为移动设备特有的硬件和系统事件提供了API，如`deviceready`事件。这个事件在PhoneGap库加载完成并准备好与设备交互时触发，是所有其他PhoneGap事件的前提。当监听到`deviceready`事件后，...
PhoneGap API是这个框架的核心，提供了与设备硬件功能交互的能力，如摄像头、加速度计、GPS等。本资源是PhoneGap API的中文版，对于中国开发者来说，无疑是一个宝贵的参考资料。 在使用PhoneGap API进行开发时，有...
此API演示项目是为了帮助开发者更直观地理解如何在实际应用中使用PhoneGap的各种功能。 在这个压缩包中，你将找到一系列的apidemo，每个代表了一个特定的PhoneGap API。这些API包括但不限于： 1. **设备API**：...