Unity3D Android Lockscreen not shown when screen times out. (Wakelock?)

Question 1

First I'd like to say thanks to MichaelTaylor3D's Answer for pointing me in the right direction.

There were a few issues with the way he solved the problem that I think I have corrected:

The first issue is with the KeyguardManager approach to locking the screen. This was depreciated in API version 8 and won't work on API 9+. The new solution uses the Device Admin API which seems very intrusive for a game.

I looked through the UnityPlayer definition in eclipse and found a function called setWakeLock(boolean), however it is private.

I made a custom android Activity. In it, I access a protected UnityPlayer function setWakeLock(boolean) and calls it in the onPause function.

I admit this is less than ideal, but it does seem to work with no side effects. I've submitted a bug report to Unity, so hopefully this work around will not be required for long.

public class UnityPlayerWithLockscreen extends UnityPlayerNativeActivity {


    @Override
    public void onCreate(Bundle savedInstanceState) 
    {
         super.onCreate(savedInstanceState);
    }

    //Provides access to the private UnityPlayer.setWakeLock(boolean) method.
    public void setWakeLock(boolean useWakelock) {
        Method setWakeLockMethod;

        //Use Reflection to get the setWakeLock(boolean) method from the UnityPlayer class
        setWakeLockMethod = mUnityPlayer.getClass().getDeclaredMethod("setWakeLock");

        //Set the method to me accessible
        setWakeLockMethod.setAccessible(true);

        //Invoke the method with our argument
        setWakeLockMethod.invoke(mUnityPlayer, useWakelock);
    }


    @Override
    protected void onPause()
    {
        super.onPause();

        //Force unity to release the wakelock
        setWakeLock(false);     
    }
}

Then you need to set this activity as the main activity in the AndroidManifest file:

<?xml version="1.0" encoding="utf-8"?>
<application android:icon="@drawable/icon" android:label="@string/app_name">
    <activity android:name=".UnityPlayerWithLockscreen"
              android:label="@string/app_name">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

This solution also doesn't require any C# scripts or C# <-> Java interop.

Again, I know this is sort of a hacky solution, but it seems to work on several devices regardless of API level with no side effects. Hopefully this gets fixed by Unity soon and will no longer require an ugly fix.

Question 2

I do not have any experience from Unity but try using this http://developer.android.com/reference/android/os/PowerManager.WakeLock.html

To see if unity is forcing the wakelock somehow with isHeld(); and try to override it within your activity

EDIT: I am using wakelock when downloading and this makes the screen go black but not lock the device, so this is probably the case so try to release it, this might give some kind of conflict but it's always worth a try.

Question 3

This is untested but you can try this,

Basically you want to try to access the Android SDK directly, Unity has some classes that allow you to do this.

Try writing an external Java class and place it in the Plugins/Android Folder.

The Java class method might be something like this: referenced from this question make sure that its compiled into a .jar file

package com.yourcompany.yourgamename;

import com.unity3d.player.UnityPlayerActivity;

import android.content.Context;
import android.os.Bundle;
import android.util.Config;
import android.util.Log;
import android.app.Activity;   

public class MainActivity extends UnityPlayerActivity 
{    
    @Override
    public void onCreate(Bundle savedInstanceState) 
    {
         super.onCreate(savedInstanceState);
    }

    public static void lockScreen()
    {
        KeyguardManager keyguardManager = (KeyguardManager)getSystemService(Activity.KEYGUARD_SERVICE); 
        KeyguardLock lock = keyguardManager.newKeyguardLock(KEYGUARD_SERVICE);  
        lock.reenableKeyguard();  
    }
}

Also make sure this is in the Android Manifest file so that Unity loads this activity instead of the main one and put it in \Plugins\Android folder:

<?xml version="1.0" encoding="utf-8"?>

<application android:icon="@drawable/icon" android:label="@string/app_name">
    <activity android:name=".MainActivity"
              android:label="@string/app_name">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

Then create a Unity C# script that invokes the external Java Class: referenced here

public static void InvokeAndroidLockScreen()
{
    #if UNITY_ANDROID
    using (AndroidJavaClass cls_UnityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer"))
    {
         using (AndroidJavaObject obj_Activity = cls_UnityPlayer.GetStatic<AndroidJavaObject>("currentActivity"))
         {
              obj_Activity .CallStatic("lockScreen");
         }
    }
    #else
    Debug.LogWarning("Cant invoke lockscreen on a non Android Device");
    #endif

}

Then finally in an active monobehavior invoke the lockscreen on the application pause event: referenced here

void OnApplicationPause(bool pauseStatus)
{
     InvokeAndroidLockScreen();
}

You would have to make sure that the following flag is set to false

Application.runInBackground = false;

I would think or else the pause event wont get triggered when the device turns off. (This is off by default)

Even if this is a work around, I still think this is a Unity Bug that should be reported to them.