VibrationEffect.BasicEnvelopeBuilder Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen.
[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- Vererbung
- Attribute
Hinweise
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen.
Dieser Generator vereinfacht die Erstellung von Wellenformeffekten, indem sie automatisch auf unterschiedlichen Geräten basierend auf ihren Funktionen angepasst werden. Effekte werden durch Kontrollpunkte definiert, die die Zielschwingungsintensität und -schärfe angeben, zusammen mit der Dauer, um diese Ziele zu erreichen. Der Vibrationsor wechselt reibungslos zwischen diesen Kontrollpunkten.
<b>Intensität:</b> Definiert die Gesamtfestigkeit der Vibration, von 0 (aus) bis 1 (maximal erreichbare Stärke). Höhere Werte führen zu stärkeren Vibrationen. Unterstützte Intensitätswerte garantieren Vertraulichkeitsstufen (SL) über 10 dB SL, um die menschliche Wahrnehmung sicherzustellen.
<b>Schärfe:</b> Definiert die Schärfe der Vibration, von 0 bis 1. Niedrigere Werte erzeugen glattere Vibrationen, während höhere Werte ein schärferes, andockigeres Gefühl erzeugen. Die Schärfe wird der entsprechenden Frequenz innerhalb des unterstützten Frequenzbereichs des Geräts zugeordnet.
Während dieser Generator den größten Teil der Anpassungslogik verarbeitet, kommt es zu einigen Einschränkungen: <ul><li>Es kann nicht den vollen Frequenzbereich</li li><>Verwenden Es ist auf einen Frequenzbereich beschränkt, der die Ausgabe von mindestens 10 db SL</li Li><>Effects erzeugen kann, muss mit einem Nullintensitätskontrollpunkt enden. Wenn sie nicht an einem Kontrollpunkt der Nullintensität enden, führt dies zu einem IllegalStateException.</li></ul>
Der Generator startet automatisch alle Effekte mit 0 Intensität.
Um diese Einschränkungen zu vermeiden und mehr Kontrolle über die Ausgabe der Effekte zu haben, verwenden Sie WaveformEnvelopeBuilder, wo direkte Amplitude und Frequenzwerte verwendet werden können.
Für eine optimale geräteübergreifende Konsistenz wird empfohlen, die Anzahl der Kontrollpunkte auf maximal 16 zu beschränken. Dies ist jedoch nicht obligatorisch, und wenn ein Muster die maximale Anzahl zulässiger Kontrollpunkte überschreitet, wird der Effekt automatisch vom Framework getrennt, um sicherzustellen, dass es ordnungsgemäß wiedergegeben wird.
Der folgende Code erstellt z. B. einen Vibrationseffekt, der die Intensität von einer niedrigen Neigung bis zu einer starken Schwingung über 500 ms hoch annimmt und dann auf 0 (aus) über 100 ms hochgestippt:
{@code
VibrationEffect effect = new VibrationEffect.BasicEnvelopeBuilder()
.setInitialSharpness(0.0f)
.addControlPoint(1.0f, 1.0f, 500)
.addControlPoint(0.0f, 1.0f, 100)
.build();
}
Java Dokumentation für android.os.VibrationEffect.BasicEnvelopeBuilder.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| VibrationEffect.BasicEnvelopeBuilder() |
Initialisiert eine neue Instanz der VibrationEffect.BasicEnvelopeBuilder-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| JniPeerMembers |
Stellt JNI-Peer-Membermetadaten für diesen Typ bereit. |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
Methoden
| Name | Beschreibung |
|---|---|
| AddControlPoint(Single, Single, Int64) |
Fügt am Ende dieses Wellenformumschlags einen neuen Kontrollpunkt hinzu. Die Intensität definiert die Gesamtfestigkeit der Vibration, von 0 (aus) bis 1 (maximal erreichbare Stärke). |
| Build() |
Erstellen Sie die Wellenform als einzelne VibrationEffect . Das BasicEnvelopeBuilder-Objekt ist nach diesem Aufruf weiterhin gültig, sodass Sie weitere Grundtypen hinzufügen und weitere VibrationEffect-Objekte generieren können, indem Sie diese Methode erneut aufrufen. |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| Equals(Object) |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetInitialSharpness(Single) |
Legt die anfängliche Schärfe für den grundlegenden Umschlageffekt fest. Der Effekt beginnt bei dieser Schärfe zu vibrieren, wenn er zu der Intensität und Schärfe wechselt, die durch den ersten Kontrollpunkt definiert wird. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| IJavaPeerable.Finalized() |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. (Geerbt von JavaObject) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Ein Generator für Wellenformeffekte, die durch ihren Umschlag definiert wurden, um eine konsistente haptische Wahrnehmung auf allen Geräten mit unterschiedlichen Funktionen zu ermöglichen. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |