跳至主要内容

Aghanim-PlayFab 集成

本指南说明了如何将 Aghanim 与 PlayFab 集成，以通过 PlayFab 的服务器 API 启用自动玩家验证和库存管理。

要求

  • 一个已配置标题的 PlayFab 账户。
  • 访问您的 PlayFab 标题的 Title ID 和 Secret Key。
  • 在您的 PlayFab 目录中配置的物品需要与您的 Aghanim 商店物品匹配。

第 1 步：获取您的 PlayFab 凭据

  1. 登录你的 PlayFab 游戏管理器。
  2. 从控制面板中选择您的标题。
  3. 进入设置 → API 功能并复制您的 Title ID。
PlayFab Title ID
PlayFab Title ID
  1. 进入设置 → 密钥并复制您的 Secret Key（如果需要可以创建一个新的）。
PlayFab Secret Key
PlayFab Secret Key

步骤 2：在 PlayFab 目录中配置物品

确保您的 PlayFab 目录中包含与您的 Aghanim 商店物品相对应的项目：

  1. 前往 PlayFab 控制台中的 经济 → 目录 。
  2. 创建或验证与您的 Aghanim 商店 SKU 值匹配的 Item IDs 项目。
  3. 根据需要设置适当的显示名称、描述和其他物品属性。

第 3 步：在 Aghanim 中配置集成

  1. 前往阿哈利姆控制台 → Aghanim Connect → PlayFab。
  2. 填写以下必填字段：
    • Title ID – 你的 PlayFab 标题 ID
    • Secret Key – 你的 PlayFab 密钥
    • 目录版本（可选）– 如果使用版本化目录，请指定一个目录版本
  3. 点击安装按钮完成集成设置。
PlayFab Configuration
PlayFab Configuration

一旦安装，在您的阿哈利姆控制台中将在Webhooks下自动创建一个PlayFab API端点，准备处理玩家验证和库存管理事件。 您可以在那里查看详细的请求和响应日志，以确切了解您的PlayFab集成是如何工作的。

PlayFab Webhook
PlayFab Webhook

操作原理

配置完成后，PlayFab 集成会自动处理以下 webhook 事件：

玩家验证

  • 处理player.verify webhook事件
  • 调用 PlayFab 的 GetPlayerProfile API 验证玩家是否存在
  • 返回包括显示名称和头像 URL 在内的玩家资料数据
  • 在认证流程中用于验证玩家

添加商品（发货）

  • 处理item.add webhook事件
  • 调用 PlayFab 的 GrantItemsToUsers 管理 API 向玩家库存添加物品
  • 根据成功的购买或手动授予授予物品
  • 存储授予的物品实例 ID 以便以后可能移除

移除商品（扣货）

  • 处理item.remove webhook事件
  • 调用 PlayFab 的 RevokeInventoryItems 服务器 API 从玩家库存中移除物品
  • 仅移除通过 Aghanim 先前授予的物品
  • 使用原始授予操作中存储的物品实例 ID

重要说明

  • SKU 匹配：确保你的 Aghanim 商店物品 SKU 与你的 PlayFab 目录项目 ID 完全匹配。
  • 错误不重试：PlayFab 操作不支持幂等性，因此为避免重复操作，失败请求不会自动重试。

需要技术支持？
联系我们的集成技术团队： integration@aghanim.com

On this page