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 顆鑽石和 10 金幣，可確保訂閱有效期為一週；第二組價格為 7 顆鑽石和 12 金幣，可確保訂閱有效期為一個月。請注意，時間長度必須以秒為單位設定。這應該會傳回訂閱已建立並發佈的回應：

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

庫存中的訂閱

訂閱會出現在玩家的庫存集合中，並具有 ID、StackId、到期日和顯示屬性。訂閱中的所有內容都可以像任何其他項目一樣，使用 Add、Subtract 和 Update 等進行修改。您可以使用 GetInventoryItems 搭配 Type 篩選，擷取玩家目前擁有的所有訂閱。

{ 
    "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

庫存中的訂閱