GDevelop中文网站

Appearance

GamePix SDK ​

GamePix游戏SDK提供了一系列在GamePix生态系统中运行游戏所需的实用方法。它们可以增强游戏的用户体验，并完成与我们的广告网络和收入系统的集成。

作者和贡献者：caiiiycuk。

警告

这是一个由社区成员创建的扩展，但未经GDevelop扩展团队审核。因此，我们无法保证它符合官方扩展的所有质量标准。如果有疑问，请在使用之前与作者联系以了解扩展的功能或检查其内容。

GamePix游戏SDK提供了一系列在GamePix生态系统中运行游戏所需的实用方法。它们可以增强游戏的用户体验，并完成与我们的广告网络和收入系统的集成。

这个SDK提供了一组在GamePix发布平台上显示广告的动作和条件。您可以在没有初始化的情况下使用它们（初始化由扩展本身处理）。如果在本地运行构建，您将收到一个警告，说明未找到GamePix播放器，请不要担心，这是正常现象，说明您正在使用测试SDK，非常适用于调试。

插屏广告的事件表单：

  • 当您要显示此广告时，请添加“显示插屏广告”动作。
  • 添加一个条件“检查插屏广告是否已结束”，当玩家关闭插屏广告时，它将被设置为true。在读取此条件时，状态将立即重置为false。

激励广告的事件表单：

  • 当您要显示此广告时，请添加“显示激励广告”动作。
  • 添加一个条件“检查激励广告是否已结束”，当玩家关闭激励广告时，它将被设置为true。在读取此条件时，状态将立即重置为false。
  • 添加一个条件“检查是否应对玩家进行奖励”，作为“检查激励广告是否已结束”的子事件。如果应对玩家进行奖励，则将其设置为true，否则将其设置为false。(这个条件始终追踪激励广告的最后结果，永不重置。)

可以使用**“语言”**表达式来获取GamePix平台上的首选语言。在SDK初始化后才可用。

可以使用**“GamePix SDK正在初始化”**条件来检查SDK初始化的状态。在成功初始化后立即设置为true。

GamePix SDK整合的事件表单示例：

事件表单

高级用法

GamePix SDK提供以下JavaScript API：

  • gdjs._gamePixSdkExtension.lang() - 获取玩家的当前首选语言
  • gdjs._gamePixSdkExtension().langSync() - 与lang()相同，但如果SDK尚未初始化，将返回null
  • gdjs._gamePixSdkExtension.updateScore(score) - 每次更新当前分数时立即调用该函数
  • gdjs._gamePixSdkExtension.updateLevel(level) - 当玩家通过关卡时，应调用此函数发送分数
  • gdjs._gamePixSdkExtension.happyMoment() - 当快乐时刻发生时应调用此函数
  • gdjs._gamePixSdkExtension.setItem(key, value) - 持久性地存储值。值必须是字符串
  • gdjs._gamePixSdkExtension.getItem(key) - 从存储中读取值
  • gdjs._gamePixSdkExtension.getItemSync(key) - 与getItem()相同，但如果SDK尚未初始化，将返回nullTip

了解如何按照逐步指南安装新扩展。

行为 ​

显示插述广告 显示插式广告（全屏）

显示奖励广告 显示奖励广告（全屏）

条件 ​

GamePix SDK已初始化 检查GamePix SDK是否准备好使用。

检查插介结束 检查插介是否已结束。

检查奖励广告是否已结束 检查奖励广告是否已结束。

检查是否应该奖励玩家 检查是否应该奖励玩家。

Expression

Description

GamePixSDK::Language()

玩家的首选语言。

_此页面是一个由_Gam-ePix SDK_扩展生成的参考页面，由GDevelop社区制作的面向所有人的开源跨平台游戏引擎。