Dokumentacja Steamworks
Interfejs ISteamUserStats

Nowsza wersja dostępna po angielsku

Angielska wersja tej strony została zaktualizowana od daty opublikowania ostatniego tłumaczenia.
Kliknij tutaj, by wyświetlić angielską wersję tej strony.
Służy do uzyskiwania dostępu do informacji o użytkownikach.

Aby dowiedzieć się więcej o korzystaniu z API webowych Steamworks, przejdź do omówienia API webowych.

GetGlobalAchievementPercentagesForApp

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
NazwaTypWymagane?Opis
gameiduint64✔ID gry, dla której chcesz uzyskać informacje o osiągnięciach.

Pobiera procenty globalnych osiągnięć dla określonej aplikacji.

Ta metoda ma wcześniejsze wersje, które nie są już oficjalnie obsługiwane. Nadal można ich używać, ale stanowczo zaleca się korzystanie z najnowszej wersji.
Historia zmian:
  • Wersja 2 – usunięto nazwy elementów z tablic.

GetGlobalStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
NazwaTypWymagane?Opis
appiduint32✔ID aplikacji, dla której mają zostać uzyskane statystyki globalne.
countuint32✔Liczba statystyk, dla których mają zostać uzyskane dane.
name[0]string✔Nazwy statystyk, dla których mają zostać uzyskane dane.
startdateuint32Data rozpoczęcia dziennych łącznych statystyk (w formacie uniksowym).
enddateuint32Data zakończenia dziennych łącznych statystyk (w formacie uniksowym).

Pobiera procenty globalnych statystyk dla określonej aplikacji.

Przeczytaj dokumentację statystyk globalnych, by poznać więcej informacji.

GetNumberOfCurrentPlayers

GET https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
NazwaTypWymagane?Opis
appiduint32✔ID aplikacji, dla którego ma zostać uzyskana liczba użytkowników.

Pobiera całkowitą liczbę graczy aktualnie aktywnych w określonej aplikacji na Steam.

Należy pamiętać, że ta opcja nie zwróci graczy, którzy grali bez połączenia ze Steam.

GetPlayerAchievements

GET https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
NazwaTypWymagane?Opis
keystring✔Klucz autoryzacyjny użytkownika API webowych Steamworks.
steamiduint64✔ID Steam użytkownika.
appiduint32✔ID aplikacji, dla której mają zostać uzyskane osiągnięcia.
lstringJęzyk, dla którego mają zostać zwrócone ciągi znaków.

Pobiera listę osiągnięć odblokowanych w aplikacji przez określonego użytkownika.

GetSchemaForGame

GET https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
NazwaTypWymagane?Opis
keystring✔Klucz autoryzacyjny użytkownika API webowych Steamworks.
appiduint32✔ID aplikacji gry.
lstringJęzyk lokalizacji, jaki ma zostać zwrócony („english” dla angielskiego, „french” dla francuskiego itd.).

Pobiera całkowitą listę statystyk i osiągnięć dla określonej gry.

Ta metoda ma wcześniejsze wersje, które nie są już oficjalnie obsługiwane. Nadal można ich używać, ale stanowczo zaleca się korzystanie z najnowszej wersji.
Historia zmian:
  • Wersja 2 – naprawiono błąd powodujący, że nazwa gry była zwracana w pliku XML.

GetUserStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
NazwaTypWymagane?Opis
keystring✔Klucz autoryzacyjny użytkownika API webowych Steamworks.
steamiduint64✔ID Steam użytkownika.
appiduint32✔ID aplikacji gry.

Pobiera listę statystyk, jakie określony użytkownik pozostawił w danej aplikacji.

Ta metoda ma wcześniejsze wersje, które nie są już oficjalnie obsługiwane. Nadal można ich używać, ale stanowczo zaleca się korzystanie z najnowszej wersji.
Historia zmian:
  • Wersja 2 – naprawiono błąd powodujący, że nazwa gry była zwracana w pliku XML.

SetUserStatsForGame

POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
NazwaTypWymagane?Opis
keystring✔Klucz autoryzacyjny wydawcy API webowych Steamworks.
steamiduint64✔ID Steam użytkownika.
appiduint32✔ID aplikacji gry.
countuint32✔Liczba statystyk i osiągnięć, dla których ma zostać przypisana wartość (pary parametrów nazwa/wartość).
name[0]string✔Nazwa statystyki lub osiągnięcia, jaka ma zostać ustawiona.
value[0]uint32✔Wartość, jaka ma zostać ustawiona.

Ustawia statystyki dla określonego użytkownika w grze.

UWAGA: to wywołanie wymaga, by klucz API wydawcy, który jest właścicielem określonego ID aplikacji, korzystał z tej metody. Z tego powodu to API MUSI zostać wywołane z zabezpieczonego serwera i nigdy nie może być bezpośrednio używane przez klienty!