Osiągnięcia

Osiągnięcia mogą być świetnym sposobem na zwiększenie zaangażowania użytkowników w grze. Możesz wdrożyć w grze osiągnięcia, aby zachęcić graczy do eksperymentowania z funkcjami, których zwykle nie używają, lub do wypróbowania zupełnie innych stylów gry. Osiągnięcia mogą też być dla graczy świetnym sposobem na porównywanie postępów i uczestniczenie w lekkiej rywalizacji.

Aby dowiedzieć się, jak wdrożyć osiągnięcia na swojej platformie, zapoznaj się z sekcją Implementacje klienta.

Atrybuty

Aby zrozumieć, jak działają osiągnięcia, musisz poznać niektóre z powiązanych z nimi atrybutów.

Z każdym osiągnięciem są powiązane te podstawowe elementy:

• Id to unikalny ciąg znaków generowany przez Konsolę Google Play. Ten niepowtarzalny identyfikator będzie Ci potrzebny do odwoływania się do osiągnięcia w klientach gry.
• Name to krótka nazwa osiągnięcia (np. „Pieman”). Wartość może mieć maksymalnie 100 znaków.
• Opis to zwięzły opis osiągnięcia. Zwykle informuje to gracza, jak zdobyć osiągnięcie (np. „Upiecz ciasto cytrynowe przed zachodem słońca”). Wartość może mieć maksymalnie 500 znaków.
• Ikona to kwadratowa ikona powiązana z osiągnięciem. Sprawdzone metody tworzenia ikon osiągnięć znajdziesz w sekcji Wytyczne dotyczące ikon.
• Kolejność na liście to kolejność, w jakiej zablokowane osiągnięcia pojawiają się, gdy gracz wyświetla osiągnięcia powiązane z Twoją grą. Możesz je ułożyć w dowolnej kolejności. Odblokowane osiągnięcia są wyświetlane u góry listy w kolejności, w jakiej zostały zdobyte.

Województwo

Osiągnięcia mogą mieć jeden z 3 stanów:

• Ukryte osiągnięcie oznacza, że szczegóły osiągnięcia są ukryte przed graczem. Usługi Play Games udostępniają ogólny opis zastępczy i ikonę osiągnięcia, gdy jest ono ukryte. Zalecamy ukrywanie osiągnięć, które zawierają spoilery, których nie chcesz zbyt wcześnie ujawniać (np. „Odkryj, że przez cały czas byłeś duchem!”).
• Odkryte osiągnięcie oznacza, że gracz wie o nim, ale jeszcze go nie zdobył. Większość osiągnięć jest początkowo w stanie ujawnionym.
• Odblokowane osiągnięcie oznacza, że gracz zdobył je. Osiągnięcie można odblokować offline. Gdy gra zostanie włączona, zsynchronizuje się z usługami gier Play, aby zaktualizować stan odblokowania osiągnięcia.

Osiągnięcia zdobywane stopniowo

Osiągnięcia mogą być standardowe lub przyrostowe. Zwykle osiągnięcie przyrostowe polega na stopniowym zdobywaniu osiągnięcia przez gracza w dłuższym okresie. Gdy gracz robi postępy w zdobywaniu osiągnięcia wieloetapowego, możesz zgłaszać częściowe postępy do Usług gier Play.

Usługa Google Play śledzi informacje o postępach, powiadamia grę, gdy gracz spełni kryteria wymagane do odblokowania osiągnięcia, i informuje go, jak blisko jest osiągnięcia celu.

Osiągnięcia przyrostowe są kumulowane w ramach sesji gry, a postępów nie można usunąć ani zresetować w grze. Na przykład „Wygrana w 50 rozgrywkach” kwalifikuje się jako osiągnięcie wieloetapowe. „Wygraj 3 mecze z rzędu” nie byłoby odpowiednie, ponieważ postępy gracza zostałyby zresetowane po przegraniu meczu. „Mieć 5000 żetonów do pokera” też się nie kwalifikuje, ponieważ gracz może zdobywać i tracić żetony w trakcie gry. W przypadku 2 ostatnich osiągnięć musisz śledzić stan „Wygrane z rzędu” lub łączną liczbę żetonów gracza i odblokowywać standardowe osiągnięcia, gdy gracz je zdobędzie.

