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 に代わる推奨される代替手段です。 タイムライン内の特定のポイントで複数の要素をスケジュールできるようにすることで、触覚パターンを作成するための柔軟性が向上します。

このビルダーを使用すると、エンベロープ、プリセット、既存の VibrationEffects (イベントとして) を追加して、複雑な波形を作成できます。 各要素は、指定された startTimeMillis で追加されます。 従来の VibrationEffects の使用は、ここではお勧めできません。

さらに、繰り返し部分は、setRepeatingEffect(long,VibrationEffect,long) を使用して設定できます。 繰り返し効果が設定されると、それ以上触覚要素を組成物に追加することはできません。

フォールバック サポート: このビルダーによって作成された振動は、デバイスが要求された触覚要素をサポートしていない場合にフォールバック サポートを提供します。

WaveformEnvelopeBuilder によって作成されたエンベロープ エフェクトは、このビルダーに追加された場合でも、フォールバック サポートは提供されないことに注意してください。 このような効果の場合、デバイスが PWLE 効果または要求された周波数をサポートしていない場合、振動は再生されません。

触覚実装の背景と、OEM がこれらの効果をサポートする方法の詳細については、Android Haptics 実装ガイドラインを参照してください。

タイミングとアラインメント: startTimeMillis は、ビルドされるコンポジションの開始からのミリ秒単位の時間です。 要素は、開始時刻の順に追加する必要があります。

このフレームワークでは、再生中にベスト エフォートのタイミング サポートが提供されます。 次のイベントの指定された開始時刻に達したときに前のイベントが再生されている場合、フレームワークは自動的に次のイベントを次の最も古いスロットにシフトします。 これにより、触覚フィードバックが削除されず、イベントが実際の再生で重複しないことが保証されます (代わりに順番に再生されます)。

ただし、この自動シフトでは、タイミング ドリフトが発生する可能性があります。 実際の再生タイミングが、指定したタイムラインとできるだけ近い位置に揃うように、ビルダーはビルド時にベスト エフォート検証を実行して、要素のスケジュール設定が近くなりすぎないようにします。 この検証では、一部の要素の既知の期間 (エンベロープなど) またはデバイスに依存する要素 (プリセットなど) の最小期間 (1 ミリ秒) が使用されます。 ビルド時に重複の可能性が検出されると、IllegalArgumentException がスローされます。

一部の要素の実際の期間は物理デバイス上の実行時にのみ完全に認識されるため、開発者は、設計された再生タイミングと実際の再生タイミングの間で最適なアラインメントを確保するために、可変期間で要素をシーケンスする場合に注意する必要があります。

android.os.VibrationEffect.Builderの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。