Astra Web Platform

⤓ Installation

Import once, open the Welcome window, add a component.

Requirements

• Unity 6000.0 or newer.
• Windows player: the WebView2 Evergreen runtime (preinstalled on Windows 11; bundled with modern Edge).
• macOS / iOS / Linux / Android native adapters require their platform binaries — see the cross-platform build guide and Engines & Platforms.

What gets installed

Assets/AstraWebPlatform/
  Runtime/        // Browser manager, engines, native adapters, bridge, policy,
                  //   profiles, diagnostics, automation, the Astra Web View component
  Editor/         // Welcome window, custom inspectors, scaffolding menu, Setup,
                  //   Diagnostics, project validation
  Welcome/        // interactive Getting Started scene (built in code at runtime)
  Plugins/        // WebGL .jslib, Windows WebView2 DLL, iOS/Android sources
  Demo/           // a guided, fully interactive showcase scene
  Documentation/  // You are here
  Tests/          // EditMode + PlayMode (run headless via Unity -runTests)Project

⚡ Quick Start (No Code)

A real web page in your scene without writing a line of code.

⚙ How It Works

From a URL in the Inspector to a rendered page in one build pass.

1. The Astra Web View component reads its serialized fields (URL, engine, size, policy/profile assets).
2. AstraBrowserEngineFactory resolves the engine selection to a concrete IBrowserEngine (falling back to Mock when the requested engine is not available in the current build).
3. The DefaultPolicyEvaluator checks the create + navigation against the BrowserPolicy (origins, bridge channels/types, payload size).
4. BrowserManager.CreateAsync creates the browser, initializes it, and navigates to the URL.
5. The platform native adapter (WebView2 / WebGL iframe / WKWebView / …) renders the page; the managed IBrowserInstance exposes navigate / evaluate / dispose.

🌐 Astra Web View Component

The single no-code component — every field is in the Inspector with a tooltip.

🧩 Engines & Platforms

One enum, one factory, the right engine per platform.

🔧 Editor Tools (No-Code)

Everything a non-coder needs is reachable by clicking — this is a headline capability.

👋 Welcome & Getting Started

Two friendly front doors that get you productive in a minute.

Welcome window (Editor)

• Auto-opens once the first time the asset is in the project (suppressed in batch/CI).
• Big buttons: Open the interactive Welcome scene, Open Documentation, Open the Demo Scene, Create your first Astra Web View, Open Setup & Validation.
• A "Get started in 3 steps" list, requirements, and the support contact.
• Dismissible via the "Show this window on startup" toggle, and re-openable any time from Tools → Astra Web Platform → Welcome.

Interactive Welcome scene

A playable, hands-on onboarding scene that walks you through the three steps to your first live web page — and lets you try it on the spot. Open it from the Welcome window's Open the interactive Welcome scene button, or generate it via Tools → Astra Web Platform → Create Welcome Scene (it lands at Assets/AstraWebPlatform/Welcome/Scenes/AstraWebPlatform_Welcome.unity).

• A left-hand stepper: Welcome → Add a Web View → Set URL & Engine → Press Play → Next steps, with Back / Next navigation.
• A live preview on the "Press Play" step: type a URL and it drives the real Astra Web View component, showing the resolved engine and the page's document.title. In the Editor this resolves the Mock engine; a Windows/WebGL player renders the real page.
• One-click Open Documentation and Contact Support throughout.

📁 Assets & Presets

Configuration lives in ScriptableObjects you can create, share, and version.

🔗 Bridge & Policy

Talk to the page safely, behind an allow-list policy.

The BridgeBus carries typed request/response and chunked streaming messages between Unity and the page. Every message is evaluated by the DefaultPolicyEvaluator against the BrowserPolicy:

• Allowed origins — navigation and bridge origins must match (scheme/host/port, or a scheme prefix like astra:).
• Allowed bridge channels / types — an allow-list (* permits all).
• Max payload bytes — oversized messages are rejected.
• Local HTTP — opt-in for http://localhost / 127.0.0.1 during development.

var policy = BrowserPolicy.AllowLocalDevelopment();
policy.AllowedOrigins.Add("https://example.com");
var options = new BrowserCreateOptions { InitialUrl = "https://example.com/", Policy = policy };C#

👤 Profiles

Isolate cookies and storage per profile.

A Browser Profile asset (or a ProfileId in code) keys cookie and storage state. Assign one to the Astra Web View component's Profile Asset slot, or create profiles in code through AstraWebRuntime.Profiles. Persistence modes range from in-memory to file-backed.

📊 Diagnostics & Automation

See what happened, and replay sequences.

• Diagnostics — every browser/bridge/policy event is recorded to a diagnostics sink. Open Tools → Astra Web Platform → Diagnostics, or export a support bundle.
• Automation — the automation runner executes a sequence of create/navigate/evaluate/bridge commands; author them as an Automation Script asset.
• Visual Scripting — browser and workflow units are provided for Unity Visual Scripting.

📙 Scripting API

The code-first path — unchanged and fully supported.

// No-code component, driven from code (auto-open defers to you):
var view = gameObject.GetComponent<AstraWebViewComponent>();
view.SuppressAutoOpen();
await view.OpenAsync("https://example.com/");

// Or the raw runtime:
var engine = AstraBrowserEngineFactory.ResolveEngine(
    AstraBrowserEngineSelection.Automatic, out var id, out _, out _);
var manager = new BrowserManager(engine, AstraWebRuntime.Diagnostics,
    AstraWebRuntime.Profiles, new DefaultPolicyEvaluator(AstraWebRuntime.Diagnostics));
var browser = await manager.CreateAsync(new BrowserCreateOptions { InitialUrl = "https://example.com/" });
string title = await browser.EvaluateScriptAsync("document.title", default);C#

💡 Troubleshooting

The common bumps and their fixes.

❓ FAQ

📬 Support

Need help? We're here for you.