學習
引擎類別
HapticEffect

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡


概要
方法
Play():()
Stop():()
繼承成員

API 參考
屬性
Looped
平行讀取
功能: Input
HapticEffect.Looped:boolean
範例程式碼
循環
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Looped = true
effect.Parent = Workspace
-- 開始觸覺效果
effect:Play()
-- 兩秒後停止效果
task.wait(2)
effect:Stop()

Position
平行讀取
功能: Input
HapticEffect.Position:Vector3
範例程式碼
位置
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- 設定位置和影響半徑
effect.Position = Vector3.new(0.5, 0.5, 0)
effect.Radius = 1
effect.Parent = Workspace
effect:Play()

Radius
平行讀取
功能: Input
HapticEffect.Radius:number
範例程式碼
半徑
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- 設定影響的位置和半徑
effect.Position = Vector3.new(0.5, 0.5, 0)
effect.Radius = 1
effect.Parent = Workspace
-- 播放觸覺效果
effect:Play()

Type
平行讀取
功能: Input
HapticEffect.Type:Enum.HapticEffectType

方法
Play
功能: Input
HapticEffect:Play():()
返回
()
範例程式碼
播放
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Parent = Workspace
-- 播放觸覺效果
effect:Play()

SetWaveformKeys
功能: Input
HapticEffect:SetWaveformKeys(keys:{any}):()
參數
keys:{any}
返回
()
範例程式碼
設置波形鍵
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- 將效果類型設置為自定義以定義波形
effect.Type = Enum.HapticEffectType.Custom
effect.Parent = Workspace
-- 通過 FloatCurveKeys 的表定義自定義波形曲線
-- 時間值以毫秒為單位;值範圍從 0(無觸覺)到 1(全強度)
local rampUpWaveform = {
FloatCurveKey.new(0, 0.3, Enum.KeyInterpolationMode.Linear),
FloatCurveKey.new(100, 0.4, Enum.KeyInterpolationMode.Linear),
FloatCurveKey.new(300, 0.8, Enum.KeyInterpolationMode.Linear),
FloatCurveKey.new(400, 1.0, Enum.KeyInterpolationMode.Linear)
}
-- 通過效果的方法設置波形
effect:SetWaveformKeys(rampUpWaveform)

Stop
功能: Input
HapticEffect:Stop():()
返回
()
範例程式碼
停止
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Looped = true
effect.Parent = Workspace
-- 開始觸覺效果
effect:Play()
-- 兩秒後停止效果
task.wait(2)
effect:Stop()

活動
Ended
功能: Input
HapticEffect.Ended():RBXScriptSignal

©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。