VibrationEffect.WaveformEnvelopeBuilder 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écrit par son enveloppe.
[Android.Runtime.Register("android/os/VibrationEffect$WaveformEnvelopeBuilder", ApiSince=36, DoNotGenerateAcw=true)]
public sealed class VibrationEffect.WaveformEnvelopeBuilder : Java.Lang.Object[<Android.Runtime.Register("android/os/VibrationEffect$WaveformEnvelopeBuilder", ApiSince=36, DoNotGenerateAcw=true)>]
type VibrationEffect.WaveformEnvelopeBuilder = class
inherit Object- Héritage
- Attributs
Remarques
Générateur d’effets de forme d’onde décrit par son enveloppe.
Les enveloppes d’effet de forme d’onde sont définies par un ou plusieurs points de contrôle décrivant une amplitude et une fréquence de vibration cibles, et une durée pour atteindre ces cibles. Le vibreur effectue des transitions lisses entre les points de contrôle.
Par exemple, le code suivant met à l’écart un vibrateur de l’amplitude totale à 120Hz sur 100 ms, conserve cet état pour 200 ms, puis remonte à plus de 100 ms :
{@code
VibrationEffect effect = new VibrationEffect.WaveformEnvelopeBuilder()
.addControlPoint(1.0f, 120f, 100)
.addControlPoint(1.0f, 120f, 200)
.addControlPoint(0.0f, 120f, 100)
.build();
}
Le générateur démarre automatiquement tous les effets à 0 amplitude.
Il est essentiel de s’assurer que la plage de fréquences utilisée dans votre effet est compatible avec les fonctionnalités de l’appareil. L’infrastructure ne joue pas de fréquences qui tombent partiellement ou complètement en dehors de la plage prise en charge de l’appareil. Elle ne tentera pas non plus de corriger ou de modifier ces fréquences.
Par conséquent, il est fortement recommandé de concevoir vos effets haptiques avec le profil de fréquence de l’appareil à l’esprit. Vous pouvez obtenir la plage de fréquences prise en charge et d’autres informations pertinentes relatives à la fréquence en obtenant la android.os.vibrator.VibratorFrequencyProfileVibrator#getFrequencyProfile() méthode.
En plus de ces limitations, lors de la conception de modèles de vibration, il est important de prendre en compte les limitations physiques de l’actionneur de vibration. Ces limitations incluent des facteurs tels que le nombre maximal de points de contrôle autorisés dans un effet d’enveloppe, les durées minimales et maximales autorisées pour chaque point de contrôle et la durée globale maximale de l’effet. 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.
Vous pouvez utiliser les API suivantes pour obtenir les limites suivantes : <ul><li>Maximum de points de contrôle d’enveloppe : duréeVibratorEnvelopeEffectInfo#getMaxSize()minimale du point de contrôle : <>VibratorEnvelopeEffectInfo#getMinControlPointDurationMillis()<durée>maximale du point VibratorEnvelopeEffectInfo#getMaxControlPointDurationMillis()<de contrôle : li>Durée maximale de l’effet : VibratorEnvelopeEffectInfo#getMaxDurationMillis()</ul>
Java documentation pour android.os.VibrationEffect.WaveformEnvelopeBuilder.
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.WaveformEnvelopeBuilder() |
Initialise une nouvelle instance de la classe VibrationEffect.WaveformEnvelopeBuilder. |
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écrit par son enveloppe. (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. Amplitude définit la force du vibrateur à cette fréquence, allant de 0 (off) à 1 (force maximale réalisable). |
| Build() |
Générez la forme d’onde en tant que vibrationEffect unique. L’objet WaveformEnvelopeBuilder 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 cette méthode à nouveau. |
| 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écrit par son enveloppe. (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écrit par son enveloppe. (Hérité de JavaObject) |
| Equals(Object) |
Générateur d’effets de forme d’onde décrit par son enveloppe. (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) |
| SetInitialFrequencyHz(Single) |
Définit la fréquence initiale de la forme d’onde dans Hertz. L’effet commence à vibrer à cette fréquence lorsqu’il passe à l’amplitude et à la fréquence définie par le premier point de contrôle. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Générateur d’effets de forme d’onde décrit par son enveloppe. (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écrit par son enveloppe. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Générateur d’effets de forme d’onde décrit par son enveloppe. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Générateur d’effets de forme d’onde décrit par son enveloppe. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Générateur d’effets de forme d’onde décrit par son enveloppe. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Générateur d’effets de forme d’onde décrit par son enveloppe. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Générateur d’effets de forme d’onde décrit par son enveloppe. (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écrit par son enveloppe. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |