跳轉到主要內容
PlayFab Game Manager 中的 API 功能是一些用於管理遊戲 PlayFab API 行為的選項。這些選項為您提供管理存取、隱私權及其他功能的工具。 若要找到設定這些選項的畫面:
  • 前往 Game Manager。
  • 從左側功能表選取 Settings。
  • 選取 API Features 索引標籤。
Game Manager - Settings - API 功能 其中有些核取方塊一目了然,有些則不然。在本教學課程中,我們將詳細說明其中幾個。
本教學課程中的數個螢幕擷取畫面和示範都使用 Postman。

要求自訂資料值必須為有效的 JSON

遭到入侵的用戶端可能會為遊戲帶來一些_嚴重_的問題。張貼格式不正確資料的惡意 API 呼叫端,可能會為開發人員產生雜訊、錯誤和問題。資料格式不正確的玩家通常需要手動介入清理。 要求自訂資料值必須為有效的 JSON,會在資料儲存至資料庫_之前_執行基本的內容類型驗證。及早發現這些問題可防止問題持續存在,並阻止駭客干擾正常開發。 設定此旗標時,會強制用戶端為其自訂資料的每個索引鍵傳入有效的 JSON。單靠簡單的 JSON 驗證並無法防止_所有_問題,但有助於剔除一些不良行為。 勾選此選項會要求在所有自訂資料 (包括玩家、發行者、角色、遊戲和項目資料) 中儲存的每個索引鍵都必須是有效的 JSON。
此旗標可以隨時_開啟_或_關閉_。但它_不_具追溯力。因此現有的值_不會_受到影響。只有新寫入的值才會經過驗證。
如果您嘗試傳遞無效的 JSON 作為值,它會以 HTTP Status Code 400 "Bad Request" 拒絕要求。 Postman - 傳送無效的 JSON

停用所有 API 要求存取

出乎意料的是,停用遊戲的所有 API 存取可能會很有用。 例如,如果您正在執行需要停機的敏感移轉,零星的 API 要求可能會造成嚴重中斷。如果您要讓遊戲退役,這可以保證您的遊戲確實已關閉。
請記住,勾選此核取方塊將會確實讓您的遊戲無法運作,因此請謹慎使用!
一旦您決定需要關閉 API 存取並勾選此方塊,所有 API 要求都會在幾分鐘內開始失敗。 PlayFab 會傳回 HTTP Status Code 400 "Bad Request",表示遊戲已停用此類使用。 Postman - 存取已停用的 API 這些 HTTP Status Code 400 回應會持續存在,直到您取消勾選此方塊為止。同樣地,取消勾選可能需要幾分鐘才會生效。

啟用玩家 IP 位址模糊處理

對許多工作室而言,擁有個人識別資訊 (PII) 是最好避免的責任。一種常見 (且實用) 的 PII 形式就是 IP 位址。 IP 位址有多種用途,包括地理位置。不過,_完全_精確的 IP 通常被視為 PII。 PlayFab 可以透過模糊處理部分 IP 位址來協助限制這一點。現在,只要勾選一個方塊,您就可以停止收集此敏感資料。 勾選此方塊後,PlayFab 一律會將玩家 IP 的最後一個八位元記錄為 0。您可以在 Players 索引標籤中檢查玩家的登入歷程記錄,以驗證此功能是否正常運作。 您應該會看到每個 IP 都以 .0 結尾。在啟用 IP 位址模糊處理之前記錄的任何 IP 都會保留其完整詳細資料。因此,如果您的遊戲對 PII 敏感,請在推出之前設定此核取方塊。
啟用模糊處理會影響使用 IP 位址的_其他_功能。最直接受到影響的三項功能是以 IP 為基礎的地理位置、IP 封鎖,以及指定 IP 位址的玩家封鎖。
PlayFab 會在登入時自動執行以 IP 為基礎的地理位置判定。這有助於您自動判斷玩家來自世界上的哪個地方。 不過,使用模糊處理的 IP 時,您可能會遇到準確度降低的情況,_尤其_是在城市層級。這是刻意的,因為模糊處理 IP 的目標是避免記錄 PII,包括確切位置。 此外,模糊處理 IP 可能會影響 IP 封鎖。發出 IP 封鎖通常比一次封鎖一個帳戶更實際,因為不良行為者可以直接建立新帳戶。 封鎖 IP 可防止不良行為者從相同的網際網路連線建立新帳戶。在許多情況下,這是一個有效的工具。 不過,使用模糊處理的 IP 時,封鎖確切的 IP 將無法運作。相反地,您必須封鎖最後一個八位元為 .0 的 IP。請記住,這實際上會封鎖_整個 IP 範圍_。 Game Manager - IP 封鎖 - 新增封鎖 若要明確指定範圍,請輸入對等的 CIDR 範圍,而不是依賴以 .0 結尾的模糊處理位址,如下所示。這兩種封鎖在功能上是相同的。 Game Manager - IP 封鎖 - 範圍封鎖 這仍會封鎖不良行為者,但具有類似 IP 位址的其他無辜玩家可能會受到影響。此外,針對特定、未模糊處理之 IP 位址的現有封鎖將不再有效。
最後修改於 2026年10月8日