readme updated

Author: Noddy20

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Arupakaman Studios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1 +1,30 @@
-# Unity-Android-SDK-Plugins
+# Unity Android SDK Plugins
+
+Unity Android SDK Plugins is an Open Source project that contains code to generate Android SDK/Plugins (.aar files) that can be used in an Unity project to implement/access native Android features.
+
+## Available Plugins :
+
+- pluginbasicutils - Provides basic Android util functions i.e. to show a toast, to check network connectivity [know more](/pluginbasicutils/README_PLUGINBASICUTILS.md)
+
+## Usage
+
+- Download the plugin .aar file that you want to use in your Unity project from releases or build it by yourself and paste the .aar file in your Unity project's `Assets/Plugins/Android` directory.
+- Use [External Dependency Manager](https://github.com/googlesamples/unity-jar-resolver) for Unity to resolve the dependencies used in the plugins.
+- Add project config ext variables in project level gradle like:
+```
+    ext{
+        compileTargetSDK = 31
+        kotlin = '1.5.30'
+    }
+```
+Check [build.gradle](build.gradle) for current config.
+- Check out usage code snippet for each plugin in their respective READ_ME files.
+
+### Request
+If you need an Android unity aar plugin create an issue with feature request or mail us at arupakamanstudios[AT]gmail[DOT]com.
+
+### I prefer a star than a cup of coffee
+
+## Licensing
+
+This project is licensed under the [MIT License.](LICENSE)

pluginbasicutils/README_PLUGINBASICUTILS.md

@@ -0,0 +1,67 @@
+# Unity Android SDK Plugins Basic Utils
+
+This plugin provides basic Android util functions.
+
+## Plugin Functions/Features :
+
+- Show Android Toast UI/Popup (Short/Long)
+- Check if device has Internet connection
+- Check if device is connected to a WiFi
+- Check if WiFi is enabled on device
+- Check if Hotspot is enabled on device
+- Check if Bluetooth is enabled on device
+- Check if Developer Mode (USB debugging) is enabled
+- Check if Device is Rooted
+- Check if Device is Rooted or has any harmful app installed
+- Check if Location Service (GPS) is enabled  
+- Get Android Device Id (Settings.Secure.ANDROID_ID or SSAID)
+- Get Current Device Battery Percentage
+
+## Plugin Usage :
+
+In your unity project, you can use these plugins in your C# scripts.
+
+### Common code required to access all functions
+
+```
+const string pluginName = "com.arupakaman.pluginbasicutils.unity.UnityUtils";             // Constant of util static class location
+
+    AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
+    AndroidJavaObject jo = jc.GetStatic<AndroidJavaObject>("currentActivity");            // jo will be used for Context param
+    AndroidJavaClass ajc = new AndroidJavaClass(pluginName);                              // ajc will be used to access UnityUtils class
+```
+
+### To show Android Toast UI/Popup (Short/Long)
+
+```
+    ajc.CallStatic("toast", jo, "Hello Unity World!");            // toast is function name to show the Toast
+    ajc.CallStatic("toastLong", jo, "Hello Unity World!");        // for long toast
+```
+
+### To check boolean returning functions
+
+```
+    bool isNetConnected = ajc.CallStatic<bool>("isNetConnected", jo);
+    bool isWifiConnected = ajc.CallStatic<bool>("isWifiConnected", jo);
+    bool isWifiEnabled = ajc.CallStatic<bool>("isWifiEnabled", jo);
+    bool isHotspotEnabled = ajc.CallStatic<bool>("isHotspotEnabled", jo);
+    bool isBluetoothEnabled = ajc.CallStatic<bool>("isBluetoothEnabled", jo);
+    bool isDeveloperModeEnabled = ajc.CallStatic<bool>("isDeveloperModeEnabled", jo);
+    bool isRooted = ajc.CallStatic<bool>("isRooted", jo);
+    bool isRootedOrHarmfulAppsInstalled = ajc.CallStatic<bool>("isRootedOrHarmfulAppsInstalled", jo);
+    bool isGpsEnabled = ajc.CallStatic<bool>("isGpsEnabled", jo);
+```
+
+### To get Android Device ID
+
+```
+    string androidDeviceId = ajc.CallStatic<string>("getAndroidDeviceId", jo);
+```
+
+### Current Device Battery Percentage
+
+```
+    int batteryPercentage = ajc.CallStatic<int>("getBatteryPercentage", jo);
+```
+
+### I prefer a star than a cup of coffee