본문으로 건너뛰기

JavaScript 가이드

JavaScript SDK를 사용하면 JS/TS 프로젝트에 햅틱을 구현할 수 있습니다. TypeScript를 위한 타입 시스템과 ESM도 지원합니다.

  1. 패키지 설치
  2. 햅틱 환경 설정

요구 사항​

  • Node.js (최신 LTS 버전 권장)
  • OS: Windows 10/11 (x64)
  • bHaptics Player 설치 및 실행
  • 프로젝트에 해당하는 배포된 햅틱 애플리케이션
    • 햅틱 앱의 앱 ID와 API 키
About haptic application

You can create and manage haptic apps in Developer Portal, a web-based tool.

If you're unfamiliar with haptic apps or haven't created one yet, please follow the Portal guide before proceeding.

Before linking a haptic app to your game project, make sure the haptic app meets the following requirements:

  • At least one haptic event must be created.
  • API Key must be generated.
    • There is no API Key by default. To generate one, go to the "API Key" tab and click "New" button.
  • Haptic app must be deployed
    • If you see "Deploy Now" button in the upper right corner, click it to deploy your haptic app. Otherwise, if you can see "Up to date", it means that the latest haptic app has already been deployed.

Also, link process requires App ID and API Key. Go to the "Settings" tab, and check the App ID and API Key.

Check app ID, API key at the settings tab in Portal

설치​

npm install tact-js

패키지 가져오기​

import Tact from "tact-js";

최적화 대상에서 제외하기​

Vite를 사용하는 경우, Vite 설정 파일에 다음을 추가하세요:

vite.config.js
export default defineConfig({
  // ...
  optimizeDeps: {
    exclude: ['tact-js'],
  },
  // ...
});

햅틱 환경 설정​

햅틱 관련 함수를 사용하기 전에 햅틱 앱을 프로젝트에 연결하고 햅틱 환경을 초기화해야 합니다.

이를 위해서는 햅틱 앱의 앱 ID와 API 키가 필요합니다. bHaptics Developer Portal에서 확인할 수 있습니다.

초기화​

  • "your_app_id"와 "your_api_key"를 본인의 앱 ID와 API 키로 교체하세요.
  • JavaScript 프로젝트를 실행하기 전에 bHaptics Player 애플리케이션이 컴퓨터에서 실행 중인지 확인하세요.

더 읽어보기​

이제 bHaptics 햅틱 기능을 사용할 준비가 되었습니다! 프로젝트에서 햅틱을 재생하려면 JavaScript 레퍼런스를 방문하거나, 아래의 전체 예제 코드를 참고하세요.

이 라이브러리를 사용하는 데 문제가 있다면 문제 해결을 확인하세요.