DT network and mapping

Scripts:

Assets/_MolcaDT/Code/Scripts/Network/NetworkManager.cs
Assets/_MolcaDT/Code/Scripts/Network/TokenRenewalManager.cs
Assets/_MolcaDT/Code/Scripts/JsonMapping/JsonMappingEvaluator.cs

When to use

Use this page when integrating machine data endpoints/streams and binding JSON payloads to DT panel data models.

Request pipeline (high-level)

NetworkManager exposes coroutine-based HTTP helpers (PostDataCoroutine, PutDataCoroutine, etc.) and attaches auth headers from DT dynamic module setup. It also retries through token-renewal flow when expiration is detected.

Mapping flow

JsonMappingEvaluator.BuildWrapper(JsonMappingAsset mapping, Dictionary<string, object> flat) walks mapping.fields. For each FieldMapping, it looks up flat[f.displayName] (not the JSON path alone unless your flatten step uses the same string as displayName). It fills allData, then categoryData / uniqueCategoryData for panel consumers. APIMapperInvokerBase (and machine-specific invokers) resolve URLs from DigitalTwinDynamicModule.UrlDatum, call NetworkManager coroutines, parse JSON into a flat dictionary, then run JsonMappingEvaluator and raise onDataReceived (full, raw, per-FieldCategory, per unique key).

Code

Manual POST (matches NetworkManager.PostDataCoroutine contract: success → (url, responseBody, true), failure → (url, errorMessage, false)):

using MolcaDT.Network;
using UnityEngine;

public class DtPing : MonoBehaviour
{
    private void Start()
    {
        string url = "https://api.example.com/v1/ping";
        string json = "{}";
        StartCoroutine(NetworkManager.instance.PostDataCoroutine(url, json, OnResponse));
    }

    private void OnResponse(string url, string bodyOrError, bool ok)
    {
        if (!ok) Debug.LogError(bodyOrError);
    }
}

Mapping-only (after you already have a Dictionary<string, object> aligned to FieldMapping.displayName keys):

var wrapper = JsonMappingEvaluator.BuildWrapper(mappingAsset, flatDictionary);
// wrapper.allData, wrapper.categoryData, wrapper.uniqueCategoryData, wrapper.rawData

SSE — NetworkManager.ConnectToSSE(url, onChunk, filterEvent) streams lines; token refresh can abort and retry the stream when TokenRenewalManager detects expiry patterns.

Troubleshooting

401 / auth errors — Ensure login populated NetworkManager.instance.CurrentAuth; DigitalTwinDynamicModule.SetupAuth() returns a bearer header; configure TokenRenewalManager.tokenExpiredKeyword so IsTokenExpired matches your API’s error body. Use bypassRefreshToken only for isolated tests.
SSL / certificate errors in dev — Requests use BypassCertificate (always validates true); prefer proper certs for production builds.
Mapping rows missing or null — Flatten JSON so keys equal FieldMapping.displayName in the JsonMappingAsset; empty slots mean TryGetValue missed that key.
Panel callbacks silent — In OnDataReceived, wire onFullDataReceived, categoryEvents, or uniqueCategoryEvents; APIMapperInvokerBase caches category hooks from FieldCategory during SyncConfiguration.
POST body ignored — Set httpMethod to POST on the invoker and fill postBodyData (see APIMapperInvokerBase).

DT startup flow
DT POI and panels
HttpClient (only if your DT fork shares Core networking for some paths)

Overview

Common Tasks

Molca Core

Shared module (MolcaSDK)

Molca SDK - VR

Molca SDK - DT

When to use

Request pipeline (high-level)

Mapping flow

Code

Troubleshooting

​When to use

​Request pipeline (high-level)

​Mapping flow

​Code

​Troubleshooting

​Related

When to use

Request pipeline (high-level)

Mapping flow

Code

Troubleshooting

Related