Gerät

Das device -Objekt beschreibt des Geräts Hard- und Software.

Eigenschaften

Geltungsbereich von Variablen

Da device zugewiesen ist das window -Objekt, es ist implizit im globalen Gültigkeitsbereich.

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

Zugriff auf die Funktion

Ab Version 3.0 implementiert Cordova Geräteebene APIs als Plugins. Verwenden Sie der CLI plugin Befehl, beschrieben in der Command-Line Interface, hinzufügen oder Entfernen dieses Feature für ein Projekt:

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

Diese Befehle gelten für alle Zielplattformen, aber die unten beschriebenen Plattform-spezifische Konfigurationseinstellungen ändern:

  • 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" />

  • BlackBerry 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 Phone (inProperties/WPAppManifest.xml)

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

    Bezug: Anwendungsmanifest für Windows Phone

  • Tizen (inconfig.xml)

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

    Bezug: Anwendungsmanifest für Tizen Webanwendung

Einige Plattformen können dieses Feature unterstützen, ohne dass eine besondere Konfiguration. Finden Sie unter Plattform-Unterstützung in der Übersicht.