Podczas tworzenia osiągnięcia przyrostowego musisz określić łączną liczbę kroków wymaganych do jego odblokowania (musi to być liczba z zakresu od 2 do 10 000). W miarę postępów użytkownika w zdobywaniu osiągnięcia należy zgłaszać Usługom gier Play liczbę dodatkowych kroków, które wykonał. Gdy łączna liczba kroków osiągnie wartość odblokowania, osiągnięcie zostanie odblokowane (nawet jeśli było ukryte). Nie musisz przechowywać łącznych postępów użytkownika.

Punkty

Osiągnięcia mają przypisaną wartość punktową. Wynik gracza musi być wielokrotnością liczby 5, a łączna liczba punktów za wszystkie osiągnięcia w grze nie może przekraczać 1000 (może być mniejsza). Ponadto żadne pojedyncze osiągnięcie nie może mieć więcej niż 200 punktów.

Śledzenie punktów doświadczenia (XP)

Gracze mogą zdobywać kolejne poziomy w profilu w Grach Play, gdy uzyskują osiągnięcia w grach obsługujących tę usługę. Za każdy punkt związany z osiągnięciem gracz otrzymuje 100 punktów doświadczenia (XP). Krótko mówiąc:

XP for an achievement = 100 * (point value for the achievement)

Usługi Play Games śledzą liczbę punktów XP zdobytych przez każdego gracza i wysyłają powiadomienie do aplikacji Gry Google Play, gdy gracz zdobędzie wystarczającą liczbę punktów, aby „awansować”. Gracze mogą sprawdzić historię poziomów i XP na stronie Profil w aplikacji Gry Play.

Minimalne osiągnięcia

Gra, która integruje osiągnięcia, powinna mieć co najmniej 5 osiągnięć przed opublikowaniem. Możesz przeprowadzić test z mniejszą liczbą osiągnięć, ale zalecamy utworzenie co najmniej 5 osiągnięć przed opublikowaniem gry.

Maksymalna liczba osiągnięć

Liczba osiągnięć jest ograniczona przez limity punktów i ich rozkład. Maksymalna liczba punktów to 1000, a każde osiągnięcie jest warte 5 punktów, więc maksymalna liczba osiągnięć to 200. Jeśli jednak osiągnięciom przypiszesz więcej punktów, liczba dostępnych osiągnięć zmniejszy się.

Dodaj osiągnięcia

Istnieją 2 sposoby tworzenia osiągnięć po raz pierwszy w Konsoli Google Play:

• Tworzenie osiągnięcia: dodaj po kolei definicje i metadane dotyczące każdego osiągnięcia.
• Importowanie osiągnięć: w jednym kroku możesz zaimportować definicje i inne metadane dotyczące wielu osiągnięć.

Tworzenie osiągnięcia

Aby utworzyć osiągnięcie dla nowej, nieopublikowanej gry:

1. W Konsoli Google Play wybierz grę.
2. Na stronie Usługi gier Play – osiągnięcia (Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Osiągnięcia) kliknij Utwórz osiągnięcie.
3. Na stronie Dodaj osiągnięcia wypełnij formularz.
4. Kliknij Zapisz jako wersję roboczą.
5. Po utworzeniu osiągnięcia musisz opublikować grę.

Dodawanie kolejnych osiągnięć

Jeśli masz już osiągnięcia i chcesz dodać więcej:

1. W Konsoli Google Play wybierz grę.
2. Na stronie Usługi gier Play – osiągnięcia (Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Osiągnięcia) kliknij Dodaj osiągnięcia.

Importuj osiągnięcia

Aby dodać do gry kilka osiągnięć naraz, wykonaj te czynności:

1. Utwórz plik .zip zawierający Twoje osiągnięcia.
2. Prześlij plik.

Więcej informacji o pliku ZIP znajdziesz w wytycznych dotyczących plików ZIP.

