# Android_Utils_Plugin A simple android library project for Unity which contains some useful features: + Capture android screen as a video. + Request android permissions at runtime. Thank for the open source project which I use as a record service in this repository. Visit this site to get a details explaining of Unity_Android_Screen_Recorder. **

If you are using this library in one of your applications and would like to thank me:

or via PayPal:

## Build guide + Clone this project and open it using Android Studio. + Make module androidutils. + Wait for build process to complete then get your plugin in Android_Screen_Recorder/unityrecorder/build/generated/outputs/aar/unityrecorder-release.aar + Copy the unityrecorder-release.aar to Plugins/Android folder inside your project. + Add a AndroidManifest.xml in the same folder which have the content below: ```xml

``` Now your plugin is ready to use in any Unity project. ## Screen Record guide To record android screen you have to follow this instruction: ### 1.Set-up recorder Call this inside Start() function of your script. ```cs #if UNITY_ANDROID && !UNITY_EDITOR using (AndroidJavaClass unityClass = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) { androidRecorder = unityClass.GetStatic("currentActivity"); androidRecorder.Call("setUpSaveFolder","Tee");//custom your save folder to Movies/Tee, by defaut it will use Movies/AndroidUtils int width = (int)(Screen.width > SCREEN_WIDTH ? SCREEN_WIDTH : Screen.width); int height = Screen.width > SCREEN_WIDTH ? (int)(Screen.height * SCREEN_WIDTH / Screen.width) : Screen.height; int bitrate = (int)(1f * width * height / 100 * 240 * 7); int fps = 30; bool audioEnable=true; androidRecorder.Call("setupVideo", width, height,bitrate, fps, audioEnable, VideoEncoder.H264.ToString());//this line manual sets the video record setting. You can use the defaut setting by comment this code block } #endif ``` ### 2. Start record Then call this to start record screen. ```cs #if UNITY_ANDROID && !UNITY_EDITOR if (!AndroidUtils.IsPermitted(AndroidPermission.RECORD_AUDIO))//RECORD_AUDIO is declared inside plugin manifest but we need to request it manualy { AndroidUtils.RequestPermission(AndroidPermission.RECORD_AUDIO); onAllowCallback = () => { androidRecorder.Call("startRecording"); }; onDenyCallback = () => { ShowToast("Need RECORD_AUDIO permission to record voice");}; onDenyAndNeverAskAgainCallback = () => { ShowToast("Need RECORD_AUDIO permission to record voice");}; } else androidRecorder.Call("startRecording"); #endif ``` ### 3. Stop record Call ```cs androidRecorder.Call("stopRecording"); ``` ### 4. Handle callback Create a function name VideoRecorderCallback(string message) inside your project. It will receive callback from java side. List of messages from java: + init_record_error + start_record + stop_record ## Runtime Permissions guide Runtime permission allow you to request android permission at runtime(for android 6.0 and above). Example: When your game need to access location service, instead of request this permission at the first runtime now you can delay it until the moment your app actually need to use the permission. Note that. Your app can only request the permissions which have been declared in AndroidManifest.xml ### 1. You need to declare the permissions in AndroidManifest.xml. Then add this below meta-data to skip request permission dialog when you open app first time ```xml ``` the final AndroidManifest.xml must look similar like this. ```xml

``` ### 2.To check if your app has a permision ```cs public static bool IsPermitted(AndroidPermission permission) { #if UNITY_ANDROID && !UNITY_EDITOR using (var androidUtils = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) { return androidUtils.GetStatic("currentActivity").Call("hasPermission", GetPermissionStrr(permission)); } #endif return true; } ``` ### 3.To request a permission ```cs public static void RequestPermission(AndroidPermission permission, UnityAction onAllow = null, UnityAction onDeny = null, UnityAction onDenyAndNeverAskAgain = null) { #if UNITY_ANDROID && !UNITY_EDITOR onAllowCallback = onAllow; onDenyCallback = onDeny; onDenyAndNeverAskAgainCallback = onDenyAndNeverAskAgain; using (var androidUtils = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) { androidUtils.GetStatic("currentActivity").Call("requestPermission", GetPermissionStrr(permission)); } #endif } ``` ### 4. Helper function to convert from enum to android permission string ```cs private static string GetPermissionStrr(AndroidPermission permission) { return "android.permission." + permission.ToString(); } ``` ### 5. List of android permissions ```cs public enum AndroidPermission { ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION, ADD_VOICEMAIL, BODY_SENSORS, CALL_PHONE, CAMERA, GET_ACCOUNTS, PROCESS_OUTGOING_CALLS, READ_CALENDAR, READ_CALL_LOG, READ_CONTACTS, READ_EXTERNAL_STORAGE, READ_PHONE_STATE, READ_SMS, RECEIVE_MMS, RECEIVE_SMS, RECEIVE_WAP_PUSH, RECORD_AUDIO, SEND_SMS, USE_SIP, WRITE_CALENDAR, WRITE_CALL_LOG, WRITE_CONTACTS, WRITE_EXTERNAL_STORAGE } ``` ### 6. Implement 3 functions below to receive callback when you request a permission ```cs private void OnAllow(){} private void OnDeny(){} private void OnDenyAndNeverAskAgain(){} ```