Apprendre
Classe de moteur
HapticEffect

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.


Résumé

Méthodes
Play():()
Stop():()
Événements
Membres hérités

Référence API
Propriétés
Looped
Lecture parallèle
Capacités : Input
HapticEffect.Looped:boolean
Échantillons de code
Bouclé
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Looped = true
effect.Parent = Workspace
-- Démarrer l'effet haptique
effect:Play()
-- Après deux secondes, arrêter l'effet
task.wait(2)
effect:Stop()

Position
Lecture parallèle
Capacités : Input
HapticEffect.Position:Vector3
Échantillons de code
Position
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- Définir la position et le rayon d'impact
effect.Position = Vector3.new(0.5, 0.5, 0)
effect.Radius = 1
effect.Parent = Workspace
effect:Play()

Radius
Lecture parallèle
Capacités : Input
HapticEffect.Radius:number
Échantillons de code
Rayon
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- Définir la position et le rayon d'impact
effect.Position = Vector3.new(0.5, 0.5, 0)
effect.Radius = 1
effect.Parent = Workspace
-- Jouer l'effet haptique
effect:Play()

Type
Lecture parallèle
Capacités : Input
HapticEffect.Type:Enum.HapticEffectType

Méthodes
Play
Capacités : Input
HapticEffect:Play():()
Retours
()
Échantillons de code
Jouer
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Parent = Workspace
-- Jouer l'effet haptique
effect:Play()

GetWaveformKeys
Capacités : Input
HapticEffect:GetWaveformKeys():{any}
Retours
Échantillons de code
Obtenir les clés de forme d'onde
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.Custom
effect.Parent = Workspace
effect:SetWaveformKeys({
FloatCurveKey.new(0, 0.4, Enum.KeyInterpolationMode.Linear),
FloatCurveKey.new(200, 1.0, Enum.KeyInterpolationMode.Linear),
})
-- Lire la forme d'onde, la réduire à la moitié de sa force, et l'écrire à nouveau.
-- Le temps est en millisecondes ; la valeur va de 0 (pas de haptique) à 1 (intensité maximale).
local keys = effect:GetWaveformKeys()
for i, key in keys do
keys[i] = FloatCurveKey.new(key.Time, key.Value * 0.5, key.Interpolation)
end
effect:SetWaveformKeys(keys)

SetWaveformKeys
Capacités : Input
HapticEffect:SetWaveformKeys(keys:{any}):()
Paramètres
keys:{any}
Retours
()
Échantillons de code
Définir les clés de forme d'onde
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
-- Définir le type d'effet sur personnalisé afin de définir une forme d'onde
effect.Type = Enum.HapticEffectType.Custom
effect.Parent = Workspace
-- Définir la courbe de forme d'onde personnalisée à travers une table de FloatCurveKeys
-- Les valeurs de temps sont en millisecondes ; les valeurs vont de 0 (pas de haptique) à 1 (pleine intensité)
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)
}
-- Définir la forme d'onde à travers la méthode de l'effet
effect:SetWaveformKeys(rampUpWaveform)

Stop
Capacités : Input
HapticEffect:Stop():()
Retours
()
Échantillons de code
Arrêter
local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Looped = true
effect.Parent = Workspace
-- Démarrer l'effet haptique
effect:Play()
-- Après deux secondes, arrêter l'effet
task.wait(2)
effect:Stop()

Événements
Ended
Capacités : Input
HapticEffect.Ended():RBXScriptSignal

©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.