Aby zaimportować osiągnięcia:

1. W Konsoli Google Play wybierz grę.
2. Na stronie Usługi gier Play – osiągnięcia (Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Osiągnięcia) kliknij Importuj osiągnięcia.
3. Na stronie Importuj osiągnięcia kliknij Prześlij.
4. Wybierz plik ZIP, który chcesz przesłać.
5. Kliknij Zapisz jako wersję roboczą.
6. Po zaimportowaniu osiągnięć musisz opublikować grę.

Opublikuj grę

Gdy przetestujesz i opublikujesz grę, zostaną też opublikowane wszystkie zarejestrowane w niej osiągnięcia.

Edytowanie osiągnięcia

Aby edytować już utworzone osiągnięcie, wybierz je na karcie Osiągnięcia w Konsoli Google Play. Wyświetli się formularz użyty do utworzenia tego osiągnięcia. Możesz edytować dowolne pola.

Gdy skończysz edytować osiągnięcie, kliknij przycisk Zapisz jako wersję roboczą. Nowo zmodyfikowane osiągnięcie będzie miało stan „Gotowe do testowania” i będzie można je przetestować. Jeśli wszystko działa prawidłowo, na liście wybierz Opublikuj ponownie. Spowoduje to ponowne opublikowanie gry wraz ze wszystkimi zaktualizowanymi osiągnięciami.

Cofanie zmian

Jeśli nie spodoba Ci się aktualne osiągnięcie i postanowisz przywrócić jego poprzednią wersję, na liście w Konsoli Google Play kliknij Przywróć. Wszystkie osiągnięcia zostaną przywrócone do wcześniej opublikowanej wersji.

Usuwanie osiągnięcia

Opublikowanego osiągnięcia nie można usunąć.

Osiągnięcie można usunąć tylko w stanie przed opublikowaniem. Aby to zrobić, kliknij przycisk Usuń u dołu formularza tego osiągnięcia.

Resetowanie osiągnięcia

Dane o postępach graczy możesz zresetować tylko w przypadku osiągnięć w wersji roboczej.

• Aby zresetować osiągnięcia w Konsoli Google Play, kliknij przycisk Zresetuj postęp osiągnięć na dole formularza dotyczącego tego zdarzenia.
• Aby zresetować dane osiągnięć w sposób zautomatyzowany, wywołaj metodyAchievements interfejsu Management API.

Wytyczne dotyczące ikon

Ikony powinny mieć wymiary 512 x 512 pikseli i format PNG, JPEG lub JPG. Wystarczy, że prześlesz nam ikonę odblokowanego osiągnięcia. Dla ikony osiągnięcia odkrytego automatycznie wygenerujemy wersję w trybie szarości. Dlatego zalecamy, aby ikony osiągnięć zawierały elementy kolorowe – dzięki temu użytkownicy będą mogli odróżnić osiągnięcia odblokowane od odkrytych.

Gdy ikona osiągnięcia jest wyświetlana w powiadomieniu na urządzeniu z Androidem, jest nałożona na kółko, a jej zewnętrzne rogi są ukryte. Upewnij się, że w takich warunkach ikona nadal dobrze wygląda.

We wszystkich wersjach językowych używana jest ta sama ikona, dlatego nie zalecamy umieszczania na niej tekstu ani treści zlokalizowanych.

Wytyczne dotyczące plików ZIP

W pliku ZIP możesz zaimportować kilka osiągnięć naraz. Dokładne nazwy plików do użycia w pliku ZIP znajdziesz w tabeli:

Wymagania dotyczące pliku ZIP:

• Brak podkatalogów.
• Unikalne nazwy plików.
• Tylko pliki CSV, PNG, JPEG lub JPG.
• Pliki CSV nie mogą zawierać wiersza nagłówka.
• Rozmiar każdego pliku musi być mniejszy niż 1 MB.
• Plik ZIP nie powinien zawierać więcej niż 203 plików.
• Łączny rozmiar pliku ZIP nie może przekraczać 200 MB.

Format pliku AchievementsMetadata.csv

