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

JavaObject

Object

VibrationEffect.BasicEnvelopeBuilder

屬性

RegisterAttribute

備註

一個由包絡線定義的波形效果建構器，旨在提供不同功能裝置間一致的觸覺感知。

此建構器透過自動根據不同裝置的功能調整波形效果，簡化了波形效果的製作。 效果由控制點定義，指定目標振動強度與銳利度，以及到達目標的持續時間。 震動器能在這些控制點間順暢切換。

<b>強度：</b> 定義振動的整體強度，範圍從 0（關閉）到 1（最大可達成強度）。 數值越高，振動越強。 支援的強度值保證靈敏度（SL）高於10 dB SL，以確保人類感知。

<b>銳利度：</b> 定義振動的清脆度，範圍從0到1。 較低的數值產生更平滑的振動，而較高的數值則產生更銳利、更靈敏的感覺。 銳利度會映射到裝置支援頻率範圍內的等效頻率。

雖然這個建構器處理了大部分的自適應邏輯，但它也有一些限制：<ul><li>它可能無法使用完整的頻率<範圍/li><li>它限制在一個能產生至少 10 db 輸出的頻率範圍 SL</li><li>效果必須以零強度控制點結尾。 若未在零強度控制點結束，則會導致 IllegalStateException。</li></ul>

建構器會自動將所有效果從 0 強度開始。

為了避免這些限制並對效果輸出有更多控制，建議使用 WaveformEnvelopeBuilder，其中可直接使用振幅與頻率值。

為了達到最佳跨裝置一致性，建議控制點數量限制在最多 16 個。 不過這並非強制，若圖案超過最大控制點數，框架會自動拆解效果以確保正確播放。

例如，以下程式碼會產生振動效果，將振動強度從低頻提升到高頻強烈，持續約 500 毫秒，然後在 100 毫秒內降至 0（關閉）：

{@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。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。