How to use Android Ultimate Plugin For Unity3d

Hi Guys! Here’s the new way on how to use our Android Ultimate Plugin for Unity3d this changes will start on version 1.7.1 and if you are a previous user of this plugin please read the links and  information below before following the steps  , if you are a new user of this plugin you can follow the steps below directly.

New Structure version 1.7.1

http://www.gigadrillgames.com/2017/01/29/android-ultimate-plugin-major-changes-1-7-1/

How to Merged  Android Ultimate Plugin and Google play Services and use them  both at the same time

http://www.gigadrillgames.com/2017/01/31/merging-android-ultimate-plugin-1-7-1-on-google-play-services/

well after reading the above links at least you know now on why we need to do this changes and now you can follow this new steps

Step by step on how to setup the Android Ultimate Plugin for unity3d

1. Download the plugin from unity3d asset store 
https://www.assetstore.unity3d.com/en/#!/search/page=1/sortby=popularity/query=publisher:13227

2. Check and import all the files from plugin

3. Download the (dependencies) google play services libraries, support .aar and 3rd party files from this link

https://drive.google.com/drive/folders/1uU4tNGy7IhUgyAqB4RQpugLAbnn4UF72?usp=sharing

Play Services and Support dependecies
Play Services and Support dependecies
Universal-Image-Loader Dependency
Universal-Image-Loader Dependency

Universal-Image-Loader original source link look for jar

https://github.com/nostra13/Android-Universal-Image-Loader

Tip: there’s a chance that your project already got other dependencies from other plugin to check this you just need to check if there’s a similar name but different version number if this exists there’s a conflict on your libraries you need to remove/delete duplicate libraries in order to build your project successfully

4. uncompress the google play services libraries and support .aar files and put it inside “Assets/Plugins/Android

5. Inside Unity3d go to File Menu, Build Settings and then select player settings and look for other settings
and change the bundle indentifier to your game or app bundle identifier for ex. com.mycoolstudio.awesomegame

6. On Build Settings switch platform to android platform

7. Inside Unity3d in your Project hierarchy go to “Assets/AndroidUltimatePlugin/Scenes” and open the Demo scene

8. Inside Unity3d go to File Menu, Build Settings and then make sure that you added Demo Scene

9. Inside Unity3d go to File Menu, Build Settings and then select Build and Run

10. wait for the build and then check the application if everything is working fine and that’s it.

So Basically it’s just import and then use it unless you want to add more Android permissions or you want to remove Android permissions to do that please read the next topic below.

 

If you follow this steps and the app is not working or crashing it means Manual permissions is needed specially on latest version of Android OS , please follow this link

http://www.gigadrillgames.com/2019/04/21/give-an-android-application-permission-manually/

 

Android Manifest Permissions

To change or remove permissions please check the Android Manifest file inside Assets/Plugins/Android/aup/AndroidManifest.xml

this is some permissions that you will need but they are all inside by default

Internet

<uses-permission android:name=”android.permission.INTERNET” />

Reading And Writing files

<uses-permission android:name=”android.permission.READ_EXTERNAL_STORAGE” />
<uses-permission android:name=”android.permission.READ_INTERNAL_STORAGE” />

For Accessing the Network State this one is also used by GPS

<uses-permission android:name=”android.permission.ACCESS_NETWORK_STATE” />

Flashlight

<uses-permission android:name=”android.permission.FLASHLIGHT”/>
<uses-permission android:name=”android.permission.CAMERA”/>
<uses-feature android:name=”android.hardware.camera”/>
<uses-feature android:name=”android.hardware.camera.autofocus” />
<uses-feature android:name=”android.hardware.camera.flash” />

Camera

<uses-permission android:name=”android.permission.WRITE_EXTERNAL_STORAGE” />
<uses-permission android:name=”android.permission.CAMERA” />
<uses-feature android:name=”android.hardware.camera” />
<uses-feature android:name=”android.hardware.camera.autofocus” />
<uses-feature android:name=”android.hardware.camera.front” android:required=”false” />

Vibration

<uses-permission android:name=”android.permission.VIBRATE”/>

For Recording Audio

<uses-permission android:name=”android.permission.WRITE_EXTERNAL_STORAGE” />
<uses-permission android:name=”android.permission.RECORD_AUDIO” />

GPS

<uses-permission android:name=”android.permission.ACCESS_FINE_LOCATION”/>
<uses-permission android:name=”android.permission.ACCESS_COARSE_LOCATION”/>

Alarm Clock

<uses-permission android:name=”android.permission.FOREGROUND_SERVICE” />
<uses-permission android:name=”android.permission.WAKE_LOCK”/>
<uses-permission android:name=”android.permission.DISABLE_KEYGUARD”/>
<uses-permission android:name=”android.permission.RECEIVE_BOOT_COMPLETED” />

Accessing Wifi State

<uses-permission android:name=”android.permission.CHANGE_WIFI_STATE” />
<uses-permission android:name=”android.permission.ACCESS_WIFI_STATE” />

Accessing Device information

<uses-permission android:name=”android.permission.READ_PHONE_STATE” />

Getting Accounts on the Device

<uses-permission android:name=”android.permission.GET_ACCOUNTS”/>

Getting Contacts on the Device

<uses-permission android:name=”android.permission.READ_CONTACTS”/>
<uses-permission android:name=”android.permission.READ_PROFILE”/>

Accessing Settings

<uses-permission android:name=”android.permission.WRITE_SETTINGS” />
<uses-permission android:name=”android.permission.WRITE_SECURE_SETTINGS” />

SMS
<uses-permission android:name=”android.permission.WRITE_SMS” />
<uses-permission android:name=”android.permission.READ_SMS” />
<uses-permission android:name=”android.permission.SEND_SMS” />
<uses-permission android:name=”android.permission.RECEIVE_SMS” />
Alarm Clock
<uses-permission android:name=”android.permission.FOREGROUND_SERVICE” />

Inside Application Tag you need to have this line

Custom Camera Activity

<activity android:label=”@string/app_name” android:name=”com.gigadrillgames.androidplugin.camera.CustomCameraActivity”></activity>

Local Notification

<receiver android:name=”com.gigadrillgames.androidplugin.notification.NotificationPublisher”/>

Removed
<receiver android:name=”com.gigadrillgames.androidplugin.notification.NotificationOnBootReceiver”>
<intent-filter>
<action android:name=”android.intent.action.BOOT_COMPLETED” />
</intent-filter>
</receiver>
Removed

<service android:name=”com.gigadrillgames.androidplugin.notification.NotificationService”
android:enabled=”true”
android:exported=”true”>

Alarm

<receiver android:name=”com.gigadrillgames.androidplugin.alarm.AlarmManagerBroadcastReceiver”/>
<service android:name=”com.gigadrillgames.androidplugin.alarm.AlarmService” android:enabled=”true” android:exported=”true”/>

Accessing Google play services remove this you don’t need this

<meta-data android:name=”com.google.android.gms.version” android:value=”@integer/google_play_services_version” />

For Demo APK please go to this link

https://drive.google.com/file/d/1UTbhNi9s-3TrBzS4fJ9AGaArzQIjScPV/view?usp=sharing

And That’s all, thanks for Purchasing Android Ultimate Plugin for Unity3d and more power to you! 🙂

For more questions or suggestions or comments please email us at gigadrillgames@gmail.com

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.