Skip to main content
File: Assets/_MolcaSDK/_VR/Scripts/Scenario/Session/ScenarioSessionManager.cs
Namespace: MolcaSDK.VR.Scenario.Session
Type: RuntimeSubsystem Handles visitor and member login, stores bearer token, raises OnTokenReceived, loads content via GetContentAsync(), and drives session/scene flows (see full source for scene loading APIs).

​
Visitor

VisitorLoginAsync(string playerCode) — Requires exactly 6 characters; builds VisitorLoginRequest with otp field, POSTs through Scenario network config, then GetContentAsync() on success.

​
Member

MemberLoginAsync(string email, string password) — Preferred member flow; validates non-empty strings, POSTs MemberLoginRequest, then loads content.

​
Obsolete

MemberLoginAsyncUsingClerk(string clerkToken) — Marked obsolete; do not use for new work.

​
Success path

Stores bearer token, invokes OnTokenReceived, SetStatus(AUTHENTICATED), then GetContentAsync() which deserializes ContentResponse, applies ScenarioDataConfig.SetFetchedContent, and raises OnContentLoaded.

​
Network

Endpoints and base HttpRequestAsset templates come from ScenarioNetworkConfig (e.g. YAML-backed); see Scenario network config.

​
Code

using Molca;
using MolcaSDK.VR.Scenario.Session;
using UnityEngine;

public class AuthBridge : MonoBehaviour
{
    private ScenarioSessionManager Session =>
        RuntimeManager.GetSubsystem<ScenarioSessionManager>();

    public async void LoginVisitor(string sixDigitCode)
    {
        bool ok = await Session.VisitorLoginAsync(sixDigitCode);
        if (!ok)
            Debug.LogWarning(Session.CurrentStatus.ToString());
    }

    public async void LoginMember(string email, string password)
    {
        bool ok = await Session.MemberLoginAsync(email, password);
        if (ok)
        {
            // Token already stored; content load ran inside MemberLoginAsync
        }
    }
}
Wire OnError, OnLoadingProgress, and OnContentLoaded in the Inspector for UI feedback without polling. 
// Inspector or Awake:
session.OnError.AddListener(msg => Debug.LogError(msg));

​
Troubleshooting

  • Visitor login always fails — Input must be length 6; API errors surface on OnError (inspect response.errorMessage in logs).
  • GetContentAsync returns null / warning — IsAuthenticated false (no token yet); ensure login completed successfully.
  • Member obsolete path — Replace MemberLoginAsyncUsingClerk with MemberLoginAsync(email, password).
  • Stuck in AUTHENTICATING — Network failure or exception; check OnError and VPN/firewall to configured host.
  • Content empty — Response JSON missing scenarios list; verify backend contract vs ContentResponse model.

​
Unity Editor

Auth VR scene — Canvas with login fields, or AuthUI component Inspector.

Unity Auth VR scene or Auth UI in Inspector