デバイス

deviceオブジェクトには、デバイスのハードウェアとソフトウェアについて説明します。

プロパティ

変数のスコープ

以来、 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

これらのコマンドすべてのターゲット プラットフォームに適用されますが、以下のプラットフォームに固有の構成設定を変更します。

  • アンドロイド

    (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 アプリケーションのアプリケーション マニフェスト

いくつかのプラットフォームは特別な構成を必要とせずにこの機能をサポート可能性があります。プラットフォームのサポートの概要のセクションを参照してください。