lycwed-cordova-plugin-games-services

Cordova Google Play Games Services + iOS Game Center

This plugin is for Cordova Android apps to enable limitted Google Play Games Services API and iOS Game Center

iOS support

iOS support has been added through a dependency of https://github.com/Wizcorp/phonegap-plugin-gameCenter . We have wrapped the API calls to match below. See the plugin for configuration details.

Usage

Follow the instructions here on setting up your app in Google Play Dashboard. Make sure you have your application ID for installation.

Please see the instructions online for getting the app id.

Short version

Go into the Google Play Developer Console -> Game Services -> Add New Game

Fill out the information and type and hit "Save". On the next page, you will see the title and a number next to it. That number is your App Id

Installing plugin

cordova plugin add lycwed-cordova-plugin-games-services --variable APP_ID=“YOUR_APP_ID”

This will install the plugin, and dependencies in your app. The GPSAPPID is the Application ID you get from Google Play Dashboard when authorizing your application.

API

The JavaScript API is below. Everything is called in window.GamesServices object.

authenticate(success, failure)   Authenticate the user against a google play
                                account.  Will call success or failure functions.
                                If fail, a message will be passed from the google play

                                for your app

showAchievements(success, failure)  Show the achievements for the user.
                                If there is an error (not logged in),
                                the message will be passed in.  This is a
                                new activity that gets launched

addAchievement(achievement_id, success, failure)  unlock the achievement for
                                the user

showLeaderboardScore(leaderboard_id, success, failure)  Show the leaderboard.
                                If there is an error (not logged in),
                                the message will be passed in the error. This is a new activity that gets launched

updateLeaderboardScore(leaderboard_id, score, success, failure) Update the
                                score for the selected
                                leaderboard for the user

NOTES

Achievements and leaderboards are created in the Google Play Dashboard. They will give you a string parameter for you to call the functions with.

Testing

To test your app, you must build your application and submit it as an Alpha APK. Next go to go to Google Play Developer Console -> Game Services and link your application to the game service you created. After they are linked, you can enable testing for both.

https://developers.google.com/games/services/console/testpub#enabling_accounts_for_testing

Make sure in the game service you created, you have also added the user under "Testing"

Adding API's

This is a small subset of the Google Play Games Services API, but can easily be extended. Feel free to fork and contribute extended the API's. Any API's that reuqire a new activity, like logging in, should be implemented in GooglePlayGamesServices.java . All other API's can be added to GooglePlayGamesPlugin.java