Touchgui/plugins/org.apache.cordova.device/doc/ru/index.md

Thu, 04 Jun 2015 14:50:33 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 04 Jun 2015 14:50:33 +0200
changeset 0
e8ccd40d0ef6
permissions
-rw-r--r--

Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.

     1 <!---
     2     Licensed to the Apache Software Foundation (ASF) under one
     3     or more contributor license agreements.  See the NOTICE file
     4     distributed with this work for additional information
     5     regarding copyright ownership.  The ASF licenses this file
     6     to you under the Apache License, Version 2.0 (the
     7     "License"); you may not use this file except in compliance
     8     with the License.  You may obtain a copy of the License at
    10       http://www.apache.org/licenses/LICENSE-2.0
    12     Unless required by applicable law or agreed to in writing,
    13     software distributed under the License is distributed on an
    14     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    15     KIND, either express or implied.  See the License for the
    16     specific language governing permissions and limitations
    17     under the License.
    18 -->
    20 # org.apache.cordova.device
    22 Этот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`.
    24     document.addEventListener("deviceready", onDeviceReady, false);
    25     function onDeviceReady() {
    26         console.log(device.cordova);
    27     }
    30 ## Установка
    32     cordova plugin add org.apache.cordova.device
    35 ## Параметры
    37 *   device.cordova
    38 *   device.model
    39 *   device.platform
    40 *   device.uuid
    41 *   device.version
    43 ## device.cordova
    45 Возвращает версию Cordova, работающую на устройстве.
    47 ### Поддерживаемые платформы
    49 *   Amazon Fire OS
    50 *   Android
    51 *   BlackBerry 10
    52 *   Обозреватель
    53 *   Firefox OS
    54 *   iOS
    55 *   Tizen
    56 *   Windows Phone 7 и 8
    57 *   Windows 8
    59 ## device.model
    61 Свойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.
    63 ### Поддерживаемые платформы
    65 *   Android
    66 *   BlackBerry 10
    67 *   Обозреватель
    68 *   iOS
    69 *   Tizen
    70 *   Windows Phone 7 и 8
    71 *   Windows 8
    73 ### Краткий пример
    75     // Android:    Nexus One       returns "Passion" (Nexus One code name)
    76     //             Motorola Droid  returns "voles"
    77     // BlackBerry: Torch 9800      returns "9800"
    78     // Browser:    Google Chrome   returns "Chrome"
    79     //             Safari          returns "Safari"
    80     // iOS:     for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models
    81     //
    82     var model = device.model;
    85 ### Особенности Android
    87 *   Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`.
    89  [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
    90  [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
    92 ### Особенности Tizen
    94 *   Возвращает модель устройства, назначенного вендором, например,`TIZEN`
    96 ### Особенности Windows Phone 7 и 8
    98 *   Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`.
   100 ## device.platform
   102 Получите имя операционной системы устройства.
   104     var string = device.platform;
   107 ### Поддерживаемые платформы
   109 *   Android
   110 *   BlackBerry 10
   111 *   Браузером4
   112 *   Firefox OS
   113 *   iOS
   114 *   Tizen
   115 *   Windows Phone 7 и 8
   116 *   Windows 8
   118 ### Краткий пример
   120     // Depending on the device, a few examples are:
   121     //   - "Android"
   122     //   - "BlackBerry 10"
   123     //   - Browser:         returns "MacIntel" on Mac
   124     //                      returns "Win32" on Windows
   125     //   - "iOS"
   126     //   - "WinCE"
   127     //   - "Tizen"
   128     var devicePlatform = device.platform;
   131 ### Особенности Windows Phone 7
   133 Windows Phone 7 устройства сообщают платформу как `WinCE`.
   135 ### Особенности Windows Phone 8
   137 Устройства Windows Phone 8 сообщают платформу как `Win32NT`.
   139 ## device.uuid
   141 Возвращает универсальный уникального идентификатора ([UUID][3] устройства).
   143  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
   145     var string = device.uuid;
   148 ### Описание
   150 Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.
   152 ### Поддерживаемые платформы
   154 *   Android
   155 *   BlackBerry 10
   156 *   iOS
   157 *   Tizen
   158 *   Windows Phone 7 и 8
   159 *   Windows 8
   161 ### Краткий пример
   163     // Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!) 
   164     // целое число генерируется при первой загрузке устройства 
   165     //
   166     // BlackBerry: Возвращает номер PIN устройства 
   167     // это 9 значный уникальный целочисленный (как строка, хотя!) 
   168     // 
   169     // iPhone: (Перефразировано из документации класса UIDevice) 
   170     // возвращает строку хэш-значения, созданные из нескольких аппаратных определяет.
   171     // Это значение гарантированно является уникальным для каждого устройства и не может быть привязано 
   172     // к учетной записи пользователя.
   173     // Windows Phone 7: Возвращает хэш устройство + текущего пользователя, 
   174     // если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться 
   175     // Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число 
   176     // уникальное для каждого мобильного телефона GSM и UMTS.
   177     var deviceID = device.uuid;
   180 ### Особенности iOS
   182 На iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным.
   184 ### Особенности Windows Phone 7 и 8
   186 Для Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.
   188 ## device.version
   190 Возвращает версию операционной системы.
   192     var string = device.version;
   195 ### Поддерживаемые платформы
   197 *   Android 2.1 +
   198 *   BlackBerry 10
   199 *   Обозреватель
   200 *   iOS
   201 *   Tizen
   202 *   Windows Phone 7 и 8
   203 *   Windows 8
   205 ### Краткий пример
   207     // Android:    Froyo OS would return "2.2"
   208     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
   209     //             Version can also return update level "2.1-update1"
   210     //
   211     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
   212     //
   213     // Browser:    Returns version number for the browser
   214     //
   215     // iPhone:     iOS 3.2 returns "3.2"
   216     //
   217     // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
   218     // Tizen: returns "TIZEN_20120425_2"
   219     var deviceVersion = device.version;

mercurial