VibrationEffect.BasicEnvelopeBuilder クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。
[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- 継承
- 属性
注釈
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。
このビルダーは、波形効果を機能に基づいてさまざまなデバイスに自動的に適応させることで、波形効果の作成を簡素化します。 効果は、ターゲットの振動強度とシャープネスを指定するコントロール ポイントと、それらのターゲットに到達する期間によって定義されます。 振動子は、これらの制御点間をスムーズに遷移します。
<b>Intensity:</b> 0 (オフ) から 1 (達成可能な最大強度) までの振動の全体的な強度を定義します。 値を大きくすると、振動が強くなります。 サポートされている強度値は、人間の知覚を保証するために、10 dB SL を超える感度レベル (SL) を保証します。
<b>Sharpness:</b> 0 から 1 までの振動の鮮明度を定義します。 値を小さくするとスムーズな振動が得られますが、値を大きくすると、よりシャープでスナップ感が増します。 シャープネスは、デバイスでサポートされている周波数範囲内の同等の周波数にマップされます。
このビルダーは適応ロジックの大部分を処理しますが、いくつかの制限があります: <ul><li>周波数の全範囲を使用することはできません</li><li>少なくとも10 db SL</li><li>Effectsの出力を生成できる周波数範囲に制限されています。 ゼロ強度制御ポイントで終了しないと、 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();
}
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| 名前 | 説明 |
|---|---|
| VibrationEffect.BasicEnvelopeBuilder() |
VibrationEffect.BasicEnvelopeBuilder クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Class |
この |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| JniIdentityHashCode |
相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object) |
| JniManagedPeerState |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| JniPeerMembers |
この型の JNI ピア メンバー メタデータを提供します。 |
| PeerReference |
このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object) |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
メソッド
| 名前 | 説明 |
|---|---|
| AddControlPoint(Single, Single, Int64) |
この波形エンベロープの末尾に新しいコントロール ポイントを追加します。 強度は、0 (オフ) から 1 (達成可能な最大強度) までの振動の全体的な強度を定義します。 |
| Build() |
波形を 1 つの VibrationEffect として構築します。 BasicEnvelopeBuilder オブジェクトは、この呼び出し後も有効であるため、このメソッドをもう一度呼び出すことで、さらにプリミティブを追加し、VibrationEffect を生成し続けることができます。 |
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| Equals(Object) |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| JavaFinalize() |
古い.
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| SetInitialSharpness(Single) |
基本的なエンベロープ 効果の初期シャープネスを設定します。 効果は、最初の制御点で定義された強度とシャープネスに遷移すると、このシャープネスで振動し始めます。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| ToArray<T>() |
このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object) |
| ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object) |
| Wait() |
現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IJavaPeerable.Disposed() |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| IJavaPeerable.Finalized() |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 (継承元 JavaObject) |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
さまざまな機能を備えたデバイス間で一貫した触覚知覚を提供するように設計された、エンベロープによって定義された波形効果のビルダー。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|