Українська · Русский · 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