Gua.Runtime
1.2.0
dotnet add package Gua.Runtime --version 1.2.0
NuGet\Install-Package Gua.Runtime -Version 1.2.0
<PackageReference Include="Gua.Runtime" Version="1.2.0" />
<PackageVersion Include="Gua.Runtime" Version="1.2.0" />
<PackageReference Include="Gua.Runtime" />
paket add Gua.Runtime --version 1.2.0
#r "nuget: Gua.Runtime, 1.2.0"
#:package Gua.Runtime@1.2.0
#addin nuget:?package=Gua.Runtime&version=1.2.0
#tool nuget:?package=Gua.Runtime&version=1.2.0
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 | Versions 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. |
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.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 |