Google Play 游戏服务

类型 库
修订版 发行版 2024.3703
关键词 google，google play 游戏服务，成就，排行榜，多人游戏
平台 安卓
示例 https://github.com/coronalabs/com.coronalabs-plugin.gpgs.v2

概述

Google Play 游戏服务插件允许访问Google Play 游戏服务用于游戏网络，包括成就，排行榜，任务，视频等。

重要事项

  • GPGSv2 不再支持多人游戏，自 2020 年 3 月 31 日起，Google 已停止支持多人游戏。请参阅旧版插件以访问多人游戏 API。

  • 以前，此插件还兼容 iOS，但 Google 不再支持与 iOS 的集成。如果你之前在 iOS 上实施了此服务，则应将该实施迁移到另一项服务。

如果你遇到Google Play 游戏服务实施此插件后出现登录问题/错误，确保已启用云端硬盘 API和Google Play 开发者 API位于Google Play 开发者控制台中。

语法

local gpgs = require( "plugin.gpgs.v2" )

项目设置

要使用此插件，请在build.settings的plugins表中添加条目。添加后，构建服务器将在构建阶段集成该插件。

settings = {
    plugins = {
        ["plugin.gpgs.v2"] = {
            publisherId = "com.coronalabs",
        }
    }
}

此外，你还必须指定Google Play 游戏应用程序 ID在build.settings的android表中，作为googlePlayGamesAppId键

settings = {

    android =
    {
        googlePlayGamesAppId = "YOUR_APPLICATION_ID",
    },
}

节点

插件分为 API 节点，以便更好地组织。

gpgs2.achievements

gpgs2.leaderboards

gpgs2.players

gpgs2.events

gpgs2.snapshots

gpgs2.videos

gpgs.*

概述

这是插件的基本 API 节点。它管理与 Google 服务器的连接、身份验证和常规 SDK 任务。

函数

gpgs2.enableDebug()

gpgs2.isConnected()

gpgs2.isAuthenticated()

gpgs2.login(params)

gpgs2.logout()

gpgs2.getAccountName(listener)

gpgs2.getServerAuthCode(params)

gpgs2.setPopupPosition(position)

gpgs2.loadGame(listener)

gpgs2.loadImage(params)

gpgs2.showSettings(listener)

事件

login

getAccountName

getServerAuthCode

loadGame

loadImage

类型

游戏