API UO TradeName - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki

UO.TradeName

ClassicUO • Runtime API

Возвращает имя партнёра из окна обмена по индексу от нуля.

Точный синтаксис

UO.TradeName(windowIndex:Any) -> String

Параметры

windowIndex — Целое число: текущий индекс окна от 0 до TradeCount()-1. Отрицательный или отсутствующий индекс даёт пустой результат. Это не serial.

Возвращает

String: сохранённое имя партнёра; пустая строка при отсутствии окна/имени. Имя предмета-контейнера не используется.

Поведение

GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade нумеруют окна с 1; TradeContainer/TradeOpponent/TradeName и все формы TradeCheck — с 0. Это явная совместимость данного клиента: внешние справочники разных движков используют разные начала отсчёта.
Чтение выполняется на игровом потоке по живым окнам текущего мира. Закрытые окна не считаются. Вызовы чтения не отправляют пакетов и не ждут ответа. Порядок UI может меняться при открытии, закрытии и переносе окна наверх; номер не является постоянным идентификатором.
ConfirmTrade и запись своего TradeCheck отправляют пакет только при изменении согласия. Чужое согласие задаёт сервер. CancelTrade отправляет отмену один раз. 1/TRUE — локальное состояние/обработка, а не гарантия завершения обмена. Имена и оба согласия не доказывают, что состав предметов не изменился.

Внутренние функции: от вызова до результата

Ниже — путь вызова в C#. После него приведены исполняемые Basic-примеры; это не попытка заново реализовать сетевой протокол в скрипте.

1. TradeName

Регистрация выбирает форму по числу аргументов; числа преобразуются через NumberConversions. Для TradeCheck с двумя аргументами стороны 1/2 проверяются и переводятся в 0/1 bridge. Legacy-serial форматируется через ToHex.

Исходник проекта: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; функция TradeName.

2. TradeName

Invoke передаёт чтение/изменение на игровой поток с отменой скрипта; метод читает ID1/ID2, LocalSerial, OpponentName или флажки выбранного TradingGump.

Возвращает имя партнёра из окна обмена по индексу от нуля.

Исходник проекта: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; функция TradeName.

3. FindTrade

FindNumberedTrade проверяет number>0 до вычитания 1; FindTrade отклоняет отрицательный индекс и перечисляет только незакрытые TradingGump текущего World.

GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade нумеруют окна с 1; TradeContainer/TradeOpponent/TradeName и все формы TradeCheck — с 0. Это явная совместимость данного клиента: внешние справочники разных движков используют разные начала отсчёта.

Исходник проекта: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; функция FindTrade.

Помощник приведён полностью и действительно вызывается из Main. Проверки диапазона/ID снижают риск ошибки, но несколько вызовов не атомарны: окно может смениться между ними. Для действия expectedPartner — сохранённый serial персонажа; это не проверка цены или содержимого обмена.

Примеры

Прямое чтение или действие

# Прямое чтение или действие
#
# Возвращает имя партнёра из окна обмена по индексу от нуля.
#
# String: сохранённое имя партнёра; пустая строка при отсутствии окна/имени. Имя
# предмета-контейнера не используется.

SUB Main()
    # Вызов сделан один раз, результат сохранён в value/result. 0 — первый индекс, 1 — первый номер
    # (см. синтаксис этой команды). HEX показывает числовой serial; CStr — число или строку.

    VAR value = UO.TradeName(0)
    UO.Print(CStr(value))
END SUB

Разбор параметров и выполнения:

Вызов сделан один раз, результат сохранён в value/result. 0 — первый индекс, 1 — первый номер (см. синтаксис этой команды). HEX показывает числовой serial; CStr — число или строку.

Другой сценарий и параметры

# Другой сценарий и параметры
#
# Возвращает имя партнёра из окна обмена по индексу от нуля.
#
# String: сохранённое имя партнёра; пустая строка при отсутствии окна/имени. Имя
# предмета-контейнера не используется.

SUB Main()
    # total — снимок числа окон; index — текущий индекс/номер. Пример перебора ничего не
    # подтверждает. В GetTradeContainer два вызова читают свой контейнер (1) и чужой (2) первого
    # окна (1).

    VAR total = UO.TradeCount()
    FOR VAR index = 0 TO total - 1
        VAR value = UO.TradeName(index)
        UO.Print(CStr(index) + ": " + CStr(value))
    NEXT
END SUB

Разбор параметров и выполнения:

total — снимок числа окон; index — текущий индекс/номер. Пример перебора ничего не подтверждает. В GetTradeContainer два вызова читают свой контейнер (1) и чужой (2) первого окна (1).

Полный помощник со всеми функциями

# Полный помощник со всеми функциями
#
# Возвращает имя партнёра из окна обмена по индексу от нуля.
#
# String: сохранённое имя партнёра; пустая строка при отсутствии окна/имени. Имя
# предмета-контейнера не используется.

SUB Main()
    # Помощник приведён полностью и действительно вызывается из Main. Проверки диапазона/ID снижают
    # риск ошибки, но несколько вызовов не атомарны: окно может смениться между ними. Для действия
    # expectedPartner — сохранённый serial персонажа; это не проверка цены или содержимого обмена.

    VAR value = ReadTradeValue(0)
    UO.Print(CStr(value))
END SUB

FUNCTION ReadTradeValue(index)
    VAR total = UO.TradeCount()
    IF index < 0 OR index >= total + 0 THEN
        RETURN ""
    END IF
    RETURN UO.TradeName(index)
END FUNCTION

Разбор параметров и выполнения:

Помощник приведён полностью и действительно вызывается из Main. Проверки диапазона/ID снижают риск ошибки, но несколько вызовов не атомарны: окно может смениться между ними. Для действия expectedPartner — сохранённый serial персонажа; это не проверка цены или содержимого обмена.

en · ru · uk · fr · de · it · es · zh-tw · ja · ko

Basic