Parametry:

Wartości zwrotne

• result
  
  • success – wartość „true”, jeśli metoda zakończy się powodzeniem. Jeśli serwer zasobów zwraca wartość „false”, to powinien ustawić error jako string z wyjaśnieniem dlaczego.
    
  • error – string wyjaśniający, dlaczego to wywołanie nie powiodło się. Ta wiadomość zostanie zapisana w dzienniku błędów, który jest dostępny w zakładce „Ekonomia” na stronie Steamworks.
    
  • context – tablica kontekstów podrzędnych dla określonego kontekstu nadrzędnego.
    
    • id – 64-bitowe ID kontekstu w obrębie tej gry dla tego ID Steam. Aby dowiedzieć się więcej, zobacz ten artykuł.
      
    • name – nazwa kontekstu. Będzie wyświetlać się pracownikom pomocy technicznej. Jeśli user_facing ma wartość „true”, to jest ona również wyświetlana użytkownikom.
      
    • nested – jeśli wartość to „true”, kolejne wywołanie funkcji GetContexts z tym kontekstem jako nadrzędnym spowoduje zwrócenie niepustej listy kontekstów.
      
    • asset_count – liczba zasobów i walut, które użytkownik posiada w tym kontekście. Ta liczba jest wyświetlana użytkownikowi i zwykle każdy kontekst z polem asset_count równym zero będzie ukryty przed użytkownikiem.
      
    • user_facing – jeśli wartość to „true” i w kontekście są zasoby, to zostaną wyświetlone w interfejsie użytkownika dla wymiany i ekwipunku.
      
    • commands – tablica poleceń do wyświetlenia dla tego kontekstu na stronie „Ekonomia” w narzędziu pomocy technicznej. Dodatkowe informacje na temat poleceń znajdują się poniżej.
      
  • alerts(opcjonalnie) – tablica alertów związanych z tą grą do wyświetlenia w interfejsie wymiany. Ten element jest ignorowany dla kategorii innych niż „trading”.
    
    • text – zlokalizowany string do wyświetlenia w interfejsie użytkownika dla wymiany w tej grze.
      
    • color (opcjonalnie) – szesnastkowy kod koloru, w którym alert zostanie wyświetlony.
      
  • trade_permissions (opcjonalnie) – poziom uprawnień wymiany tego użytkownika. Wartość musi być jedną z następujących: NONE, RECEIVEONLY, SENDONLY, SENDONLY_FULLINVENTORY lub FULL.
    Użytkownicy z NONE nie będą mogli wymieniać żadnych zasobów związanych z tą grą. Użytkownicy z RECEIVEONLY będą mogli otrzymywać zasoby związane z tą grą, ale nie będą mogli dodawać własnych zasobów do wymiany. Użytkownicy z SENDONLY będą mogli dodawać posiadane przez siebie zasoby do wymiany, ale nie będą mogli otrzymywać zasobów związanych z tą grą. Użytkownicy z SENDONLY_FULLINVENTORY będą mieć te same ograniczenia co SENDONLY, ale zostaną powiadomieni, że ograniczenie jest spowodowane faktem, że ich ekwipunek jest pełny. Użytkownicy z FULL mogą dodawać do wymiany dowolne posiadane przez siebie przedmioty oznaczone jako wymienialne lub otrzymywać dowolne wymienialne przedmioty od partnera wymiany. Ten element jest ignorowany dla kategorii innych niż „trading”. Domyślnie: FULL.
    

Polecenia

• name – nazwa polecenia. Jest wyświetlana w narzędziu pomocy technicznej i zostanie zwrócona do ContextCommand.
  
• description – opis tego, co zrobi polecenie. Zostanie on wyświetlony pracownikowi pomocy technicznej w oknie dialogowym potwierdzenia.
  
• record_note – jeśli wartość to „true”, to pracownik pomocy technicznej zobaczy okno, w którym będzie musiał dodać notatkę, która następnie znajdzie się w historii działań podjętych przez pomoc techiczną dla tego konta.
  „false” powinno zostać zwrócone dla poleceń, które nie wprowadzają zmian w informacjach użytkownika (takich jak ponowne wczytywanie danych użytkownika z bazy danych).
  (domyślnie: true)
  
• asset_command (opcjonalnie) – jeśli wartość to „true”, polecenie pojawi się na każdym zasobie w kontekście zamiast na samym kontekście.
  Jeśli pracownik pomocy technicznej wykona to polecenie na kontekście, to dodatkowy argument o nazwie assetid zostanie dodany do wynikowego wywołania ContextCommand.
  
  
• options – tablica opcji do wyświetlenia w oknie dialogowym z potwierdzeniem.
  
  • name – nazwa opcji.
    
  • type – typ elementu interfejsu wyświetlany dla opcji. Obsługiwane typy to checkbox, dropdown, numeric i type_picker.
    
  • default – domyślna wartość dla tej opcji. Jest to wartość typu bool dla opcji z polem wyboru (checkbox) i nazwa wartości dla opcji z listą rozwijaną (dropdown).
    
  • supervisor_only – wartość to „true” tylko wtedy, gdy istnieje ograniczona liczba pracowników pomocy technicznej, która powinna mieć dostęp do tej opcji. Dla wszystkich pozostałych pracowników zostanie użyta wartość domyślna.
    
  • values – tablica możliwych wartości dla opcji typu dropdown. Nie jest używana dla innych typów opcji.
    
    • name – nazwa, która zostanie wyświetlona pracownikowi pomocy technicznej dla tej wartości.
      
    • value – wartość, która zostanie zwrócona w ContextCommand, jeśli została wybrana z listy rozwijanej.
      
    
    
  • types – tablica typów do wyświetlenia w opcjach type_picker. Nie jest używana dla innych typów opcji.
    
    • name – nazwa typu.
      
    • value – wartość do zwrócenia dla tego typu.
      
    • icon_url – URL ikony, która będzie wyświetlana obok tego typu w kontrolce wyboru.
      
    • tags – tablica tagów do wyświetlenia pod nazwą w type_picker.
      
    
    

Przykładowe wyjście