VibrationEffect.BasicEnvelopeBuilder Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités.
[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- Héritage
- Attributs
Remarques
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités.
Ce générateur simplifie la création d’effets de forme d’onde en les adaptant automatiquement à différents appareils en fonction de leurs fonctionnalités. Les effets sont définis par des points de contrôle spécifiant l’intensité et la netteté des vibrations cibles, ainsi que des durées pour atteindre ces cibles. Le vibreur passe en douceur entre ces points de contrôle.
<intensité b>:</b> Définit la force globale de la vibration, allant de 0 (off) à 1 (force maximale réalisable). Des valeurs plus élevées entraînent des vibrations plus fortes. Les valeurs d’intensité prises en charge garantissent des niveaux de sensibilité (SL) supérieurs à 10 dB SL pour garantir la perception humaine.
<b>Sharpness :</b> Définit la netteté de la vibration, allant de 0 à 1. Les valeurs inférieures produisent des vibrations plus lisses, tandis que les valeurs plus élevées créent une sensation plus nette et plus snappy. La netteté est mappée à sa fréquence équivalente dans la plage de fréquences prise en charge de l’appareil.
Bien que ce générateur gère la plupart de la logique d’adaptation, il présente certaines limitations : <ul><li>Il peut ne pas utiliser la plage complète de fréquences</li li><>Il est limité à une plage de fréquences qui peut générer la sortie d’au moins 10 db SL</li Effets doivent><>se terminer par un point de contrôle d’intensité zéro. L’échec de la fin à un point de contrôle d’intensité zéro entraîne un IllegalStateException.</li></ul>
Le générateur démarre automatiquement tous les effets à 0 intensité.
Pour éviter ces limitations et avoir plus de contrôle sur la sortie des effets, utilisez WaveformEnvelopeBuilder, où les valeurs d’amplitude directe et de fréquence peuvent être utilisées.
Pour une cohérence optimale entre appareils, il est recommandé de limiter le nombre de points de contrôle à un maximum de 16. Toutefois, cela n’est pas obligatoire et si un modèle dépasse le nombre maximal de points de contrôle autorisés, l’infrastructure décompose automatiquement l’effet pour s’assurer qu’il joue correctement.
Par exemple, le code suivant crée un effet de vibration qui accélère l’intensité d’une vibration basse à une vibration forte haute sur 500 ms, puis la descend jusqu’à 0 (off) sur 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 documentation pour android.os.VibrationEffect.BasicEnvelopeBuilder.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| VibrationEffect.BasicEnvelopeBuilder() |
Initialise une nouvelle instance de la classe VibrationEffect.BasicEnvelopeBuilder. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| JniPeerMembers |
Fournit des métadonnées de membre homologue JNI pour ce type. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object) |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object) |
Méthodes
| Nom | Description |
|---|---|
| AddControlPoint(Single, Single, Int64) |
Ajoute un nouveau point de contrôle à la fin de cette enveloppe de forme d’onde. L’intensité définit la force globale de la vibration, allant de 0 (off) à 1 (force maximale réalisable). |
| Build() |
Générez la forme d’onde en tant que vibrationEffect unique. L’objet BasicEnvelopeBuilder est toujours valide après cet appel. Vous pouvez donc continuer à y ajouter d’autres primitives et générer davantage de VibrationEffect en appelant à nouveau cette méthode. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| Equals(Object) |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetInitialSharpness(Single) |
Définit la netteté initiale pour l’effet d’enveloppe de base. L’effet commence à vibrer à cette netteté lorsqu’il passe à l’intensité et à la netteté définies par le premier point de contrôle. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. (Hérité de JavaObject) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Générateur d’effets de forme d’onde défini par leur enveloppe, conçu pour fournir une perception haptique cohérente entre les appareils avec différentes fonctionnalités. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |