HapticEffect

非推奨を表示

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

閲覧できません

現代のコントローラーとデバイスには、ハプティックフィードバックを提供するモーターが内蔵されています。バイブレーションや振動を追加すると、ビジュアルやオーディオで伝えるのが難しい微妙なフィードバックを提供できます。

Roblox は次のデバイスのためのハプティクスをサポートします：

  • Android と iOS の電話は、ほとんどの iPhone、Pixel、および Samsung Galaxy デバイスを含むハプティクスをサポートします
  • プレイステーションゲームパッド
  • Xbox ゲームパッド
  • クエストタッチコントローラ

概要

プロパティ

  • Looped:boolean
    並列読み取り

    ハプティック効果ループが連続して再生するかどうか。

  • Position:Vector3
    並列読み取り

    以下の Radius とともに、入力デバイスに対する影響位置と、効果が近くのモーターに及ぶ範囲を効果的に指定します。

  • Radius:number
    並列読み取り

    以下の Position とともに、入力デバイスに対する影響範囲と、効果範囲が近くのモーターにどれほど広がるかを指定します。

  • Type:Enum.HapticEffectType
    並列読み取り

    Enum.HapticEffectType ハプティックタイプを説明する。

  • Waveform:FloatCurve
    Robloxのスクリプトセキュリティ
    並列読み取り
Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

  • Play():()

    ハプティック効果を再生します。

  • SetWaveformKeys(keys : Array):()

    カスタム波形をテーブルとして定義し、ハプティックに適用する方法。

  • Stop():()

    ハプティック効果を停止します。

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

プロパティ

Looped

boolean
並列読み取り

ハプティック効果ループが連続して再生するかどうか。

local Workspace = game:GetService("Workspace")



local effect = Instance.new("HapticEffect")

effect.Type = Enum.HapticEffectType.GameplayExplosion

effect.Looped = true

effect.Parent = Workspace



-- Start the haptic effect

effect:Play()

-- After two seconds, stop the effect

task.wait(2)

effect:Stop()

Position

Vector3
並列読み取り

以下の Radius とともに、入力デバイスに対する影響位置と、効果が近くのモーターに及ぶ範囲を効果的に指定します。いくつかのゲームパッドには「小」と「大」のモーターの両方がないことに注意してください、および「ゲームパッド大左/右」は PC ではサポートされていません。

local Workspace = game:GetService("Workspace")



local effect = Instance.new("HapticEffect")



-- Set the position and radius of impact

effect.Position = Vector3.new(0.5, 0.5, 0)

effect.Radius = 1

effect.Parent = Workspace



effect:Play()

Radius

number
並列読み取り

以下の Position とともに、入力デバイスに対する影響範囲と、効果範囲が近くのモーターにどれほど広がるかを指定します。いくつかのゲームパッドには「小」と「大」のモーターの両方がないことに注意してください、および「ゲームパッド大左/右」は PC ではサポートされていません。

local Workspace = game:GetService("Workspace")



local effect = Instance.new("HapticEffect")



-- Set the position and radius of impact

effect.Position = Vector3.new(0.5, 0.5, 0)

effect.Radius = 1

effect.Parent = Workspace



-- Play the haptic effect

effect:Play()

Type

Enum.HapticEffectType
並列読み取り

大きな即時震動が素早く死亡するよう入力、Enum.HapticEffectType.GameplayCollision のようなハプティックタイプ。Enum.HapticEffectType.Custom 値は、SetWaveformKeys() を通じて定義されたカスタム波形キーを使用して、ハプティックを指定できます。

Waveform

FloatCurve
Robloxのスクリプトセキュリティ
並列読み取り
Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

Play

()

ハプティック効果を再生します。

local Workspace = game:GetService("Workspace")



local effect = Instance.new("HapticEffect")

effect.Type = Enum.HapticEffectType.GameplayExplosion

effect.Parent = Workspace



-- Play the haptic effect

effect:Play()

戻り値

()

SetWaveformKeys

()

このメソッドでは、カスタム波形をテーブルとして定義し、ハプティックに適用できます。

local Workspace = game:GetService("Workspace")



local effect = Instance.new("HapticEffect")



-- Set effect type to custom in order to define a waveform

effect.Type = Enum.HapticEffectType.Custom

effect.Parent = Workspace



-- Define the custom waveform curve through a table

local rampUpWaveform = {

	FloatCurveKey.new(0, 0.3),

	FloatCurveKey.new(100, 0.4),

	FloatCurveKey.new(300, 0.8),

	FloatCurveKey.new(400, 1.0)

}



-- Set waveform through the effect's method

effect:SetWaveformKeys(rampUpWaveform)

パラメータ

keys: Array
既定値: ""

戻り値

()

Stop

()

ハプティック効果を停止します。

local Workspace = game:GetService("Workspace")



local effect = Instance.new("HapticEffect")

effect.Type = Enum.HapticEffectType.GameplayExplosion

effect.Looped = true

effect.Parent = Workspace



-- Start the haptic effect

effect:Play()

-- After two seconds, stop the effect

task.wait(2)

effect:Stop()

戻り値

()
Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

イベント

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示