Plik AchievementsMetadata.csv zawiera metadane dotyczące każdego osiągnięcia. Plik powinien zawierać informacje w postaci wartości rozdzielonych przecinkami w tej kolejności:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Pola są opisane w tej tabeli:

Wymagania dotyczące plików AchievementsMetadata.csv:

• Każdy wiersz musi zawierać 7 wartości. Jeśli chcesz pominąć wartość, pozostaw to pole puste.
• Pola Name i Description są używane jako język domyślny.
• Pole Name powinno być unikalne dla wszystkich osiągnięć.
• Pola Name i Description nie powinny zawierać przecinków.

Przykładowy plik AchievementsMetadata.csv:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

Format pliku AchievementsLocalizations.csv

Plik AchievementsLocalizations.csv to opcjonalny plik, który zawiera wszystkie dane potrzebne do opisania każdego osiągnięcia dla użytkowników korzystających z różnych wersji regionalnych. Osiągnięcia są tłumaczone zgodnie z ustawieniami regionalnymi gry.

Plik powinien zawierać informacje w postaci wartości rozdzielonych przecinkami w tej kolejności:

   Name, Localized name, Localized description, locale

Pola są opisane w tej tabeli:

Wymagania dotyczące plików AchievementsLocalizations.csv:

• Nazwy osiągnięć w grze muszą być niepowtarzalne dla danych ustawień regionalnych. Jeśli na przykład gra obsługuje wersje językowe angielską (en-US) i francuską (fr-FR), osiągnięcie o nazwie „Achievement1” w języku angielskim (en-US) może mieć również nazwę „Achievement1” w języku francuskim (fr-FR).
• Każdy wiersz powinien zawierać 4 wartości. Jeśli chcesz pominąć wartość Zlokalizowany opis, pozostaw to pole puste.

Przykładowy plik AchievementsLocalizations.csv:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

Format pliku AchievementsIconMappings.csv

Plik AchievementsIconMappings.csv to opcjonalny plik, który służy do mapowania osiągnięć za pomocą danej ikony. Plik powinien zawierać informacje w postaci wartości rozdzielonych przecinkami w tej kolejności:

Name, icon filename

Pola są opisane w tej tabeli:

Wymagania dotyczące plików AchievementsIconMappings.csv:

• Każdy wiersz powinien zawierać 2 wartości.
• Pliki ikon mogą mieć tylko format PNG lub JPEG.

Przykładowy plikAchievementsIconMappings.csv:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

Pliki ikon

Ikony, do których odwołujesz się w pliku AchievementsIconMappings.csv, muszą znajdować się w bieżącym importowanym archiwum ZIP. Więcej informacji znajdziesz w wytycznych dotyczących ikon.

Dodawanie tłumaczeń osiągnięć

Możesz określić własne tłumaczenia osiągnięć powiązanych z Twoją grą. Zanim to zrobisz, wykonaj czynności opisane w sekcji Dodawanie tłumaczeń gry.

Tłumaczenia do gry możesz dodać na 2 sposoby:

• Aby przesłać tłumaczenia kilku nowych osiągnięć naraz, możesz użyć opcji importuj osiągnięcia. Nie możesz użyć tej opcji do przesłania tłumaczeń już istniejących osiągnięć.

• Możesz dodać tłumaczenia każdego osiągnięcia w grze. Aby dodać własne tłumaczenie każdego osiągnięcia:

  1. W Konsoli Google Play otwórz kartę Osiągnięcia swojej gry, a następnie wybierz istniejące osiągnięcie.
  2. Na stronie z informacjami o osiągnięciach wybierz kartę języka, który został wcześniej dodany na karcie Informacje o grze.
  3. Na stronie z informacjami o osiągnięciu w danym języku wpisz swoje tłumaczenie dotyczące tego osiągnięcia.
  4. Aby zapisać przetłumaczone informacje o osiągnięciu, kliknij Zapisz.

Implementacje klienta

Więcej informacji o wdrażaniu osiągnięć na platformie znajdziesz w tych materiałach:

• Android
• Unity
• Komputer
• Sprawdzone metody wdrażania osiągnięć