集成PlayFab

运行机制

• 将目录从PlayFab导入游戏内商店以使用艾克索拉解决方案。
• 将用户通过艾克索拉购买的商品自动传输到PlayFab。

适用对象

• 集成了PlayFab，现希望通过艾克索拉解决方案扩大商品（虚拟货币和虚拟物品）销售范围的合作伙伴。
• 集成了艾克索拉解决方案，现希望在PlayFab中取得商品营收（销售商品以获得真实货币）的合作伙伴。

导入规则

从PlayFab导入商品时，适用以下规则：

• PlayFab中的耐久商品将作为虚拟物品（而非虚拟货币或捆绑包）导入。
• 所有商品，包括虚拟货币套餐和PlayFab捆绑包中的商品，都将作为消耗品导入（参数consumable = true或未指定）。
• 虚拟货币将以部分可用状态导入，且不指定价格（API标记：is_show_in_store = false、is_enabled = trueis_free = true）。
• 一个仅包含一种虚拟货币的捆绑包将导入为一个虚拟货币套餐。
• 包含多种虚拟货币的捆绑包将导入为多个独立的虚拟货币套餐。对于每个唯一SKU和数量组合，系统将创建一个免费虚拟货币套餐且状态为部分可用（API标记：is_show_in_store = false、is_enabled = true、is_free = true）。
• 一个包含不同类型商品的捆绑包将导入为一个捆绑包。
• 如果PlayFab中未填写商品的描述字段，将使用名称字段作为商品描述；如果没有名称，则使用SKU。

导入限制

游戏内商店限制

• 不导入容器和包含容器的捆绑包。
• 不导入DropTables和包含DropTables的捆绑包。
• 将忽略PlayFab特有的参数，如isStackable、isTradable、UsageCount、UsagePeriod、UsagePeriodGroup。
• 创建消耗品时不考虑数量（商品在首次使用后就从物品库中消失）。

PlayFab限制

• PlayFab不存储真实货币价格，只使用以RM为货币代码的虚拟货币，等效于1美分的真实货币(100 RM = 1 USD)。因此，商品价格只能以虚拟货币或RM设置。
• 商品的SKU必须唯一，且仅包含数字、英文字母、连字符和下划线。

如何获取

从PlayFab导入目录

如果尚未配置PlayFab，请执行以下操作：

• 创建您的PlayFab帐户。
• 创建您的游戏。
• 获取您的唯一游戏ID。
• 获取您的PlayFab密钥。

前往发布商帐户，然后将商品目录从PlayFab导入到游戏内商店。

1. 打开您的发布商帐户并前往“商店 > 目录管理 > 与外部平台集成 > PlayFab”。
2. 在商品导入选项卡中指定：
   • 游戏ID — PlayFab中的项目ID。
   • 密钥 — PlayFab中的项目密钥。
3. 单击保存。
4. 让用户物品库与PlayFab同步（可选）：
   1. 前往物品库同步并指定：
      • 游戏ID — PlayFab中的项目ID。
      • 密钥 — PlayFab中的项目密钥。
   2. 将用户物品库与PlayFab同步开关设置为开。
   3. 单击保存。
5. 前往商品导入选项卡，然后单击开始导入。目录导入将立即开始。
6. 要在通过建站器创建的网页商城中销售虚拟物品，请在发布商帐户中配置物品组，然后为每个物品分配一个或多个组。
7. 要显示物品图片，请在您的发布商帐户中上传图片。

要检查导入是否成功完成，请前往侧边栏中的商店部分，确保虚拟货币、虚拟物品和捆绑包选项卡中启用了虚拟物品、货币和捆绑包。

重新导入目录

• 已在商店中的商品将被更新。
• 不在商店中的商品将被添加。
• 已从导入源中删除的商品将保留在商店中。您可以在发布商帐户中删除或通过API删除。

将商品添加到PlayFab物品库

• 通过将用户物品库同步到PlayFab。
• 通过将PlayFab存储与艾克索拉登录管理器集成。此情况下，PlayFab ID在令牌中指定。艾克索拉侧返回商品时，会在令牌中向PlayFab发送请求。

如要将用户物品库与PlayFab同步：

1. 打开您的发布商帐户并前往“商店 > 目录管理 > 与外部平台集成 > PlayFab”。
2. 前往物品库同步，然后指定
   • 游戏ID — PlayFab中的游戏唯一ID。
   • 密钥 — PlayFab中的项目密钥。
3. 将用户物品库与PlayFab同步开关设置为开。
4. 单击保存。

之后，在游戏内商店中所购商品的信息将自动传输到PlayFab。