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

UO.GetScriptPath

ClassicUO • Runtime API

Читает путь исходного файла активного запуска.

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

UO.GetScriptPath(ScriptIndex:Any) -> String

Параметры

  • ScriptIndex — Обязательный ScriptIndex — целое число, индекс с нуля из свежего GetScriptsList. Для отрицательного или отсутствующего индекса возвращается описанный пустой/неизвестный результат. Не передавайте serial предмета, имя процедуры или ID запуска из IDE.

Возвращает

String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это обычно полный путь; у команды или исходника в памяти обычного файла может не быть.

Поведение

  • Учитываются выполняющиеся и приостановленные запуски; завершённые и получившие запрос отмены исключаются. Работающий скрипт обычно учитывает и себя. Просто загруженная вкладка IDE запуском не считается.
  • Индексы — текущие позиции в порядке запуска. Запуск/остановка скриптов могут сдвинуть позиции. Разные вызовы не образуют общий атомарный снимок; перед последующей командой управления перечитайте список.
  • Закрытие Basic IDE не удаляет активные запуски. Команды относятся к этому клиенту, а не к другим клиентам или процессам Windows.
  • GetScriptsList даёт индексы, GetScriptsCount — количество, GetScriptState — код из трёх состояний. Не подменяйте одно другим и не считайте любой ненулевой результат значением true.
  • ScriptIndex=0 выбирает первый текущий запуск. Результат указывает его исходник; команда не открывает, не сохраняет и не запускает этот файл.

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

Ниже указаны реальные методы клиента. В примерах Basic приведены полные вызываемые функции; имена внутренних методов C# не являются дополнительными командами скрипта.

1. ExecuteStealthCompatibility

Runtime вызывает зарегистрированную UO-команду и упаковывает ответ моста как Integer, String или Array.

String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это обычно полный путь; у команды или исходника в памяти обычного файла может не быть.

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

2. GetScriptPath

Мост обращается к менеджеру запусков именно этого клиента.

ScriptIndex=0 выбирает первый текущий запуск. Результат указывает его исходник; команда не открывает, не сохраняет и не запускает этот файл.

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

3. GetScriptPath

ElementAt(RunningScripts(), index)?.FilePath ?? string.Empty

Индексы — текущие позиции в порядке запуска. Запуск/остановка скриптов могут сдвинуть позиции. Разные вызовы не образуют общий атомарный снимок; перед последующей командой управления перечитайте список.

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

Закрытие Basic IDE не удаляет активные запуски. Команды относятся к этому клиенту, а не к другим клиентам или процессам Windows.

Примеры

Первый вызов и результат

# Первый вызов и результат
#
# Читает путь исходного файла активного запуска.
#
# String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это
# обычно полный путь; у команды или исходника в памяти обычного файла может не быть.

SUB Main()
    # Запускайте Sub Main. Число 0, где оно передано, обозначает индекс; пустые скобки означают
    # отсутствие аргументов. Текст Print — только сообщение примера.
    # ScriptIndex=0 выбирает первый текущий запуск. Результат указывает его исходник; команда не
    # открывает, не сохраняет и не запускает этот файл.
    # String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это
    # обычно полный путь; у команды или исходника в памяти обычного файла может не быть.
    # Обязательный ScriptIndex — целое число, индекс с нуля из свежего GetScriptsList. Для
    # отрицательного или отсутствующего индекса возвращается описанный пустой/неизвестный результат.
    # Не передавайте serial предмета, имя процедуры или ID запуска из IDE.

    Dim index=0
    Dim path=UO.GetScriptPath(index)
    If path<>"" Then
        UO.Print(path)
    End If
END SUB

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

  • Запускайте Sub Main. Число 0, где оно передано, обозначает индекс; пустые скобки означают отсутствие аргументов. Текст Print — только сообщение примера.
  • ScriptIndex=0 выбирает первый текущий запуск. Результат указывает его исходник; команда не открывает, не сохраняет и не запускает этот файл.
  • String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это обычно полный путь; у команды или исходника в памяти обычного файла может не быть.
  • Обязательный ScriptIndex — целое число, индекс с нуля из свежего GetScriptsList. Для отрицательного или отсутствующего индекса возвращается описанный пустой/неизвестный результат. Не передавайте serial предмета, имя процедуры или ID запуска из IDE.

