API UO ReceiveObjectName

UO.ReceiveObjectName

ClassicUO / Basic IDE

Оглавление · Алфавитный указатель · Items

Посылает одиночный клик по объекту для запроса имени. Если задан timeout, ждёт появления непустого имени до этого срока с проверкой не реже 25 мс; timeout в миллисекундах. Без второго аргумента длительного ожидания нет. Команда ничего не возвращает; имя читайте через GetName.

Синтаксис

UO.ReceiveObjectName(id:Any) -> Unit
UO.ReceiveObjectName(id:Any, timeout:Any) -> Unit

Регистр имени не важен. Any — динамическое значение Basic; Unit — отсутствие возвращаемого значения. Integer — знаковое 32-битное число, Decimal — число с плавающей точкой. Правила типов, serial, индексов и ожиданий.

Параметры

Имя	Назначение
id	Идентификатор объекта/контейнера или селектор, указанный в описании команды. 0 и -1 не являются универсальными заменителями serial.
timeout	Delay/timeout in milliseconds; use a non-negative integer (for example 3000 = 3 seconds).

Параметры обязательны внутри каждой показанной сигнатуры. Опустить аргумент можно только при наличии более короткой перегрузки; пропуск позиции посередине не подразумевается.

Возвращает: Unit — значения нет. Выполняйте вызов отдельной строкой; его нельзя использовать как проверку успеха. Эффект и ограничения зависят от команды.

Примеры

Каждый блок — самостоятельный скрипт из мануала проекта. Параметры демонстрационного объекта/контейнера и условия действия необходимо сопоставить с вашей игровой ситуацией.

Пример 1

SUB Main()
    UO.ReceiveObjectName(self)
END SUB

Пример 2

SUB Main()
    VAR arg1 = self # id
    VAR arg2 = 1000 # timeout
    UO.ReceiveObjectName(arg1, arg2)
END SUB

Пример 3

SUB Main()
    IF UO.Connected THEN
        VAR arg1 = self # id
        UO.ReceiveObjectName(arg1)
    END IF
END SUB

Пример 4

SUB RunAction()
    VAR arg1 = self # id
    UO.ReceiveObjectName(arg1)
END SUB

SUB Main()
    # Запуск процедуры выполняет действие:
    RunAction()
END SUB

Реализация и проверка контракта

• InjectionScript.Runtime.InjectionApiUO.ReceiveObjectName

Источник реестра и отчёт сверки. Примеры проверяются загрузчиком/парсером включённого runtime. Действия на игровом сервере этой проверкой не исполняются.