API UO GetTradeContainer de - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki
UO.GetTradeContainer
ClassicUO • Runtime API
Liest die numerische Serial eines Handelsbehälters.
Genaue Syntax
UO.GetTradeContainer(TradeNum:Any, Num:Any) -> Any
Parameter
TradeNum— Ganzzahlige aktuelle Fensternummer 1..TradeCount(). Null/negativ ungültig. Keine Serial.Num— 1 eigener Behälter, 2 Partnerbehälter; andere Werte ergeben 0.
Rückgabewert
Integer: 32 Serial-Bits des Behälters; 0 bei fehlendem Fenster/ungültigem Num. Kein Grafiktyp. Höchstes Bit bleibt erhalten: <> 0 testen, nicht > 0 oder = TRUE.
Verhalten
- GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade beginnen bei 1; TradeContainer/TradeOpponent/TradeName und alle TradeCheck-Formen bei 0. Dieser Client erhält diese Konventionen; externe Handbücher verschiedener Engines verwenden unterschiedliche Anfänge.
- Lesen erfolgt im Spielthread aus lebenden Fenstern dieser World. Geschlossene Fenster zählen nicht. Lesen sendet keine Pakete und wartet nicht. Öffnen, Schließen und In-den-Vordergrund-Bringen können die UI-Reihenfolge ändern; der Index ist keine dauerhafte ID.
- ConfirmTrade und eigenes TradeCheck-Schreiben senden nur bei geänderter Zustimmung. Die Gegenseite steuert der Server. CancelTrade sendet einmal. 1/TRUE bedeutet lokalen Zustand/Verarbeitung, keinen abgeschlossenen Transfer. Namen und Häkchen beweisen keinen unveränderten Inhalt.
Interne Funktionen: vom Aufruf zum Ergebnis
Unten stehen der C#-Aufrufpfad und danach ausführbare Basic-Beispiele. Die Skripte implementieren kein eigenes Netzwerkprotokoll.
1. ExecuteStealthCompatibility
Die Registrierung wählt nach Argumentanzahl; NumberConversions wandelt Zahlen. Zweistelliges TradeCheck prüft Seiten 1/2 und bildet sie auf Bridge-Indizes 0/1 ab. ToHex formatiert Legacy-Serials.
Integer: 32 Serial-Bits des Behälters; 0 bei fehlendem Fenster/ungültigem Num. Kein Grafiktyp. Höchstes Bit bleibt erhalten: <> 0 testen, nicht > 0 oder = TRUE.
Projektquelle: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; Funktion ExecuteStealthCompatibility.
2. GetTradeContainer
Invoke verlegt Lesen/Schreiben in den Spielthread mit Skriptabbruch; gelesen werden ID1/ID2, LocalSerial, OpponentName oder Häkchen des gewählten TradingGump.
Liest die numerische Serial eines Handelsbehälters.
Projektquelle: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; Funktion GetTradeContainer.
3. FindNumberedTrade
FindNumberedTrade prüft number>0 vor dem Abziehen von 1; FindTrade weist negative Indizes zurück und zählt nur offene TradingGump dieser World.
GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade beginnen bei 1; TradeContainer/TradeOpponent/TradeName und alle TradeCheck-Formen bei 0. Dieser Client erhält diese Konventionen; externe Handbücher verschiedener Engines verwenden unterschiedliche Anfänge.
Projektquelle: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; Funktion FindNumberedTrade.
Die vollständige Hilfsfunktion wird von Main aufgerufen. Bereichs-/ID-Prüfungen verringern Fehler, machen mehrere Aufrufe aber nicht atomar. Das Fenster kann wechseln. expectedPartner ist eine gespeicherte Charakter-Serial, keine Preis-/Inhaltsprüfung.
Beispiele
Direkt lesen oder ausführen
# Direkt lesen oder ausführen
#
# Liest die numerische Serial eines Handelsbehälters.
#
# Integer: 32 Serial-Bits des Behälters; 0 bei fehlendem Fenster/ungültigem Num. Kein Grafiktyp.
# Höchstes Bit bleibt erhalten: <> 0 testen, nicht > 0 oder = TRUE.
SUB Main()
# Ein Aufruf, gespeichert in value/result. 0 ist der erste Index, 1 die erste Nummer (siehe
# Syntax). HEX zeigt numerische Serials; CStr Zahlen oder Text.
VAR value = UO.GetTradeContainer(1, 1)
UO.Print(HEX(value))
END SUB
Erläuterung der Parameter und Ausführung:
- Ein Aufruf, gespeichert in value/result. 0 ist der erste Index, 1 die erste Nummer (siehe Syntax). HEX zeigt numerische Serials; CStr Zahlen oder Text.
Weiteres Szenario und Parameter
# Weiteres Szenario und Parameter
#
# Liest die numerische Serial eines Handelsbehälters.
#
# Integer: 32 Serial-Bits des Behälters; 0 bei fehlendem Fenster/ungültigem Num. Kein Grafiktyp.
# Höchstes Bit bleibt erhalten: <> 0 testen, nicht > 0 oder = TRUE.
SUB Main()
# total speichert die Fensteranzahl, index den aktuellen Index/die Nummer. Aufzählen bestätigt
# nichts. GetTradeContainer liest eigenen (1) und fremden (2) Behälter von Fenster 1.
VAR ours = UO.GetTradeContainer(1, 1)
VAR theirs = UO.GetTradeContainer(1, 2)
UO.Print(HEX(ours) + " / " + HEX(theirs))
END SUB
Erläuterung der Parameter und Ausführung:
- total speichert die Fensteranzahl, index den aktuellen Index/die Nummer. Aufzählen bestätigt nichts. GetTradeContainer liest eigenen (1) und fremden (2) Behälter von Fenster 1.
Vollständige Hilfsfunktion
# Vollständige Hilfsfunktion
#
# Liest die numerische Serial eines Handelsbehälters.
#
# Integer: 32 Serial-Bits des Behälters; 0 bei fehlendem Fenster/ungültigem Num. Kein Grafiktyp.
# Höchstes Bit bleibt erhalten: <> 0 testen, nicht > 0 oder = TRUE.
SUB Main()
# Die vollständige Hilfsfunktion wird von Main aufgerufen. Bereichs-/ID-Prüfungen verringern
# Fehler, machen mehrere Aufrufe aber nicht atomar. Das Fenster kann wechseln. expectedPartner
# ist eine gespeicherte Charakter-Serial, keine Preis-/Inhaltsprüfung.
VAR value = ReadTradeValue(1)
UO.Print(HEX(value))
END SUB
FUNCTION ReadTradeValue(index)
VAR total = UO.TradeCount()
IF index < 1 OR index >= total + 1 THEN
RETURN 0
END IF
RETURN UO.GetTradeContainer(index, 1)
END FUNCTION
Erläuterung der Parameter und Ausführung:
- Die vollständige Hilfsfunktion wird von Main aufgerufen. Bereichs-/ID-Prüfungen verringern Fehler, machen mehrere Aufrufe aber nicht atomar. Das Fenster kann wechseln. expectedPartner ist eine gespeicherte Charakter-Serial, keine Preis-/Inhaltsprüfung.