B4A Library Google Play Game Services

This is a wrapper for the Google Play Services related to games. This library was tested successfully with the API 37 of Google Play Services.

List of features:
  • Sign-in: supported;
  • Achievements: supported;
  • Leaderboards: supported;
  • Real-time multiplayer: supported (NEW!);
  • Turn-based multiplayer: supported;
  • Level and XP: supported;
  • Gifts and requests: supported;
  • Events and quests: not supported;
  • Saved games: supported;
  • Notifications: supported;
  • Player stats: supported;
  • Nearby connections: supported.
To compile, you need B4A v6+, JDK v7+ and android.jar v21+ (cf. Tools/Configure paths).

The library is provided with its Java source code and a few B4A modules:
  • ClsConnection: manages the sign-in, sign-out and connection events;
  • CodConverter: converts your data map to and from the byte array needed for the Saved Games service (this module requires three extra libraries: JSON, ByteConverter and RandomAccessFile) in case you don't own the DataCollection library;
  • CodTurnBasedMatch: helper module for turn-based matches.
Before using this library, you need to:
  • download the Google Play services SDK and Android Support Repository with the Android SDK manager;
  • copy the GooglePlayGameServices library (Jar+Xml) to your additional B4A libraries folder.
When you create a project requiring this library, you need to:
  • add this line in the project attributes of your Main module:
    Code: 
    #AdditionalJar: com.google.android.gms:play-services-games
  • add also this line if you want to access the Nearby Connections API:
    Code: 
    #AdditionalJar: com.google.android.gms:play-services-nearby
  • add these lines to your manifest:
    Code: 
    AddApplicationText(
<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 also these lines to the manifest if you want to access the Nearby Connections API:
    Code: 
    AddApplicationText(
<meta-data android:name="com.google.android.gms.nearby.connection.SERVICE_ID"
    android:value="$PACKAGE$" />)
  • copy the games-ids.xml file generated by your Google Play developer console in the Objects\res\values folder.
To generate the games-ids.xml file, click on the link at the bottom of some screens (e.g. achievements) in your developer console (you need of course a game project properly configured to see it):
ressources.png


This file should look like this:
Code: 
<?xml version="1.0" encoding="utf-8"?>
<!--
Google Play game services IDs.
Save this file as res/values/games-ids.xml in your project.
-->
<resources>
  <string name="app_id">01234567890</string>
  <string name="achievement_win_on_a_very_large_map">CgkIuqeG8-kOEAIQAQ</string>
  <string name="achievement_win_on_a_large_map">CgkIuqeG8-kOEAIQAg</string>
  <string name="achievement_win_on_a_medium_map">CgkIuqeG8-kOEAIQAw</string>
  <string name="achievement_win_on_a_small_map">CgkIuqeG8-kOEAIQBA</string>
  <string name="achievement_win_on_a_very_small_map">CgkIuqeG8-kOEAIQBQ</string>
  <string name="leaderboard_main_score">CgkIuqeG8-kOEAIQBw</string>
</resources>

To set up a game in the Google Play developer console, please read this, then this.

To get details about a returned status code, please read this.
 

Attachments

Last edited:
Click to expand...
MaxApps said:
Hi

I am getting

internal error
Error=0 Code=8

any ideas?
Click to expand...

Are you trying to access saved games?

check in the game information section if the saved games are as "yes".

Best regards!
 
Informatix said:
During the development of the library, I got a few strange errors while testing. Some of them happened after I changed something in my project on the dev console. We obviously have to wait after any change. For example, I had to wait a couple of hours before one of my leaderboards work as expected. The other errors were due to the network. So you should retry later; things might suddenly work.
About leaderboards, I'm still unable to make the social variant work (I can only see the current's player; no one else from the same circles). I probably did not understand something.
Click to expand...


Almost a day later and still the same
 
Informatix said:
During the development of the library, I got a few strange errors while testing. Some of them happened after I changed something in my project on the dev console. We obviously have to wait after any change. For example, I had to wait a couple of hours before one of my leaderboards work as expected. The other errors were due to the network. So you should retry later; things might suddenly work.
About leaderboards, I'm still unable to make the social variant work (I can only see the current's player; no one else from the same circles). I probably did not understand something.
Click to expand...
I see now that may Google Play Services app is version 5.0.89 (ref your previous post about it had to be 6.1....). Could that be the problem? I cannot see how I can update this?
 
Marcela Calixto said:
I see now that may Google Play Services app is version 5.0.89 (ref your previous post about it had to be 6.1....). Could that be the problem? I cannot see how I can update this?
Click to expand...
The version should be 6.1.xxx on all devices, whatever Android version you have. You can update the Google Play Services app with your Play Store app as any other app. On my own devices, it has been updated automatically.
 
first i get this error
Code: 
AndroidManifest.xml:25: error: Error: No resource found that matches the given name (at 'value' with value '@string/app_id').

i try to remove above lines from manifest to run project ,then i get this error
Code: 
Initialize: creating a GoogleAPIClient instance
State change: Unconfigured -> Disconnected
Initialize: ready for connection
** Activity (main) Resume **
Connect: state = Disconnected
Connect: no auto sign-in, FirstAttempt is false
NetworkInfo.onConnectivityChange: Bundle[{networkInfo=NetworkInfo: type: WIFI[], state: CONNECTED/CONNECTED, reason: (unspecified), extra: (none), roaming: false, failover: false, isAvailable: true, inetCondition=0}]
Connect: state = Disconnected
Connect: first attempt
Connect: isGooglePlayServicesAvailable returned 0
State change: Disconnected -> Connecting
java.lang.IllegalStateException: A fatal developer error has occurred. Check the logs for further information.
    at com.google.android.gms.internal.hc$h.b(Unknown Source)
    at com.google.android.gms.internal.hc$h.d(Unknown Source)
    at com.google.android.gms.internal.hc$b.fq(Unknown Source)
    at com.google.android.gms.internal.hc$a.handleMessage(Unknown Source)
    at android.os.Handler.dispatchMessage(Handler.java:99)
    at android.os.Looper.loop(Looper.java:137)
    at android.app.ActivityThread.main(ActivityThread.java:4517)
    at java.lang.reflect.Method.invokeNative(Native Method)
    at java.lang.reflect.Method.invoke(Method.java:511)
    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:993)
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:760)
    at dalvik.system.NativeStart.main(Native Method)
 
hanyelmehy said:
first i get this error
Code: 
AndroidManifest.xml:25: error: Error: No resource found that matches the given name (at 'value' with value '@string/app_id').

i try to remove above lines from manifest to run project ,then i get this error
Code: 
Initialize: creating a GoogleAPIClient instance
State change: Unconfigured -> Disconnected
Initialize: ready for connection
** Activity (main) Resume **
Connect: state = Disconnected
Connect: no auto sign-in, FirstAttempt is false
NetworkInfo.onConnectivityChange: Bundle[{networkInfo=NetworkInfo: type: WIFI[], state: CONNECTED/CONNECTED, reason: (unspecified), extra: (none), roaming: false, failover: false, isAvailable: true, inetCondition=0}]
Connect: state = Disconnected
Connect: first attempt
Connect: isGooglePlayServicesAvailable returned 0
State change: Disconnected -> Connecting
java.lang.IllegalStateException: A fatal developer error has occurred. Check the logs for further information.
    at com.google.android.gms.internal.hc$h.b(Unknown Source)
    at com.google.android.gms.internal.hc$h.d(Unknown Source)
    at com.google.android.gms.internal.hc$b.fq(Unknown Source)
    at com.google.android.gms.internal.hc$a.handleMessage(Unknown Source)
    at android.os.Handler.dispatchMessage(Handler.java:99)
    at android.os.Looper.loop(Looper.java:137)
    at android.app.ActivityThread.main(ActivityThread.java:4517)
    at java.lang.reflect.Method.invokeNative(Native Method)
    at java.lang.reflect.Method.invoke(Method.java:511)
    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:993)
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:760)
    at dalvik.system.NativeStart.main(Native Method)
Click to expand...
You missed a step in my first post (probably the copy of Games-id.xml). Please re-read it carefully.
 
Thanks for the help Informatix

It works and I am a few hours, from releasing an update, to one of my games, with Leader-boards and achievements
 
Informatix said:
Sorry, but I don't understand. Did you copy the xml file in your res/values folder?
Click to expand...
Did you copy the xml file in your res/values folder? yes i copy it and make all instruction as mention in first post
my question about xml file name ,i use (ids.xml) as a file name ,you say (probably the copy of Games-id.xml) ,so what is the correct name (ids.xml or Games-id.xml)
Thank you
 
