VibrationEffect.Builder 類別

定義

[Android.Runtime.Register("android/os/VibrationEffect$Builder", ApiSince=37, DoNotGenerateAcw=true)]
public sealed class VibrationEffect.Builder : Java.Lang.Object

[<Android.Runtime.Register("android/os/VibrationEffect$Builder", ApiSince=37, DoNotGenerateAcw=true)>]
type VibrationEffect.Builder = class
    inherit Object

繼承

Object

JavaObject

Object

VibrationEffect.Builder

屬性

RegisterAttribute

備註

一個透過編排各種觸覺元素來創作觸覺效果的建構器。

此 API 是 VibrationEffect.Composition 的首選替代方案，用於創造複雜振動效果。 它能在時間軸的特定點排程多個元素，提供更多彈性來創造觸覺模式。

這個建構器允許你加入包絡線、預設和現有的振動效果（以事件形式）來創造複雜的波形。 每個元素都會以指定的 startTimeMillis 加入。 請注意，這裡不建議使用舊有的振動效果。

此外，重複部分可使用 setRepeatingEffect（long，VibrationEffect，long） 設定。 一旦設定好重複效果，就無法再加入觸覺元素。

備援支援：若裝置不支援所需觸覺元件，由本製造商產生的振動將提供備援支援。

請注意，即使將包絡線效果加入此建構器，WaveformEnvelopeBuilder 所產生的包絡效果並未提供備援支援。 若裝置不支援PWLE效果或要求的頻率，震動將無法播放。

關於觸覺實作的更多細節，以及原廠（OEM）如何支援這些效果，請參閱 Android 觸覺實作指南。

時間與對齊：startTimeMillis 是從構圖開始起的時間（以毫秒計）。 元素必須依其開始時間的遞增順序添加。

該框架在播放時提供盡力而為的時序支援。 如果當下一個事件的指定開始時間到達時，前一個事件仍在播放，框架會自動將下一個事件移至下一個最早的時段。 這樣可以確保不會掉落觸覺回饋，且實際播放時事件不會重疊（它們會依序播放）。

然而，這種自動換檔可能會產生時序漂移。 為了確保實際播放時序盡可能符合你指定的時間軸，建置者會在建置時進行盡力驗證，幫助你避免將元素排程過於密集。 此驗證使用某些元素（如包絡線）已知的持續時間，或裝置相關元素（如預設）的最小持續時間（1毫秒）。 若在建置時偵測到潛在重疊，會拋出 IllegalArgumentException。

由於某些元素的實際時長僅在實體裝置執行時完全確定，開發者在排序可變時長元素時仍應謹慎，以確保設計與實際播放時間的最佳對齊。

Android 參考資料。android.os.VibrationEffect.Builder

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