Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JustinFincher/UniLWP.Droid.Package.Free
Open-sourced version of UniLWP.Droid, an Android live wallpaper solution for Unity 2019.3+
https://github.com/JustinFincher/UniLWP.Droid.Package.Free
android livewallpaper unilwp unity unity-asset unity3d unity3d-plugin upm upm-package
Last synced: 3 months ago
JSON representation
Open-sourced version of UniLWP.Droid, an Android live wallpaper solution for Unity 2019.3+
- Host: GitHub
- URL: https://github.com/JustinFincher/UniLWP.Droid.Package.Free
- Owner: JustinFincher
- License: gpl-3.0
- Created: 2020-05-01T03:57:38.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-06-21T16:34:19.000Z (over 4 years ago)
- Last Synced: 2024-04-30T04:43:01.451Z (7 months ago)
- Topics: android, livewallpaper, unilwp, unity, unity-asset, unity3d, unity3d-plugin, upm, upm-package
- Homepage: http://u3d.as/1QVw
- Size: 250 KB
- Stars: 35
- Watchers: 5
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# UniLWP.Droid (Free Version) UPM Package
[](https://openupm.com/packages/com.justzht.unilwp.droid.free/)
UniLWP.Droid is an Android live wallpaper framework for Unity. With it, you can create Android Studio projects that compile to live wallpaper apps. This is the free version of it (full version on: [Asset Store](http://u3d.as/1QVw)), which only contains necessary code for live wallpaper service itself. The demo app for UniLWP.Droid (full version) is also on [Google Play](https://play.google.com/store/apps/details?id=com.justzht.unilwp.droid).
For packaging purposes, the plugin is uploaded as an aar file. The java source can be found on the [JavaSource](https://github.com/JustinFincher/UniLWP.Droid.Free.JavaSource) repo.
# Screenshots
| Editor | Activity | Service |
:-------------------------:|:-------------------------:|:-------------------------:
 |  | 
# Requirements
- Unity 2019.3+
- Android API: 7.0 and up
- Works best with OpenGL ES 3.0 (Vulkan is fine, but not that good)
# Installation Guide
- Add this line to your manifest.json
```
"dependencies": {
"com.justzht.unilwp.droid.free": "https://github.com/JustinFincher/UniLWP.Droid.Package.Free.git" // this line
}
```
- If you are not in Android target, switch to Android target now
- Modify your build settings
- Android API to 7.0 and up
- Disable the Optimized Frame Pacing option
- Disable Unity Audio (Optional)
- Graphics API to OpenGL ES 3.0 (Optional)
- Build an apk and install it to your Android device
- Now you have one activity on your launcher, and one service if you open the live wallpaper picker
# How does UniLWP.Droid work?
This section has a more detailed version on [UniLWP.Droid Documentation](https://docs.google.com/document/d/10b5zDYjr2MDDKUhuUeq192YYoOb5YHcEqfLbr_5m9iM/edit?usp=sharing), check it out if you want to know more.
The UnityPlayer java class has a constructor that accepts a Context instance to init the player itself. It also has a method for switching surfaces:
```java
class UnityPlayer
{
public UnityPlayer(Context var1) {}
public boolean displayChanged(int var1, Surface var2) {}
}
```
As UnityPlayer does not enforce the activity check (it actually did for `runOnUiThread` reasons, but that is another story), we can pass an application context to the parameter and init a UnityPlayer.
This should be executed as soon as possible, so UniLWP.Droid introduced a ContentProvider subclass solely for early-init purposes.
> For why ContentProvider is even inited earlier than the `onCreate` call in the Application class, please read a post on [firebase blog](http://firebase.googleblog.com/2016/12/how-does-firebase-initialize-on-android.html).
Our ContentProvider subclass provides a universal application context that calls Unity at the beginning of the application lifecycle, so any Activity or Service inited after that are free of null reference exceptions.
> Each Activity or WallpaperService references a Surface. On Activity, it is a SurfaceView, and on WallpaperService, it is a SurfaceHolder. UniLWP.Droid registers the callback of these surfaces and call `displayChanged` when a new surface is visible. This is how UniLWP.Droid switch the display target dynamically.
However, Unity's default activity implementation isn't designed for such usages. In order to bypass this, UniLWP provides an Activity class that replaces the default Activity in gradle compiling stages. The magic is in the merging process of AndroidManifest.xml files. For more you can read [how to remove activity from manifest](https://developer.android.com/studio/build/manifest-merge).
# Feature Comparsion
This is the free & open-sourced version of UniLWP.Droid, and certain features are missing in order for you to buy the full version (obviously). For a comparsion between this free version and a [paid version](http://u3d.as/1QVw), see the table below:
| UniLWP.Droid | Free | Paid |
|---------------------------------------|-----------------------------------------------------|------|
| Live Wallpaper | ✅ | ✅ |
| One-click deploy | ✅ | ✅ |
| Callbacks (Offset, Lock Event, etc) | ❌ | ✅ |
| Touch Events | ❌ | ✅ |
| C# Post-build Scripts For Easy Update | ❌ | ✅ |
| Modular Customization | ✅(only if you read the code and extend it yourself) | ✅ |
# Have Questions?
Open an issue or write an email to [[email protected]](mailto:[email protected])
# Apps Using UniLWP.Droid
- [DEV Sample](https://play.google.com/store/apps/details?id=com.justzht.unilwp.droid)
- [Metropolis 3D City LWP](https://play.google.com/store/apps/details?id=com.justzht.metropolis)
- [Vortex Data Driven Particle LWP](https://play.google.com/store/apps/details?id=com.justzht.vortex)