Logowanie się w grach na Androida

Aby korzystać z funkcji Usług Gier Google Play, gra musi udostępnić konto zalogowanego gracza. Z tej dokumentacji dowiesz się, jak wdrożyć w swojej grze płynne logowanie.

SDK usług gier Play w wersji 2 zawiera szereg ulepszeń, które zwiększają liczbę użytkowników zalogowanych w grze i ułatwiają tworzenie:

  • Ulepszenia dla użytkowników:
    • Po wybraniu konta domyślnego użytkownicy są logowani bez konieczności interakcji z prośbą.
    • Użytkownicy nie muszą już pobierać aplikacji Google Play Games, aby zalogować się w usługach gier Play lub utworzyć nowe konto.
    • Użytkownicy mogą teraz zarządzać kontami usług gier Play w przypadku wielu gier z jednej strony.
  • Ulepszenia dla deweloperów:
    • Kod klienta nie musi już obsługiwać procesu logowania ani wylogowywania, ponieważ logowanie jest automatycznie uruchamiane po rozpoczęciu gry, a zarządzanie kontem odbywa się w ustawieniach systemu operacyjnego.

Nowa integracja klienta

W tej sekcji opisaliśmy, jak zintegrować nowego klienta z usługą Logowanie w usługach gier Play w wersji 2.

Dodawanie zależności

Dodaj zależność pakietu SDK usług gier Play do pliku build.gradle na poziomie katalogu głównego aplikacji. Jeśli używasz Gradle, możesz dodać lub zaktualizować zależność w ten sposób:

dependencies {
 implementation "com.google.android.gms:play-services-games-v2:+"
}

Zdefiniuj identyfikator projektu

Aby dodać do aplikacji identyfikator projektu pakietu SDK usług gier Play, wykonaj te czynności:

  1. W pliku AndroidManifest.xml aplikacji dodaj element <meta-data> i atrybuty do elementu <application>:

    <manifest>
  <application>
    <meta-data android:name="com.google.android.gms.games.APP_ID"
               android:value="@string/game_services_project_id"/>
  </application>
</manifest>

    Zdefiniuj odwołanie do zasobu ciągu znaków @string/game_services_project_id, używając jako wartości identyfikatora projektu usług gier w Twoich grach. Identyfikator projektu usług gier znajdziesz pod nazwą gry na stronie Konfiguracja w Konsoli Google Play.

  2. W pliku res/values/strings.xml dodaj odwołanie do zasobu ciągu znaków i jako wartość ustaw identyfikator projektu. Identyfikator projektu znajdziesz w Konsoli Google Play pod nazwą gry na stronie Konfiguracja. Na przykład:

    <!-- res/values/strings.xml -->
<resources>
  <!-- Replace 0000000000 with your game’s project id. Example value shown above.  -->
  <string translatable="false"  name="game_services_project_id"> 0000000000 </string>
</resources>

Inicjowanie pakietu SDK

Zainicjuj pakiet SDK Usług Gier w funkcji onCreate(..) w klasie Application.

import com.google.android.gms.games.PlayGamesSdk;

...

@Override
public void onCreate(){
  super.onCreate();
  PlayGamesSdk.initialize(this);
}

Pobieranie wyniku logowania

Gdy gra się uruchamia, zawsze próbuje zalogować użytkownika. Aby uwierzytelnić użytkownika, musisz sprawdzić, czy zalogował się on prawidłowo, a następnie uzyskać jego identyfikator gracza.

Aby zweryfikować próbę zalogowania, wywołaj funkcję GamesSignInClient.isAuthenticated() i użyj parametru addOnCompleteListener, aby pobrać wyniki. Na przykład:

GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(getActivity());

gamesSignInClient.isAuthenticated().addOnCompleteListener(isAuthenticatedTask -> {
  boolean isAuthenticated =
    (isAuthenticatedTask.isSuccessful() &&
     isAuthenticatedTask.getResult().isAuthenticated());

  if (isAuthenticated) {
    // Continue with Play Games Services
  } else {
    // Disable your integration with Play Games Services or show a
    // login button to ask  players to sign-in. Clicking it should
    // call GamesSignInClient.signIn().
  }
});

Jeśli użytkownik zdecyduje się nie logować po uruchomieniu gry, możesz opcjonalnie wyświetlić przycisk z ikoną Gry Play i spróbować ponownie zalogować użytkownika, wywołując funkcję GamesSignInClient.signIn(), jeśli użytkownik naciśnie przycisk.

Po sprawdzeniu, czy użytkownik jest zalogowany, możesz pobrać identyfikator odtwarzacza, aby go zidentyfikować. Na przykład:

PlayGames.getPlayersClient(activity).getCurrentPlayer().addOnCompleteListener(mTask -> {
    // Get PlayerID with mTask.getResult().getPlayerId()
  }
);