Economy v2 订阅

订阅允许你为耐久物品授予基于时间的访问权限。订阅内的物品在调用 GetInventoryItems 之后会在玩家库存中拆包。

本文重点介绍虚拟订阅，即存在于你的游戏中的订阅。

创建订阅

要创建订阅，你必须首先确保已发布你希望在游戏中可访问/可购买的目录物品、货币或用户生成内容 (UGC)。要在创建订阅之前设置你的目录，请参阅 Economy V2 快速入门

GameManager

导航到 Economy > Catalog (V2)。
在 Subscriptions 选项卡下，选择 New Subscription。

API

你可以使用 CreateDraftItem API 创建订阅。创建订阅的 CreateDraftItem API 请求示例：

{
  "Item": {
   "Type": "subscription",
    "Title": {
      "NEUTRAL": "Holiday Skins Pass"
    },
    "StartDate": "2023-03-07T00:01:00.0000000Z",
    "ItemReferences":[
      {
        "Id":"{{GlowingGlovesItemID}}",
        "Amount": 1
      }, 
      {
        "Id":"{{ShinyShoesItemID}}", 
        "Amount": 1
      }
    ],
        "PriceOptions": {
          "Prices": [
        {
            "UnitDurationInSeconds":604800,
              "Amounts": [
                {
                    "ItemId": "{{DiamondItemID}}",
                    "Amount": 5
                },
                {
                    "ItemId": "{{GoldItemID}}",
                    "Amount": 10
                }
                ]
        },      
        {
            "UnitDurationInSeconds":2628000,
              "Amounts": [
                {
                    "ItemId": "{{DiamondItemID}}",
                    "Amount": 7
                },
                {
                    "ItemId": "{{GoldItemID}}",
                    "Amount": 12
                }
                ]
        } ]
          }
        },
  "Publish": true
}

上面的 Holiday Skins Pass 订阅以两个价格点为两个不同的有效期授予两个物品，Glowing Gloves 和 Shiny Shoes。第一个价格集为 5 diamonds 和 10 gold，确保订阅有效期为一周，而第二个价格集为 7 diamonds 和 12 gold，确保订阅有效期为一个月。请注意，时间持续时间需要以秒为单位设置。这应该返回订阅已创建和发布的响应：

{
  "code": 200,
    "status": "OK",
    "data": {
        "Item": {
            "Id": "{{NewlyCreatedSubscriptionItemID}}",
            "Type": "subscription",
            "AlternateIds": [],
            "Title": {
                "NEUTRAL": "Holiday Skins Pass"
            },
    ...
}

库存中的订阅

订阅将以 ID、StackId、到期日期和显示属性存在于玩家的库存集合中。订阅中的所有内容都可以像任何其他物品一样使用 Add、Subtract 和 Update 等进行修改。你可以使用带有 Type 过滤器的 GetInventoryItems 检索玩家当前拥有的所有订阅。

{ 
    "Entity": {
        "Type": "title_player_account", 
        "Id": "ID" 
    }, 
    "CollectionId": "default", 
    "Filter": "type eq 'subscription'"
}

**Sample Response**

{
    "code": 200,
    "status": "OK",
    "data": {
        "Items": [
            {
                "Id": "{{SubscriptionID}}",
                "StackId": "default",
                "DisplayProperties": {},
                "Type": "subscription",
                "ExpirationDate": "2023-08-27T23:59:59Z"
            }
        ],
        "ETag": "1/Mw=="
    }
}

未到期的订阅在读取时被拆包。拆包的物品具有预期的 ID、一个由订阅 ID 和订阅的 StackId 组成的唯一复合 StackId。数量设置为订阅物品引用中配置的数量。这些拆包的物品是不可变的，不能使用 Add、Subtract、Update 等进行修改。

{ 
    "Entity": {
        "Type": "title_player_account", 
        "Id": "ID" 
    }, 
    "CollectionId": "default", 
    "Filter": "StackId eq 'SubscriptionItemID:default'"
}

**Sample Response**

{
    "code": 200,
    "status": "OK",
    "data": {
        "Items": [
            {
                "Id": "{{GlowingGlovesItemID}}",
                "StackId": "{{SubscriptionID:default}}",
                "DisplayProperties": {},
                "Amount": 1,
                "Type": "catalogItem"
            },
            {
                "Id": "{{ShinyShoesItemID}}",
                "StackId": "{{SubscriptionID:default}}",
                "DisplayProperties": {},
                "Amount": 1,
                "Type": "catalogItem"
            }
        ],
        "ETag": "1/NQ=="
    }
}

订阅拆包发生在过滤和分页之前，因此订阅物品可以像集合中的任何其他物品一样可靠地被过滤和分页。你可以使用 UpdateInventoryItems、AddInventoryItems 和 SubtractIventoryItems 来更新玩家订阅的到期日期。以下 UpdateInventoryItems API 调用正在更新订阅的到期日期。

{
   "Entity": { 
      "Type": "title_player_account", 
      "Id": "{{ID}}" 
    }, 
  "CollectionId": "default", 
   "Item": { 
        "Id": "{{SubscriptionID}}", 
        "StackId": "default",
        "DisplayProperties": {},
        "Type": "subscription",
        "ExpirationDate": "2023-03-27T23:59:59Z" 
    } 
} 

以下 AddInventoryItems API 调用通过增加 DurationInSeconds 参数来延长到期日期。

{
    "Entity": { 
        "Type": "title_player_account", 
        "Id": "{{ID}}" 
    }, 
    "CollectionId": "default", 
    "Item": { 
        "Id": "{{SubscriptionID}}" 
    }, 
    "DurationInSeconds":2628000 
} 

以下 SubtractInventoryItems API 调用通过减少 DurationInSeconds 参数来缩短到期日期。

{
    "Entity": { 
        "Type": "title_player_account", 
        "Id": "{{ID}}" 
    }, 
    "CollectionId": "default", 
    "Item": { 
        "Id": "{{SubscriptionID}}" 
    }, 
    "DurationInSeconds":60 
} 

XBOX Services

PlayFab

创建订阅

GameManager

API

库存中的订阅

​创建订阅

​GameManager

​API

​库存中的订阅

创建订阅

GameManager

API

库存中的订阅