Использование в цикле или условии

# Использование в цикле или условии
#
# Читает путь исходного файла активного запуска.
#
# String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это
# обычно полный путь; у команды или исходника в памяти обычного файла может не быть.

SUB Main()
    # Это отдельный пример совместного использования команд. Индексация массива начинается с нуля;
    # перед обращением проверяйте длину. Wait(250), где он используется, ждёт 250 миллисекунд.
    # ScriptIndex=0 выбирает первый текущий запуск. Результат указывает его исходник; команда не
    # открывает, не сохраняет и не запускает этот файл.
    # String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это
    # обычно полный путь; у команды или исходника в памяти обычного файла может не быть.
    # Обязательный ScriptIndex — целое число, индекс с нуля из свежего GetScriptsList. Для
    # отрицательного или отсутствующего индекса возвращается описанный пустой/неизвестный результат.
    # Не передавайте serial предмета, имя процедуры или ID запуска из IDE.

    Dim indices=UO.GetScriptsList()
    For Each index In indices
        UO.Print(UO.GetScriptName(index) & " -> " & UO.GetScriptPath(index))
    Next
END SUB

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

  • Это отдельный пример совместного использования команд. Индексация массива начинается с нуля; перед обращением проверяйте длину. Wait(250), где он используется, ждёт 250 миллисекунд.
  • ScriptIndex=0 выбирает первый текущий запуск. Результат указывает его исходник; команда не открывает, не сохраняет и не запускает этот файл.
  • String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это обычно полный путь; у команды или исходника в памяти обычного файла может не быть.
  • Обязательный ScriptIndex — целое число, индекс с нуля из свежего GetScriptsList. Для отрицательного или отсутствующего индекса возвращается описанный пустой/неизвестный результат. Не передавайте serial предмета, имя процедуры или ID запуска из IDE.

Полная вспомогательная функция

# Полная вспомогательная функция
#
# Читает путь исходного файла активного запуска.
#
# String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это
# обычно полный путь; у команды или исходника в памяти обычного файла может не быть.

SUB Main()
    # Под Main приведена функция целиком. Её параметры и результат объясняются отдельно от
    # API-команды, которую она вызывает.
    # ReadScriptPath подставляет параметр fallback только при пустом пути. Это отдельная функция, а
    # не новая перегрузка GetScriptPath.
    # String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это
    # обычно полный путь; у команды или исходника в памяти обычного файла может не быть.
    # Обязательный ScriptIndex — целое число, индекс с нуля из свежего GetScriptsList. Для
    # отрицательного или отсутствующего индекса возвращается описанный пустой/неизвестный результат.
    # Не передавайте serial предмета, имя процедуры или ID запуска из IDE.

    UO.Print(ReadScriptPath(0, "path unavailable"))
END SUB

Function ReadScriptPath(index, fallback) As String
    Dim path=UO.GetScriptPath(index)
    If path="" Then
        Return fallback
    End If
    Return path
End Function

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

  • Под Main приведена функция целиком. Её параметры и результат объясняются отдельно от API-команды, которую она вызывает.
  • ReadScriptPath подставляет параметр fallback только при пустом пути. Это отдельная функция, а не новая перегрузка GetScriptPath.
  • String: сохранённый путь исходного файла либо "", если индекса нет. При запуске файла это обычно полный путь; у команды или исходника в памяти обычного файла может не быть.
  • Обязательный ScriptIndex — целое число, индекс с нуля из свежего GetScriptsList. Для отрицательного или отсутствующего индекса возвращается описанный пустой/неизвестный результат. Не передавайте serial предмета, имя процедуры или ID запуска из IDE.

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

Basic