Google Play Games Services

Improve this doc

A Cordova plugin that let's you interact with Google Play Games Services.

Repo: https://github.com/artberri/cordova-plugin-play-games-services

Installation

1. Install the Cordova and Ionic Native plugins:
   

   $ ionic cordova plugin add cordova-plugin-play-games-services --variable APP_ID="YOUR_APP_ID
   $ npm install --save @ionic-native/google-play-games-services@4
   

2. Add this plugin to your app's module

Supported platforms

• Android

Usage

import { GooglePlayGamesServices } from '@ionic-native/google-play-games-services';


constructor(private googlePlayGamesServices: GooglePlayGamesServices) { }

...

// Authenticate with Play Games Services
this.googlePlayGamesServices.auth()
    .then(() => console.log('Logged in to Play Games Services'))
    .catch(e) => console.log('Error logging in Play Games Services', e);

// Sign out of Play Games Services.
this.googlePlayGamesServices.signOut()
    .then(() => console.log('Logged out of Play Games Services'))
    .catch(e => console.log('Error logging out of Play Games Services', e);

// Check auth status.
this.googlePlayGamesServices.isSignedIn()
    .then((signedIn: SignedInResponse) => {
        if (signedIn.isSignedIn) {
            hideLoginButton();
        }
    });

// Fetch currently authenticated user's data.
this.googlePlayGamesServices.showPlayer().then((data: Player) => {
   console.log('Player data', data);
});

// Submit a score.
this.googlePlayGamesServices.submitScore({
    score: 100,
    leaderboardId: 'SomeLeaderboardId'
});

// Show the native leaderboards window.
this.googlePlayGamesServices.showAllLeaderboards()
    .then(() => console.log('The leaderboard window is visible.'));

// Show a signle native leaderboard window.
this.googlePlayGamesServices.showLeaderboard({
    leaderboardId: 'SomeLeaderBoardId'
}).then(() => console.log('The leaderboard window is visible.'));

// Unlock an achievement.
this.googlePlayGamesServices.unlockAchievement({
    achievementId: 'SomeAchievementId'
}).then(() => console.log('Achievement unlocked'));

// Incremement an achievement.
this.googlePlayGamesServices.incrementAchievement({
    step: 1,
    achievementId: 'SomeAchievementId'
}).then(() => console.log('Achievement incremented'));

// Show the native achievements window.
this.googlePlayGamesServices.showAchivements()
   .then(() => console.log('The achievements window is visible.'));

Instance Members

auth()

Initialise native Play Games Service login procedure.

signOut()

Sign out of Google Play Games Services.

isSignedIn()

Check if the user is signed in.

showPlayer()

Show the currently authenticated player.

submitScore(data)

Submit a score to a leaderboard. You should ensure that you have a successful return from auth() before submitting a score.

showAllLeaderboards()

Launches the native Play Games leaderboard view controller to show all the leaderboards.

showLeaderboard(data)

Launches the native Play Games leaderboard view controll to show the specified leaderboard.

unlockAchievement(data)

Unlock an achievement.

incrementAchievement(data)

Increment an achievement.

showAchievements()

Lauches the native Play Games achievements view controller to show achievements.