본문으로 건너뛰기

햅틱 (Haptic)

사용자에게 진동 피드백을 제공하는 모듈입니다.

개요​

appify.haptic은 다양한 유형의 햅틱 피드백을 실행하는 기능을 제공합니다. 충격 강도 피드백과 알림 유형 피드백을 지원하며, 피드백 유형을 생략하면 기본값인 impactMedium이 적용됩니다. 햅틱을 지원하지 않는 기기에서는 무시됩니다.

API​

trigger(type?: HapticType): Promise<void>​

햅틱 피드백을 실행합니다.

매개변수

이름타입필수설명
typeHapticType아니오햅틱 유형. 기본값: 'impactMedium'

HapticType 값:

값설명
'impactLight'약한 충격 피드백
'impactMedium'중간 충격 피드백
'impactHeavy'강한 충격 피드백
'notificationSuccess'성공 알림 피드백
'notificationWarning'경고 알림 피드백
'notificationError'에러 알림 피드백
'selection'선택 변화 피드백

반환값: Promise<void>

예제

import { appify } from '@nolraunsoft/appify-sdk';

// 기본 피드백 (impactMedium)
await appify.haptic.trigger();

// 성공 알림 피드백
await appify.haptic.trigger('notificationSuccess');

// 강한 충격 피드백
await appify.haptic.trigger('impactHeavy');

플랫폼별 참고사항​

  • iOS: Taptic Engine이 탑재된 기기(iPhone 7 이상)에서만 동작합니다.
  • Android: 기기 및 OS 버전에 따라 지원 여부가 다를 수 있습니다.

관련 문서​