VibrationEffect.BasicEnvelopeBuilder Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas.
[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- Herança
- Atributos
Comentários
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas.
Esse construtor simplifica a criação de efeitos de forma de onda adaptando-os automaticamente a diferentes dispositivos com base em suas funcionalidades. Os efeitos são definidos por pontos de controle que especificam a intensidade e a nitidez da vibração de destino, juntamente com as durações para atingir esses destinos. O vibrador fará a transição suave entre esses pontos de controle.
<b>Intensidade:</b> Define a força geral da vibração, variando de 0 (desativado) a 1 (força máxima alcançável). Valores mais altos resultam em vibrações mais fortes. Valores de intensidade com suporte garantem níveis de confidencialidade (SL) acima de 10 dB SL para garantir a percepção humana.
<b>Nitidez:</b> Define a nitidez da vibração, variando de 0 a 1. Valores mais baixos produzem vibrações mais suaves, enquanto valores mais altos criam uma sensação mais nítida e rápida. A nitidez é mapeada para sua frequência equivalente dentro do intervalo de frequência com suporte do dispositivo.
Embora esse construtor lide com a maior parte da lógica de adaptação, ele vem com algumas limitações: ul<li Ele pode não usar a gama completa de frequências>/li<>li<É restrito a um intervalo de frequência que pode gerar saída de pelo menos 10 db SL>/li<><Efeitos deve terminar com um ponto de controle de intensidade zero.><> Falha ao terminar em um ponto de controle de intensidade zero resultará em um IllegalStateException.</li></ul>
O construtor inicia automaticamente todos os efeitos em 0 intensidade.
Para evitar essas limitações e ter mais controle sobre a saída de efeitos, use WaveformEnvelopeBuilder, em que valores diretos de amplitude e frequência podem ser usados.
Para obter a consistência ideal entre dispositivos, é recomendável limitar o número de pontos de controle a um máximo de 16. No entanto, isso não é obrigatório e, se um padrão exceder o número máximo de pontos de controle permitidos, a estrutura dividirá automaticamente o efeito para garantir que ele seja executado corretamente.
Por exemplo, o código a seguir cria um efeito de vibração que aumenta a intensidade de um tom baixo para uma vibração forte de arremesso alto acima de 500ms e, em seguida, aumenta-a para 0 (off) ao longo de 100ms:
{@code
VibrationEffect effect = new VibrationEffect.BasicEnvelopeBuilder()
.setInitialSharpness(0.0f)
.addControlPoint(1.0f, 1.0f, 500)
.addControlPoint(0.0f, 1.0f, 100)
.build();
}
Java documentação para android.os.VibrationEffect.BasicEnvelopeBuilder.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Construtores
| Nome | Description |
|---|---|
| VibrationEffect.BasicEnvelopeBuilder() |
Inicializa uma nova instância da classe VibrationEffect.BasicEnvelopeBuilder. |
Propriedades
| Nome | Description |
|---|---|
| Class |
Retorna a classe de runtime deste |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| JniPeerMembers |
Fornece metadados de membro par JNI para esse tipo. |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| ThresholdClass |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object) |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object) |
Métodos
| Nome | Description |
|---|---|
| AddControlPoint(Single, Single, Int64) |
Adiciona um novo ponto de controle ao final deste envelope de forma de onda. A intensidade define a força geral da vibração, variando de 0 (desativado) a 1 (força máxima alcançável). |
| Build() |
Crie a forma de onda como um único VibrationEffect. O objeto BasicEnvelopeBuilder ainda é válido após essa chamada, portanto, você pode continuar adicionando mais primitivos a ele e gerando mais VibrationEffect chamando esse método novamente. |
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| Dispose() |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Dispose(Boolean) |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| DisposeUnlessReferenced() |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| Equals(Object) |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| JavaFinalize() |
Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object) |
| Notify() |
Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object) |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetInitialSharpness(Single) |
Define a nitidez inicial para o efeito envelope básico. O efeito começará a vibrar nessa nitidez quando fizer a transição para a intensidade e a nitidez definidas pelo primeiro ponto de controle. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IJavaPeerable.Disposed() |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| IJavaPeerable.Finalized() |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. (Herdado de JavaObject) |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Um construtor para efeitos de forma de onda definidos por seu envelope, projetado para fornecer uma percepção háptica consistente entre dispositivos com funcionalidades variadas. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |