Putting real feeling into Android Apps
0 likes624 views
The document outlines the process of integrating haptic feedback into Android apps, emphasizing the importance of touch feedback for user engagement. It includes detailed steps for creating a new Android project, linking it to third-party libraries, and adding haptic effects using the Immersion Haptic SDK. Additionally, it provides setup instructions for running the app on a physical device and resources for further learning.
Putting real feeling into Android Apps
- 1. Peter van der Linden Android Technology Evangelist Jan 2014, Chicago NASDAQ: IMMR Putting Real Feeling Into Android apps! ©2012 Immersion Corporation–Confidential
- 2. ■ Agenda 1 Haptics 2 Creating a new project 3 Linking to a 3rd party Library 4 Running your code on a phone 5 Wrap up ©2012 Immersion Corporation–Confidential
- 3. 1 Haptics 2 Creating a new project 3 Linking to a 3rd party Library 4 Running your code on a phone 5 Wrap up ©2012 Immersion Corporation–Confidential
- 4. The Mobile User ©2012 Immersion Corporation–Confidential 4
- 5. Solo! ©2012 Immersion Corporation–Confidential © 2011 Immersion Corporatio
- 6. Agency TBWANeboko Photo: Michael Harvey Touch feedback fills the human need for tactile gratification CBS News Photo: Walter Geis ©2012 Immersion Corporation–Confidential © 2011 Immersion Corporatio
- 7. 1 Haptics 2 Creating a new project 3 Linking to a 3rd party Library 4 Running your code on a phone 5 Wrap up ©2012 Immersion Corporation–Confidential
- 8. Android API levels http://goo.gl/LuNCDG ©2012 Immersion Corporation–Confidential
- 9. Choosing Android API levels It’s a tradeoff • You want the oldest possible API because – more phones will run your app • You want the newest possible API because – better quality, better performance, widest range of new features Review market share of different API levels http://goo.gl/219Br4 API level 14 is a good choice at present, but will fade out. ©2012 Immersion Corporation–Confidential
- 10. Create new project - Exercise To create a new Android project in Eclipse 1. start Eclipse 2. select File > New > Project. 3. expand “Android”, then click > Android Application Project, and click Next. 4. enter Application Name: Hello. 5. Enter Project Name: Helloworld 7. Package name: com.example.helloworld. 6. Select Min Reqd SDK: “API 14 Android 4.0” 7. Select Target SDK: “API 14” 9. Compile with: ”API 19” or any >= 14 where you have downloaded that platform Then hit ”Next” 10. on “New Android App” uncheck “custom launcher icon”, click “Next” 11. on “Create Activity”, click “Next”. 12. Click Finish. ©2012 Immersion Corporation–Confidential
- 11. Create new project step 2 - 3 2. select File > New > Project… 3. expand “Android”, click > Android Application Project, click Next. Running your Studio Project ©2012 Immersion Corporation–Confidential
- 12. Create a new Android project ■ File > New > Android Project using Eclipse + ADT Field Purpose Project name What Eclipse calls this app Hello Target API level this app uses 14 App name what phone calls the app Hello Package name what Java calls the app com.example.hello Activity name The file containing main MainActivity Min SDK version API level this app uses Value to use 14 You must have installed the platform file for “target” and “minsdk” level that you choose. This is part of installing the Eclipse bundle. Platforms live in the SDK & have names like “platform-14” ©2012 Immersion Corporation–Confidential
- 13. Create new project step 4 - 9 4. enter Application Name: Hello. 5. Enter Project Name: Helloworld 7. Package name: com.example.helloworld. 6. Select Min Reqd SDK: “API 14 Android 4.0” 7. Select Target SDK: “API 14” 9. Compile with: ”API 14” or any >= 14 where you have downloaded that platform Then hit ”Next” Running your Studio Project ©2012 Immersion Corporation–Confidential
- 14. Create new project step 10 10. on “New Android App,” uncheck “custom launcher icon”, click “Next” Running your Studio Project ©2012 Immersion Corporation–Confidential
- 15. Create new project step 11 11. on “Create Activity”, click “Next”. 12. Click Finish. Running your Studio Project ©2012 Immersion Corporation–Confidential
- 16. Create new project step 12 12. Note the “Activity name” and “layout name” you were given. Click Finish. ©2012 Immersion Corporation–Confidential
- 17. New project appears in Eclipse You can expand folders by clicking right pointing triangle If project has errors, click Project > Clean > OK ©2012 Immersion Corporation–Confidential
- 18. 1 Haptics 2 Creating a new project 3 Linking to a 3rd party Library 4 Running your code on a phone 5 Wrap up ©2012 Immersion Corporation–Confidential
- 19. Downloading the Immersion Haptic Platform Immersion Haptic SDK Tools: www.immersion.com/haptic/sdk § Download the Haptic SDK (450KB) § Download the Haptic Studio (only for advanced custom effect design) Haptic Effects Quick Start Guide: www.immersion.com/haptic/guide Immersion Haptic Effect Preview App § Download FREE from Google Play ©2012 Immersion Corporation–Confidential 19
- 20. Add Haptics to “Hello World!” Project • Download UHL zip file • Copy extracted libImmEmulatorJ.so file to libs/armeabi folder (create folders if necessary) • Copy extracted UHL.jar to libs folder ©2012 Immersion Corporation–Confidential 2 0
- 21. Add a Button in res/layout/activity_main.xml <Button TextView! android:text=”play effect!”! android:onClick="handleClick"! />! in src/… MainActivity.java import android.view.View;! ! public void handleClick(View v) { }! ©2012 Immersion Corporation–Confidential 21
- 23. Add Vibrate permission in top level AndroidManifest.xml <manifest xmlns:android= … />! ! <uses-permission! ! android:name="android.permission.VIBRATE" />! ! <application android:icon= ! <activity>! </activity>! </application>! ! </manifest>! ©2012 Immersion Corporation–Confidential 23
- 24. Add Import Statement Import the UHL classes into your Activity in src/… MainActivity.java import com.immersion.uhl.*;! ©2012 Immersion Corporation–Confidential 24
- 25. Instantiate Launcher object in src/… MainActivity.java public class MainActivity extends Activity {! ! Launcher haptic;! ! @Override! public void onCreate(Bundle b) {! super.onCreate(b);! haptic = new Launcher(this);! ©2012 Immersion Corporation–Confidential 25
- 26. Use the Haptic Effect Preview App ©2012 Immersion Corporation–Confidential 26
- 27. Play Effect public sta+c final int BOUNCE_100 = 0; … public sta+c final int EXPLOSION7= 79; public sta+c final int ENGINE4_33 = 123; haptic.play(Launcher.EXPLOSION7);! ©2012 Immersion Corporation–Confidential 27
- 28. Stop any rendering when app Pauses in src/… MainActivity.java @Override! !protected void onPause() {! ! !super.onPause();! ! !haptic.stop();! !}! ©2012 Immersion Corporation–Confidential 28
- 29. Harden the code try {! ! haptic.play(Launcher.EXPLOSION7);! ! } catch (RuntimeException e) {! Log.e(”MyTestApp", e.getMessage());! }! ©2012 Immersion Corporation–Confidential 29
- 30. In a nutshell, that’s it! That’s all you need to put haptics in your app Now you can add cool pre-made haptic effects to your game applications. ©2012 Immersion Corporation–Confidential 30
- 31. Immersion Haptic SDK Plugins § Unity3D plugin § Marmalade plugin § YoYo Games Plugins available at www.immersion.com/haptic/sdk ©2012 Immersion Corporation–Confidential 31
- 32. 1 Haptics 2 Creating a new project 3 Linking to a 3rd party Library 4 Running your code on a phone 5 Wrap up ©2012 Immersion Corporation–Confidential
- 33. One time set up – using phone/tablet Eclipse ADT Eclipse plugin SDK Run As > Android Application workspace your app code platform library ©2012 Immersion Corporation–Confidential actual device
- 34. One time set up – PHONE / TABLET Home > All Apps > Settings • Applications > Development • Click “USB Debugging” & “Stay awake” • Different in Ice Cream Sandwich (Dev options) • Different in Jelly Bean (Hidden! click “build num” 7x) actual device Pull down Notification Shade > USB Connection • Click “Charge only”, “OK” Connect the device to your devt PC with a micro USB cable If using Windows, you need to install a driver on Windows. Get it from phone manufacturer’s developer website. ©2012 Immersion Corporation–Confidential
- 35. Run app on phone / tablet ©2012 Immersion Corporation–Confidential
- 36. 1 Haptics 2 Creating a new project 3 Linking to a 3rd party Library 4 Running your code on a phone 5 Wrap up ©2012 Immersion Corporation–Confidential
- 37. Haptic Effect Preview App § Free app on Google Play § Feel each effect on any Android device § Code sample provided for each effect § Awesome on Android handsets with TouchSense installed by Samsung, LG, Toshiba, Pantech and others § Emulates effects on all other Android devices without the TouchSense technology – Allows vibe effects not available with standard Google vibrate () method ©2012 Immersion Corporation–Confidential
- 38. Connect with Immersion #HapticsDev like “ImmersionDeveloper” search “Immersion Corporation” ©2012 Immersion Corporation–Confidential
- 39. Some great Android resources § http://developer.android.com § http://stackoverflow.com § Various meetups – § http://www.meetup.com/Android-Career-TrainingChicago/ § http://www.meetup.com/Newbie-Mobile-Developers/ § http://www.momochicago.org/ § http://www.meetup.com/chicago-google/ § Have a great time with this! ©2012 Immersion Corporation–Confidential
- 40. Contact Us Hap+csDev@immersion.com Like Us hNp://www.facebook.com/ImmersionDeveloper Follow Us @Hap+csDev Read Our Blog hNp://blog.immersion.com Direct Access: Peter van der Linden plinden@immersion.com Bob Heubel rheubel@immersion.com ©2012 Immersion Corporation–Confidential 40