Wykorzystaj interfejsy Friends API, by uzupełnić i ulepszyć dotychczasowy system znajomych w grze oraz inne systemy społecznościowe, do których ma dostęp Twoja gra. W ten sposób możesz umożliwić graczom:
Znajdź ich znajomych w grze.
Porównuj wyniki ze znajomymi w tabelach wyników.
Połącz listę znajomych z Gier Play z listą znajomych w grze.
Aby zidentyfikować innego gracza, użyj wyskakującego okienka z profilem w grze. Pokazuje ono pseudonim, który obecny gracz podał znajomemu, żeby wiedział, z kim gra.
Podstawy
Te interfejsy API pozwalają wykonywać następujące czynności:
- Wczytywanie znajomych: możesz sprawdzić, czy gracz zezwolił grze na dostęp do informacji z listy znajomych. Po przyznaniu dostępu możesz zobaczyć listę obiektów odtwarzacza przypisanych znajomym zalogowanego gracza.
- Wyświetlanie profilu innego gracza w Grach Play: możesz go otworzyć, aby zobaczyć nazwę nadaną innemu graczowi przez zalogowanego gracza. Ten widok pozwala też zarządzać znajomością i nie zabiera gracza z poziomu gry.
- Zapewnianie użytkownikom kontroli: użytkownik może kontrolować widoczność jego profilu w Grach Play dla znajomych i widoczność listy znajomych w grach. W przypadku dostępu do listy znajomych użytkownik może określić, czy chce automatycznie przyznawać dostęp do wszystkich gier czy osobno w przypadku każdej gry. Dlatego podczas wczytywania listy znajomych wynikiem może być wywołanie zwrotne w celu wyświetlenia prośby o dostęp.
Importuj listę znajomych z Gier Play
Za pomocą interfejsów Friends API możesz wyświetlić listę znajomych graczy w Grach Play i dodać ich do listy znajomych w grze.
Nowi użytkownicy będą mieć początkową listę znajomych, z którymi mogą grać, a dotychczasowi użytkownicy mogą zaimportować swoich znajomych z Gier Play do dowolnej listy znajomych w grze. Dzięki temu Twoi użytkownicy będą mieli największą możliwą grupę graczy, z którymi mogą grać lub z nimi rywalizować.
Dodaj do gry znajomych z Gier Play
Aby dodać znajomych z Gier Play do istniejącej listy znajomych w grze, powiąż ich identyfikatory 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 powoduje wyświetlenie profilu drugiego gracza. Dzięki temu użytkownicy będą wiedzieć, kim są.
Jeśli korzystasz z listy znajomych z serwera backendu, załaduj ją bezpiecznie za pomocą interfejsu API REST, zamiast przekazywać wynik interfejsu Android API. Pamiętaj, aby w przypadku zalogowanego obecnie odtwarzacza używać identyfikatora odtwarzacza zwróconego przez players.get(me) w interfejsie API REST – będzie on taki sam jak identyfikator widoczny dla innych graczy.
Jeśli rozszerzona lista znajomych nie jest przechowywana (ale używana tylko podczas oglądania), nie musisz nic robić.
Przyznaj dostęp do Gier Play
Jeśli Twoja gra nie ma jeszcze dostępu do Gier Play, warto poprosić użytkowników o zgodę podczas przeglądania Twojej listy znajomych w grze. Możesz na przykład dodać przycisk Importuj znajomych z Gier Play, który po kliknięciu wyświetla prośbę o zgodę na wykorzystanie danych. Pamiętaj, aby na każdym przycisku z informacją o usłudze umieścić logo Gier Play.
Wyświetl profil innego gracza
Możesz zezwolić zalogowanemu graczowi na wyświetlanie profilu innego gracza w Grach Play. Dzięki temu zalogowany gracz może zobaczyć nazwę, którą nadał innemu graczowi, i sprawdzić, czy jest już znajomym. Dzięki temu uzyska dodatkowy kontekst dotyczący relacji. Jeśli gracze nie są jeszcze znajomymi, w widoku profilu będą widoczne opcje zarządzania znajomymi. Gdy powstaje przyjaźń z poziomu gry, domyślnymi nazwami obu graczy są nazwy w grze (jeśli je podasz). Widoczna jest też nazwa gry, w której zainicjowano przyjaźń.
Tablice wyników w mediach społecznościowych
Interfejsów API znajomych można też używać w tabelach wyników. Użyj tej funkcji, by wyświetlić ranking bieżącego gracza
wśród jego znajomych w Grach Play. Pamiętaj, że dotyczy to tylko użytkowników, którzy zdecydowali się udostępniać te informacje Twojej aplikacji, i użytkowników, którzy są znajomymi w Grach Play. Aby umożliwić obsługę tej funkcji, gra udostępnia użytkownikowi element sterujący. Ten element sterujący używa argumentu collection do wyboru społecznościowego widoku tabeli wyników. Więcej informacji znajdziesz w sekcji o publicznych i społecznościowych tablicach wyników.
Jeśli zaimplementujesz kolekcję tabel wyników społecznościowych, wywołanie wczytania wyników tabeli wyników może zwracać wyjątek związany z wymaganiem zgody, podobny do tego z metody loadFriends().
Jeśli wdrożysz domyślny interfejs użytkownika Gier Play (np. getLeaderboardIntent()), będzie on obsługiwany automatycznie.
Dalsze kroki
Zanim zaczniesz korzystać z interfejsów Friends API, wykonaj te czynności:
- Pobierz i sprawdź przykładowy kod:
- Zapoznaj się z rekomendacjami opisanymi na liście kontrolnej jakości.
- Zaimplementuj interfejsy Friends API w kliencie w języku Java.