cordova-plugin-playgames-moongar

Google Play Games Services V2 for Apache Cordova.

This plugin enables Android integration with Google Play Games Services V2, providing automatic/silent sign-in, login callbacks, and score submission to leaderboards.

Installation

cordova plugin add cordova-plugin-playgames-moongar --variable APP_ID="YOUR_PLAY_GAMES_APP_ID"

Setup

Make sure your Google Play Console configuration is correct, and that you pass the proper Google Play Games App ID during plugin installation.

API Usage

Once the plugin is installed, it is available globally under PlayGames.

1. Initialize & Silent Sign-In

Call initialize at startup. This will automatically attempt to sign in the user silently.

PlayGames.initialize(
    function(response) {
        console.log("Play Games initialized successfully:", response);
        // response.status could be "SIGNED_IN", "SIGN_IN_REQUIRED", etc.
    },
    function(error) {
        console.error("Play Games initialization failed:", error);
    }
);

2. Submit Score

Submit high scores to a leaderboard by specifying the leaderboard ID.

var leaderboardId = "CgkIu7234...your_leaderboard_id";
var score = 1250;

PlayGames.submitScore(
    leaderboardId,
    score,
    function(success) {
        console.log("Score submitted successfully:", success);
    },
    function(error) {
        console.error("Failed to submit score:", error);
    }
);

3. Show Leaderboard

Open the native Play Games leaderboard overlay screen.

PlayGames.showLeaderboard(
    leaderboardId,
    function() {
        console.log("Leaderboard screen opened");
    },
    function(error) {
        console.error("Failed to open leaderboard:", error);
    }
);

License

MIT