VibrationEffect.BasicEnvelopeBuilder 类

定义

[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

继承

Object

Object

VibrationEffect.BasicEnvelopeBuilder

属性

RegisterAttribute

注解

由信封定义的波形效果生成器，旨在跨具有不同功能的设备提供一致的触觉感知。

此生成器可以根据其功能自动调整波形效果，从而简化波形效果的创建。 效果由指定目标振动强度和锐度的控制点定义，以及到达这些目标的持续时间。 振动器将在这些控制点之间顺利过渡。

<b>强度：</b> 定义振动的整体强度，范围为 0（关闭）到 1（最大可实现强度）。 较高的值会导致更强的振动。 支持的强度值保证敏感度级别（SL）高于 10 dB SL，以确保人类感知。

<b>锐度：</b> 定义振动的脆度，范围为 0 到 1。 较低的值会产生更流畅的振动，而较高的值会产生更尖锐、更贴贴的感觉。 锐度映射到设备支持的频率范围内等效的频率。

虽然此生成器处理大多数适应逻辑，但它确实存在一些限制：ul>li 它可能不会使用全范围的频率</li><Li>它仅限于可生成至少 10 db SL</li><>Effects 输出的频率范围，必须以零强度控制点结束。><< 未能在零强度控制点处结束将导致一个 IllegalStateException。</li></ul>

生成器会自动以 0 强度启动所有效果。

若要避免这些限制并更好地控制效果输出，请使用 WaveformEnvelopeBuilder直接振幅和频率值。

为了获得最佳跨设备一致性，建议将控制点数限制为最多 16 个。 但是这不是强制性的，如果模式超过允许的最大控制点数，框架将自动分解效果，以确保它正确播放。

例如，以下代码创建一个振动效果，该效果将强度从低音调提升到高音强振动超过 500 毫秒，然后将强度降低到 0（关闭）超过 100 毫秒：

{@code
            VibrationEffect effect = new VibrationEffect.BasicEnvelopeBuilder()
                .setInitialSharpness(0.0f)
                .addControlPoint(1.0f, 1.0f, 500)
                .addControlPoint(0.0f, 1.0f, 100)
                .build();
            }

Java文档android.os.VibrationEffect.BasicEnvelopeBuilder。

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