AssetStreaming was built to demonstrate how to handle world loading without loading everything into memory at once. For more details and explanations you can visit our Guide to Asset Streaming in Open World Game. More documentation that explains the ideas and the approach behind this project can be found here.
This codebase is availabale as a reference to help you setup your own asset streaming project. Unity-AssetStreaming is under the license found here unless otherwise specified.
See the CONTRIBUTING file for how to help out.
The majority of Asset Streaming is licensed under MIT LICENSE, however files listed below are licensed under their respective licensing terms.
- [TextMeshPro](./Assets/TextMesh Pro) - Unity Companion License
- Demo Assets - Meta Platforms Technologies Examples License
First, ensure you have Git LFS installed by running this command:
git lfs installThen, clone this repo using the "Code" button above, or this command:
git clone https://github.com/oculus-samples/Unity-AssetStreaming.gitTo run the sample, open the project folder in Unity 2021.3.26f1 or newer. Load the Assets/Scenes/Startup scene.
In order to build to device we need 2 steps. First we need to build the addressables assets, then we can build the apk.
You can use the traditional route to build addressables from the groups menu (Window->Asset Management->Addressables->Groups). Then open Build Settings and click Build.
We also added an utility menu. Under AssetStreaming menu on the menu bar, you can do different builds:
- Build Addressables and Apk: build the addressables and the apk
- Build Addressables: Build's only the addressables
- Build Apk: Build's only the apk (usefull when only changing code)
In our implementation of the LOD Generator, we used a package from the Asset Store called Mesh Baker. We highly recommend using Mesh Baker to create texture atlases and combine your meshes. Alternatively, you could write your own or get a license for something like Simplygon.
For Licenses reasons we didn't include Mesh Baker in the project.
We detailed how we converted the original Asset Streaming project to use Unity Addressables system here.
You can find the build version on the Quest Store