VibrationEffect.Builder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos.
[Android.Runtime.Register("android/os/VibrationEffect$Builder", ApiSince=37, DoNotGenerateAcw=true)]
public sealed class VibrationEffect.Builder : Java.Lang.Object[<Android.Runtime.Register("android/os/VibrationEffect$Builder", ApiSince=37, DoNotGenerateAcw=true)>]
type VibrationEffect.Builder = class
inherit Object- Herencia
- Atributos
Comentarios
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos.
Esta API es la alternativa preferida a VibrationEffect.Composition para crear efectos de vibración complejos. Ofrece más flexibilidad para crear patrones hápticos al permitir que varios elementos se programen en puntos específicos de una escala de tiempo.
Este generador permite agregar sobres, valores preestablecidos y VibrationEffects existentes (como eventos) para crear una forma de onda compleja. Cada elemento se agrega con un startTimeMillis especificado. Tenga en cuenta que el uso de VibrationEffects heredado no se recomienda aquí.
Además, se puede establecer una parte de repetición mediante setRepeatingEffect(long,VibrationEffect,long). Una vez establecido un efecto de repetición, no se pueden agregar más elementos hápticos a la composición.
Compatibilidad con reserva: las vibraciones creadas por este generador proporcionarán compatibilidad con reserva si el dispositivo no admite los elementos hápticos solicitados.
Tenga en cuenta que no se proporciona compatibilidad con reserva para efectos de sobre creados por WaveformEnvelopeBuilder, incluso cuando se agregan a este generador. Para tales efectos, si el dispositivo no admite efectos PWLE o las frecuencias solicitadas, la vibración no se reproducirá.
Para obtener más información sobre el fondo de la implementación de hápticos y cómo los OEM admiten estos efectos, consulte las Directrices de implementación de hápticos de Android.
Tiempo y alineación: startTimeMillis es el tiempo en milisegundos desde el principio de la composición que se está compilando. Los elementos deben agregarse en orden creciente de sus horas de inicio.
El marco proporciona compatibilidad con el tiempo de mejor esfuerzo durante la reproducción. Si se sigue reproduciendo un evento anterior cuando se alcanza la hora de inicio especificada del evento siguiente, el marco cambiará automáticamente el siguiente evento a la siguiente ranura más antigua. Esto garantiza que no se quita ningún comentario háptico y los eventos no se superponen en la reproducción real (se reproducirán secuencialmente en su lugar).
Sin embargo, este cambio automático puede introducir el desfase de tiempo. Para asegurarse de que el tiempo de reproducción real se alinea lo más cerca posible de la escala de tiempo especificada, el generador realiza la validación del mejor esfuerzo en tiempo de compilación para ayudarle a evitar que los elementos de programación estén demasiado cerca. Esta validación usa duraciones conocidas de algunos elementos (como sobres) o una duración mínima (1 ms) para elementos dependientes del dispositivo (como valores preestablecidos). Si se detecta una superposición potencial en tiempo de compilación, se produce una excepción IllegalArgumentException.
Dado que la duración real de algunos elementos solo es totalmente conocida en tiempo de ejecución en el dispositivo físico, los desarrolladores deben seguir teniendo en cuenta al secuenciar elementos con duraciones variables para garantizar la mejor alineación entre el tiempo de reproducción diseñado y real.
Referencia de Android para android.os.VibrationEffect.Builder.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| VibrationEffect.Builder() |
Crea un Generador vacío para componer un nuevo Objeto VibrationEffect. |
| VibrationEffect.Builder(VibrationEffect) |
Crea un Generador inicializado con una copia de un objeto VibrationEffect existente. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| JniPeerMembers |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object) |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object) |
Métodos
| Nombre | Description |
|---|---|
| AddEnvelope(Int64, VibrationEffect+Envelope) |
Agrega un sobre háptico a la composición. |
| AddEvents(Int64, IList<VibrationEffect.Event>) |
Agrega una lista de eventos existentes a la composición. |
| AddPreset(Int64, VibrationEffect+Preset) |
Agrega un valor preestablecido háptico predefinido a la composición. |
| Build() |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| Equals(Object) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| GetHashCode() |
Devuelve un valor de código hash del objeto. (Heredado de Object) |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| SetRepeatingEffect(Int64, VibrationEffect, Int64) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto. (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierta, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| IJavaPeerable.Finalized() |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. (Heredado de JavaObject) |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Generador para componer efectos hápticos mediante la secuenciación de varios elementos hápticos. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |