Skip to content

A native only capacitor plugin for googles play services library and apples game center library

License

Notifications You must be signed in to change notification settings

DexterHuang/capacitor-game-services

 
 

Repository files navigation

Official Website | Opportunities | Facebook

Leading By Example.

Working with the latest technologies, designing the best products, and sharing our knowledge with the world wide community.

Required

  1. Google Developer Account
  2. Apple Developer Account

Setting up Google Play Services

  1. Go to Google Play Console.
  2. Click New Game button and fill out name and category fields.
  3. Click Linked apps tab in side menu, and click the Android button.
  4. Enter your appId, should be found in your capacitor.config.json file.
  5. Click Save and Continue, then click "authorize your app now" button.
  6. Enter your sha-1 and confirm
  7. In your native android project, add your app id string to your strings xml file.
    • your strings xml file can be found in android/app/src/main/res/values/strings.xml
  8. Go to testing tab and add test account.
  9. Add the plugin to main activity after running npx cap sync

Setting up Apple Game Services

  1. Click on target app in xcode
  2. Add team to signing and capabilities
  3. Add game center capability
  4. Go to your apps in https://appstoreconnect.apple.com/ and add your application
  5. go to features, add leaderboard matching the generated id from google

Adding Leaderboards and Achievements

When adding resouces to Google and Apple services, we would recommend you add resources to Google's Play Services first, and reuse the id values generated for resources in Apple's Game Center service. That way you wont need two sets of resource id's.

Using the plugin

In order to use the plugin, you need to follow this steps:

  • Include this meta data tags in the main manifest
<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" />
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>
  • Add on build gradle (app):
implementation 'com.google.android.gms:play-services-auth:17.0.0'
implementation 'com.google.android.gms:play-services-games:19.0.0'
  • On the Main Activy add:
import io.openforge.gameservices.GameServices;
...
add(GameServices.class);
...

Once all this steps are done, you just need to call the sign method of the plugin.

import { Plugins } from '@capacitor/core';
const { GameServices } = Plugins;
const data = await GameServices.signIn();

About

A native only capacitor plugin for googles play services library and apples game center library

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 52.6%
  • Swift 28.0%
  • TypeScript 12.0%
  • Objective-C 3.4%
  • Ruby 3.2%
  • JavaScript 0.8%