👩‍💻 Edit Code

Now that you are able to successfully stream the 3D model into Unity, it's time to make some custom adjustments.
Each hologram will be instantiated with a script named CustomBehaviour.cs attached. You can edit this script to create any behavior you would like while referencing additional data streamed from the cloud.
Code Example
Open the Assets/echo3D/CustomBehaviour.cs script:
CustomBehaviour.cs
1
using System.Collections;
2
using System.Collections.Generic;
3
using UnityEngine;
4
​
5
public class CustomBehaviour : MonoBehaviour
6
{
7
    [HideInInspector]
8
    public Entry entry;
9
​
10
    /// <summary>
11
    /// EXAMPLE BEHAVIOUR
12
    /// Queries the database and names the object based on the result.
13
    /// </summary>
14
​
15
    // Use this for initialization
16
    void Start()
17
    {
18
        // Add RemoteTransformations script to object and set its entry
19
        this.gameObject.AddComponent<RemoteTransformations>().entry = entry;
20
​
21
        // ADD YOUR CODE HERE //
22
        // Qurey additional data to get the name
23
        string value = "";
24
        if (entry.getAdditionalData() != null && 
25
            entry.getAdditionalData().TryGetValue("name", out value))
26
        {
27
            // Set name
28
            this.gameObject.name = value;
29
        }
30
    }
31
​
32
    // Update is called once per frame
33
    void Update()
34
    {
35
​
36
    }
37
}
Copied!
 Note that this is an regular Unity MonoBehaviour with additions to the Start() function.
Lines 18-19 attaches a RemoteTransformations component to the game object and sets its content entry. This component is in charge of enabling real-time updates and animations.
1
// Add RemoteTransformations script to object and set its entry
2
this.gameObject.AddComponent<RemoteTransformations>().entry = entry;
Copied!
You can add any custom code after line 21. An example follows.
Querying Metadata
Lines 22-28 are an example that queries the entry's metadata for a key called name, and if such key exists, set the game object's name to the corresponding value:
1
string value = "";
2
if (entry.getAdditionalData() != null && 
3
    entry.getAdditionalData().TryGetValue("name", out value))
4
{
5
    // Set name
6
    this.gameObject.name = value;
7
}
Copied!
Without the name key being set, the default game object's name is the asset filename.
Use the console to set a metadata entry with the following data:
key
value
name
empire_state
Built-in keywords will be suggested through a drop-down list but you can add any key and any value by typing it in the text input field.
Run Unity again and notice that the game object name automatically changes.
Great work! 🎉
Posting Metadata
You can add metadata to the cloud or update existing metadata stored remotely by calling the UpdateEntryData function located in the echo3D.cs script. This function implements the Post Metadata to an Entry API query.
In order to call this function from any other script you can find the echo3D game object and use the echo3D.cs script instance to call the UpdateEntryData function with this single line of code:
1
StartCoroutine(GameObject.Find("echo3D")
2
    .GetComponent<echo3D>()
3
    .UpdateEntryData("<ENTRY_ID>", "<DATA>", "<VALUE>"));
Copied!
Where <ENTRY_ID> is the a specific entry ID you are trying to post metadata too, <DATA> is the data key (e.g. scale), and <VALUE> is the data value (e.g. 2).
Subscribing for Metadata Changes
Add the following code to your Start function to register an action that will be executed when metadata is received from the cloud.
1
// Define data action
2
WClient.On(WClient.EventType.DATA_POST_ENTRY.ToString(), (string message) => {
3
    
4
    // Parse data
5
    string[] messageArray = message.Split('|');
6
    string dataKey = messageArray[2];
7
    string dataValue = messageArray[3];
8
    
9
    // Add you code here
10
    // myFunction(dataKey, dataValue);
11
    
12
});
Copied!

Unity - Previous

Transforming Content

Next - Unity

Adding AR Capabilities

Last modified 3mo ago

Copy link

Contents

Code Example

Querying Metadata

Posting Metadata

Subscribing for Metadata Changes