Inno.Runtime
Section titled “Inno.Runtime”
- 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.
Host and Session ownership
Section titled “Host and Session ownership”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.
Execute and retire
Section titled “Execute and retire”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.
Host usage
Section titled “Host usage”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 });}Source boundary
Section titled “Source boundary”The source project defines the host declarations. Source API extraction does not establish script visibility, native behavior or completed generation retirement.
API reference
Section titled “API reference”Browse exact types and members.
Logical script references
Section titled “Logical script references”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.
Source project facts
Section titled “Source project facts”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. |