Grupa znajomych

Używaj interfejsów API znajomych, aby uzupełniać i ulepszać istniejący w grze system znajomych oraz inne systemy społecznościowe, do których Twoja gra może mieć dostęp. Dzięki temu gracze mogą:

  • znajdować znajomych w Twojej grze;

  • porównywać wyniki ze znajomymi w tabelach wyników;

  • połączyć listę znajomych z Gier Play z dotychczasowymi listami znajomych w grze;

  • Identyfikuj innych graczy za pomocą wyskakującego okienka z profilem w grze. Wyskakujące okienko zawiera pseudonim, który bieżący gracz nadał znajomemu, aby wiedzieć, z kim gra.

Importowanie znajomych

Podstawy

Te interfejsy API umożliwiają wykonywanie tych działań:

  • Wczytaj znajomych: możesz sprawdzić, czy gracz zezwolił grze na dostęp do informacji z listy znajomych. Jeśli dostęp zostanie przyznany, możesz uzyskać listę obiektów Player odpowiadających znajomym uwierzytelnionego gracza.
  • Uruchamianie widoku profilu innego gracza w Grach Play: możesz otworzyć ten widok, aby wyświetlić nazwę nadaną innemu graczowi przez uwierzytelnionego gracza. Ten widok zawiera też elementy sterujące zarządzaniem znajomymi i nie powoduje wyjścia gracza z gry.
  • Zapewnij użytkownikom kontrolę: użytkownik ma możliwość zarządzania widocznością swojego profilu w Grach Play dla znajomych oraz widocznością listy znajomych dla gier. W przypadku dostępu do listy znajomych użytkownik może wybrać, czy chce automatycznie przyznawać dostęp do wszystkich gier, czy też zatwierdzać dostęp do każdej gry z osobna. W związku z tym podczas wczytywania listy znajomych może zostać wywołane wywołanie zwrotne, aby wyświetlić prośbę o dostęp.

Importowanie listy znajomych z Gier Play

Za pomocą interfejsów Friends API możesz uzyskać listę znajomych graczy w Gry Play i dodać ich do listy znajomych w grze.

Nowi użytkownicy będą mieli początkową listę znajomych, z którymi mogą grać, a obecni użytkownicy mogą importować znajomych z Gier Play na dowolne listy znajomych w grze. Dzięki temu Twoi użytkownicy będą mieli największy możliwy zbiór graczy, z którymi mogą grać lub rywalizować.

Dodawanie znajomych z Gier Play do gry

Dodaj znajomych z Gier Play do dowolnej listy znajomych w grze, łącząc ich identyfikatory w Grach Play z odpowiednimi informacjami o graczach w wewnętrznej bazie danych. Upewnij się, że obok tych znajomych znajduje się przycisk z ikoną Gier Play, który po naciśnięciu wyświetla profil innego gracza, aby użytkownicy wiedzieli, kim są znajomi.

Jeśli korzystasz z listy znajomych z serwera backendu, wczytuj ją bezpiecznie za pomocą interfejsu REST API, a nie przekazuj wyniku interfejsu Android API. Używaj identyfikatora gracza zwróconego przez players.get(me) w interfejsie REST API dla aktualnie uwierzytelnionego gracza, ponieważ będzie on zgodny z identyfikatorem widocznym dla innych graczy.

Jeśli rozszerzona lista znajomych nie jest przechowywana (a jedynie używana w momencie wyświetlania), nie musisz podejmować żadnych dodatkowych działań.

Przyznawanie dostępu do Gier Play

Jeśli Twoja gra nie ma jeszcze dostępu do Gier Play, dobrym momentem na poproszenie użytkowników o zgodę jest wyświetlenie listy znajomych w grze. Możesz na przykład dodać przycisk Importuj znajomych z Gier Play, który po kliknięciu wyświetli prośbę o zgodę użytkownika. (Pamiętaj, aby na każdym przycisku, który odnosi się do usługi, używać logo Gier Play).

Wyświetlanie profilu innego gracza

Możesz zezwolić uwierzytelnionemu graczowi na wyświetlanie profilu w Grach Play innego gracza. Umożliwia to uwierzytelnionemu graczowi zobaczenie nazwy, jaką nadał drugiemu graczowi, oraz sprawdzenie, czy są już znajomymi, co daje mu dodatkowy kontekst dotyczący relacji. Jeśli gracze nie są jeszcze znajomymi, uwierzytelniony gracz zobaczy w widoku profilu elementy sterujące zarządzaniem znajomymi. Gdy przyjaźnie są tworzone w grze, domyślne nazwy 2 graczy to ich nazwy w grze (jeśli zostały podane). Wyświetlana jest też nazwa gry, w której nawiązano znajomość.

Wyświetlanie profilu innego gracza

Tablice wyników graczy

Interfejsy Friends API mogą być też używane w przypadku tablic wyników. Użyj tej funkcji, aby wyświetlić ranking bieżącego gracza wśród jego znajomych z Gier Play. Pamiętaj, że dotyczy to tylko użytkowników, którzy zdecydowali się udostępnić te informacje Twojej aplikacji i są znajomymi w Grach Play. Aby obsługiwać tę funkcję, gra udostępnia użytkownikowi element sterujący. Ten element sterujący używa argumentu collection do wybrania widoku społecznościowego tablicy wyników. Więcej informacji znajdziesz w sekcji publiczne i społecznościowe tablice wyników.

Jeśli zaimplementujesz zbieranie danych na potrzeby społecznościowych tablic wyników, wywołanie wczytujące wyniki tablicy może zwrócić wyjątek dotyczący konieczności uzyskania zgody użytkownika, podobny do tego z loadFriends(). Jeśli zaimplementujesz domyślny interfejs udostępniany przez Gry Play (np. getLeaderboardIntent()), zostanie to obsłużone automatycznie.

Dalsze kroki

Zanim zaczniesz korzystać z interfejsów Friends API: