How To Integrate echo3D Into a Unity Project — Free Tutorial
Tags: tutorial, unity3d, gamedev, csharp
Published: 2022-07-02 00:47:16

Depending on your project size and platform, it can be challenging to update all your assets smoothly! [echo3D](http://www.echo3d.co\) has made it easy to do this by simply using an API key. Assets are stored on the [echo3D](http://www.echo3d.co\) cloud and called at runtime so your experience runs smoothly and faster, every time and everywhere.

In this tutorial, you will modify an existing Unity project to utilize echo3D. The music making icons will be swapped out in echo3D.

Click this link [**https://go.echo3d.co/4vFU**](https://go.echo3d.co/4vFU) or scan this QR code to see something musical 🎸.

![](https://miro.medium.com/max/1348/1*-gYIbQMbbZ4ONs_NWhshWg.png)

Video Tutorial
==============
{% youtube xHi7yPzaz2Q %}

Register
========

Don’t have an echo3D account? Register for FREE at [echo3D](https://console.echo3d.co/#/auth/register).

Version
=======

[Unity 2021.2.7f1](https://unity3d.com/get-unity/download/archive)

Setup
=====

*   Clone this [repo](https://github.com/echo3Dco/Unity-echo3D-demo-ConvertProjectToEcho), see the full README [here](https://github.com/echo3Dco/Unity-echo3D-demo-ConvertProjectToEcho/blob/main/README.md)
*   [Import the Unity SDK](https://docs.echo3D.co/unity/installation)
*   [Add the assets](https://docs.echo3D.co/quickstart/add-a-3d-model) to the echo3D console from the Unity ‘Models’ folder
*   Uncheck the [Security](https://docs.echo3d.co/web-console/deliver-pages/security-page) box in your console
*   In Unity, open _MusicScene_
*   Drag the _echo3D script_ onto the Drum, Piano and Guitar
*   Add the API key and entry ID for each object in the Inspector

![](https://miro.medium.com/max/1400/1*0Z_JDVXFCJNPaE9CkL18BA.png)![](https://miro.medium.com/max/916/1*avr9BU31JiZd56DC4clLUw.png)

*   In the Hierarchy, uncheck the box for the Sprite Renderer for Drum, Piano and Guitar
*   Press _Play_ in Unity to see where the 3 assets show up in the scene so you can modify the [metadata](https://docs.echo3d.co/unity/transforming-content) in the console
*   Adjust the [metadata](https://docs.echo3d.co/unity/transforming-content) in the echo3D console as follows so the assets appear within the colliders:
    Drum: scale: .1/ xAngle: 90/ zAngle: 180
    Piano: scale: .1/ xAngle: 90/ zAngle: 180/ x: -7/ z: .4
    Guitar: scale: .1/ xAngle: 90/ zAngle: 180/ x: -14/ z: .4

Run
===

*   Press _Play_ in Unity and click on each instrument to play and stop music while the assets stream from the echo3D cloud 🎉.

Learn More
==========

Refer to our [documentation](https://docs.echo3D.co/unity/) to learn more about how to use Unity and echo3D.

Support
=======

Feel free to reach out at [support@echo3D.co](mailto:support@echo3D.co)or join our [support channel on Slack](https://go.echo3D.co/join).

Sources
=======

*   [Guitar audio](https://www.bensound.com/royalty-free-music/track/acoustic-breeze)
*   [Drum audio](https://www.bensound.com/royalty-free-music/track/downtown)
*   P[iano audio](https://www.bensound.com/royalty-free-music/track/once-again)
*   [Frame graphic](https://www.canva.com/design/play?locale=en&layoutQuery=square+frame&analyticsCorrelationId=f7ba0eb9-bdd8-41e5-8578-e99b67b21209)
*   [Instruments — macrovector / freepik](https://www.freepik.com/free-vector/colored-flat-musical-icons-isolated-black-background_10600517.htm#query=instruments&position=49&from_view=search)
*   [‘Squealer’ rock and roll font](https://www.dafont.com/squealer.font)

Support
=======

Feel free to reach out at [support@echo3D.co](mailto:support@echo3D.co) or join our [support channel on Slack](https://go.echo3d.co/join). For additional troubleshooting, debug [here](https://docs.echo3d.co/unity/troubleshooting).

More Tutorials
==============

For more easy tutorials, check these out:

*   [Build a 3D Balloon Pop game in Unity](https://medium.com/echo3d/build-a-balloon-pop-game-unity-free-eed9fe7d8be9)
*   [Get a Quarantine Dog in AR](https://medium.com/echo3d/get-a-quarantine-dog-in-ar-8383ea55376b)
*   [How to Create 3D Content and See It In AR](https://medium.com/echo3d/how-to-create-3d-content-and-see-it-in-ar-free-no-coding-required-369e5b4a4b3e)

***

>_**echo3D** ([www.echo3D.co](http://www.echo3d.co/); Techstars 19’) is a cloud platform for 3D/AR/VR that provides tools and network infrastructure to help developers & companies quickly build and deploy 3D apps, games, and content._

![](https://miro.medium.com/max/1400/1*cNrRDT0JEpkcy-zG6KBNgw.png)