Aprenda
Classe do mecanismo
HapticEffect

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Métodos
Play():()
Stop():()
Membros herdados

Referência API
Propriedades
Looped
Ler Parallel
Recursos: Input
HapticEffect.Looped:boolean
Amostras de código
Repetido
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Looped = true
effect.Parent = Workspace
-- Inicie o efeito háptico
effect:Play()
-- Após dois segundos, pare o efeito
task.wait(2)
effect:Stop()

Position
Ler Parallel
Recursos: Input
HapticEffect.Position:Vector3
Amostras de código
Posição
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- Defina a posição e o raio de impacto
effect.Position = Vector3.new(0.5, 0.5, 0)
effect.Radius = 1
effect.Parent = Workspace
effect:Play()

Radius
Ler Parallel
Recursos: Input
HapticEffect.Radius:number
Amostras de código
Raio
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- Defina a posição e o raio de impacto
effect.Position = Vector3.new(0.5, 0.5, 0)
effect.Radius = 1
effect.Parent = Workspace
-- Reproduza o efeito háptico
effect:Play()

Type
Ler Parallel
Recursos: Input
HapticEffect.Type:Enum.HapticEffectType

Métodos
Play
Recursos: Input
HapticEffect:Play():()
Devolução
()
Amostras de código
Jogar
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Parent = Workspace
-- Reproduzir o efeito háptico
effect:Play()

SetWaveformKeys
Recursos: Input
HapticEffect:SetWaveformKeys(keys:{any}):()
Parâmetros
keys:{any}
Devolução
()
Amostras de código
Definir Chaves de Forma de Onda
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- Defina o tipo de efeito como personalizado para definir uma forma de onda
effect.Type = Enum.HapticEffectType.Custom
effect.Parent = Workspace
-- Defina a curva de forma de onda personalizada através de uma tabela de FloatCurveKeys
-- Os valores de tempo estão em milissegundos; os valores variam de 0 (sem háptico) a 1 (intensidade total)
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)
}
-- Defina a forma de onda através do método do efeito
effect:SetWaveformKeys(rampUpWaveform)

Stop
Recursos: Input
HapticEffect:Stop():()
Devolução
()
Amostras de código
Parar
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Looped = true
effect.Parent = Workspace
-- Inicie o efeito háptico
effect:Play()
-- Após dois segundos, pare o efeito
task.wait(2)
effect:Stop()

Eventos
Ended
Recursos: Input
HapticEffect.Ended():RBXScriptSignal

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.