Grupa znajomych

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.

Importuj znajomych

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źń.

Wyświetlanie profilu innego gracza

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.

Znajomi w tabeli 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: