API UO Launch es

UO.Launch

Русский · English · Українська · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

UO.Exec · UO.Launch · UO.CallSub · UO.FunRunning · UO.SubExists

ClassicUO • Runtime API

Pide al sistema operativo abrir un programa o documento local, como un informe de botín o utilidad externa. Para scripts Basic use StartScript.

Sintaxis exacta

UO.Launch(file:Any) -> Integer
UO.Launch(file:Any, parameters:Any) -> Integer
UO.Launch(file:Any, parameters:Any, workingDirectory:Any) -> Integer
UO.Launch(file:Any, parameters:Any, workingDirectory:Any, hidden:Any) -> Integer

Parámetros

• file — Nombre/ruta obligatorio del programa o documento, convertido a texto sin espacios exteriores. Vacío devuelve 0 y un mensaje. Prefiera la ruta completa; no añada comillas alrededor de file.
• parameters — Cadena opcional de argumentos externos; vacía por defecto. Entrecomille rutas con espacios dentro de ella mediante Chr(34). No son parámetros Basic.
• workingDirectory — Carpeta de trabajo opcional. Omitida o vacía usa la carpeta del script actual; si no está disponible, la carpeta de trabajo del proceso cliente. No necesariamente es la del juego o EXE.
• hidden — Boolean opcional, False por defecto. True desactiva el shell y pide un ejecutable sin consola. False permite asociaciones de documentos. Un programa gráfico puede abrir sus propias ventanas.

Devuelve

Integer: 1 (True) si Process.Start devuelve un objeto de proceso; en otro caso 0 (False). Se puede comparar con 1/True. No es PID, código de salida ni confirmación de finalización. Las excepciones informan y devuelven 0. Un documento puede abrirse en una aplicación existente sin nuevo proceso, por lo que 0 no demuestra siempre un fallo.

Comportamiento

• De uno a cuatro argumentos, en el orden indicado. Para hidden conservando la carpeta predeterminada, pase el tercero vacío. Convertir a texto no comprueba si existe el archivo.
• La carpeta predeterminada procede del script en ejecución. Con hidden=True, una ruta relativa de programa se busca primero respecto a workingDirectory. Búsqueda y asociaciones dependen del sistema; la ruta completa evita ambigüedad. Un programa o carpeta inexistente puede impedir el inicio.
• Launch no espera a que termine, no captura stdout/stderr ni finaliza el programa al detener el script. hidden no garantiza que todas las ventanas gráficas sean invisibles. Se libera el objeto Process tras la solicitud, pero el programa sigue ejecutándose.

Funciones internas: de la llamada al resultado

Son etapas de implementación del cliente, no comandos Basic adicionales. Los procedimientos auxiliares se definen completos.

1. CompactLaunch

De uno a cuatro argumentos, en el orden indicado. Para hidden conservando la carpeta predeterminada, pase el tercero vacío. Convertir a texto no comprueba si existe el archivo.

La carpeta predeterminada procede del script en ejecución. Con hidden=True, una ruta relativa de programa se busca primero respecto a workingDirectory. Búsqueda y asociaciones dependen del sistema; la ruta completa evita ambigüedad. Un programa o carpeta inexistente puede impedir el inicio.

Código del proyecto: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; función CompactLaunch.

2. Launch / Process.Start

Launch no espera a que termine, no captura stdout/stderr ni finaliza el programa al detener el script. hidden no garantiza que todas las ventanas gráficas sean invisibles. Se libera el objeto Process tras la solicitud, pero el programa sigue ejecutándose.

Integer: 1 (True) si Process.Start devuelve un objeto de proceso; en otro caso 0 (False). Se puede comparar con 1/True. No es PID, código de salida ni confirmación de finalización. Las excepciones informan y devuelven 0. Un documento puede abrirse en una aplicación existente sin nuevo proceso, por lo que 0 no demuestra siempre un fallo.

Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función Launch / Process.Start.

