Skip to content

API UO Sound

Codex edited this page Sep 19, 2026 · 4 revisions

UO.Sound

ClassicUO / Basic IDE

Оглавление · Алфавитный указатель · Sound & Visual Environment

Проигрывает игровой звук согласно номеру sndnumber.

Синтаксис

UO.Sound(soundId:Any) -> Unit

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

Параметры

Имя Назначение
soundId Позиционный аргумент этой перегрузки. Подробности использования указаны в описании/фактической ветви runtime ниже.

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

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

Примеры

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

Пример 1

SUB Main()
    VAR result = UO.Sound(0)
END SUB

Пример 2

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

Пример 3

SUB Main()
    UO.Sound(1)
END SUB

Пример 4

SUB Main()
    IF UO.Connected THEN
        VAR arg1 = 1 # soundId
        UO.Sound(arg1)
    END IF
END SUB

Пример 5

SUB RunAction()
    VAR arg1 = 1 # soundId
    UO.Sound(arg1)
END SUB

SUB Main()
    # Запуск процедуры выполняет действие:
    RunAction()
END SUB
Реализация и проверка контракта
  • InjectionScript.Runtime.InjectionApiUO+<>c__DisplayClass62_0.<RegisterLegacyManualAliases>b__1

Соответствующая ветвь совместимого обработчика в InjectionApiUO.cs. Arg(i)/Text(i) читают позицию с нуля; bridge обращается к клиенту. Прямые типизированные перегрузки перечислены выше и могут иметь отдельный маршрут.

bridge.PlaySound(Arg(0)); break;

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

Clone this wiki locally