玩家禁止系統 - XBOX Game Development Documentation

玩家禁止功能可讓您限制某些違反規則的玩家存取遊戲。對玩家套用玩家禁止後，任何現有的玩家驗證權杖都會失效，且該玩家未來的驗證嘗試都會遭到拒絕。玩家禁止可以是永久的，也可以是指定時間範圍內的暫時禁止，並可套用至玩家識別碼或 IP 位址。禁止的範圍限定於單一遊戲，不適用於您命名空間中的任何其他遊戲。

對於新的整合，我們建議使用專用的 IP 禁止系統，而不是在玩家禁止中指定 IP 位址。

下列教學課程示範如何使用 PlayFab API 和 Game Manager 來運用禁止系統。

識別

雖然您的遊戲可能有自訂系統來識別作弊者和違規者，但 PlayFab 提供了玩家對玩家的檢舉機制。基本上，您依賴玩家來檢舉其他有問題的玩家。若要讓用戶端檢舉特定玩家，請在用戶端程式碼中使用下列程式碼片段。

public void ReportPlayer(string problematicPlayerId, string reason) {
    PlayFabClientAPI.ReportPlayer(new ReportPlayerClientRequest() {
        ReporteeId = problematicPlayerId,
        Comment = reason
    }, result => {
        //... Handle success
    }, error => {
        Debug.Log(error.GenerateErrorReport());
    });
}

此 API 呼叫會產生：

一個檢舉事件，您可以透過 Analytics 工具 (1) 找到它。
選取 player_reported_as_abusive 事件類型 (2)。
這會顯示：
- 事件名稱 (3)。
- 被檢舉的玩家識別碼 (4)。

套用禁止

識別出有問題的玩家後，您可以套用禁止。有兩種方式可以套用禁止：透過 Game Manager 手動套用，或透過程式碼以程式設計方式套用。

從 Game Manager 建立禁止

您的社群管理代表可能想要使用 Game Manager 套用禁止。

瀏覽至 Players 區段。
找到並選取有問題的玩家。
瀏覽至 Bans 索引標籤。
選取 Add Ban 以顯示 Add Ban 表單。
輸入禁止的 Reason 和所需的持續時間。您也可以選擇依特定 IP ADDRESS (4) 進行 Ban。
最後，選取 ADD BAN 按鈕。

如果一切設定正確，您會在表格中看到新的 Ban。您可以選擇在 REVOKE BANS 欄位中選取 Ban 來手動移除它。

從伺服器或服務建立禁止

或者，您可以使用下方提供的程式碼片段，透過 Services SDK 以程式碼套用禁止。

public void AddBan(string playerId, uint hours) {
    PlayFabServerAPI.BanUsers(new BanUsersRequest() {
        Bans = new List<BanRequest>() {
            new BanRequest() {
                DurationInHours = hours,
                PlayFabId = playerId,
                Reason = "Automatic ban for WH",
            }
        }
    }, result => {
        //... Handle success
    }, error => {
        Debug.Log(error.GenerateErrorReport());
    });
}

透過程式碼套用的禁止也會顯示在 Game Manager 中目標玩家的禁止表格中。

PlayFab 伺服器 SDK 方法提供更多選項，例如 IP 位址禁止。

您套用的每個禁止都會獲得一個指派的識別碼。請考慮使用下列伺服器 SDK API 方法進行精確的禁止管理：

您可以將 CloudScript 函式作為可能禁止玩家之自動化系統的一部分。若要深入了解 CloudScript，請參閱我們的教學課程撰寫自訂 CloudScript。

另請參閱

BanUsers

​識別

​套用禁止

​從 Game Manager 建立禁止

​從伺服器或服務建立禁止

​另請參閱

識別

套用禁止

從 Game Manager 建立禁止

從伺服器或服務建立禁止

另請參閱