API UO IsTrade es - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki
UO.IsTrade
ClassicUO • Runtime API
Comprueba si hay una ventana de intercambio seguro abierta.
Sintaxis exacta
UO.IsTrade() -> Integer
Parámetros
Sin parámetros.
Devuelve
Integer: 1 = TRUE si hay un intercambio abierto; si no, 0 = FALSE.
Resultado lógico: 1 = TRUE, 0 = FALSE. Tras VAR result = comando(...), use IF result = TRUE THEN o IF result = 1 THEN; para el resultado negativo, IF result = FALSE THEN o IF result = 0 THEN. TRUE/FALSE sin comillas. Llame una vez y guarde el resultado: otra llamada puede repetir la acción o leer un estado cambiado.
Comportamiento
- GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade empiezan en 1; TradeContainer/TradeOpponent/TradeName y todas las formas TradeCheck en 0. Este cliente conserva esas convenciones; las referencias de distintos motores difieren.
- Lee en el hilo del juego las ventanas vivas del World actual, excluyendo las cerradas. Leer no envía paquetes ni espera respuestas. Abrir, cerrar o traer al frente cambia el orden UI; el índice no es un ID permanente.
- ConfirmTrade y escribir su TradeCheck envían solo si cambia la aceptación. El servidor controla la casilla ajena. CancelTrade envía una vez. 1/TRUE indica estado/procesamiento local, no transferencia completa. Nombres y casillas no prueban que los objetos sigan iguales.
Funciones internas: de la llamada al resultado
Se explica la ruta C# y después se muestran ejemplos Basic ejecutables. Los scripts no reimplementan el protocolo de red.
1. ExecuteStealthCompatibility
El registro selecciona según cantidad de argumentos; NumberConversions convierte números. TradeCheck de dos argumentos valida 1/2 y los transforma en 0/1 del bridge. ToHex formatea serials heredados.
Integer: 1 = TRUE si hay un intercambio abierto; si no, 0 = FALSE.
Código del proyecto: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; función ExecuteStealthCompatibility.
2. IsTrade
Invoke lleva lectura/escritura al hilo del juego con cancelación del script; lee ID1/ID2, LocalSerial, OpponentName o casillas del TradingGump seleccionado.
Comprueba si hay una ventana de intercambio seguro abierta.
Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función IsTrade.
3. FindTrade
FindNumberedTrade comprueba number>0 antes de restar 1; FindTrade rechaza índices negativos y enumera solo TradingGump abiertos de este World.
GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade empiezan en 1; TradeContainer/TradeOpponent/TradeName y todas las formas TradeCheck en 0. Este cliente conserva esas convenciones; las referencias de distintos motores difieren.
Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función FindTrade.
La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del personaje, no una validación de precio/contenido.
Ejemplos
Lectura o acción directa
# Lectura o acción directa
#
# Comprueba si hay una ventana de intercambio seguro abierta.
#
# Integer: 1 = TRUE si hay un intercambio abierto; si no, 0 = FALSE.
#
# Resultado lógico: 1 = TRUE, 0 = FALSE. Tras VAR result = comando(...), use IF result = TRUE
# THEN o IF result = 1 THEN; para el resultado negativo, IF result = FALSE THEN o IF result = 0
# THEN. TRUE/FALSE sin comillas. Llame una vez y guarde el resultado: otra llamada puede repetir
# la acción o leer un estado cambiado.
SUB Main()
# Una llamada guardada en value/result. 0 es el primer índice, 1 el primer número (ver
# sintaxis). HEX muestra serials numéricos; CStr números o texto.
VAR value = UO.IsTrade()
UO.Print(CStr(value))
END SUB
Explicación de los parámetros y la ejecución:
- Una llamada guardada en value/result. 0 es el primer índice, 1 el primer número (ver sintaxis). HEX muestra serials numéricos; CStr números o texto.
Otro escenario y parámetros
# Otro escenario y parámetros
#
# Comprueba si hay una ventana de intercambio seguro abierta.
#
# Integer: 1 = TRUE si hay un intercambio abierto; si no, 0 = FALSE.
#
# Resultado lógico: 1 = TRUE, 0 = FALSE. Tras VAR result = comando(...), use IF result = TRUE
# THEN o IF result = 1 THEN; para el resultado negativo, IF result = FALSE THEN o IF result = 0
# THEN. TRUE/FALSE sin comillas. Llame una vez y guarde el resultado: otra llamada puede repetir
# la acción o leer un estado cambiado.
SUB Main()
# before/after son instantáneas separadas por 500 milisegundos. La pausa no espera un
# intercambio específico y puede omitir cambios intermedios.
VAR before = UO.IsTrade()
WAIT(500)
VAR after = UO.IsTrade()
UO.Print(CStr(before) + " -> " + CStr(after))
END SUB
Explicación de los parámetros y la ejecución:
- before/after son instantáneas separadas por 500 milisegundos. La pausa no espera un intercambio específico y puede omitir cambios intermedios.
Función auxiliar completa
# Función auxiliar completa
#
# Comprueba si hay una ventana de intercambio seguro abierta.
#
# Integer: 1 = TRUE si hay un intercambio abierto; si no, 0 = FALSE.
#
# Resultado lógico: 1 = TRUE, 0 = FALSE. Tras VAR result = comando(...), use IF result = TRUE
# THEN o IF result = 1 THEN; para el resultado negativo, IF result = FALSE THEN o IF result = 0
# THEN. TRUE/FALSE sin comillas. Llame una vez y guarde el resultado: otra llamada puede repetir
# la acción o leer un estado cambiado.
SUB Main()
# La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las
# llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del
# personaje, no una validación de precio/contenido.
VAR value = ReadTradeState()
UO.Print(CStr(value))
END SUB
FUNCTION ReadTradeState()
RETURN UO.IsTrade()
END FUNCTION
Explicación de los parámetros y la ejecución:
- La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del personaje, no una validación de precio/contenido.