Tabele wyników mogą być ciekawym sposobem na zachęcenie graczy do rywalizacji – zarówno tych najbardziej zaangażowanych (którzy będą walczyć o pierwsze miejsce w publicznej tabeli wyników), jak i tych, którzy grają bardziej okazjonalnie (będą oni mogli porównywać swoje postępy z postępami znajomych).
Aby dowiedzieć się, jak wdrożyć tabele wyników na swojej platformie, zapoznaj się z sekcją Implementacje klienta.
Informacje o tabelach wyników
Gdy utworzysz tabelę wyników, usługi gier Play zajmą się zarządzaniem większością jej aspektów. Typowy proces wygląda tak:
- Po zakończeniu gry (lub w odpowiednim momencie, który określisz) gra przesyła wynik gracza do co najmniej 1 tabeli wyników utworzonej na potrzeby tej gry.
- Usługi gier Play sprawdzają, czy ten wynik jest lepszy od bieżącego wyniku gracza w tabeli wyników (dziennego, tygodniowego lub ogólnego). Jeśli tak, usługi gier Play aktualizują odpowiednie tabele wyników o nowy wynik.
- Usługi gier Play wysyłają raport o wyniku z powrotem do klienta gry. Ten raport informuje klienta, czy jest to nowy najlepszy wynik dzienny, tygodniowy czy ogólny. Jeśli nie, usługi Gier Play poinformują klienta, jaki jest bieżący dzienny, tygodniowy lub ogólny rekord tego gracza.
- Aby pobrać wyniki gracza w tabeli wyników, możesz poprosić o przedział czasu (dzienny, tygodniowy lub ogólny) i określić, czy użytkownik chce zobaczyć tabelę wyników graczy czy publiczną. Usługi gier Play wykonują wszystkie niezbędne filtrowanie, a następnie wysyłają wyniki z powrotem do klienta.
- Jeśli jest wiele wyników do zgłoszenia, usługi gier Play wysyłają tylko dane dotyczące najlepszych wyników w tabeli wyników. Możesz też pobrać surowe dane dotyczące najlepszych wyników lub wyników sąsiadujących z wynikiem gracza.
Wiele tabel wyników
Gry mogą mieć wiele tabel wyników, maksymalnie 70. Na przykład gra wielopoziomowa może mieć inną tabelę wyników dla każdego poziomu, a gra wyścigowa – osobną tabelę wyników dla każdego toru.
Przedziały czasu w tabeli wyników
Pakiet SDK Gier Play automatycznie tworzy wersje dzienną, tygodniową i ogólną każdej utworzonej tabeli wyników. Nie musisz tworzyć osobnych tabel wyników dla każdego przedziału czasu.
Tabele wyników dziennych są resetowane o godzinie 7:00 UTC (czyli o północy czasu letniego pacyficznego) przez cały rok.
Tabele wyników tygodniowych są resetowane o północy z soboty na niedzielę w tej samej strefie czasowej co tabele wyników dziennych (UTC-7).
Publiczne i społecznościowe tabele wyników
Pakiet SDK Gier Play może wyświetlać graczowi 2 różne wersje każdej tabeli wyników:
Społecznościowa tabela wyników to tabela wyników, która zawiera osoby z kręgów użytkownika (lub, dokładniej, członków kręgów, które użytkownik udostępnił Twojej aplikacji), które zdecydowały się udostępniać użytkownikowi swoją aktywność w grze.
Publiczna tabela wyników to tabela wyników, która zawiera graczy, którzy zdecydowali się udostępniać swoją aktywność w grze publicznie. Jeśli gracz nie zdecyduje się udostępniać swojej aktywności w grze publicznie, nie pojawi się w tej tabeli wyników.
Wyświetlanie tabel wyników
W bibliotekach klienta mobilnego biblioteki zajmują się formatowaniem i wyświetlaniem tabel wyników. Możesz określić, czy gracz może zobaczyć konkretną tabelę wyników, czy listę wszystkich tabel wyników, z których może wybrać.
Możesz też wdrożyć własne wersje tabel wyników, uzyskując dostęp do danych bezpośrednio z bibliotek klienta.
Atrybuty
Aby tworzyć tabele wyników i nimi zarządzać, musisz znać te atrybuty tabel wyników:
Podstawy
Z każdą tabelą wyników są powiązane te podstawowe elementy:
- Identyfikator to unikalny ciąg znaków, który zostanie wygenerowany przez Konsolę Google Play. Będziesz używać tego unikalnego identyfikatora do odwoływania się do tabeli wyników w klientach gry.
- Nazwa to krótka nazwa tabeli wyników (np. „Najlepsze wyniki” lub „Poziom 3”). Może ona zawierać do 100 znaków.
- Ikona to kwadratowa ikona, która będzie powiązana z Twoją tabelą wyników. Sprawdzone metody tworzenia ikon tabel wyników znajdziesz w artykule Wskazówki dotyczące ikon.
- Kolejność na liście to kolejność, w jakiej tabela wyników będzie się wyświetlać, gdy gracz wyświetli tabele wyników powiązane z Twoją grą.
- Limity to opcjonalne wartości, które określają dolny i górny limit wyników dozwolonych w tabeli wyników. Może to pomóc w odrzucaniu zgłoszeń wyników, które są wyraźnie sfałszowane. Możesz też użyć
Players.hideaby ukryć graczy, którzy Twoim zdaniem przesłali sfałszowane wyniki, we wszystkich tabelach wyników w aplikacji.
Określanie kolejności tabel wyników
Tabele wyników mogą mieć jeden z 2 typów kolejności:
- Domyślnie używane są tabele wyników typu Większy wynik jest lepszy. Zazwyczaj są one używane w większości gier, w których gracze zdobywają punkty.
- Tabele wyników typu Mniejszy wynik jest lepszy są czasami używane w przypadkach, gdy mniejszy wynik jest lepszy. Najczęstsze przykłady tego typu tabel wyników to gry wyścigowe, w których wynik reprezentuje czas gracza na ukończenie wyścigu.
Format wyniku
Wszystkie wyniki są przesyłane do tabel wyników i przechowywane wewnętrznie jako długie liczby całkowite, ale usługi gier Play mogą prezentować je użytkownikowi w różnych formatach:
Tabele wyników liczbowych prezentują wyniki jako liczby. Mogą być one wyświetlane jako liczby całkowite lub rzeczywiste z ustaloną liczbą miejsc po przecinku. Wynik przesyłasz jako liczbę całkowitą, a przecinek jest wstawiany w określonym miejscu. Na przykład wynik
314159będzie wyświetlany jako3.14159,3141.59lub314159w zależności od określonego miejsca po przecinku.Tabele wyników czasowych prezentują wyniki w formacie godziny / minuty / sekundy/setne sekundy. Wyniki musisz przesyłać w milisekundach, więc
66032zostanie zinterpretowane jako1:06.03.Tabele wyników walutowych prezentują wyniki w formacie waluty. Wyniki przesyłasz jako 1/1 000 000 głównej jednostki waluty. Na przykład wynik 19 950 000 zostanie zinterpretowany jako
$19.95, jeśli jako walutę określisz USD.
Tabele wyników liczbowych obsługują też jednostki niestandardowe. Jeśli na przykład Twoja gra mierzy najlepsze wyniki w metrach, możesz określić „metry” jako domyślną jednostkę w tabeli wyników.
Tłumaczenia i formatowanie wyników
Gdy biblioteki klienta mobilnego wysyłają do usług gier Play prośbę o dane tabeli wyników, określają język i ustawienia regionalne, w których mają być wyświetlane te wyniki. Interfejs REST API umożliwia też określenie języka opartego na ustawieniach regionalnych. Usługi gier Play zwracają sformatowane wyniki tabeli wyników odpowiednie dla danego języka i ustawień regionalnych. Te sformatowane wyniki będą się wyświetlać niezależnie od tego, czy dodasz tłumaczenia dla swojej tabeli wyników.
W przypadku tabel wyników liczbowych format liczb jest wyświetlany inaczej w zależności od języka. (Na przykład 12,345.78 w Stanach Zjednoczonych i 12 345,78 we Francji). Jeśli
używasz jednostek niestandardowych i masz dodane
tłumaczenia do swojej
gry, musisz podać przetłumaczone jednostki dla każdego dodanego języka. Usługa wyświetla wtedy te przetłumaczone jednostki w odpowiednich miejscach.
W zależności od wybranego języka może być konieczne podanie różnych wersji nazw jednostek. W języku angielskim musisz podać wersję dla 1 elementu i inną dla wszystkich pozostałych (np. „meter” i „meters”). Z kolei w języku polskim musisz podać wersję dla 1 jednostki, kilku jednostek, wielu jednostek i wszystkich pozostałych. Więcej informacji o regułach liczby mnogiej znajdziesz w artykule Ciągi znaków ilości(liczba mnoga).
W przypadku tabel wyników czasowych format czasu jest wyświetlany zgodnie z językiem i ustawieniami regionalnymi gracza. Będzie to widoczne głównie wtedy, gdy używasz ułamków sekundy lub masz wartość godzinową z więcej niż 3 cyframi (np. 4,815:16:23.42 w Stanach Zjednoczonych i 4.815:16:23,42 w Niemczech).
W przypadku tabel wyników walutowych format waluty będzie wyświetlany zgodnie z językiem i ustawieniami regionalnymi gracza. Nie możesz jednak zmienić jednostki waluty. Jeśli na przykład określisz walutę w USD, gra będzie
wyświetlać $19.95 w Stanach Zjednoczonych i 19,95 $ we Francji. Nie możesz jednak określić, że gra ma wyświetlać dolary w Stanach Zjednoczonych i euro we Francji.
Wskazówki dotyczące ikon
Ikony powinny mieć wymiary 512 x 512 pikseli i format PNG lub JPEG. W większości klientów gry ikony będą pomniejszane, dlatego unikaj tworzenia ikon z zbyt dużą liczbą drobnych szczegółów. Możesz przesyłać ikony z kanałem alfa, a przezroczystość zostanie zachowana. Ikona tabeli wyników będzie wyświetlana na urządzeniach z Androidem na ciemnoszarym tle, dlatego wybierz ikonę, która będzie dobrze wyglądać w tej sytuacji.
We wszystkich wersjach językowych używana jest ta sama ikona, dlatego nie zalecamy umieszczania na niej tekstu ani treści zlokalizowanych.
Tworzenie tabeli wyników
W tej sekcji dowiesz się, jak tworzyć tabele wyników w nowych i dotychczasowych grach.
Tworzenie tabeli wyników
w nowej grze
Aby utworzyć tabelę wyników w nowej, nieopublikowanej grze, otwórz w Konsoli Google Play stronę swojej gry i kliknij Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Tabele wyników, a potem kliknij przycisk Utwórz tabelę wyników.
Następnie wypełnij wymagane informacje dotyczące tej tabeli wyników.
Kliknij Zapisz jako wersję roboczą, aby tabela wyników była dostępna w stanie „Wersja robocza” . Gdy opublikujesz grę, wszystkie tabele wyników tej gry zostaną opublikowane razem z nią.
Tworzenie tabeli wyników
w opublikowanej grze
Aby utworzyć dodatkową tabelę wyników dla gry, która została już opublikowana, wykonaj te same czynności. Więcej informacji o testowaniu zaktualizowanej wersji gry znajdziesz w artykule Publikowanie zmian w grze.
Gdy przetestujesz tabelę wyników i uznasz, że jest w porządku, możesz ponownie opublikować grę z nowymi tabelami wyników, które zostaną udostępnione wszystkim graczom.
Edytowanie tabeli wyników
Aby edytować już utworzoną tabelę wyników, kliknij ją na karcie Tabele wyników w Konsoli Google Play. Wyświetli się formularz użyty do utworzenia tabeli wyników. Będziesz mieć możliwość edytowania dowolnego pola.
Gdy skończysz edytowanie tabeli wyników, kliknij przycisk Zapisz jako wersję roboczą. Nowo zmodyfikowana tabela wyników będzie miała stan „Wersja robocza”, co pozwoli Ci ją przetestować.
Jeśli wszystko działa prawidłowo, w polu u góry formularza tabeli wyników kliknij Opublikuj zmiany . Dzięki temu będziesz mieć możliwość ponownego opublikowania gry wraz ze wszystkimi zaktualizowanymi tabelami wyników.
Cofanie zmian
Jeśli nowo zmodyfikowana tabela wyników nie będzie Ci się podobać i postanowisz wrócić do poprzedniej wersji, w polu u góry formularza tabeli wyników kliknij Przywróć. Tabela wyników zostanie przywrócona do już opublikowanej wersji.
Usuwanie tabeli wyników
Możesz usunąć tabele wyników, które są w stanie „Wersja robocza” lub zostały opublikowane. Aby usunąć tabelę wyników w Konsoli Google Play, otwórz formularz tabeli i u góry kliknij Usuń tabelę wyników.
Możesz też wywołać Players.hide, aby
ukryć w aplikacji tabelę wyników gracza.
Resetowanie tabeli wyników
Dane o postępach graczy możesz resetować tylko w wersjach roboczych tabel wyników.
- Aby zresetować tabele wyników w Konsoli Google Play, kliknij Zresetuj postęp u góry formularza danego zdarzenia.
- Aby zresetować dane tabeli wyników w sposób zautomatyzowany, wywołaj metody interfejsu API zarządzania Google Analytics
Scoresmethods.
Dodawanie tłumaczeń tabel wyników
Możesz podać własne tłumaczenia tabel wyników powiązanych z Twoją grą. Zanim to zrobisz, wykonaj czynności opisane w sekcji Dodawanie tłumaczeń gry. W swojej grze musisz też utworzyć co najmniej 1 tabelę wyników.
Aby dodać własne tłumaczenia tabel wyników, w Konsoli Google Play otwórz kartę Tabele wyników dla swojej gry, a następnie wybierz istniejącą tabelę wyników. Na stronie z informacjami o tabeli wyników kliknij kartę języka, który został wcześniej dodany na karcie Szczegóły gry. Na stronie z informacjami o tabeli wyników dla danego języka edytuj formularz, korzystając ze swoich tłumaczeń dla tej tabeli. Aby zapisać przetłumaczone informacje dotyczące tabeli wyników, kliknij Zapisz.
Ukrywanie wyników w tabeli wyników
Usługi gier Google Play oferują funkcję ochrony tabeli wyników przed nieuprawnionymi modyfikacjami, która sprawdza wyniki pod kątem podejrzenia o modyfikację i automatycznie je ukrywa. Ta funkcja jest dostępna tylko w przypadku gier na Androida.
Ochrona przed nieuprawnionymi modyfikacjami jest domyślnie włączona w przypadku nowych tabel wyników utworzonych dla gry na Androida, ale jest wyłączona w przypadku istniejących tabel wyników. Aby włączyć ochronę przed nieuprawnionymi modyfikacjami w tabelach wyników, które zostały już opublikowane:
- W Konsoli Google Play otwórz kartę Usługi gier , a następnie wybierz grę z listy.
- Otwórz kartę Tabele wyników , a potem wybierz instancję tabeli wyników, dla której chcesz włączyć ochronę przed nieuprawnionymi modyfikacjami.
- WŁĄCZ opcję Włącz ochronę tabeli wyników przed nieuprawnionymi modyfikacjami.
- Kliknij Zapisz i kontynuuj.
- Opublikuj swoją grę.
Po włączeniu w Konsoli Google Play ochrony tabeli wyników przed nieuprawnionymi modyfikacjami może minąć do 24 godzin, zanim ta funkcja zacznie działać. Wyniki przesłane przed włączeniem ochrony przed nieuprawnionymi modyfikacjami nie zostaną ukryte.
W niektórych sytuacjach ochronę przed nieuprawnionymi modyfikacjami warto wyłączyć (na przykład jeśli gra działa nie tylko na Androidzie, ale też w przeglądarce i udostępnia tabele wyników na obu platformach).
Implementacje klienta
Aby dowiedzieć się, jak wdrożyć tabele wyników na swojej platformie, zapoznaj się z tymi materiałami: