Implementa constantes y primitivas

El HAL del vibrador define las constantes y primitivas táctiles, y el framework de Android las asigna a las APIs públicas. Realiza estas verificaciones para determinar si tu dispositivo cumple con los requisitos mínimos para implementar la tecnología táctil:

Figura 2: Implementa efectos

Figura 3: Cómo implementar primitivas

Implementa constantes

Los desarrolladores pueden usar las constantes táctiles en VibrationEffect a través de VibrationEffect.createPredefined(). Verifica el estado de implementación de las siguientes constantes táctiles.

Constantes táctiles	Ubicaciones y resúmenes
EFFECT_TICK, EFFECT_CLICK, EFFECT_HEAVY_CLICK, EFFECT_DOUBLE_CLICK	Clase VibrationEffect Las constantes táctiles en VibrationEffect no incluyen ninguna noción de eventos de entrada ni tienen elementos de IU. En cambio, las constantes incluyen la noción de niveles de energía, como EFFECT_CLICK y EFFECT_HEAVY_CLICK, a los que llama createPredefined().

Las vibraciones alternativas que se describen a continuación se realizan en dispositivos que no implementan las constantes VibrationEffect. Se recomienda actualizar estos parámetros de configuración para obtener el mejor rendimiento en esos dispositivos.

• EFFECT_CLICK

  Vibración de forma de onda creada con VibrationEffect.createWaveform y los tiempos configurados en frameworks/base/core/res/res/values/config.xml##config_virtualKeyVibePattern.

• EFFECT_HEAVY_CLICK

  Vibración de forma de onda creada con VibrationEffect.createWaveform y los tiempos configurados en frameworks/base/core/res/res/values/config.xml##config_longPressVibePattern.

  • EFFECT_DOUBLE_CLICK

  Vibración de forma de onda creada con VibrationEffect.createWaveform y los tiempos (0, 30, 100, 30).

• EFFECT_TICK

  Vibración de forma de onda creada con VibrationEffect.createWaveform y los tiempos configurados en frameworks/base/core/res/res/values/config.xml##config_clockTickVibePattern.

Figura 4: Cómo implementar constantes de comentarios

Los desarrolladores pueden usar las constantes táctiles de HapticFeedbackConstants a través de View.performHapticFeedback(). Verifica el estado de las siguientes constantes de comentarios públicos.

Constantes táctiles	Ubicaciones y resúmenes
CLOCK_TICK, CONTEXT_CLICK, KEYBOARD_PRESS, KEYBOARD_RELEASE, KEYBOARD_TAP, LONG_PRESS, TEXT_HANDLE_MOVE, VIRTUAL_KEY, VIRTUAL_KEY_RELEASE, CONFIRM, REJECT, GESTURE_START, GESTURE_END	Las constantes táctiles de la clase HapticFeedbackConstants ayudan a los eventos de entrada con ciertos elementos de la IU, como KEYBOARD_PRESS y KEYBOARD_RELEASE, a los que llama performHapticFeedback(). HapticFeedbackConstants

Implementa primitivas

Las primitivas táctiles en VibrationEffect.Composition tienen una intensidad escalable que los desarrolladores pueden usar a través de addPrimitive(int primitiveId, float scale, int delay). Las primitivas se pueden dividir en dos categorías:

• Primitivas cortas: Son primitivas con una duración corta, por lo general, inferior a 20 ms. Estas son CLICK, TICK y LOW_TICK.

• Primitivos de chirrido: Son primitivos con amplitud y frecuencia variables, por lo general, con una duración más larga que los primitivos cortos. Estos son SLOW_RISE, QUICK_RISE, QUCK_FALL, THUD y SPIN.

Primitivos cortos

Las primitivas cortas se pueden describir con el perfil de aceleración de salida del motor del vibrador. La frecuencia absoluta que se usa varía para cada primitiva, según la frecuencia resonante del actuador. Consulta Cómo configurar el equipo de prueba para obtener más información sobre la configuración de hardware y las herramientas para medir el resultado.

