TouchSense® SDK for Mobile Apps Release Notes
=============================================

SDK Package Content
-------------------
- TouchSense SDK binaries for Android - TouchSenseSDK-vX.Y.Z.jar and libTouchSenseSDK.so.
- Haptic Effect Library - pre-designed haptic media files including an APK for previewing effects.
- Documentation - Release Notes (this document), NOTICE.txt, javadoc.zip, User Guide and Quick Start Guide.
- Shims and Plugins - Java, Native (C/C++) and Unity (C#).

Sample Applications Package Content
-----------------------------------
- Service, Sticker, Video, Native and Unity sample applications with source code.

---------+---------+---------+---------+---------+---------+---------+---------+---------+

Version 2.2.41 - August 10, 2018
------------------------------------
- Improved haptic playback using Android's amplitude control vibrator API (API >= 26).
- Improved the stability and robustness of the SDK.
- Improved JNI memory usage.
- Replaced deprecated Android API usage (up to API 28).
- Reduced the size of the Video sample app.

Version 2.2.11 - February 21, 2018
------------------------------------
- Improved JNI code stability.
- Improved network connectivity mechanism.
- Improved Unity plugin memory usage.
- Updated documentation.

Version 2.1.16 - October 19, 2017
------------------------------------
- Improved mechanism to safely catch native crashes.
- Improved Haptic Effect Library effects.
- Improved JNI threading usage.
- Improved the stability and performance of the SDK.
- Updated Unity and Native sample apps.
- Updated documentation.

Version 2.1.12 - July 21, 2017
------------------------------------
- Fixed library load segments to comply with Android security restriction (API >= 26).
- Fixed functions signatures in the SDK's Unity plugin API.
- Improved the stability and robustness of the SDK.
- Added a mechanism to safely catch native crashes.
- Improved JNI memory usage.

Version 2.1.1 - January 5, 2017
------------------------------------
- Updated native API enums names and values.
- Added namespace to Unity plugin.
- Added PLAYER_PLAYBACK_TYPE to getPlayerInfo.
- Improved JNI efficiency.
- Fixed potential corner cases resulting in deadlock or crash.
- Reduced Warnings and Error messages.
- Extracted sample applications into a separate package.
- Updated documentation.

Version 2.0.62 - October 28, 2016
------------------------------------
- Documented integration within Cocos2D framework.
- Updated built-in effects and fixed some issues.

Version 2.0.50 - September 19, 2016
------------------------------------
- First release.
- Consolidates functionality from Immersion's Gaming and Video SDKs.

---------+---------+---------+---------+---------+---------+---------+---------+---------+

Known Issues
------------
1. TouchSense SDK uses UTF-8 encoding and does not support invalid input that cannot be converted to UTF-8.
2. There is a slight chance of playback issues arising from playing the exact same resource in parallel [19211].
3. URIs beginning with 'file://' are currently not supported. However we do support local files specified as a file path. [19191].
4. AutoSyncPlayer:
   - setLooping(true) does not work out of the box [19207].
   - setupHapticPlayerListeners must be called [19206].
   - seekTo should not call play [19205].

Additional Notes
----------------
- The package only includes an ARM 32-bit native library, which is compatible with ARM v7a 32-bit, ARM 64-bit, x86 32-bit and x86 64-bit Android devices.
  -> Contact Immersion if you require a platform specific library.
- TouchSense SDK can also be integrated as an Android Service.
  -> Contact Immersion if you require the SDK as a Service solution.
- Exact duration of license is specified in your Evaluation or Software License Agreement with Immersion. The product will cease to function after your license has expired.
- This product collects data about the usage of the TouchSense SDK each time a piece of content is played.
  For more information, please refer to your Evaluation or Software License Agreement with Immersion.
- This product contains open source code.
  For more information, see NOTICE.txt and https://www.immersion.com/open-source-notices/
