VibrationEffect.WaveformEnvelopeBuilder 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
其信封描述的波形效果生成器。
[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
- 继承
- 特性
注解
其信封描述的波形效果生成器。
波形效果信封由描述目标振动振幅和频率的一个或多个控制点定义,以及到达这些目标的持续时间。 振动器将在控制点之间执行平滑转换。
例如,以下代码使振动器从 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 |
返回此 |
| 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() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |