本快速入門假設您已熟悉目錄和庫存物品。範例玩家必須已擁有他們想要交易出去的庫存物品。
OpenTrade API,讓另一位玩家可以進行交易。您將需要 playfabId 來識別禮物接收者,以及目前庫存中擁有該物品之玩家的 ItemInstanceID。
secondPlayerId:這是識別禮物接收者的唯一字串 (PlayFabId)。
myItemInstanceId:這是識別目前玩家所擁有之物品執行個體的唯一字串 (InstanceID)。
所有交易都是公開資訊。任何玩家都可以查看另一位玩家的開啟交易,以及另一位玩家的交易歷程記錄 (如果他們知道該玩家的
playFabId)。LogSuccess 回呼也必須評估 result.Trade.TradeId,並將 firstPlayFabId 和 tradeId 都傳送給第二位玩家。如果未儲存,第二位玩家將無法評估或接受交易。
在目前的預覽版中,您必須確保您的交易在並行動作下是執行緒安全的。執行緒安全的選項包括自訂遊戲伺服器,以及透過 CloudScript 對外部資料庫/系統進行的 Webhook 呼叫。執行緒不安全的選項可以使用直接修改玩家資料索引鍵的 CloudScript 建置。後者有並行問題,同時進行的交易清單更新可能無法正確處理。
playFabId 和 tradeId 傳送給第二位玩家之後,第二位玩家可以透過發出 GetTradeStatus 要求來檢查交易需求 (確認這是一份禮物)。
最相關的 TradeStatus 值為 Open、Filled 和 Canceled。所有其他狀態都是中間狀態。在呼叫之間,交易可能會在這些中間狀態停留一段明顯的時間。最近修改的交易可能無法立即使用。
AcceptGiftFrom 函式會將贈送的物品從第一位玩家的庫存轉移到第二位玩家的庫存。