銷毀

燒毀是一個功能，允許用戶燒毀已發行的NFT並將其轉換為可以在遊戲中使用的物品。用戶將NFT轉換為物品的過程大致如下。

1. 用戶在 NFT 查看頁面檢查他們擁有的 NFT。
2. 用戶選擇已勾選的 NFT，並將其轉換為可在遊戲中重用的物品（= NFT 燒毀）。

燃燒功能的實現流程¶

以下是燃燒功能的實現過程。要實現燃燒功能，請按照流程圖圖像和指南內容在遊戲客戶端 (Hive SDK，遊戲客戶端) 和遊戲服務器區域中實現代碼。下圖中標有藍色星號的部分是開發人員需要工作的區域。有關主要任務的更多詳細信息，請參閱下面的指南。

在 hive SDK 中實現登錄¶

在遊戲客戶端實現代碼，允許用戶使用IdP 登錄和Hive SDK 認證功能登錄。也支持網頁登錄作為登錄方法。

實現 nft 查詢按鈕¶

實現一個用戶界面，允許用戶在遊戲客戶端中打開他們的NFT列表。例如，在用戶角色的庫存中實現一個查看擁有的NFT列表按鈕。當按下此按鈕時，您需要根據以下內容實現NFT查看頁面的打開。

NFT 查詢請求¶

實現從遊戲客戶端向遊戲伺服器請求用戶的NFT的代碼。這是為了實現用戶選擇NFT查詢按鈕時的操作。當遊戲伺服器收到遊戲客戶端的請求時，它會調用NFT查詢頁面鏈接創建API以顯示用戶的NFT列表。

NFT 查詢頁面連結生成 API 呼叫¶

NFT 查看頁面是一個用戶可以查看他們擁有的 NFT 列表的網頁。這個網頁由 Hive 區塊鏈伺服器提供。遊戲伺服器調用鏈接生成 API 以獲取此網頁 URL (webLinkUrl)。當用戶訪問此網頁時，他們可以查看自己擁有的 NFT 列表並在區塊鏈上燒毀（銷毀）特定的 NFT。

註解¶

以下是開發者在進行API調用時的注意事項。

遊戲伺服器網址¶

gameServerUrl 用作 Hive 區塊鏈伺服器調用遊戲伺服器的 請求 URL，包括 項目驗證 API 和 結果檢查 API。

遊戲伺服器網址和令牌¶

當 Hive 區塊鏈伺服器呼叫 項目驗證 API 或 結果檢查 API 時，遊戲伺服器可以使用身份驗證令牌（標頭參數）進行 API 呼叫，這對開發者來說是可選的。如果要在 API 呼叫中使用身份驗證令牌，遊戲伺服器必須將此身份驗證令牌作為 token（查詢參數）附加到 gameServerUrl，並在呼叫 NFT 查詢頁面鏈接生成 API 時提前發送到 Hive 區塊鏈伺服器。以下是示例。

"gameServerUrl": "https://api.com2us.com/hive?token=sInR5cCI6IkpXVC..."

NFT 查詢頁面鏈接有效期¶

一個創建過的頁面的鏈接僅在10分鐘內有效，基於第一次訪問的會話。

請求 URL¶

標頭參數¶

請求主體¶

請求範例¶

curl -X 'POST' \
  'https://sandbox-bc-platform-api.withhive.com/web3/v1/web-link' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlObyI6NiwiaWQiOiIvVWpXN....' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "HOME",
  "playerId": 1276814678,
  "characterId": "zeratu",
  "gameServerUrl": "https://api.com2us.com/hive" //인증 토큰 전송 시: "gameServerUrl": "https://api.com2us.com/hive?token=sInR5cCI6IkpXVC..."
}'

回應¶

回應範例¶

{
  "code": 0,
  "message": "success",
  "data": {
    "webLinkid": "b6d2ca1b-b43a-4129-bf54-9a189e3aa664",
    "webLinkUrl": "https://sandbox-xpla-platform.withhive.com/api/v1/web-link/redirect?token=b256c85c-aee8-4837-b54d-9a03fe8a7435.f94140b71c9ebf058956547753131adde9968a0266f208d7e3059bbb6dd0c7bc",
    "expiration": "2024-08-05T08:33:15.448Z"
  }
}

使用 Hive SDK 實現 NFT 瀏覽頁面¶

該NFT查詢頁面鏈接創建API暴露了作為響應接收的網頁URL，使用Hive SDK在外部瀏覽器中打開它。

以下是NFT查看頁面的範例。

擁有的 NFT 列表

當您打開 NFT 查看頁面時，將會出現一個窗口，用於登錄 X-PLANET 錢包 或 XLPA Vault。用戶必須選擇特定的錢包地址，以便在登錄 X-PLANET 錢包或 XLPA Vault 後執行 Mint 或 Burn。

X-PLANET	XPLA Vault

NFT 燒毀執行¶

在 NFT 查看頁面上，用戶選擇一個 NFT 然後執行燒毀。

