Touchgui/plugins/org.apache.cordova.vibration/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.vibration
    22 Este plugin se alinea con la vibración W3C especificación http://www.w3.org/TR/vibration/
    24 Este plugin proporciona una manera de vibrar el dispositivo.
    26 ## Instalación
    28     cordova plugin add org.apache.cordova.vibration
    31 ## Plataformas soportadas
    33 Navigator.Vibrate  
    34 Navigator.Notification.Vibrate - Amazon fuego OS - sistema operativo Android - BlackBerry 10 - Firefox - iOS - Windows Phone 7 y 8
    36 navigator.notification.vibrateWithPattern,  
    37 navigator.notification.cancelVibration - Android
    39 ## vibrar (recomendado)
    41 Esta función tiene tres diferentes funcionalidades basadas en los parámetros pasados a él.
    43 ### Estándar de vibrar
    45 Vibra el dispositivo para una cantidad dada de tiempo.
    47     navigator.vibrate(time)
    50 o
    52     navigator.vibrate([time])
    55 -**tiempo**: milisegundos a vibrar el dispositivo. *(Número)*
    57 #### Ejemplo
    59     // Vibrate for 3 seconds
    60     navigator.vibrate(3000);
    62     // Vibrate for 3 seconds
    63     navigator.vibrate([3000]);
    66 #### iOS rarezas
    68 *   **time**: ignora el tiempo especificado y vibra por un tiempo preestablecido.
    70     navigator.vibrate(3000); // 3000 is ignored
    72 #### Windows y rarezas de Blackberry
    74 *   **tiempo**: tiempo máximo es 5000ms (5s) y min tiempo 1ms
    76     navigator.vibrate(8000); // will be truncated to 5000
    78 ### Vibrar con un patrón (Android y Windows solamente)
    80 Vibra el dispositivo con un patrón determinado
    82     navigator.vibrate(pattern);   
    85 *   **patrón**: secuencia de duraciones (en milisegundos) que desea activar o desactivar el vibrador. *(Matriz de números)*
    87 #### Ejemplo
    89     // Vibrate for 1 second
    90     // Wait for 1 second
    91     // Vibrate for 3 seconds
    92     // Wait for 1 second
    93     // Vibrate for 5 seconds
    94     navigator.vibrate([1000, 1000, 3000, 1000, 5000]);
    97 ### Cancelar vibración (no soportada en iOS)
    99 Inmediatamente se cancela cualquier vibración actualmente en ejecución.
   101     navigator.vibrate(0)
   104 o
   106     navigator.vibrate([])
   109 o
   111     navigator.vibrate([0])
   114 Pasando en un parámetro de 0, una matriz vacía o una matriz con un elemento de valor 0 se cancelará cualquier vibraciones.
   116 ## *Notification.Vibrate (obsoleto)
   118 Vibra el dispositivo para una cantidad dada de tiempo.
   120     navigator.notification.vibrate(time)
   123 *   **tiempo**: milisegundos a vibrar el dispositivo. *(Número)*
   125 ### Ejemplo
   127     // Vibrate for 2.5 seconds
   128     navigator.notification.vibrate(2500);
   131 ### iOS rarezas
   133 *   **time**: ignora el tiempo especificado y vibra por un tiempo preestablecido.
   135         navigator.notification.vibrate();
   136         navigator.notification.vibrate(2500);   // 2500 is ignored
   139 ## *Notification.vibrateWithPattern (obsoleto)
   141 Vibra el dispositivo con un patrón determinado.
   143     navigator.notification.vibrateWithPattern(pattern, repeat)
   146 *   **patrón**: secuencia de duraciones (en milisegundos) que desea activar o desactivar el vibrador. *(Matriz de números)*
   147 *   **repito**: índice opcional en la matriz de patrón en el cual comenzar repitiendo (se repite hasta que se cancele), o -1 para la no repetición (por defecto). *(Número)*
   149 ### Ejemplo
   151     // Immediately start vibrating
   152     // vibrate for 100ms,
   153     // wait for 100ms,
   154     // vibrate for 200ms,
   155     // wait for 100ms,
   156     // vibrate for 400ms,
   157     // wait for 100ms,
   158     // vibrate for 800ms,
   159     // (do not repeat)
   160     navigator.notification.vibrateWithPattern([0, 100, 100, 200, 100, 400, 100, 800]);
   163 ## *Notification.cancelVibration (obsoleto)
   165 Inmediatamente se cancela cualquier vibración actualmente en ejecución.
   167     navigator.notification.cancelVibration()
   170 * Nota: debido a la alineación con la especificación del w3c, los métodos favoritos a ser eliminados

mercurial