VibrationEffect.WaveformEnvelopeBuilder Klasse

Definition

Namespace:: Android.OS

Assembly:: Mono.Android.dll

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, der durch seinen Umschlag beschrieben wird.

[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

Vererbung: Object

JavaObject

Object
VibrationEffect.WaveformEnvelopeBuilder

Attribute: RegisterAttribute

Hinweise

Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird.

Wellenformeffektumschläge werden durch einen oder mehrere Kontrollpunkte definiert, die eine Zielschwingungsampling und -frequenz beschreiben, und eine Dauer, um diese Ziele zu erreichen. Der Vibrationsor führt übergangsfreie Übergänge zwischen Kontrollpunkten durch.

Der folgende Code führt z. B. einen Vibror von off zu full amplitude bei 120Hz über 100 ms, hält diesen Zustand für 200 ms und führt dann zurück über 100 ms:

{@code
            VibrationEffect effect = new VibrationEffect.WaveformEnvelopeBuilder()
                .addControlPoint(1.0f, 120f, 100)
                .addControlPoint(1.0f, 120f, 200)
                .addControlPoint(0.0f, 120f, 100)
                .build();
            }

Der Generator startet automatisch alle Effekte bei 0 Amplitude.

Es ist wichtig, sicherzustellen, dass der in Ihrem Effekt verwendete Frequenzbereich mit den Funktionen des Geräts kompatibel ist. Das Framework gibt keine Frequenzen wieder, die teilweise oder vollständig außerhalb des unterstützten Bereichs des Geräts liegen. Es wird auch nicht versucht, diese Frequenzen zu korrigieren oder zu ändern.

Daher wird dringend empfohlen, ihre haptischen Effekte im Hinblick auf das Frequenzprofil des Geräts zu entwerfen. Sie können den unterstützten Frequenzbereich und andere relevante Frequenzinformationen abrufen, indem Sie die android.os.vibrator.VibratorFrequencyProfileVibrator#getFrequencyProfile() Methode verwenden.

Zusätzlich zu diesen Einschränkungen ist es wichtig, beim Entwerfen von Vibrationsmustern die physikalischen Einschränkungen des Vibrationsaktors zu berücksichtigen. Zu diesen Einschränkungen gehören Faktoren wie die maximale Anzahl von Kontrollpunkten, die in einem Umschlageffekt zulässig sind, die mindeste und maximale Dauer für jeden Kontrollpunkt und die maximale Gesamtdauer des Effekts. Wenn ein Muster die maximale Anzahl zulässiger Kontrollpunkte überschreitet, unterbricht das Framework automatisch den Effekt, um sicherzustellen, dass es ordnungsgemäß wiedergegeben wird.

Sie können die folgenden APIs verwenden, um diese Grenzwerte zu erhalten: ul<li Maximale Umschlagsteuerungspunkte:>< li Mindeststeuerungspunktdauer: >VibratorEnvelopeEffectInfo#getMaxSize()li<>Maximale Dauer des Kontrollpunkts:VibratorEnvelopeEffectInfo#getMinControlPointDurationMillis()< li>Maximale Gesamteffektdauer:VibratorEnvelopeEffectInfo#getMaxControlPointDurationMillis()< /ul>VibratorEnvelopeEffectInfo#getMaxDurationMillis()<>

Java Dokumentation für android.os.VibrationEffect.WaveformEnvelopeBuilder.

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.WaveformEnvelopeBuilder()	Initialisiert eine neue Instanz der VibrationEffect.WaveformEnvelopeBuilder-Klasse.

Eigenschaften

Name	Beschreibung
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
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, der durch seinen Umschlag beschrieben wird. (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. Amplitude definiert die Festigkeit des Vibrationsers bei dieser Frequenz, von 0 (aus) bis 1 (maximal erreichbare Stärke).
Build()	Erstellen Sie die Wellenform als einzelne VibrationEffect . Das WaveformEnvelopeBuilder-Objekt ist nach diesem Aufruf noch gültig, sodass Sie weiterhin 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, der durch seinen Umschlag beschrieben wird. (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, der durch seinen Umschlag beschrieben wird. (Geerbt von JavaObject)
Equals(Object)	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird. (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)
SetInitialFrequencyHz(Single)	Legt die Anfängliche Frequenz für die Wellenform in Hertz fest. Der Effekt beginnt bei dieser Frequenz zu vibrieren, wenn er zu der Amplitude und Frequenz wechselt, die durch den ersten Kontrollpunkt definiert wird.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird. (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, der durch seinen Umschlag beschrieben wird. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird. (Geerbt von JavaObject)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Ein Generator für Wellenformeffekte, der durch seinen Umschlag beschrieben wird.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: