Korzystaj z interfejsów API znajomych, aby uzupełnić i ulepszyć obecny system znajomych w grze i inne systemy społecznościowe, do których może mieć dostęp Twoja gra. Dzięki temu możesz:
Znajdź ich w grze.
Porównuj wyniki ze znajomymi na tabelach wyników.
Połącz listę znajomych z Gier Play z dotychczasowymi listami znajomych w grze.
Identyfikowanie innego gracza za pomocą wyskakującego okienka dotyczącego profilu w grze. W tym wyskakującym okienku znajdziesz pseudonim, który obecny gracz przekazał znajomemu, aby wiedział, z kim gra.
Podstawowe
Interfejsy API umożliwiają wykonywanie następujących czynności:
- Wczytaj znajomych: możesz sprawdzić, czy gracz zezwolił grze na dostęp do informacji o liście znajomych. Jeśli przyznano dostęp, możesz zobaczyć listę obiektów gracza odpowiadających znajomym zalogowanego gracza.
- Uruchamianie widoku profilu innego gracza w Grach Play: możesz otworzyć ten widok, aby wyświetlić nazwę nadaną przez gracza, który się w niej zalogował. W tym widoku dostępne są też opcje zarządzania znajomymi i nie musisz wychodzić z gry.
- Kontrola użytkowników: użytkownik może zarządzać widocznością swojego profilu w Grach Play oraz listą znajomych. W przypadku dostępu do listy znajomych użytkownik może automatycznie przyznać dostęp do wszystkich gier lub indywidualnie zatwierdzić dostęp dla każdej gry. Dlatego podczas wczytywania listy znajomych wynik może zawierać wywołanie zwrotne z prośbą o dostęp.
Importowanie listy znajomych w Grach Play
Za pomocą interfejsów Friends API możesz pobrać listę znajomych w Grach Play i dodać ich do swojej listy znajomych w grze.
Nowi użytkownicy będą mieli do dyspozycji początkową listę znajomych, a dotychczasowi użytkownicy będą mogli importować znajomych z Gier Play na dowolne listy znajomych w grze. W rezultacie użytkownicy będą mieli największą możliwą liczbę graczy, z którymi będą mogli grać.
Dodaj do gry znajomych z Gier Play
Dodaj znajomych w Grach Play do dowolnej listy znajomych w grze, wiążąc ich identyfikator z odpowiednimi informacjami o graczach w wewnętrznej bazie danych. Upewnij się, że obok gier znajduje się przycisk z Grami Play, który obok profilu pokazuje profil innego gracza, dzięki czemu użytkownicy wiedzą, kim są.
Jeśli używasz listy znajomych z serwera backendu, załaduj ją bezpiecznie przy użyciu interfejsu API REST, zamiast przekazywać wynik interfejsu API Androida. Pamiętaj, aby w przypadku obecnie zalogowanego gracza używać identyfikatora odtwarzacza zwróconego przez players.get(me)
, ponieważ jest on zgodny z identyfikatorem, który widzą inni gracze.
Jeśli lista dodanych do znajomych nie jest przechowywana (ale została wyświetlona w momencie wyświetlenia), nie musisz nic robić.
Przyznaj dostęp do Gier Play
Jeśli Twoja gra nie ma jeszcze dostępu do Gier Play, dobrym pomysłem jest poproszenie użytkowników o zgodę na to, gdy będą przeglądać listę znajomych w grze. Możesz na przykład dodać przycisk o nazwie Importuj znajomych z Gier Play, który prosi użytkownika o zgodę na kliknięcie. Pamiętaj, aby użyć przycisku Gry Play na każdym przycisku, który wspomina o usłudze.
Wyświetlanie profilu innego gracza
Możesz zezwolić zalogowanym graczom na wyświetlanie profilu innych graczy w Grach Play. Dzięki temu zalogowany użytkownik widzi swoje imię i nazwisko, a także informację o tym, czy jest już znajomym, czy lepiej pamięta o relacji. Jeśli gracze nie są jeszcze znajomymi, po zalogowaniu się w profilu będą widzieli opcje zarządzania przyjaźniami. W przypadku nawiązania znajomości w grze domyślnie używane są nazwy 2 graczy (jeśli podasz nazwę). Wyświetla się też nazwa gry, w której rozpoczęto przyjaźń.
Tabele wyników społecznościowych
Interfejsów API aplikacji Friends możesz też używać do tabel wyników. Dzięki tej funkcji możesz zobaczyć pozycję bieżącego gracza w gronie znajomych w Grach Play. Pamiętaj, że dotyczy to tylko użytkowników, którzy zdecydowali się udostępnić te informacje aplikacji, oraz tych, którzy są znajomymi w Grach Play. Aby obsługiwać tę funkcję, gra daje użytkownikowi kontrolę. Ten element sterujący używa argumentu collection
, aby wybrać społecznościowy ranking. Więcej informacji znajdziesz w sekcji o publicznych i społecznościowych tabelach wyników.
Jeśli wdrożysz funkcję tabel wyników w mediach społecznościowych, wywołanie ładowania wyników może zwrócić wyjątek wymagający zgody użytkownika podobny do tego z loadFriends()
.
Jeśli wdrożysz domyślny interfejs udostępniany przez Gry Play (na przykład getLeaderboardIntent()
), zostanie on skonfigurowany automatycznie.
Dalsze kroki
Zanim zaczniesz korzystać z interfejsów Friends API, wykonaj te czynności:
- Pobierz i przejrzyj przykładowy kod:
- Java
- Przykładowa aplikacja Unity przy użyciu wtyczki Unity
- Zapoznaj się z rekomendacjami opisanymi na liście kontrolnej jakości.
- Zaimplementuj interfejsy Friends API w kliencie Java.