設備

device物件描述該設備的硬體和軟體。

屬性

• device.model
• device.cordova
• device.platform
• device.uuid
• device.version
• device.name

變數範圍

因為 device 分配到 window 的物件，它是隱式地在全球範圍內。

// These reference the same `device`
var phoneModel = window.device.model;
var phoneModel = device.model;

訪問功能

從 3.0 版，科爾多瓦作為外掛程式實現了設備級 Api。 使用 CLI 的 plugin 命令，描述在命令列介面，可以添加或刪除一個專案，為此功能：

    $ cordova plugin add org.apache.cordova.device
    $ cordova plugin ls
    [ 'org.apache.cordova.device' ]
    $ cordova plugin rm org.apache.cordova.device

這些命令適用于所有有針對性的平臺，但修改如下所述的特定于平臺的配置設置：

• Android 系統

  (in app/res/xml/config.xml)
  <feature name="Device">
      <param name="android-package" value="org.apache.cordova.Device" />
  </feature>
  
  (in app/AndroidManifest.xml)
  <uses-permission android:name="android.permission.READ_PHONE_STATE" />
  

• 黑莓手機 WebWorks

  (in www/plugins.xml)
  <feature name="Device">
      <param name="blackberry-package" value="org.apache.cordova.device.Device" />
  </feature>
  
  (in www/config.xml)
  <feature id="blackberry.app" required="true" version="1.0.0.0" />
  <rim:permissions>
      <rim:permit>read_device_identifying_information</rim:permit>
  </rim:permissions>
  

• （在 Windows PhoneProperties/WPAppManifest.xml)

  <Capabilities>
      <Capability Name="ID_CAP_WEBBROWSERCOMPONENT" />
      <Capability Name="ID_CAP_IDENTITY_DEVICE" />
      <Capability Name="ID_CAP_IDENTITY_USER" />
  </Capabilities>
  

  引用：為 Windows Phone 應用程式清單

• （在 Tizenconfig.xml)

  <feature name="http://tizen.org/api/systeminfo" required="true"/>
  

  引用： Tizen Web 應用程式的應用程式清單

一些平臺可能支援此功能，而無需任何特殊的配置。請參見在概述部分中的平臺支援。