hanyelmehy said:
Did you copy the xml file in your res/values folder? yes i copy it and make all instruction as mention in first post
my question about xml file name ,i use (ids.xml) as a file name ,you say (probably the copy of Games-id.xml) ,so what is the correct name (ids.xml or Games-id.xml)
Thank you
Click to expand...
I cannot say whether the name is really important, but as you can read in the file itself, Google suggests to name it "games-ids.xml", so there's no good reason to do otherwise.
 
Hi

I have followed your steps , and the APK will casue a error after run with "AchievementsLeaderboards”.

It looks like lost "flm.b4a.googleplay.GooglePlayConnection" , but I can find it in the APK package.

I use API19, and get ID for google console.

Please help me.

** Activity (main) Create, isFirst = true **

clsconnection_class_globals (java line: 87)
java.lang.NoClassDefFoundError: flm.b4a.googleplay.GooglePlayConnection

at com.example.clsconnection._class_globals(clsconnection.java:87)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:507)
at anywheresoftware.b4a.BA.raiseEvent2(BA.java:174)
at com.example.clsconnection.innerInitialize(clsconnection.java:23)
at com.example.clsconnection._initialize(clsconnection.java:264)
at com.example.main._activity_create(main.java:301)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:507)
at anywheresoftware.b4a.BA.raiseEvent2(BA.java:174)
at com.example.main.afterFirstLayout(main.java:98)
at com.example.main.access$100(main.java:16)
at com.example.main$WaitForLayout.run(main.java:76)
at android.os.Handler.handleCallback(Handler.java:587)
at android.os.Handler.dispatchMessage(Handler.java:92)
at android.os.Looper.loop(Looper.java:130)
at android.app.ActivityThread.main(ActivityThread.java:3683)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:507)
at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:880)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:638)
at dalvik.system.NativeStart.main(Native Method)
 
ppgirl said:
Hi

I have followed your steps , and the APK will casue a error after run with "AchievementsLeaderboards”.

It looks like lost "flm.b4a.googleplay.GooglePlayConnection" , but I can find it in the APK package.

I use API19, and get ID for google console.

Please help me.

** Activity (main) Create, isFirst = true **

clsconnection_class_globals (java line: 87)
java.lang.NoClassDefFoundError: flm.b4a.googleplay.GooglePlayConnection

at com.example.clsconnection._class_globals(clsconnection.java:87)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:507)
at anywheresoftware.b4a.BA.raiseEvent2(BA.java:174)
at com.example.clsconnection.innerInitialize(clsconnection.java:23)
at com.example.clsconnection._initialize(clsconnection.java:264)
at com.example.main._activity_create(main.java:301)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:507)
at anywheresoftware.b4a.BA.raiseEvent2(BA.java:174)
at com.example.main.afterFirstLayout(main.java:98)
at com.example.main.access$100(main.java:16)
at com.example.main$WaitForLayout.run(main.java:76)
at android.os.Handler.handleCallback(Handler.java:587)
at android.os.Handler.dispatchMessage(Handler.java:92)
at android.os.Looper.loop(Looper.java:130)
at android.app.ActivityThread.main(ActivityThread.java:3683)
at java.lang.reflect.Method.invokeNative(Native Method)
at java.lang.reflect.Method.invoke(Method.java:507)
at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:880)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:638)
at dalvik.system.NativeStart.main(Native Method)
Click to expand...
I don't know why you get this error, but you probably missed something. That looks like there's a library missing.
 
test login Google Play Services rev. 21 ok!
TurnBasedMatch (activate Multiplayer Turn)
save game test ok (activate game save)
AchievementsLeaderboards(activate game save)
 
Last edited:
You must log in or register to reply here.

Similar Threads

Biswajit
  • Article Article
B4A Library [New] Google Play Games Services
2 3
Replies
53
Views
28K
paris7162
paris7162
Erel
  • Locked
  • Article Article
B4A Library GooglePlayBilling - In App Purchases
2 3
Replies
40
Views
40K
Erel
Erel
Erel
  • Locked
  • Article Article
Android Tutorial Google Play App Signing
Replies
6
Views
23K
yfleury
yfleury
Erel
  • Locked
  • Article Article
B4A Library Barcode reader based on Google Play Services Vision
2 3
Replies
46
Views
49K
Erel
Erel
Erel
  • Locked
  • Article Article
Android Tutorial Integrating Firebase Services
Replies
1
Views
99K
Erel
Erel
Back
Top