Skip to main content
Version: Next

디바이스를 진동시킨다.

안드로이드 앱은 AndroidManifest.xml에 <uses-permission android:name="android.permission.VIBRATE"/>를 추가해 android.permission.VIBRATE 권한을 요청해야 한다.

iOS에서는 Vibration API가 AudioServicesPlaySystemSound(kSystemSoundID_Vibrate) 호출로 구현된다.

참조

메서드​

cancel()​

tsx
static cancel();

반복 설정이 활성화된 vibrate()를 호출한 후, 이 메서드를 사용해 진동을 중지한다.

vibrate()​

tsx
static vibrate(
  pattern?: number | number[],
  repeat?: boolean
);

진동을 고정된 시간 동안 발생시킨다.

안드로이드에서는 진동 시간이 기본적으로 400밀리초로 설정되며, pattern 인자에 숫자를 전달해 임의의 진동 시간을 지정할 수 있다. iOS에서는 진동 시간이 대략 400밀리초로 고정된다.

vibrate() 메서드는 밀리초 단위의 시간을 나타내는 숫자 배열을 pattern 인자로 받을 수 있다. repeat을 true로 설정하면 cancel()이 호출될 때까지 진동 패턴을 반복한다.

안드로이드에서는 pattern 배열의 홀수 인덱스가 진동 시간을 나타내고, 짝수 인덱스가 분리 시간을 나타낸다. iOS에서는 pattern 배열의 숫자가 분리 시간을 나타내며, 진동 시간은 고정된다.

인자:

이름타입기본값설명
patternnumber
안드로이드
array of numbers		400밀리초 단위의 진동 시간.
밀리초 단위의 숫자 배열로 나타낸 진동 패턴.
repeatbooleanfalsecancel()이 호출될 때까지 진동 패턴을 반복.