Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Explicit engine metadata, isolated Sessions and ordered subsystem execution.

Explicit engine metadata, isolated Sessions and ordered subsystem execution.

Start with composing a runtime host and runtime lifetime.

EngineHostBuilder receives explicit module, type and serialization metadata sources. Configure the complete reference-resolution context and subsystem factories before creating a Session. Dynamic shadow-copy paths belong to the selected DotNet module source; a static module needs no shadow-copy cache.

Each Edit, Play or Player Session has independent identity, event, diagnostic and resource scopes. Its contentStore is borrowed. The createLogSink factory transfers each new sink exclusively to that Session; the Session does not invent a file-log or deployment directory. Settings come from injected documents, with read-only documents in a Player.

RuntimeSubsystemPipeline supplies complete DAG ordering, dependency/cycle detection and reverse phase unwinding. Domain runtimes implement the neutral subsystem contract; they do not duplicate whole application loops.

Shutdown first stops admission, cancels and drains work, then retires subsystems, resources and subscriptions. Close the Session before the borrowed content store. Partial startup failure retires acquired resources in reverse order. Pending retirement retains its owner/dependencies; a Faulted generation cannot resume Play, Build or Export and requires host replacement.

Asset, Settings and Rendering content access follows their explicit service contracts. Shared Session code neither scans deployment directories nor creates file logs. For complete launch and content validation, use the Player application rather than assembling an incomplete Session from guessed defaults.

Supply live, explicitly owned dependencies as described above. These examples compile against the host contract; they do not initialize a complete product or verify a device.

using Inno.Content;
using Inno.Runtime;
static RuntimeSession CreateSession(
EngineHost host,
IRuntimeContentStore content
) {
return host.CreateSession(new RuntimeSessionOptions
{
kind = RuntimeSessionKind.Player,
applicationId = "sample.game",
contentStore = content,
jobExecutionMode = RuntimeJobExecutionMode.SingleThread
});
}

The source project defines the host declarations. Source API extraction does not establish script visibility, native behavior or completed generation retirement.

Browse exact types and members.

The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.

Project: Inno.Runtime
Source: src/runtime/engine/Inno.Runtime/Inno.Runtime.csproj

Type API Description
EngineHost engine Owns application-level engine services and creates isolated runtime sessions.
EngineHostBuilder engine Collects application-level runtime services before creating an T:Inno.Runtime.EngineHost.
GameCodeAssembly engine Identifies one immutable code input independently of its physical deployment representation.
GameCodeDeployment engine Owns a validated, immutable and dependency-ordered logical game code closure.
GameCodeModule engine Freezes the code ownership, ordered assembly identities and dependencies of one logical module.
GamePresentationSettings engine Defines the project-wide game presentation area shared by Editor previews and deployed Players.
GamePresentationViewport engine Stores one centered game-content region within a presentation surface.
GameRuntimeAssembly engine Records a logical assembly identity and the content fingerprint of its build input.
GameRuntimeManifest engine Stores the immutable startup contract consumed by a deployed game Player.
GameRuntimeModule engine Describes one dependency-ordered managed module in a frozen Player generation.
GameRuntimePlugin engine Stores one Plugin’s runtime-only project setting contribution.
RuntimeContentCatalog engine Describes the single immutable content pack deployed with a Player build.
RuntimeJobExecutionMode engine Selects how one runtime session executes its frame jobs.
RuntimeManifestEnvelope engine Frames the serialized runtime manifest with the application identity required before engine startup.
RuntimeSession engine Owns all mutable simulation, identity, asset, scheduling, and logging state for one isolated execution session.
RuntimeSessionKind engine Identifies the ownership and lifecycle semantics of an isolated runtime session.
RuntimeSessionOptions engine Defines storage, scheduling, and timing policy for one runtime session.
RuntimeSubsystemPipeline engine Owns the dependency-ordered runtime subsystem generation for one Host or Session scope.
StaticAssemblyCatalogSource engine Supplies an explicit linked host closure without runtime assembly probing or dynamic loading.
StaticModuleSource engine Contributes statically linked module code to the same catalog transactions used by authoring hosts.
StaticTypeCatalogSource engine Resolves type metadata and factories from linked registrations without runtime type discovery.
Time engine Provides Unity-style timing values for the runtime session bound to the current execution context.
Time Runtime Provides Unity-style timing values for the runtime session bound to the current execution context.