109 lines
3.6 KiB
Markdown
109 lines
3.6 KiB
Markdown
|
---
|
||
|
|
license: Licensed to the Apache Software Foundation (ASF) under one
|
||
|
|
or more contributor license agreements. See the NOTICE file
|
||
|
|
distributed with this work for additional information
|
||
|
|
regarding copyright ownership. The ASF licenses this file
|
||
|
|
to you under the Apache License, Version 2.0 (the
|
||
|
|
"License"); you may not use this file except in compliance
|
||
|
|
with the License. You may obtain a copy of the License at
|
||
|
|
|
||
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
|
||
|
|
Unless required by applicable law or agreed to in writing,
|
||
|
|
software distributed under the License is distributed on an
|
||
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||
|
|
KIND, either express or implied. See the License for the
|
||
|
|
specific language governing permissions and limitations
|
||
|
|
under the License.
|
||
|
|
---
|
||
|
|
|
||
|
|
device.name
|
||
|
|
===========
|
||
|
|
|
||
|
|
__WARNING:__ `device.name` is deprecated as of version 2.3.0. Use `device.model` instead.
|
||
|
|
|
||
|
|
Get the device's model name.
|
||
|
|
|
||
|
|
var string = device.name;
|
||
|
|
|
||
|
|
Description
|
||
|
|
-----------
|
||
|
|
|
||
|
|
`device.name` returns the name of the device's model or product. This
|
||
|
|
value is set by the device manufacturer and may be different across
|
||
|
|
versions of the same product.
|
||
|
|
|
||
|
|
Supported Platforms
|
||
|
|
-------------------
|
||
|
|
|
||
|
|
- Android
|
||
|
|
- BlackBerry WebWorks (OS 5.0 and higher)
|
||
|
|
- iOS
|
||
|
|
- Windows Phone 7 and 8
|
||
|
|
- Bada 1.2 & 2.x
|
||
|
|
- webOS
|
||
|
|
- Tizen
|
||
|
|
- Windows 8
|
||
|
|
|
||
|
|
Quick Example
|
||
|
|
-------------
|
||
|
|
|
||
|
|
// Android: Nexus One returns "Passion" (Nexus One code name)
|
||
|
|
// Motorola Droid returns "voles"
|
||
|
|
// BlackBerry: Torch 9800 returns "9800"
|
||
|
|
// iOS: All devices returns either "iPhone", "iPod Touch", "iPhone Simulator", "iPad", "iPad Simulator"
|
||
|
|
//
|
||
|
|
var name = device.name;
|
||
|
|
|
||
|
|
Full Example
|
||
|
|
------------
|
||
|
|
|
||
|
|
<!DOCTYPE html>
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<title>Device Properties Example</title>
|
||
|
|
|
||
|
|
<script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
|
||
|
|
<script type="text/javascript" charset="utf-8">
|
||
|
|
|
||
|
|
// Wait for device API libraries to load
|
||
|
|
//
|
||
|
|
document.addEventListener("deviceready", onDeviceReady, false);
|
||
|
|
|
||
|
|
// device APIs are available
|
||
|
|
//
|
||
|
|
function onDeviceReady() {
|
||
|
|
var element = document.getElementById('deviceProperties');
|
||
|
|
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
|
||
|
|
'Device Cordova: ' + device.cordova + '<br />' +
|
||
|
|
'Device Platform: ' + device.platform + '<br />' +
|
||
|
|
'Device UUID: ' + device.uuid + '<br />' +
|
||
|
|
'Device Model: ' + device.model + '<br />' +
|
||
|
|
'Device Version: ' + device.version + '<br />';
|
||
|
|
}
|
||
|
|
|
||
|
|
</script>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<p id="deviceProperties">Loading device properties...</p>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|
||
|
|
Android Quirks
|
||
|
|
--------------
|
||
|
|
|
||
|
|
- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL), which is often the production code name. For example, the Nexus One returns `Passion`, and Motorola Droid returns `voles`.
|
||
|
|
|
||
|
|
Windows Phone 7 and 8 Quirks
|
||
|
|
-------------
|
||
|
|
|
||
|
|
- Returns the device model specified by the manufacturer. For example, the Samsung Focus returns `SGH-i917`.
|
||
|
|
|
||
|
|
Bada Quirks
|
||
|
|
-----------
|
||
|
|
- Returns the manufacturer model name, for example, `Samsung Wave S8500`
|
||
|
|
|
||
|
|
Tizen Quirks
|
||
|
|
-----------
|
||
|
|
- Returns the device model assigned by the vendor, for example, `TIZEN`
|