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 Oculus License applies to the SDK and supporting material.
The Demo Assets used in this project are released under the Oculus Examples License.
The MIT License applies to only certain, clearly marked documents. If an individual file does not indicate which license it is subject to, then the Oculus License applies.
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 2019.4.34f1 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 order to keep the project simple, we kept only the required features from Oculus Integration. We kept VR and Platform. To update it, import the updated Asset Store package, and select only VR and Platform.
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 AppLab: