Unity examples using the Augmenta-Unity library created by Théoriz.
https://assetstore.unity.com/packages/tools/integration/augmenta-for-unity-206658
This project uses submodules, you need to pull the submodules to get everything using $git submodule update --init --recursive.
- Download zip and unzip this project.
- Download zip and unzip Augmenta Unity in
/Assets/Plugins/Augmenta/. - Download zip and unzip Shared-Texture-Unity in
/Assets/Plugins/SharedTextureUnity/.
To start developping your application you probably need Augmenta data. If you do not have an Augmenta node ready, you can use our Augmenta simulator.
-
Open your Unity scene.
-
Drop the Augmenta prefab (from Assets/Plugins/Augmenta/Prefabs) in it.
-
Set the input port in the AugmentaManager script of the Augmenta prefab to your protocol port.
-
Run the scene.
-
You should see gizmos of your Augmenta scene and persons in the scene view. You can enable or disable debug objects with the Show Debug option of the AugmentaManager.
To instantiate your own prefab on each Augmenta object, add your prefab to the Custom Object Prefab parameter of the Augmenta Manager.
You can change this prefab at runtime by calling the function ChangeCustomObjectPrefab(GameObject newPrefab) of the Augmenta Manager.
Using Custom Behaviours
You can implement custom spawn and destroy behaviours for your custom Augmenta objects by implementing the IAugmentaObjectBehaviour interface in a script of your object. If you do, its Spawn function will be called when the object is instantiated, and its Destroy function will be called when the object should be destroyed (i.e. when the corresponding AugmentaObject is destroyed).
Note that if you implement the IAugmentaObjectBehaviour interface, the AugmentaObject will NOT destroy your object when it destroys itself, instead it will call the Destroy function of the interface. You should handle the destruction of the custom object yourself in the Destroy() function of the interface.
An example use of the custom behaviours is shown in scene 10 - AugmentaObjectBehaviour.
You can receive different Augmenta streams in the same Unity application as long as they are not on the same OSC port. You need to add an Augmenta prefab (i.e. AugmentaManager) for each incoming stream, then set each AugmentaManager ID and input port to listen to each protocol.
The simplest example using only the AugmentaManager to parse incoming Augmenta data and expose them to Unity.
In this example, an Augmenta Scene Camera is used to always render exactly the Augmenta Scene. The resulting texture is sent via Spout to be used in an external software.
This example analyzes the incoming Augmenta messages rate to compute an estimation of the number of messages received per second.
This example shows how to use an Augmenta Video Output along with an Augmenta Video Output Camera to always render exactly the video texture area sent by Fusion. The resulting texture is sent via Spout and shown on a debug quad in the scene.
In this workflow, the field of view of the camera is computed to always match exactly the Video Output area.
This example shows how to use an Augmenta Video Output along with any camera in the scene to render the intersection of the video texture area sent by Fusion and the camera's field of view. The resulting texture is sent via Spout and shown on a debug quad in the scene.
In this workflow, the field of view of the camera is fixed and color padding is added to the output video texture to match the desired texture resolution.
In this example, two different Augmenta streams are received on two different ports and placed in the scene to simulate the usecase of an interactive floor and an interactive wall used together in the same scene.
In this example, a custom object prefab is used to make a simple scene with squirrels react to Augmenta persons.
In this example, the Augmenta person data is send to a ripple shader in order to have the shader creates ripples under the Augmenta persons.
In this example, the Augmenta person data is send to a VFXGraph in order to make the sand particle react to the oldest 3 persons in the scene.
In this example, the FusionSpout prefab is used to display a Spout coming from Augmenta Fusion on a quad fitted to an AugmentaVideoOutput.
In this example, the IAugmentaObjectBehaviour interface is used in the custom object prefab to fade in and out a sphere rotating around each AugmentaObject.
In this example, the FusionNDI prefab is used to display an NDI coming from Augmenta Fusion on a quad fitted to an AugmentaVideoOutput.
In this example, an existing immersive space 3D model is imported and the Augmenta areas are mapped to the floor and walls of the space. The Fusion file for this space can be found in the Fusion folder of this scene.
There is an issue with Klak NDI that may cause an error when importing.
To fix it, you can try switching between the different Api Compatibility Level in Project Settings/Player/Other Settings/Configuration.
You can also remove the Klak NDI package and the 11 - FusionNDI folder if you do not intend to use NDI.
https://github.com/Augmenta-tech/Augmenta/wiki
Unity 2021.2.17f1