API UO GetTradeContainer fr

UO.GetTradeContainer

ClassicUO • Runtime API

Renvoie le serial numérique d’un des conteneurs d’échange.

Syntaxe exacte

UO.GetTradeContainer(TradeNum:Any, Num:Any) -> Any

Paramètres

• TradeNum — Numéro entier actuel de 1 à TradeCount(). Zéro/négatif invalide. Ce n’est pas un serial.
• Num — 1 : votre conteneur ; 2 : celui du partenaire ; autres valeurs : 0.

Retour

Integer : les 32 bits du serial du conteneur ; 0 si fenêtre absente ou Num invalide. Pas un type graphique. Bit de poids fort conservé : tester <> 0, pas > 0 ni = TRUE.

Comportement

• GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade commencent à 1 ; TradeContainer/TradeOpponent/TradeName et toutes les formes TradeCheck à 0. Ce client conserve ces conventions ; les références des différents moteurs ne concordent pas toujours.
• Lecture sur le thread du jeu, dans les fenêtres vivantes du World actuel. Les fenêtres fermées sont exclues. Aucun paquet ni attente en lecture. L’ordre UI change à l’ouverture, fermeture ou passage au premier plan ; l’indice n’est pas un identifiant stable.
• ConfirmTrade et l’écriture de votre TradeCheck envoient uniquement lors d’un changement d’accord. Le serveur contrôle l’autre case. CancelTrade annule une seule fois. 1/TRUE signifie état/traitement local, pas transfert terminé. Les noms et cases ne garantissent pas un contenu inchangé.

Fonctions internes : de l’appel au résultat

Le chemin C# est expliqué ci-dessous, suivi d’exemples Basic exécutables. Les scripts ne réimplémentent pas le protocole réseau.

1. ExecuteStealthCompatibility

La signature est choisie selon le nombre d’arguments ; NumberConversions convertit les nombres. TradeCheck à deux arguments valide 1/2 puis les transforme en 0/1 pour le bridge. ToHex formate les serials historiques.

Integer : les 32 bits du serial du conteneur ; 0 si fenêtre absente ou Num invalide. Pas un type graphique. Bit de poids fort conservé : tester <> 0, pas > 0 ni = TRUE.

Source du projet: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; fonction ExecuteStealthCompatibility.

2. GetTradeContainer

Invoke transfère lecture/écriture sur le thread du jeu avec annulation du script ; lecture de ID1/ID2, LocalSerial, OpponentName ou des cases du TradingGump choisi.

Renvoie le serial numérique d’un des conteneurs d’échange.

Source du projet: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; fonction GetTradeContainer.

3. FindNumberedTrade

FindNumberedTrade vérifie number>0 avant de soustraire 1 ; FindTrade refuse les indices négatifs et parcourt les TradingGump non fermés de ce World.

GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade commencent à 1 ; TradeContainer/TradeOpponent/TradeName et toutes les formes TradeCheck à 0. Ce client conserve ces conventions ; les références des différents moteurs ne concordent pas toujours.

Source du projet: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; fonction FindNumberedTrade.

La fonction est entièrement définie et appelée par Main. Vérifier les limites/ID réduit les erreurs sans rendre les appels atomiques ; la fenêtre peut changer entre deux appels. expectedPartner est le serial mémorisé du personnage, pas une validation du prix/contenu.

Exemples

Lecture ou action directe

# Lecture ou action directe
#
# Renvoie le serial numérique d’un des conteneurs d’échange.
#
# Integer : les 32 bits du serial du conteneur ; 0 si fenêtre absente ou Num invalide. Pas un
# type graphique. Bit de poids fort conservé : tester <> 0, pas > 0 ni = TRUE.

SUB Main()
    # Un seul appel, conservé dans value/result. 0 désigne le premier indice, 1 le premier numéro
    # (voir syntaxe). HEX affiche les serials numériques ; CStr affiche nombres ou texte.

    VAR value = UO.GetTradeContainer(1, 1)
    UO.Print(HEX(value))
END SUB

Explication des paramètres et du déroulement:

• Un seul appel, conservé dans value/result. 0 désigne le premier indice, 1 le premier numéro (voir syntaxe). HEX affiche les serials numériques ; CStr affiche nombres ou texte.

Autre scénario et paramètres

# Autre scénario et paramètres
#
# Renvoie le serial numérique d’un des conteneurs d’échange.
#
# Integer : les 32 bits du serial du conteneur ; 0 si fenêtre absente ou Num invalide. Pas un
# type graphique. Bit de poids fort conservé : tester <> 0, pas > 0 ni = TRUE.

SUB Main()
    # total mémorise le nombre de fenêtres ; index est l’indice/numéro actuel. Le parcours ne
    # confirme rien. GetTradeContainer lit les conteneurs propre (1) et adverse (2) de la fenêtre 1.

    VAR ours = UO.GetTradeContainer(1, 1)
    VAR theirs = UO.GetTradeContainer(1, 2)
    UO.Print(HEX(ours) + " / " + HEX(theirs))
END SUB

Explication des paramètres et du déroulement:

• total mémorise le nombre de fenêtres ; index est l’indice/numéro actuel. Le parcours ne confirme rien. GetTradeContainer lit les conteneurs propre (1) et adverse (2) de la fenêtre 1.

Fonction auxiliaire complète

# Fonction auxiliaire complète
#
# Renvoie le serial numérique d’un des conteneurs d’échange.
#
# Integer : les 32 bits du serial du conteneur ; 0 si fenêtre absente ou Num invalide. Pas un
# type graphique. Bit de poids fort conservé : tester <> 0, pas > 0 ni = TRUE.

SUB Main()
    # La fonction est entièrement définie et appelée par Main. Vérifier les limites/ID réduit les
    # erreurs sans rendre les appels atomiques ; la fenêtre peut changer entre deux appels.
    # expectedPartner est le serial mémorisé du personnage, pas une validation du prix/contenu.

    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

Explication des paramètres et du déroulement:

• La fonction est entièrement définie et appelée par Main. Vérifier les limites/ID réduit les erreurs sans rendre les appels atomiques ; la fenêtre peut changer entre deux appels. expectedPartner est le serial mémorisé du personnage, pas une validation du prix/contenu.

---

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

Basic