https://github.com/artcom/unity-android-watchdog-plugin

a java library for Unity Android apps which observes a heartbeat of the Unity App to check for blocked UI
https://github.com/artcom/unity-android-watchdog-plugin

Last synced: about 1 month ago
JSON representation

a java library for Unity Android apps which observes a heartbeat of the Unity App to check for blocked UI

• Host: GitHub
• URL: https://github.com/artcom/unity-android-watchdog-plugin
• Owner: artcom
• Created: 2015-07-31T12:20:29.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2015-07-31T15:12:35.000Z (over 9 years ago)
• Last Synced: 2024-11-07T06:36:25.174Z (3 months ago)
• Language: Java
• Size: 14 MB
• Stars: 4
• Watchers: 15
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# A Watchdog Plugin for an Unity3D Android App

The idea is to have a plugin for the Unity3D app which will restart the application as soon as it becomes unresponsive. This is done for the Unity3D app running on Android, so the plugin is written in Java. 

How to build an android java plugin for an C# Unity3D application we learned from this article: 

 - https://blog.nraboy.com/2014/06/creating-an-android-java-plugin-for-unity3d/

The idea is simple: The plugin provides a `tic` method to the unity app which must be called on every update in the main event loop. This is the heartbeat of the applcation, as long as the `tic` method is called, the app is considered alive. Once the app stops looping and thereby stops sending the tics, the plugin will restart the application. 

Two classes are involved in this: 

 - `HeartbeatWatchdog.java`: the java plugin code itseld and 

 - `UnityHeartbeat.cs`: the C# class to start and call the plugin class from C#

   Unity side. 

This project combines both parts in the two subdirectories:

 - **android-heartbeat-watchdog:** The android java code to handle the restart

 - **unity-android-heartbeat-watchdog-demonstrator:** A Unity3D demo project which

   show how the android plugin is used. 

**TODO:** explain Unity3D project setup with the plugin