Una métrica de calidad valiosa para las vibraciones cortas es la relación pulso a timbre (PRR), que se muestra en la Figura 5. El PRR se define como la relación entre el pulso principal, que se define por la señal dentro de la ventana de duración en la que la amplitud disminuye al 10% de la amplitud máxima, y el pulso de anillo, que se define por la señal en la que la amplitud disminuye del 10% de la amplitud máxima a menos del 1% de la amplitud máxima. La fórmula del PRR es la siguiente:

Para obtener más información sobre la PRR, consulta Cómo analizar la forma de onda y, para obtener más información sobre cómo analizar y comparar los resultados, consulta Cómo comparar los resultados con el mapa de rendimiento.

Figura 5: Definición de la proporción de pulso a timbre

Aplica primitivas cortas como comentarios de entrada del usuario o reprodúcelas en composiciones más largas para crear texturas suaves. Esto significa que, por lo general, se activan con frecuencia y se reproducen en rápida sucesión. La intensidad percibida de una sola primitiva corta puede aumentar la intensidad del efecto más grande. Por este motivo, mide una sola marca o una primitiva de marca baja con una composición más grande, por ejemplo, 100 marcas consecutivas.

Primitiva de clic

La primitiva de clic es un efecto fuerte y nítido que suele funcionar cerca de la frecuencia resonante de un dispositivo para alcanzar una salida máxima en un período breve. Es más fuerte y profunda que las otras primitivas, y funciona con la máxima intensidad.

Si está disponible, usa la sobremarcha del motor al principio y el frenado activo al final para lograr un tiempo de ascenso y descenso del motor corto. En algunos motores, usar una onda cuadrada en lugar de una sinusoidal puede lograr una aceleración más rápida. En la Figura 6, se muestra un ejemplo de perfil de aceleración de salida para la primitiva de clic:

Figura 6: Ejemplo de perfil de aceleración de salida para la primitiva de clic

Parámetro	Guideline
Duración	Objetivo: 12 ms Límite: < 30 ms
Aceleración máxima de salida	Objetivo: 2 G Límite: > 1 G
Frecuencia	Aproximadamente a la frecuencia resonante

Primitive de marca (marca clara)

La primitiva de marca es un efecto agudo y corto que suele funcionar en un rango de frecuencia más alto. Esta primitiva también se puede describir como un clic de intensidad media con una frecuencia más alta y una cola corta. La misma guía se aplica para lograr un tiempo de ascenso corto con sobretensión del motor o una onda cuadrada para el inicio inicial y el frenado activo en el desplazamiento. En la figura 7, se muestra un ejemplo de perfil de aceleración de salida para la primitiva de marca de tiempo:

Figura 7: Ejemplo de perfil de aceleración de salida para la primitiva de marca

Parámetro	Guideline
Duración	Objetivo: 5 ms Límite: Menos de 20 ms
Aceleración máxima de salida	Objetivo: La mitad de CLICK, 1 G Límite: Entre 0.5 G y 1 G
Frecuencia	Objetivo: 2 veces la frecuencia resonante Límite: < 500 Hz

Primitiva de marca baja

La primitiva de tick bajo es una versión más suave y débil de un tick claro, que funciona en un rango de frecuencia más bajo para proporcionar más cuerpo al efecto. Esta primitiva también se puede describir como un clic de intensidad media con una frecuencia más baja, que se usa de forma repetitiva para obtener comentarios dinámicos. La misma guía se aplica para lograr un tiempo de ascenso corto con la sobrecarga del motor o una onda cuadrada para el inicio inicial. En la Figura 8, se muestra un ejemplo de perfil de aceleración de salida para la primitiva de tick bajo:

Figura 8: Ejemplo de perfil de aceleración de salida para primitiva de tick bajo

