VibrationEffect.BasicEnvelopeBuilder 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 de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades.
[Android.Runtime.Register("android/os/VibrationEffect$BasicEnvelopeBuilder", ApiSince=36, DoNotGenerateAcw=true)]
public sealed class VibrationEffect.BasicEnvelopeBuilder : Java.Lang.Object[<Android.Runtime.Register("android/os/VibrationEffect$BasicEnvelopeBuilder", ApiSince=36, DoNotGenerateAcw=true)>]
type VibrationEffect.BasicEnvelopeBuilder = class
inherit Object- Herencia
- Atributos
Comentarios
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades.
Este generador simplifica la creación de efectos de forma de onda al adaptarlos automáticamente a diferentes dispositivos en función de sus capacidades. Los efectos se definen mediante puntos de control que especifican la intensidad de vibración objetivo y la nitidez, junto con duraciones para alcanzar esos objetivos. El vibrador pasará suavemente entre estos puntos de control.
<b>Intensidad:</b> Define la fuerza general de la vibración, que va de 0 (off) a 1 (fuerza máxima factible). Los valores más altos dan lugar a vibraciones más fuertes. Los valores de intensidad admitidos garantizan niveles de sensibilidad (SL) superiores a 10 dB SL para garantizar la percepción humana.
<b>Sharpness:</b> Define la crispez de la vibración, que va de 0 a 1. Los valores inferiores producen vibraciones más suaves, mientras que los valores más altos crean una sensación más nítida y más rápida. La nitidez se asigna a su frecuencia equivalente dentro del intervalo de frecuencia admitido del dispositivo.
Aunque este generador controla la mayor parte de la lógica de adaptación, viene con algunas limitaciones: <ul><li>Es posible que no use el rango completo de frecuencias</li li><>Está restringido a un intervalo de frecuencias que puede generar la salida de al menos 10 db SL</li><>Li Effects debe terminar con un punto de control de intensidad cero. Si no finaliza en un punto de control de intensidad cero, se producirá una IllegalStateExceptionexcepción .</li></ul>
El generador inicia automáticamente todos los efectos a una intensidad 0.
Para evitar estas limitaciones y tener más control sobre la salida de los efectos, use WaveformEnvelopeBuilder, donde se pueden usar los valores de amplitud y frecuencia directas.
Para lograr una coherencia óptima entre dispositivos, se recomienda limitar el número de puntos de control a un máximo de 16. Sin embargo, esto no es obligatorio y, si un patrón supera el número máximo de puntos de control permitidos, el marco desglosará automáticamente el efecto para asegurarse de que se reproduce correctamente.
Por ejemplo, el código siguiente crea un efecto de vibración que aumenta la intensidad de un tono bajo a una vibración fuerte de alto tono en más de 500 ms y, a continuación, lo reduce a 0 (desactivado) a más de 100 ms:
{@code
VibrationEffect effect = new VibrationEffect.BasicEnvelopeBuilder()
.setInitialSharpness(0.0f)
.addControlPoint(1.0f, 1.0f, 500)
.addControlPoint(0.0f, 1.0f, 100)
.build();
}
Java documentación para android.os.VibrationEffect.BasicEnvelopeBuilder.
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.BasicEnvelopeBuilder() |
Inicializa una nueva instancia de la clase VibrationEffect.BasicEnvelopeBuilder. |
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 de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| JniPeerMembers |
Proporciona metadatos de miembro del mismo nivel de JNI para este tipo. |
| 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 |
|---|---|
| AddControlPoint(Single, Single, Int64) |
Agrega un nuevo punto de control al final de este sobre de forma de onda. La intensidad define la fuerza general de la vibración, que va de 0 (off) a 1 (fuerza máxima factible). |
| Build() |
Compile la forma de onda como un único VibrationEffect . El objeto BasicEnvelopeBuilder sigue siendo válido después de esta llamada, por lo que puede seguir agregando más primitivos a él y generando más VibrationEffect llamando a este método de nuevo. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (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 de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| Equals(Object) |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (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 para el 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) |
| SetInitialSharpness(Single) |
Establece la nitidez inicial para el efecto de sobre básico. El efecto comenzará a vibrar en esta nitidez cuando pase a la intensidad y la nitidez definidas por el primer punto de control. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| 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 despierte, 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 de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| IJavaPeerable.Finalized() |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Generador de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. (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 de efectos de forma de onda definidos por su sobre, diseñados para proporcionar una percepción háptica coherente en todos los dispositivos con distintas funcionalidades. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |