README

Gameball PHP SDK 提供了从 PHP 编写的应用程序方便地访问 Gameball API。

文档

请参阅 Gameball API 文档。

要求

PHP 5.6.0 及以上版本。

安装

除非您想修改 SDK，否则不需要此源代码。如果您只想使用 SDK，只需运行以下命令

Composer

您可以通过 Composer 安装绑定。运行以下命令

composer require gameball/gameball-php

要使用绑定，请使用 Composer 的自动加载

require_once('vendor/autoload.php');

依赖项

绑定需要以下扩展才能正常工作

curl（尽管您可以选择使用自己的非-cURL 客户端）
json
mbstring（多字节字符串）

如果您使用 Composer，这些依赖项应自动处理。如果您手动安装，请确保这些扩展可用。

使用方法

SDK 需要配置您的账户 API & 交易密钥，这些密钥可在您的 Gameball 控制台中找到。

示例

发送事件

// INITIALIZE PLAYER
$gameball = new \Gameball\GameballClient('Your_API_Key', 'Your_SECRET_Key');

$playerAttributes = new \Gameball\Models\PlayerAttributes();
$playerAttributes->displayName = "display_name";
$playerAttributes->firstName = 'first_name';
$playerAttributes->lastName = 'last_name';
$playerAttributes->gender = 'M';
$playerAttributes->email = 'user@example.com';
$playerAttributes->mobile = '_mobile_';
$playerAttributes->dateOfBirth = '1991-09-19T00:00:00.000Z';
$playerAttributes->joinDate = '2022-01-01T21:06:29.158Z';

$playerRequest = \Gameball\Models\PlayerRequest::factory(
        "player_unique_id",
        null, // EMAIL
        null, // MOBILE 
        $playerAttributes
    );

// SEND EVENT
$eventRequest = new \Gameball\Models\EventRequest();
$eventRequest->addEvent('place_order');
$eventRequest->addMetaData('place_order','total_amount','100');
$eventRequest->addMetaData('place_order','category',array("electronics","cosmetics"));
$eventRequest->addEvent('review');

$playerRequest = \Gameball\Models\PlayerRequest::factory('player123');
$eventRequest->playerRequest = $playerRequest;

$res= $gameball->event->sendEvent($eventRequest);

// Accessing response data
echo $res->body;

// Accessing response data as JSON
echo $res->decodedJson;

处理异常

失败的请求会引发异常。抛出的异常将反映发生的错误类型，并带有相应的消息和错误代码。请参阅 Gameball API 文档。

贡献

此存储库的 master 分支包含 SDK 的最新稳定版本。

联系方式

对于使用问题或建议，请发送电子邮件至 support[ at ]gameball.co。请将任何错误报告为问题。

gameball / gameball-php

维护者

详细信息