從列表中選擇要燒毀的 NFT	檢查費用

項目驗證 API 呼叫 (hive 區塊鏈伺服器 → 遊戲伺服器)¶

Hive 區塊鏈伺服器向遊戲伺服器請求項目驗證，以檢查用戶擁有的 NFT 是否為遊戲中的可用物品。

Hive 區塊鏈伺服器通過遊戲伺服器傳遞的響應值驗證該物品在遊戲中是否可用。一旦驗證完成，Hive 區塊鏈伺服器會在區塊鏈上銷毀該 NFT。如果 物品驗證失敗，Hive 區塊鏈伺服器則不會銷毀該 NFT。

註解¶

以下是開發人員在配置 API 端點時的一些考慮事項。

遊戲伺服器網址¶

此 API 通过使用从 NFT 查找页面链接创建 API 请求的 gameServerUrl 向游戏服务器请求验证。

授權標頭¶

如果在從 NFT 查詢頁面鏈接創建 API 請求的 gameServerUrl 中存在 token 查詢參數，請使用此 token 值以 Bearer 格式。

屬性¶

當呼叫NFT 發行頁面鏈接創建 API時，請求的attributes將包含在項目驗證 API 請求主體中。

請求 URL¶

以下是需要在遊戲伺服器上準備的API端點資訊。

標頭參數¶

請求主體¶

請求範例¶

curl -X 'POST' \
  'https://api.com2us.com/hive/items/validate' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoieHBsYS13ZWJ2aWV3IiwiYXBwIjoiY29tLmdjcC5zdGVwYnlzdGVwLnBjd2ViLmJs...' \
  -H 'User-Agent: HiveBlockchain/1.0' \
  -d '{
    "type": "BURN",
    "itemId": "HIVE",
    "playerId": 2319123897,
    "characterId": "zeratu",
    "webLinkId": "b6d2ca1b-b43a-4129-bf54-9a189e3aa664",
    "attributes": [ // NFT 조회 페이지 링크 생성 시 attributes
        {
          "traitType": "item_id",
          "value": "sward-3283272101239"
        },
        {
          "traitType": "strength",
          "value": "50"
        },
        {
          "traitType": "agility",
          "value": "10"
        }
      ],
    "tokenId": "HIVE#01"
  }'

回應¶

HTTP 狀態碼如下。

• 成功
  • 200
• 失敗
  • 4xx: 錯誤請求的錯誤狀態碼
  • 5xx: 伺服器錯誤的錯誤狀態碼

結果檢查 API 呼叫 (hive 區塊鏈 → 遊戲伺服器)¶

當Hive區塊鏈伺服器將NFT燒毀結果作為請求主體傳送到遊戲伺服器時，遊戲伺服器會在遊戲中生成物品，然後通過API將結果發送回Hive區塊鏈伺服器。

遊戲伺服器將根據焚燒結果採取的行動如下。

• NFT 燒毀成功
  • 處理以在遊戲中使用物品（例如，創建遊戲用戶的庫存中的物品）
• NFT 燒毀失敗
  • 遊戲中不需要單獨處理
  • 如果用戶取消 NFT 燒毀或超過某個時間限制，則發送 NFT 燒毀失敗結果

以下是當Hive區塊鏈伺服器成功通訊NFT燒毀時的NFT燒毀頁面螢幕示例。

註解¶

以下是開發人員在配置 API 端點時的一些考量。

屬性¶

當呼叫NFT發行頁面鏈接創建API時請求的attributes包含在結果確認API請求主體中。如果attributes中包含唯一代碼，則可以使用該唯一代碼更新項目狀態。

授權標頭¶

如果在從NFT查詢頁面鏈接創建API請求的gameServerUrl中存在token查詢參數，則使用此token值以Bearer格式。

請求 URL¶

標頭參數¶

請求主體¶

請求樣本¶

curl -X 'POST' \
  'https://api.com2us.com/hive/items/callback' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoieHBsYS13ZWJ2aWV3IiwiYXBwIjoiY29tLmdjcC5zdGVwYnlzdGVwLnBjd2ViLmJs...' \
  -H 'User-Agent: HiveBlockchain/1.0' \
  -d '{
    "type": "BURN",
    "itemId": "HIVE",
    "playerId": 2319123897,
    "characterId": "zeratu",
    "webLinkId": "b6d2ca1b-b43a-4129-bf54-9a189e3aa664",
    "tokenId": "HIVE#348",
    "status": "success",
    "attributes": [ // NFT 조회 페이지 링크 생성 시 attributes
        {
          "traitType": "item_id",
          "value": "sward-3283272101239"
        },
        {
          "traitType": "strength",
          "value": "50"
        },
        {
          "traitType": "agility",
          "value": "10"
        }
      ]
  }'

回應¶

HTTP 狀態碼如下。

• 成功
  • 200
• 失敗
  • 4xx: 錯誤請求的錯誤狀態碼
  • 5xx: 伺服器錯誤的錯誤狀態碼