배우기
엔진 클래스
HapticEffect

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.



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()
-- 2초 후에 효과 중지
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()
-- 2초 후에 효과 중지
task.wait(2)
effect:Stop()

이벤트
Ended
기능: Input
HapticEffect.Ended():RBXScriptSignal

©2026 Roblox Corporation. Roblox 및 Roblox 로고, 'Powering Imagination'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.