feat(google-play-games-services): add getPlayerScore function (#2949)

src/@ionic-native/plugins/google-play-games-services/index.ts

@@ -15,6 +15,13 @@ export interface ScoreData {
 
 }
 
+export interface PlayerScoreData {
+ /**
+ * The player score.
+ */
+ playerScore: number;
+}
+
 export interface LeaderboardData {
 
  /**
@@ -126,6 +133,13 @@ export interface Player {
  * leaderboardId: 'SomeLeaderboardId'
  * });
  *
+ * // Get the player score on a leaderboard.
+ * this.googlePlayGamesServices.getPlayerScore({
+ * leaderboardId: 'SomeLeaderBoardId'
+ * }).then((data: PlayerScoreData) => {
+ * console.log('Player score', data);
+ * });
+ *
  * // Show the native leaderboards window.
  * this.googlePlayGamesServices.showAllLeaderboards()
  * .then(() => console.log('The leaderboard window is visible.'));
@@ -220,6 +234,19 @@ export class GooglePlayGamesServices extends IonicNativePlugin {
  return;
  }
 
+ /**
+ * Get the player score on a leaderboard. You should ensure that you have a
+ * successful return from auth() before requesting a score.
+ *
+ * @param data {LeaderboardData} The leaderboard score you want to request.
+ * @return {Promise<PlayerScoreData>} Returns a promise that resolves when Play
+ * Games Services returns the player score.
+ */
+ @Cordova()
+ getPlayerScore(data: LeaderboardData): Promise<PlayerScoreData> {
+ return;
+ }
+
  /**
  * Launches the native Play Games leaderboard view controller to show all the
  * leaderboards.