Touchgui/plugins/org.apache.cordova.device/doc/es/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 Este plugin define un global `device` objeto que describe del dispositivo hardware y software. Aunque el objeto está en el ámbito global, no está disponible hasta después de la `deviceready` evento.
    24     document.addEventListener("deviceready", onDeviceReady, false);
    25     function onDeviceReady() {
    26         console.log(device.cordova);
    27     }
    30 ## Instalación
    32     cordova plugin add org.apache.cordova.device
    35 ## Propiedades
    37 *   device.cordova
    38 *   device.model
    39 *   device.platform
    40 *   device.uuid
    41 *   device.version
    43 ## device.cordova
    45 Obtener la versión de Cordova que se ejecuta en el dispositivo.
    47 ### Plataformas soportadas
    49 *   Amazon fire OS
    50 *   Android
    51 *   BlackBerry 10
    52 *   Explorador
    53 *   Firefox OS
    54 *   iOS
    55 *   Tizen
    56 *   Windows Phone 7 y 8
    57 *   Windows 8
    59 ## device.model
    61 El `device.model` devuelve el nombre de modelo del dispositivo o producto. El valor es fijado por el fabricante del dispositivo y puede ser diferente a través de versiones del mismo producto.
    63 ### Plataformas soportadas
    65 *   Android
    66 *   BlackBerry 10
    67 *   Explorador
    68 *   iOS
    69 *   Tizen
    70 *   Windows Phone 7 y 8
    71 *   Windows 8
    73 ### Ejemplo rápido
    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 ### Rarezas Android
    87 *   Obtiene el [nombre del producto][1] en lugar del [nombre de la modelo][2], que es a menudo el nombre de código de producción. Por ejemplo, el Nexus One devuelve `Passion` y Motorola Droid devuelve `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 ### Rarezas Tizen
    94 *   Devuelve que el modelo de dispositivo asignado por el proveedor, por ejemplo, `TIZEN`
    96 ### Windows Phone 7 y 8 rarezas
    98 *   Devuelve el modelo de dispositivo especificado por el fabricante. Por ejemplo, el Samsung Focus devuelve `SGH-i917`.
   100 ## device.platform
   102 Obtener el nombre del sistema operativo del dispositivo.
   104     var string = device.platform;
   107 ### Plataformas soportadas
   109 *   Android
   110 *   BlackBerry 10
   111 *   Browser4
   112 *   Firefox OS
   113 *   iOS
   114 *   Tizen
   115 *   Windows Phone 7 y 8
   116 *   Windows 8
   118 ### Ejemplo rápido
   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 rarezas
   133 Dispositivos Windows Phone 7 informe de la plataforma como `WinCE`.
   135 ### Windows Phone 8 rarezas
   137 Dispositivos Windows Phone 8 Informe la plataforma como `Win32NT`.
   139 ## device.uuid
   141 Obtener identificador universalmente única del dispositivo ([UUID][3]).
   143  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
   145     var string = device.uuid;
   148 ### Descripción
   150 Los detalles de cómo se genera un UUID son determinados por el fabricante del dispositivo y son específicos a la plataforma del dispositivo o modelo.
   152 ### Plataformas soportadas
   154 *   Android
   155 *   BlackBerry 10
   156 *   iOS
   157 *   Tizen
   158 *   Windows Phone 7 y 8
   159 *   Windows 8
   161 ### Ejemplo rápido
   163     // Android: devuelve un entero de 64 bits al azar (como una cadena, otra vez!) 
   164     // el entero es generado en el primer arranque del dispositivo 
   165     // 
   166     // BlackBerry: devuelve el número PIN del dispositivo 
   167     // este es un entero único de nueve dígitos (como una cadena, aunque!) 
   168     // 
   169     // iPhone: (parafraseado de la documentación de la clase UIDevice) 
   170     // devuelve una cadena de valores hash creado a partir 
   171     //  de múltiples hardware identifica.
   172     / / Está garantizado para ser único para cada dispositivo y no puede ser atado / / a la cuenta de usuario.
   173     // Windows Phone 7: devuelve un hash de dispositivo + usuario actual, 
   174     // si el usuario no está definido, un guid generado y persistirá hasta que se desinstala la aplicación 
   175     // 
   176     // Tizen: devuelve el dispositivo IMEI (identidad de equipo móvil internacional o IMEI es un número 
   177     // único para cada teléfono móvil GSM y UMTS.
   178     var deviceID = device.uuid;
   181 ### iOS chanfle
   183 El `uuid` en iOS no es exclusiva de un dispositivo, pero varía para cada aplicación, para cada instalación. Cambia si puedes borrar y volver a instalar la aplicación, y posiblemente también cuándo actualizar iOS, o incluso mejorar la aplicación por la versión (evidente en iOS 5.1). El `uuid` no es un valor confiable.
   185 ### Windows Phone 7 y 8 rarezas
   187 El `uuid` para Windows Phone 7 requiere el permiso `ID_CAP_IDENTITY_DEVICE`. Microsoft pronto probablemente desaprueban esta propiedad. Si la capacidad no está disponible, la aplicación genera un guid persistente que se mantiene durante la duración de la instalación de la aplicación en el dispositivo.
   189 ## device.version
   191 Obtener la versión del sistema operativo.
   193     var string = device.version;
   196 ### Plataformas soportadas
   198 *   Android 2.1 +
   199 *   BlackBerry 10
   200 *   Explorador
   201 *   iOS
   202 *   Tizen
   203 *   Windows Phone 7 y 8
   204 *   Windows 8
   206 ### Ejemplo rápido
   208     // Android:    Froyo OS would return "2.2"
   209     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
   210     //             Version can also return update level "2.1-update1"
   211     //
   212     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
   213     //
   214     // Browser:    Returns version number for the browser
   215     //
   216     // iPhone:     iOS 3.2 returns "3.2"
   217     //
   218     // Windows Phone 7: returns current OS version number, ex. el Mango se vuelve 7.10.7720 
   219     // Tizen: devuelve "TIZEN_20120425_2" 
   220     var deviceVersion = device.version;

mercurial