You can integrate Google Play Games account sign-in into your app so that your users can be identified by AppGallery Connect using their Google Play Games accounts.

NOTE

Google Play Games sign-in is supported only when your data processing location is Germany, Singapore, or Russia.
If your app allows users to sign in using Google Play Games accounts, GMS must be available on user devices.

Before You Start

Enable Auth Service in AppGallery Connect.
Integrate the Auth Service SDK into your app.

Development Process

Auth Service allows you to integrate Google Play Games account sign-in in either of the following methods:

Unified sign-in (recommended), which implements unified sign-in
Traditional sign-in, which is the original integration method retained for compatibility

Unified Sign-in

Click to enlarge

Add the SDK dependency.
- Android Studio
  Open the app-level build.gradle file (usually in the app directory) and add dependencies on Huawei's Auth Service SDK and Google Play Games' SDK to the dependencies block.
```
Copied
dependencies {
    implementation "com.huawei.agconnect:agconnect-auth-googlegame:1.9.0.300"     
    implementation "com.google.android.gms:play-services-auth:{version}"
}
```
- Eclipse
  Open the build.gradle file in the aar2eclipse/aar directory and add dependencies on Huawei's Auth Service SDK and Google Play Games' SDK to the dependencies block. The procedure is similar to that for integrating the AppGallery Connect SDK in Eclipse.
```
Copied
dependencies {
    embed "com.huawei.agconnect:agconnect-auth-googlegame:1.9.0.300"
    embed "com.google.android.gms:play-services-auth:{version}"
}
```
NOTE
Replace {version} in the sample code with the latest version number of Google Play Games's SDK. Huawei is not responsible for the update.
To add Google Play Games's SDK dependency to your project, download the latest SDK dependency from the Google Play Games Open Platform and integrate it into your project.

Set parameters required for users to sign in with a Google Play Games account.

Set google_app_id and google_client_id in the /app/res/values/string.xml file.

NOTE

Set google_client_id to the client ID that you have configured when enabling the Google authentication mode. The number (typically 12 or more digits) at the beginning of the client ID is the value of google_app_id.
```
Copied
<string name="google_app_id">5758********</string>
<string name="google_client_id">5758********-lp1cdv4uu2k1jjm1ksi5n59tta0mdkg9.apps.googleusercontent.com</string>
```

Configure the metadata information in the application element in the AndroidManifest.xml file.


Copied
        <meta-data
            android:name="com.google.android.gms.games.APP_ID"
            android:value="@string/google_app_id" />
        <meta-data
            android:name="com.google.android.gms.version"
            android:value="@integer/google_play_services_version" />

Add the lifecycle callback.

Call AGConnectAuth.signIn for a user to sign in with a Google Play Games account.

Java

Kotlin


Copied
AGConnectAuth.getInstance().signIn(this,AGConnectAuthCredential.GoogleGame_Provider).addOnSuccessListener(new OnSuccessListener<SignInResult>() {
        @Override
        public void onSuccess(SignInResult signInResult) {
                // onSuccess
                AGConnectUser user =  signInResult.getUser();
        }
})
.addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
                // onFail
        }
});


Copied
AGConnectAuth.getInstance().signIn(this, AGConnectAuthCredential.GoogleGame_Provider).addOnSuccessListener {
    // updateUI
}.addOnFailureListener {
    // onFailure
}

Traditional Sign-in

Click to enlarge

Initialize the AGConnectAuth instance on the app sign-in page, obtain user information from AppGallery Connect, and check whether a user is currently signed in. If so, display the user's home page. If not, display the sign-in page.
Java
Kotlin
Copied
AGConnectUser user = AGConnectAuth.getInstance().getCurrentUser();
Copied
val user = AGConnectAuth.getInstance().currentUser

After a user requests to sign in using a Google Play Games account, obtain the user's authorization.

NOTE

This step is for reference only. For details, please refer to Google Play Games documentation.

Obtain the Google Play Games sign-in authorization.

Java


Copied
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
         .requestServerAuthCode(CLIENT_ID)
         .build();
client = GoogleSignIn.getClient(this, gso);

Intent signInIntent = client.getSignInIntent();
startActivityForResult(signInIntent, RC_SIGN_IN);

Add a callback to obtain the server authentication code upon successful authorization.

Java


Copied
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (requestCode == RC_SIGN_IN) {
        Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
        task.addOnSuccessListener(new OnSuccessListener<GoogleSignInAccount>(){
            @Override
            public void onSuccess(GoogleSignInAccount googleSignInAccount) {
                String serverAuthCode = googleSignInAccount.getServerAuthCode();
            }
        }).addOnFailureListener(new OnFailureListener(){
            @Override
            public void onFailure(@NonNull Exception e) {
            }
        });
    }
}

Call GoogleGameAuthProvider.credentialWithToken to generate a credential using the obtained server authentication code, and then call AGConnectAuth.signIn to implement sign-in.

Java

Kotlin


Copied
AGConnectAuthCredential credential = GoogleGameAuthProvider.credentialWithToken(serverAuthCode);
AGConnectAuth.getInstance().signIn(credential)
.addOnSuccessListener(new OnSuccessListener<SignInResult>() {
    @Override
    public void onSuccess(SignInResult signInResult) {
        // onSuccess
        AGConnectUser user = signInResult.getUser();
    }
})
.addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        // onFail
    }
});


Copied
val credential = GoogleGameAuthProvider.credentialWithToken(serverAuthCode)
AGConnectAuth.getInstance().signIn(credential).addOnSuccessListener {
    // onSuccess
    val user = it.user
}.addOnFailureListener {
    // onFail
}

More You May Need to Know

If you want to allow a user to use multiple accounts to sign in to your app, you can link these accounts.
If a user wants to exit the current account or switch to another account, you need to sign this user out.
You can deregister an account as required.
Users can perform sensitive operations, such as deregistration, password change, account linking, and mobile number and email address resetting, only within 5 minutes after sign-in. If a user signed in 5 minutes before and tries to perform such operations, you need to reauthenticate the account first.
You can implement your own exception handling logic to provide a better experience for users.
You can use Cloud Functions triggers to receive key events, such as user registration, sign-in, and deregistration, to extend the capabilities of Auth Service.

Google Account

VK Account

Was this page helpful?

Unusable
Poor
OK
Good
Excellent

Send feedback

You can go to the community forum for more help. If you need other help, use Intelligent Assistant.

More You May Need to Know