Parámetro	Guideline
Duración	Objetivo: 12 ms Límite: < 30 ms
Aceleración máxima de salida	Objetivo: 1/4 de TICK, 0.25 G Límite: Entre 0.2 G y 0.5 G
Frecuencia	Objetivo: Frecuencia resonante de 2/3 Límite: < 100 Hz

Primitivas de Chirp

Las primitivas de chirrido se pueden describir con los indicadores de entrada para el nivel de voltaje y la frecuencia de vibración. La aceleración que el motor puede generar en diferentes rangos de frecuencia varía según la curva de respuesta de frecuencia del actuador. Los rangos de frecuencia y los niveles de voltaje deben ajustarse por dispositivo.

Primitivo de aumento lento

El aumento lento es un barrido lento de amplitud y frecuencia hacia arriba con un inicio suave y una intensidad de vibración que aumenta de forma constante durante el barrido. Se puede implementar mediante un barrido coherente de la amplitud y la frecuencia, con un rango de frecuencia más bajo que funciona fuera de la resonancia. En la Figura 9, se muestran los parámetros de entrada y un ejemplo de perfil de aceleración de salida para esta implementación. (La línea roja coincide con las etiquetas de amplitud de la izquierda y representa cómo varía la amplitud de la vibración con el tiempo. La línea azul coincide con las etiquetas de frecuencia de la derecha y representa cómo varía la frecuencia de vibración con el tiempo.

Figura 9: Parámetros de entrada y ejemplo de perfil de aceleración de salida para la primitiva de aumento lento

Si la respuesta de frecuencia del motor es limitada (no es lo suficientemente fuerte fuera de su frecuencia resonante), una implementación alternativa es un barrido de seno de 1/2x a 1x la frecuencia resonante. La resonancia del motor contribuye a alcanzar el pico de señal al final.

Parámetro	Guideline
Duración	Objetivo: 500 ms Tolerancia: 20 ms
Aceleración máxima de salida	Objetivo: 0.5 G Límite: Entre 0.5 G y 1 G
Frecuencia	Objetivo: De 1/2 a 2/3 de la frecuencia resonante Alternativa: 1/2 a la frecuencia resonante

Primitive de aumento rápido

El aumento rápido es un barrido de amplitud y frecuencia más rápido hacia arriba con un inicio suave y una intensidad de vibración que aumenta de forma constante durante el barrido. Los objetivos de frecuencia de vibración y aceleración de salida deben ser los mismos que los de la primitiva de aumento lento, que se logra en una duración más corta. En la Figura 10, se muestran los parámetros de entrada de vibración y un ejemplo de perfil de aceleración de salida para la primitiva de aumento lento. (La línea roja coincide con las etiquetas de amplitud de la izquierda y representa cómo varía la amplitud de la vibración con el tiempo. La línea azul coincide con las etiquetas de frecuencia de la derecha y representa cómo varía la frecuencia de vibración con el tiempo.

Figura 10: Parámetros de entrada y ejemplo de perfil de aceleración de salida para la primitiva de aumento rápido

Parámetro	Guideline
Duración	Objetivo: 150 ms Tolerancia: 20 ms
Aceleración máxima de salida	Segmentación: Igual que en SLOW_RISE Límite: Igual que SLOW_RISE
Frecuencia	Segmentación: Igual que en SLOW_RISE Alternativa: Igual que SLOW_RISE

Primitive de caída rápida

La caída rápida es un barrido descendente rápido de amplitud y frecuencia con un inicio suave. Puedes usar una frecuencia más alta como punto de partida mientras el motor se acelera para alcanzar la aceleración de salida máxima. La frecuencia debe disminuir de manera coherente durante el barrido, incluso durante el tiempo de ascenso. En la figura 11, se muestran los parámetros de entrada y un ejemplo de perfil de aceleración de salida para esta implementación. (La línea roja coincide con las etiquetas de amplitud de la izquierda y representa cómo varía la amplitud de la vibración con el tiempo. La línea azul coincide con las etiquetas de frecuencia de la derecha y representa cómo varía la frecuencia de vibración con el tiempo.

Figura 11: Parámetros de entrada y ejemplo de perfil de aceleración de salida para la primitiva de caída rápida

Parámetro	Guideline
Duración	Objetivo: 100 ms Tolerancia: 20 ms
Aceleración máxima de salida	Objetivo: 1 G Límite: Entre 0.5 G y 2 G
Frecuencia	Objetivo: De 2 a 1 veces la frecuencia resonante

Primitiva Thud

El golpe es un efecto percusivo bajo y sordo que simula la sensación física de golpear madera hueca. Esta primitiva opera en un rango de frecuencia baja, similar a la primitiva de tic bajo, para proporcionar más cuerpo al efecto. Puedes implementar la primitiva de golpe como un barrido descendente de amplitud y frecuencia en un rango de frecuencia más bajo (preferentemente, menos de 100 Hz). En la Figura 12, se muestran los parámetros de entrada y un ejemplo de perfil de aceleración de salida para esta implementación. (La línea roja coincide con las etiquetas de amplitud de la izquierda y representa cómo varía la amplitud de la vibración con el tiempo. La línea azul coincide con las etiquetas de frecuencia de la derecha y representa cómo varía la frecuencia de vibración con el tiempo.

Figura 12: Parámetros de entrada y ejemplo de perfil de aceleración de salida para la primitiva de golpe

Si la respuesta de frecuencia del motor es limitada, una implementación alternativa es comenzar con una señal de accionamiento de intensidad completa en la frecuencia resonante y bajar a la frecuencia más baja posible que aún se pueda percibir. Es posible que este enfoque requiera un aumento de la intensidad de la señal de accionamiento en la frecuencia más baja para que se sienta la vibración.

Parámetro	Guideline
Duración	Objetivo: 300 ms Tolerancia: 20 ms
Aceleración máxima de salida	Objetivo: 0.25 G Límite: Entre 0.2 G y 0.5 G
Frecuencia	Objetivo: De 1/2 a 1/3 de la frecuencia resonante Alternativa: De 1 a 1/2 de la frecuencia resonante

Primitiva de giro

El giro simula un momento de giro rápido hacia arriba y hacia abajo con un ligero acento en el centro. Para implementar el giro, se debe barrer la amplitud y la frecuencia de forma independiente, en direcciones opuestas y, luego, seguir con el movimiento inverso. Es importante usar un rango de frecuencia más bajo (preferentemente inferior a 100 Hz). En la Figura 13, se muestran los parámetros de entrada y un ejemplo de perfil de aceleración de salida para esta implementación. (La línea roja coincide con las etiquetas de amplitud de la izquierda y representa cómo varía la amplitud de la vibración con el tiempo. La línea azul coincide con las etiquetas de frecuencia de la derecha y representa cómo varía la frecuencia de vibración con el tiempo.

Recomendamos que se llame a la primitiva de giro dos veces seguidas o tres veces en las composiciones para lograr una sensación de giro y de inestabilidad.

Si la respuesta de frecuencia del motor es limitada, una implementación alternativa es realizar un barrido de seno rápido de 1/2x a 1x la frecuencia resonante y viceversa. La resonancia del motor le da automáticamente un acento al medio de la señal.

Figura 13: Parámetros de entrada y ejemplo de perfil de aceleración de salida para la primitiva de giro

Parámetro	Guideline
Duración	Objetivo: 150 ms Tolerancia: 20 ms
Aceleración máxima de salida	Objetivo: 0.5 G Límite: Entre 0.25 G y 0.75 G
Frecuencia	Objetivo: De 2/3 a 1/3 y, luego, a 1/2 de la frecuencia resonante Alternativa: de 2/3 a 1x y, luego, a 1/2 de la frecuencia resonante