Gua.Runtime 1.2.0

Suggested Alternatives

Gua.Runtime 1.1.2

dotnet add package Gua.Runtime --version 1.2.0
                    
NuGet\Install-Package Gua.Runtime -Version 1.2.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Gua.Runtime" Version="1.2.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Gua.Runtime" Version="1.2.0" />
                    
Directory.Packages.props
<PackageReference Include="Gua.Runtime" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Gua.Runtime --version 1.2.0
                    
#r "nuget: Gua.Runtime, 1.2.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Gua.Runtime@1.2.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Gua.Runtime&version=1.2.0
                    
Install as a Cake Addin
#tool nuget:?package=Gua.Runtime&version=1.2.0
                    
Install as a Cake Tool

Gua.Runtime

engine adapterのための役割

ゲーム側が「現在の画面を公開し、外部から来た操作を実行する」ためのwrapperです。 例えば設定画面をadapterがframeとして公開すると、外部テストはチェックボックスを見つけられます。 テスト用locatorではなく、host側の公開・consume・完了報告・bridgeを担当します。

「BeginFrame → node登録 → EndFrameで公開 → TryConsumeAction → engineの実処理 → EmitActionResult」の順で追ってください。game inputも受理と適用を分け、 adapterがhost threadで注入してCompleteGameInputを報告します。 Action Mapは操作の一覧、capabilityは初期化済みの機能の宣言です。 Debugの入力経路を初期化してもPlayerへ同じ権限が自動付与されるわけではありません。 GuaClockも、明示的に利用したゲーム処理だけを制御します。

GuaRuntimeはUI/bridgeの入口、 game-input APIは保持・lease・cleanupの入口です。 ObserveTransportTests等のruntime経路と 共通の確認準備とsuite別手順を参照してください。APIの条件は以下に説明しています。受理結果だけではゲーム上の成功を確認できません。

Semantic Game Action descriptor v2 exposes Category, Aliases, Tags, and AgentExposure. Use FindGameInputActions with a GuaGameInputActionSelector for bounded, profile-aware discovery; its result revision must be treated as a snapshot because execution is revalidated against the current Action Map.

Managed net10.0 and netstandard2.1 wrapper over the stable Gua runtime C ABI. Engine adapters use it to publish semantic frames, consume actions, complete screenshot requests, expose adapter versions, and run the Inspector WebSocket bridge without duplicating P/Invoke declarations.

GuaRuntime.Clock is the adapter-side clock pump. Adapters call AdvanceMilliseconds(unscaledDeltaMs) when their engine exposes elapsed time as a floating-point value, or Advance(unscaledDelta) when a TimeSpan is already available. Game code uses Schedule and Tick for deterministic pause/run-for behavior. Installing the clock does not intercept Time.deltaTime, coroutines, or engine timers; each game subsystem that should be controllable must explicitly use this clock as its time source.

Tick receives GuaClockDelta, which retains the native double-precision millisecond value even below TimeSpan's 100 ns resolution. It exposes TotalMilliseconds, TotalSeconds, and an explicitly fallible TimeSpan projection. Clock status likewise keeps NowMilliseconds as the authoritative protocol value; Now is null when that value exceeds TimeSpan's range. Adapter callback failures are reported by CallbackFailed after the scheduler isolates the failure and continues the remaining due callbacks and tick notification.

The NuGet package deploys gua_runtime.dll, libgua_runtime.so, or libgua_runtime.dylib from its win-x64, linux-x64, osx-x64, and osx-arm64 native assets. GUA_RUNTIME_NATIVE_DIR remains available for local build overrides.

World queries use GuaWorldSelector.Near plus an optional positive Limit for same-snapshot radius search. The runtime delegates XY/XYZ distance evaluation to the native core and returns snapshot metadata and aligned spatial distances, so engine adapters and remote bridges do not implement their own geometry.

Local distributable packing requires an absolute GuaNativeAssetsRoot whose four RID directories contain gua_runtime.dll, libgua_runtime.so, or libgua_runtime.dylib as appropriate. Packing fails when that root is omitted without the legacy Windows Release DLL, or when any required RID asset is missing.

Screenshot adapters should use TryCompleteScreenshot. It returns false when a timeout, cancellation, or context reset has already invalidated the request; such a late completion is benign and must not be retried.

Game input adapter API

Publish a complete action-map frame with PublishGameInputActions, then enable only the initialized GuaGameInputCapabilities with EnableGameInput and a shutdown action that synchronously neutralizes every injected host value before the native runtime is destroyed. Local consumers create a GuaGameInputSession; Dispose queues owner-scoped neutral cleanup. Adapters call TryConsumeGameInput, inject the request on the host thread, and then call CompleteGameInput. Call TickGameInputLeases once per host frame with unscaled elapsed time. Enqueue acceptance and host completion are deliberately separate; local callers use GuaGameInputSession.PollResult(requestId) for the correlated completion. Lease timing never uses GuaRuntime.Clock. The optional third EnableGameInput argument is the Player/Public Agent capability ceiling and defaults to None. Trusted engine bridges create a Player session with CreateGameInputSession(GuaObservationProfile.Player); the runtime intersects that authorization with initialized adapter capabilities at enqueue and again immediately before host consumption.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Gua.Runtime:

Package Downloads
Gua.Testing.Recording

Semantic UI operation recording and correlated replay for Gua.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.2.0 307 11/1/2026 1.2.0 is deprecated because it has critical bugs.
1.1.2 261 10/26/2026
1.1.1 1,183 10/5/2026
1.1.0 141 10/4/2026
1.0.10 128 9/3/2026
1.0.9 126 9/3/2026
1.0.8 118 9/2/2026
1.0.7 113 9/2/2026
1.0.6 121 9/2/2026
1.0.5 124 9/1/2026
1.0.4 116 8/31/2026
1.0.3 123 8/30/2026
1.0.2 115 8/29/2026
1.0.1 113 8/29/2026
1.0.0 113 8/29/2026
0.18.0 119 8/21/2026
0.17.0 120 8/21/2026
0.16.0 120 8/21/2026
0.15.0 145 7/14/2026