This document discusses extending Unity functionality using Java and Android plugins. It describes creating an Android plugin in Unity, communication between Java and Unity code, and some common Android features that can be accessed from Unity like Toasts, notifications, intents and web views. Limitations of plugins are noted as well as pros and cons versus other integration methods. Code examples are provided for various Android features that can be called from Unity using a plugin.

1. @agatestudio
@agatestudio
Unity Android
Rio
Knight
Agate Studio
Sanrio Hernanto

2. @agatestudio@agatestudio@agatestudio@agatestudio
Extending Unity Functionality using Java Android

3. @agatestudio@agatestudio@agatestudio@agatestudio
Overview
• Extending Unity via Android Plug-in
– Creating Unity Android Plug-in
– Java – Unity Communication
– Limitation
– Pros & Cons VS Other Methods
• Java Android Usability
– Toast
– Local Notification
– Intent Call
– WebView
– etc

4. @agatestudio@agatestudio@agatestudio@agatestudio
Creating Unity Android Plug-in
• Pre-requisite
– Eclipse
– Android SDK

5. Create New Android Application Project

6. Create New Android Application Project

7. Create New Android Application Project

8. Add Unity Library to Project

9. Add Unity Library to Project

10. Create Your Own Class

11. Create Your Own Class

12. Create Your Own Class

13. Export Your Project

14. Export Your Project

15. Export Your Project

16. Put your JAR file as Unity Android Plugins

17. @agatestudio@agatestudio@agatestudio@agatestudio
Java – Unity Communication
• Java to Unity
– Access to Unity Activity
– Send Message to Unity
• Unity to Java
– Access to Java Class
– Call Java Function

18. @agatestudio@agatestudio@agatestudio@agatestudio
Java to Unity

19. @agatestudio@agatestudio@agatestudio@agatestudio
Java to Unity – Unity Send Message

20. @agatestudio@agatestudio@agatestudio@agatestudio
Unity to Java - AndroidJavaClass
• Unity C#
• Java

21. @agatestudio@agatestudio@agatestudio@agatestudio
Unity to Java - AndroidJavaObject
• Unity C#
• Java

22. @agatestudio@agatestudio@agatestudio@agatestudio
Result

23. @agatestudio@agatestudio@agatestudio@agatestudio
Limitation
• Java to Unity cannot receive return value
• Does not extend Android Activity
Alternative Method
• Extending UnityPlayerActivity
• Modifying Android Manifest from Unity
• Building JAR via Command Prompt
• Custom Build.xml

24. @agatestudio@agatestudio@agatestudio@agatestudio
Pros & Cons
• Pros
– Simple Plug-in Code & Build
– Edit and Compile Java and Android Code with full Eclipse
Usage
– Non Strict Packages (com.something.something)
– Does not edit Android Manifest file from Unity
• Cons
– Does not extend Android Activity directly
– Does not edit Android Manifest file

25. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – Toast
http://developer.android.com/guide/topics/ui/notifiers/toasts.html

26. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – Toast
• Java Toast Code

27. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – Local Notification
http://developer.android.com/guide/topics/ui/notifiers/notifications.html

28. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – Local Notification

29. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – Local Notification
• Java Local Notification Code

30. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – Intent Call
• Intent Call to Open File or Url

31. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – Intent Call
• Java Intent Call Code

32. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – WebView
• WebView

33. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – WebView
• Java WebView Code

34. @agatestudio@agatestudio@agatestudio@agatestudio
Java Android Usability – ETC
• Push Notification
• Database
• Java Library
• Anroid Usability using Additional Methods
– Services
– Widgets

35. Source Code
https://dl.dropboxusercontent.com/u/18962743/source.zip
Thank You