Skip to main content

Migration Guide (SDK1 → SDK2)

  1. Import Exporter Plugin
  2. Convert your TactFile to Events
  3. Import UE SDK2 Plugin
  4. Replace SDK1 to SDK2 and Delete Unnecessary Files

Requirement

note

This guide is based on the assumption that bHaptics SDK1(old) is applied.

You need an empty haptic application in the Portal. If you don't have one, please visit Portal first and make the empty haptic app.

Import Exporter Plugin

  1. Download bHapticsExporter Plugin and Import.

    • bHapticsExporter Plugin UE 4.26 Plugin: Download
    • bHapticsExporter Plugin UE 4.27 Plugin: Download
  2. Import bHapticsExporter Plugin in your project.

  3. Open your project and check bHapticsExporter Button.

Convert your TactFile to Events

  1. Press Toolbar > bHapticsExporter to export the feedback files you are using.

  2. After completing the feedback export, close the Unreal project and delete bHapticsExporter Plugin.

  3. Create the haptic events with exported files.

    1. Go into your app in Developer Portal.
    2. Press the Import button.
    3. Select exported folders.
    4. Press Confirm and Save.

Import UE SDK2 plugin

note

Refer to Unreal Guide for more information.

  1. Download BhapticsPlugin

  2. Click Free and Install to Engine in Epic Games Launcher

    Untitled

    Untitled

    Untitled

  3. Open up your Unreal project and activate bHaptics Plugin.

  4. Open up bHaptics developer portal.

    Copy and paste your "AppID" & "API Key" and press "Link" to sync your events in bhaptics developer portal with your Unreal project. (Open "Project Setting" - "Plugin Tab" and Press "bHaptics Menu")

  5. If the project is successfully synchronized with bHaptics Developer portal, you will receive following message BHAPTICS SETTINGS SUCCESS.

    Untitled

    Untitled

Replace SDK1 to SDK2 and Delete Unnecessary Files

  • SubmitFeedback(SDK1) to PlayHaptic(SDK2)

  • SubmitFeedfeedbackwithOptions(SDK1) to PlayHapticWithOption(SDK2)

  • Initialize - Using SDK2 InitializebHaptics (Refer to Guide)

  • SubmitDots/Bytes(SDK1) to PlayDots(SDK2)

  • GetCurrentDevices(Android Only SDK1) to GetBhapticsDevices(SDK2)

  • PingAll/PingByPosition/PingHapticsDevice(Android Only SDK1) to Ping/PingAll(SDK2)

  • ToggleDevicePosition(Android Only SDK1) to SwapPosition(SDK2)

  • If all SDK 1 functions and haptic events are replaced with SDK 2 functions, delete all feedback files and disable SDK1 Plugin.