语言

VibrationEffect.WaveformEnvelopeBuilder 类

定义

其信封描述的波形效果生成器。

[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
继承
VibrationEffect.WaveformEnvelopeBuilder
特性

注解

其信封描述的波形效果生成器。

波形效果信封由描述目标振动振幅和频率的一个或多个控制点定义,以及到达这些目标的持续时间。 振动器将在控制点之间执行平滑转换。

例如,以下代码使振动器从 120Hz 到 100 毫秒的全振幅倾斜,保留 200 毫秒的状态,然后斜坡回退超过 100 毫秒:

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

生成器会自动以 0 振幅启动所有效果。

确保效果中使用的频率范围与设备的功能兼容至关重要。 框架不会播放部分或完全超出设备支持范围的任何频率。 它也不会尝试更正或修改这些频率。

因此,强烈建议使用设备的频率配置文件设计触觉效果。 可以通过获取android.os.vibrator.VibratorFrequencyProfileVibrator#getFrequencyProfile()该方法来获取支持的频率范围和其他相关的频率相关信息。

除了这些限制之外,在设计振动模式时,请务必考虑振动执行器的物理限制。 这些限制包括以下因素:信封效果中允许的最大控制点数、每个控制点允许的最小和最大持续时间,以及效果的最大总持续时间。 如果模式超过允许的最大控制点数,框架将自动分解效果,以确保其正确播放。

可以使用以下 API 获取以下限制:ul<li 最大信封控制点:><li 最小控制点持续时间:>VibratorEnvelopeEffectInfo#getMaxSize()li<最大控制点持续时间:li>VibratorEnvelopeEffectInfo#getMinControlPointDurationMillis()最大总效果持续时间:<>VibratorEnvelopeEffectInfo#getMaxControlPointDurationMillis()< /ul>VibratorEnvelopeEffectInfo#getMaxDurationMillis()<>

Java文档android.os.VibrationEffect.WaveformEnvelopeBuilder。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
VibrationEffect.WaveformEnvelopeBuilder()

初始化 VibrationEffect.WaveformEnvelopeBuilder 类的新实例。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

为此类型提供 JNI 对等成员元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)

方法

名称 说明
AddControlPoint(Single, Single, Int64)

将新的控制点添加到此波形信封的末尾。 Amplitude 以此频率定义振动器的强度,范围为 0(关闭)到 1(最大可实现强度)。

Build()

将波形生成为单个 VibrationEffect。 在调用此调用后,波形符EnvelopeBuilder 对象仍然有效,因此你可以继续向其添加更多基元,并通过再次调用此方法来生成更多 VibrationEffect。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetInitialFrequencyHz(Single)

设置赫茨波形的初始频率。 当效果转换为第一个控制点定义的振幅和频率时,该效果将以此频率开始振动。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于