API UO GetGlobal

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

UO.GetGlobal

Сигнатури C#

string UO.GetGlobal(object? name);
dynamic UO.GetGlobal(object? globalRegion, object? varName);

Поведінка та результат

SetGlobal і GetGlobal мають спільний простір для всіх скриптів і профілів, також між процесами Full Client та Client. Значення зберігаються як рядки; відсутній ключ повертає "N/A". Регістр ключа враховується. Форми з region використовують пару region/name. Файл Manager/Game Manager/CSharp/globals.json читається свіжим під міжпроцесним блокуванням; перезапуск не стирає значення. Shared-форми є явними синонімами того самого сховища.

Параметри

• globalRegion — Простір імен; поєднується з ім’ям ключа.
• name — Ім’я спільного ключа, чутливе до регістру.
• varName — Ім’я спільного ключа, чутливе до регістру.

Кожен блок — повний окремий .csx. Демонстраційні serial, type та координати замініть своїми. Параметри передаються у порядку сигнатури; іменовані параметри C# дозволяють явно вказати їх призначення.

Команди чату

#getglobal team.target
#get global team.message

Самостійні приклади C#

Кожен блок — повний окремий .csx. Демонстраційні serial, type та координати замініть своїми. Параметри передаються у порядку сигнатури; іменовані параметри C# дозволяють явно вказати їх призначення.

1

string value = UO.GetGlobal("team.target");
UO.Print(value);

2

string value = UO.GetGlobal("team.delay");
if (int.TryParse(value, out int milliseconds))
    UO.Print(milliseconds.ToString());

3

UO.Print(Convert.ToString(UO.GetGlobal("team", "delay")));

4

new CommandSample().Execute(UO);

sealed class CommandSample
{
    public void Execute(global::ClassicUO.CSharp.CSharpGameApi api)
    {
        string value = api.GetGlobal("team.target");
        api.Print(value);
    }
}

Внутрішні виклики

CSharpGameApi.GetGlobal
  -> CSharpScriptGlobals
  -> InjectionScript.Runtime.InjectionApiUO.RegisterClientApiCompatibility
  -> InjectionScript.Runtime.State.Globals.GetGlobal

Globals -> SharedGlobalStore -> named mutex -> atomic JSON replacement

InjectionScript.Runtime.State.SharedGlobalStore.Get