Son etapas de implementación del cliente, no comandos Basic adicionales. Los procedimientos auxiliares se definen completos.

Ejemplos

Abrir un informe existente

# Abrir un informe existente
#
# Pide al sistema operativo abrir un programa o documento local, como un informe de botín o
# utilidad externa. Para scripts Basic use StartScript.
#
# Integer: 1 (True) si Process.Start devuelve un objeto de proceso; en otro caso 0 (False). Se
# puede comparar con 1/True. No es PID, código de salida ni confirmación de finalización. Las
# excepciones informan y devuelven 0. Un documento puede abrirse en una aplicación existente sin
# nuevo proceso, por lo que 0 no demuestra siempre un fallo.

SUB Main()
    # Coloque loot-report.txt junto al script. El sistema usa la asociación .txt. Main devuelve el
    # resultado de la solicitud, no el contenido ni confirmación de lectura.

    Dim started = UO.Launch("loot-report.txt")
    Return started
END SUB

Explicación de los parámetros y la ejecución:

• Coloque loot-report.txt junto al script. El sistema usa la asociación .txt. Main devuelve el resultado de la solicitud, no el contenido ni confirmación de lectura.

Ruta con espacios hacia el editor

# Ruta con espacios hacia el editor
#
# Pide al sistema operativo abrir un programa o documento local, como un informe de botín o
# utilidad externa. Para scripts Basic use StartScript.
#
# Integer: 1 (True) si Process.Start devuelve un objeto de proceso; en otro caso 0 (False). Se
# puede comparar con 1/True. No es PID, código de salida ni confirmación de finalización. Las
# excepciones informan y devuelven 0. Un documento puede abrirse en una aplicación existente sin
# nuevo proceso, por lo que 0 no demuestra siempre un fallo.

SUB Main()
    # La carpeta y el informe deben existir; adapte sus rutas. Chr(34) entrecomilla el informe
    # dentro de arguments. notepad.exe debe estar disponible. False permite su ventana normal.

    Dim report = "C:\UO Scripts\loot report.txt"
    Dim arguments = Chr(34) & report & Chr(34)
    Return UO.Launch("notepad.exe", arguments, "C:\UO Scripts", False)
END SUB

Explicación de los parámetros y la ejecución:

• La carpeta y el informe deben existir; adapte sus rutas. Chr(34) entrecomilla el informe dentro de arguments. notepad.exe debe estar disponible. False permite su ventana normal.

Listar registros sin consola

# Listar registros sin consola
#
# Pide al sistema operativo abrir un programa o documento local, como un informe de botín o
# utilidad externa. Para scripts Basic use StartScript.
#
# Integer: 1 (True) si Process.Start devuelve un objeto de proceso; en otro caso 0 (False). Se
# puede comparar con 1/True. No es PID, código de salida ni confirmación de finalización. Las
# excepciones informan y devuelven 0. Un documento puede abrirse en una aplicación existente sin
# nuevo proceso, por lo que 0 no demuestra siempre un fallo.

SUB Main()
    # Windows/cmd.exe crea o sobrescribe log-files.txt junto al script con los nombres *.log. Tercer
    # argumento vacío: carpeta del script; True: consola oculta. True desde Main solo confirma el
    # inicio: el archivo puede no estar listo; no encontrar registros o un error de utilidad no
    # cambia el resultado anterior.

    Dim started = UO.Launch("cmd.exe", "/d /c dir /b *.log > log-files.txt", "", True)
    If started = 0 Then
        Return False
    End If
    Return True
END SUB

Explicación de los parámetros y la ejecución:

• Windows/cmd.exe crea o sobrescribe log-files.txt junto al script con los nombres *.log. Tercer argumento vacío: carpeta del script; True: consola oculta. True desde Main solo confirma el inicio: el archivo puede no estar listo; no encontrar registros o un error de utilidad no cambia el resultado anterior.