Osiągnięcia

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Prześlij opinię

Osiągnięcia mogą być świetnym sposobem na zwiększenie zaangażowania użytkowników w grze. Możesz wdrożyć osiągnięcia w grze, aby zachęcić graczy do eksperymentowania z funkcjami, których normalnie nie używają, lub do stosowania zupełnie innych stylów gry. Osiągnięcia mogą też być ciekawym sposobem na porównanie postępów z innymi graczami i zaangażowanie się w niezobowiązującą rywalizację.

Aby dowiedzieć się, jak wdrożyć osiągnięcia na swojej platformie, zapoznaj się z artykułem Wdrażanie na poziomie klienta.

Atrybuty

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

Te podstawowe elementy są powiązane z każdym osiągnięciem:

• Id to unikalny ciąg znaków wygenerowany przez Konsolę Google Play. Użyjesz tego unikalnego identyfikatora, aby odwoływać się do osiągnięcia w klientach gry.
• Nazwa to krótka nazwa osiągnięcia (np. „Pieman”). Wartość może zawierać maksymalnie 100 znaków.
• Opis to krótki opis Twojego osiągnięcia. Zazwyczaj informuje on gracza, jak zdobyć osiągnięcie (np. „Upiecz sernik cytrynowy z bezą 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 Wskazówki dotyczące ikon.
• Kolejność na liście to kolejność, w jakiej zablokowane osiągnięcia pojawiają się, gdy gracz przegląda osiągnięcia powiązane z Twoją grą. Możesz je ustawić w dowolnej kolejności. Odblokowane osiągnięcia są wyświetlane u góry listy w kolejności zdobycia.

Region

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

• Osiągnięcie ukrytej nagrody oznacza, że szczegóły dotyczące nagrody są ukryte przed graczem. Usługi Google Play dotyczące Gier udostępniają ogólny opis i ikonę dla osiągnięcia, gdy jest ono w stanie ukrytym. Zalecamy ukrycie osiągnięcia, jeśli zawiera ono spoiler, którego nie chcesz ujawniać zbyt wcześnie (np. „Odkryj, że od początku byłeś duchem”).
• Osiągnięcie ujawnione oznacza, że gracz wie o osiągnięciu, ale jeszcze go nie zdobył. Większość osiągnięć jest początkowo ukryta.
• Osiągnięcie odblokowane oznacza, że gracz zdobył osiągnięcie. Osiągnięcie można odblokować offline. Gdy gra jest online, synchronizuje 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 stopniowe. Ogólnie osiągnięcie stopniowe polega na stopniowym ulepszaniu wyników przez gracza w dłuższym okresie czasu. Gdy gracz będzie robić postępy w kierunku osiągnięcia osiągnięcia wieloetapowego, możesz zgłaszać jego częściowe postępy w Usługach Gier Play.

Usługa Google Play śledzi informacje o postępach, ostrzega grę, gdy gracz spełni kryteria niezbędne do odblokowania danego osiągnięcia, oraz informuje gracza, jak daleko jest od osiągnięcia tego celu.

Osiągnięcia cząstkowe są kumulowane w całych sesjach gry, a postępy nie można usunąć ani zresetować w grze. Przykładem osiągnięcia wieloetapowego może być „Wygrana w 50 rozgrywkach”. „Wygraj 3 gry z rzędu” nie byłoby możliwe, ponieważ postępy gracza byłyby resetowane po przegranej grze. „Mieć 5000 żetonów do gry w pokera” też nie kwalifikuje się, ponieważ gracz może zdobywać i tracić żetony w trakcie gry. W przypadku tych dwóch osiągnięć to Ty musisz śledzić stan „Zwycięstwa z rzędu” gracza lub łączną liczbę żetonów i odblokowywać standardowe osiągnięcia, gdy gracz je zdobędzie.

Podczas tworzenia osiągnięcia stopniowego musisz określić łączną liczbę kroków wymaganych do jego odblokowania (musi to być liczba z zakresu od 2 do 10 tys.). W miarę jak użytkownik będzie robić postępy w odblokowywaniu osiągnięcia, należy zgłaszać liczbę dodatkowych kroków, które wykonał w Usługach Play Games. Gdy łączna liczba kroków osiągnie wartość odblokowania, osiągnięcie zostanie odblokowane (nawet jeśli było ukryte). Nie musisz przechowywać skumulowanego postępu użytkownika.

Punkty

Osiągnięcia mają powiązaną wartość punktową. Wynik gracza musi być wielokrotnością 5, a w przypadku wszystkich osiągnięć w grze nie może przekroczyć 1000 punktów (może być ich mniej). Ponadto żadne osiągnięcie nie może mieć więcej niż 200 punktów.

śledzenie punktów doświadczenia (XP);

Gracze mogą awansować na kolejne poziomy na swoim profilu w grze, gdy zdobywają osiągnięcia w grach z wsparciem Gier Play. Za każde osiągnięcie związane 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 Gier Play śledzą punkty doświadczenia zdobyte przez każdego gracza i wysyłają powiadomienie do aplikacji Gier Google Play, gdy gracz zdobędzie wystarczającą liczbę punktów, aby „awansować”. Gracze mogą sprawdzić poziom i historię zdobytych punktów XP na stronie profilu w aplikacji Google Play Games.

Minimalne osiągnięcia

Gra, która integruje osiągnięcia, powinna mieć co najmniej 5 osiągnięć przed opublikowaniem. Możesz przetestować grę z mniej niż 5 osiągnięciami, ale przed opublikowaniem gry zalecamy utworzenie co najmniej 5 osiągnięć.

Maksymalne osiągnięcia

Liczba osiągnięć jest ograniczona przez limity i rozkład punktów. Maksymalna liczba punktów to 1000, a każde osiągnięcie ma przypisane 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:

• Utwórz osiągnięcie: definicje i metadane każdego osiągnięcia należy dodawać pojedynczo.
• Importuj osiągnięcia: 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 nowego, nieopublikowanego jeszcze tytułu:

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 wiele 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ę, wszystkie osiągnięcia z niej zostaną opublikowane.

Edytowanie osiągnięcia

Aby edytować już utworzone osiągnięcie, wybierz je na karcie Osiągnięcia w Konsoli Google Play. W tym momencie zobaczysz ten sam formularz, którego użyliśmy podczas tworzenia osiągnięcia. Możesz edytować dowolne pola według potrzeb.

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

Cofanie zmian

Jeśli zdecydujesz, że nie podoba Ci się aktualne osiągnięcie i chcesz przywrócić je do poprzedniego stanu, w Konsoli Google Play kliknij Cofnij na liście rozwijanej. 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 przedopublikacyjnym, klikając przycisk Usuń u dołu formularza.

Zresetuj osiągnięcie

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

• Aby zresetować osiągnięcia w Konsoli Google Play, kliknij przycisk Resetuj postępy w osiągniuciach na dole formularza dotyczącego danego wydarzenia.
• Aby zresetować dane osiągnięć za pomocą programowania, wywołaj metody interfejsu Management APIAchievements.

Wskazówki 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. Automatycznie wygenerujemy wersję w szarościach dla odsłoniętej ikony. Dlatego zalecamy, aby ikony osiągnięć zawierały kolorowe elementy, dzięki którym użytkownicy będą mogli odróżnić odblokowane osiągnięcia od odkrytych.

Gdy ikona osiągnięcia jest wyświetlana na Androidzie w powiadomieniu, jest nałożona na okrąg, a jej zewnętrzne rogi są ukryte. Upewnij się, że ikona nadal wygląda dobrze w takich okolicznościach.

Ta sama ikona jest używana we wszystkich lokalizacjach, dlatego nie zalecamy umieszczania na niej tekstu ani treści zlokalizowanych.

Wskazówki dotyczące plików ZIP

Możesz importować wiele osiągnięć naraz, korzystając z pliku ZIP. Dokładne nazwy plików do użycia w pliku ZIP znajdziesz w tabeli:

Wymagania dotyczące plików ZIP:

• Brak katalogów podrzędnych.
• 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 tym porządku:

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

Te pola są opisane w tabeli poniżej:

Wymagania dotyczące pliku 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 domyślny język.
• Pole Name powinno być unikalne w przypadku wszystkich osiągnięć.
• Te pola nie powinny zawierać przecinków: Name i Description.

Przykładowy plik AchievementsMetadata.csv:

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

Format 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 w różnych lokalizacjach. Osiągnięcia są tłumaczone zgodnie z lokalizacją określoną dla gry.

Plik powinien zawierać informacje rozdzielone przecinkami w tym porządku:

   Name, Localized name, Localized description, locale

Te pola są opisane w tabeli poniżej:

Wymagania dotyczące pliku AchievementsLocalizations.csv:

• Nazwy osiągnięć w grze muszą być niepowtarzalne w każdej lokalizacji. Jeśli na przykład gra obsługuje zarówno język angielski (USA), jak i francuski (Francja), osiągnięcie o nazwie „Osiągnięcie1” w języku angielskim (USA) może mieć też nazwę „Osiągnięcie1” w języku francuskim (Francja).
• Każdy wiersz powinien zawierać 4 wartości. Jeśli chcesz pominąć wartość lokalnego opisu, 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 służący do mapowania osiągnięć na daną ikonę. Plik powinien zawierać informacje w postaci wartości rozdzielonych przecinkami w takim porządku:

Name, icon filename

Te pola są opisane w tabeli poniżej:

Wymagania dotyczące pliku AchievementsIconMappings.csv:

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

Przykładowy plik AchievementsIconMappings.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łuje się plik 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 artykule Dodawanie tłumaczeń do gry.

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

• Możesz użyć opcji importuj osiągnięcia, aby przesłać tłumaczenia wielu nowych osiągnięć naraz. 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 dla swojej gry, a potem wybierz istniejące osiągnięcie.
  2. Na stronie z informacjami o osiągniętych osiągnięciach wybierz kartę języka, który został wcześniej dodany na karcie Szczegóły gry.
  3. Na stronie z informacjami o osiągnięciu w danym języku edytuj formularz, korzystając z tłumaczenia tego osiągnięcia.
  4. Aby zapisać przetłumaczone szczegóły osiągnięcia, kliknij Zapisz.

Implementacje po stronie klienta

Aby dowiedzieć się, jak wdrożyć osiągnięcia na swojej platformie, zapoznaj się z tymi materiałami:

• Android
• Unity
• Komputer
• Sprawdzone metody implementacji osiągnięć