Google Play Game Services (Android) for Godot Game Engine
This is a Google Play Game Services module for the Godot Game Engine. This module is meant to be used for games deployed to an Android device. This module allows you to use nearly all the features provided by the Google Play Games Service API for Android including:
Log-in with Google
Information about the signed in player (including their profile pictures)
Achievements
Leaderboards
Saved Games (Snapshots)
Real Time Multiplayer
Device network status
This module uses Google Play Services' powerful Tasks API to execute various operations asynchronously. To handle the results from these asynchronous operations, a lot of relevant callback functions are also provided and can be used in GDScript.
NOTE: This module is compatible with Godot 3.0 but has not been tested with the Mono version. So, using this module for developing Godot games using C# could lead to unforeseen errors.
Setup
Make sure that you have the Android SDK and NDK setup and are familiar with compiling Godot for Android (See Godot's documentation for more information about this)
Create a "Game Services" game in the Google Play Console and take a note of the App ID
Clone or download the repository onto your computer
Copy the "gpgs" folder into the "modules" directory of Godot's source code
Inside "../android/AndroidManifestChunk.xml", replace the {Your APP_ID here} so that it looks more like this (note: the APP_ID shown here is just a dummy value)
If any of your other modules also use the second line of the AndroidManifestChunk.xml shown above, then delete one of them because it could cause errors down the line.
Recompile the Godot source for android
Compile the resultant Android project using gradlew build.
Open the godot engine and link the created .apk files as Custom Packages in the Export menu
Enable the following permissions in the Export menu
Access Network State
Internet
Using the module in your game
Add the following code in your project's engine.cfg file (for Godot versions lower than 3.0) or in the project.godot file (for Godot 3.0 and above)
If you already have such an entry then add a , after the existing module path, followed org/godotengine/godot/GodotPlayGameServices in the string. It would look something like this:
Now, you should be able to call the functions in the gpgs object (singleton) in order to use the Google Play Game Services.
Functions and Callbacks
See the Wiki for a description of the various functions that you can call on the gpgs object and the various callbacks that you can listen for in your GDScript file
请发表评论