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

繼承

Object

JavaObject

Object

VibrationEffect.WaveformEnvelopeBuilder

屬性

RegisterAttribute

備註

波形效果的建構器，由其包絡線描述。

波形效應包絡線由一個或多個控制點定義，描述目標振動振幅與頻率，以及到達這些目標所需的持續時間。 震動器會在控制點間進行平滑轉換。

例如，以下程式碼會將震動器從關閉頻率提升到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.VibratorFrequencyProfile 使用該 Vibrator#getFrequencyProfile() 方法獲得支援的頻率範圍及其他相關頻率資訊。

除了這些限制外，設計振動模式時還需考慮振動執行器的物理限制。 這些限制包括包絡線效果中允許的最大控制點數、每個控制點允許的最小與最大持續時間，以及效果的總持續時間。 若圖案超過允許的最大控制點數，框架會自動拆解效果以確保正確播放。

你可以使用以下 API 來取得這些限制：ul<li 最大包絡控制點：><li>最小控制點持續時間：VibratorEnvelopeEffectInfo#getMaxSize()<li>最大控制點持續時間：VibratorEnvelopeEffectInfo#getMinControlPointDurationMillis()<li>最大總效果持續時間：VibratorEnvelopeEffectInfo#getMaxControlPointDurationMillis()</ul>VibratorEnvelopeEffectInfo#getMaxDurationMillis()<>

Java 文件 android.os.VibrationEffect.WaveformEnvelopeBuilder。

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