入门指南

本指南提供有关将您的手机游戏与Aghanim集成的分步说明。此集成的唯一要求是您的游戏已在应用商店上架，并分配一些开发资源进行集成。

通过一次集成，您将可以连接到整个Aghanim产品套件，使您能够部署游戏中心、启动liveops活动、全球接受支付等更多功能。

步骤1：注册Aghanim并链接您的游戏

您的游戏必须在Apple App Store或Google Play Store上架。

注册Aghanim并链接您的手机游戏→

步骤2：处理Aghanim的事件

在玩家与游戏中心交互的过程中，Aghanim会向您的后台发送多个事件。您的系统应对这些事件作出响应，例如根据数据库验证玩家，并将购买的物品更新到玩家账户。

成功集成的重要Aghanim事件包括：

验证玩家（player.verify）：通知您的游戏有关玩家登录的情况，要求您的webhook服务器确认以允许或拒绝游戏中心访问。
添加物品（item.add）：通知您的游戏根据玩家在游戏中心的活动将物品记入玩家账户。
移除物品（item.remove）：在支付取消或退款等情况下通知您的游戏从玩家账户中移除物品。

player.verify
item.add
item.remove

{
  "event_type": "player.verify",
  "event_data": {"player_id": "2D2R-OP3C"},
  "event_id": "whevt_eCacGbJVbvToOgzjXUgOCitkQE",
  "event_time": 1725548450,
  "idempotency_key": null,
  "sandbox": false,
  "trigger": "hub.login",
  "request_id": "d1593e9c-c291-4004-8846-6679c2e5810b",
  "transaction_id": "whtx_eCacGbJVbvToOgzjXUgOCitkQE"
}

{
  "event_type": "item.add",
  "event_data": {
    "player_id": "2D2R-OP3C",
    "items": [
      {
        "id": "itm_exTBZQmIlDz",
        "name": "水晶",
        "description": "用这庞大的水晶宝藏统治你的对手。",
        "sku": "crystals",
        "quantity": 480000,
        "price": 9499,
        "price_decimal": 94.99,
        "currency": "USD",
        "type": "item",
        "nested_items": null
      }
    ],
    "reason": "使用优惠券 WELCOME"
  },
  "event_time": 1725548450,
  "event_id": "whevt_eCacGbJVbvToOgzjXUgOCitkQE",
  "idempotency_key": "550e8400-e29b-41d4-a716-446655440000",
  "sandbox": false,
  "trigger": "order.paid",
  "request_id": "d1593e9c-c291-4004-8846-6679c2e5810b",
  "transaction_id": "whtx_eCacGbJVbvToOgzjXUgOCitkQE"
}

{
  "event_type": "item.remove",
  "event_data": {
    "player_id": "2D2R-OP3C",
    "items": [
      {
        "id": "itm_exTBZQmIlDz",
        "name": "水晶",
        "description": "用这庞大的水晶宝藏统治你的对手。",
        "sku": "crystals",
        "quantity": 480000,
        "price": 9499,
        "price_decimal": 94.99,
        "currency": "USD",
        "type": "item",
        "nested_items": null
      }
    ],
    "reason": "使用优惠券 WELCOME"
  },
  "event_time": 1725548450,
  "event_id": "whevt_eCacGbJVbvToOgzjXUgOCitkQE",
  "idempotency_key": "550e8400-e29b-41d4-a716-446655440000",
  "sandbox": false,
  "trigger": "order.refunded",
  "request_id": "d1593e9c-c291-4004-8846-6679c2e5810b",
  "transaction_id": "whtx_eCacGbJVbvToOgzjXUgOCitkQE"
}

开发一个webhook端点函数

要管理来自Aghanim的事件，您需要开发一个或多个函数。此选择取决于您是希望通过单个端点处理所有事件，还是使用多个端点，每个专用于特定事件或不同逻辑。

您的函数应符合以下要求和逻辑：

HTTPS端点，接受POST webhook请求。
监听由Aghanim生成和签名的事件。
处理webhook负载中包含的idempotency_key，以防止处理重复的webhook。
适当处理传入请求，例如根据玩家ID验证玩家数据库，以确定游戏中心的访问权限，向玩家账户记入购买的物品，从玩家账户中移除退款物品等。
对于成功处理的事件返回2xx状态码，对于拒绝或错误返回4xx或5xx状态码。对于player.verify事件，您的服务器还需在成功验证玩家时返回包含玩家数据的JSON负载。

以下是为处理Aghanim生成的基本事件而设计的单个端点函数模板：

您可以通过执行以下请求在本地测试您的webhook端点函数：

cURL
Python

curl -X POST "https://your-webhook-endpoint.com/your/webhook/uri" \
  -H 'x-aghanim-signature-timestamp: <EVENT_TIMESTAMP>' \
  -H 'x-aghanim-signature: <HMAC-SHA256_SIGNATURE>' \
  -H 'user-agent: Aghanim/0.1.0' \
  -H 'content-type: application/json' \
  -H 'accept: */*' \
  -H 'host: your-webhook-endpoint.com' \
  -d '{
      "event_id": "whevt_eAeXhOxLwxy",
      "event_type": "player.verify",
      "idempotency_key": null,
      "event_data": {
          "player_id": "testplayer"
      }
  }'

import requests

# 端点URL
url = "https://your-webhook-endpoint.com/your/webhook/uri"

# 头部信息
headers = {
    'x-aghanim-signature-timestamp': '<EVENT_TIMESTAMP>',
    'x-aghanim-signature': '<HMAC-SHA256_SIGNATURE>',
    'user-agent': 'Aghanim/0.1.0',
    'content-type': 'application/json',
    'accept': '*/*',
    'host': 'your-webhook-endpoint.com'
}

# JSON负载
data = {
    "event_id": "whevt_eAeXhOxLwxy",
    "event_type": "player.verify",
    "idempotency_key": null,
    "event_data": {
        "player_id": "testplayer"
    }
}

# 发出POST请求
response = requests.post(url, headers=headers, json=data)

# 打印服务器响应
print(response.text)

在Aghanim中注册您的端点

令您的端点(s)可用。
在Aghanim账户中注册端点 → 游戏 → Webhooks → 新Webhooks 选择以下事件：

玩家验证
添加物品
移除物品

复制生成的密钥，并在您的webhook函数中指定用于请求签名验证。

步骤3：设置玩家ID验证

玩家可以使用他们的玩家ID登录游戏中心，该ID应作为游戏中的唯一标识符。

确定将在游戏中心中用于验证玩家的游戏内参数。这应是您游戏中已有的唯一标识符。
Aghanim将在玩家与游戏中心互动后向您的服务器发送通知，包括登录尝试。然后，您的服务器必须根据玩家ID来允许或拒绝访问。按照下面的说明实施此验证过程。
在Aghanim仪表板下的游戏 → 设置 → 游戏中心登录外观与感觉中，通过添加详细说明来指导游戏中心用户定位其验证数据。详细说明玩家可以在游戏中找到玩家ID的位置，并考虑包含示例图片以便于理解。

步骤4：查看生成的游戏中心

链接您的手机游戏后，Aghanim将立即创建一个根据您的游戏数据量身定制的游戏中心。此中心作为直接面向消费者的网站，提供的功能包括游戏商店、新闻、活动、排行榜、成就、每日奖励、特别优惠和可兑换代码，并可进行全面定制和品牌化。

要组装游戏中心，我们直接从应用商店获取所有必要数据，并自动将其填充到游戏中心中，包括：

您的游戏标识
游戏内物品及其价格
新闻和更新
即将到来或正在进行的活动
排行榜

对于应用商店缺乏的数据，Aghanim通过AI引导的Hub设置过程进行补充，添加缺失元素如物品图片、新闻图片等。

要访问您的游戏中心，请在Aghanim仪表板上导航到游戏中心构建器 → 查看您的游戏中心。

步骤5：开展移动玩家参与活动

您的游戏中心现在准备就绪！是时候将您的手机玩家引入网页体验，通过liveops活动吸引他们。

选择至少一项以下活动以继续：

需要帮助吗？
联系我们的集成团队 integration@aghanim.com

步骤1：注册Aghanim并链接您的游戏​

步骤2：处理Aghanim的事件​

开发一个webhook端点函数​

在Aghanim中注册您的端点​

步骤3：设置玩家ID验证​

步骤4：查看生成的游戏中心​

步骤5：开展移动玩家参与活动​