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

注釈

エンベロープによって記述される波形効果のビルダー。

波形効果エンベロープは、ターゲットの振動振幅と周波数、およびそれらのターゲットに到達するための継続時間を記述する 1 つ以上の制御点によって定義されます。 振動子は制御ポイント間の滑らかな転移を行う。

たとえば、次のコードは、振動子を 100 ミリ秒にわたって 120Hz でオフから完全振幅に傾斜させ、その状態を 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>Maximum エンベロープ コントロール ポイント: VibratorEnvelopeEffectInfo#getMaxSize()<li>Minimum コントロール ポイント期間: VibratorEnvelopeEffectInfo#getMinControlPointDurationMillis()<li>Maximum コントロール ポイント期間: VibratorEnvelopeEffectInfo#getMaxControlPointDurationMillis()<li>Maximum total effect duration: VibratorEnvelopeEffectInfo#getMaxDurationMillis()</ul>

Javaドキュメント。

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