> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 從遊戲傳送信譽意見反應

> 您的遊戲如何向 XBOX Live 信譽服務提交玩家意見反應，包括意見反應類型、API 呼叫和回報的最佳做法。

<a id="top" />

本主題說明如何透過將玩家意見反應傳送至信譽服務，來促進正面的玩家體驗。

大多數 XBOX Live 成員都能愉快地一起遊玩，但有一小部分有問題的成員會破壞其他成員的遊戲體驗。
我們會透過玩家和遊戲的意見反應來找出這些有問題的成員。
我們會確保這些成員只能擁有受限的多人遊戲體驗，讓他們無法干擾遵守規範之玩家的遊戲，藉此協助保護其餘的 XBOX Live 遊戲族群。

XBOX Live 在很大程度上依賴玩家檢舉其他玩家，以維持系統的準確性。不過，遊戲可以直接參與檢舉，並大幅協助提升玩家信譽族群的準確性。

本主題涵蓋下列內容：

* [從遊戲或遊戲服務提交意見反應的步驟](#stsfftots)
* [合作夥伴意見反應使用案例範例](#epfus)
* [完整的行為意見反應選項](#cbfo)
* [意見反應 API 呼叫](#fac)
* [意見反應物件](#fo)
* [意見反應問與答](#fqaa)

<a id="stsfftots" />

## 從遊戲或遊戲服務提交意見反應的步驟

1. 將意見反應時機 (傳達違規時間) 新增至遊戲或遊戲服務。
2. 判斷正確的意見反應類型。
3. 以意見反應呼叫信譽意見反應 API。

### 將意見反應時機新增至遊戲或遊戲服務

玩家可能會因為破壞己方的隊友、什麼都不做而不積極遊玩的玩家，或破壞遊戲的作弊者而有不好的體驗。
XBOX Live 可讓玩家直接檢舉這些有問題的玩家。不過，使用者意見反應並不完美。

遊戲可以輕鬆判斷一些簡單的情況，例如玩家在遊戲中閒置和提早退出。遊戲有時可以判斷玩家何時在作弊。
您的遊戲可以在各式各樣的意見反應時機提交意見反應，這有助於改善所有遵守規範之玩家的體驗。

### 判斷正確的意見反應類型

信譽服務有許多意見反應類型，可擷取玩家可能需要意見反應的各種方式。
如需詳細資訊，請參閱下表。
大多數意見反應類型都是負面的，但也可以透過正面意見反應來提升玩家的信譽。

XBOX 系統 UI 提供一種方式，讓玩家在遊戲中提交對其他玩家的意見反應。
這種玩家對玩家的意見反應權重不高，因為有些玩家在輸掉時容易互相惡意騷擾。

遊戲可以補充此系統 UI，提供讓玩家直接提交對其他玩家之意見反應的 UI。我們偏好遊戲使用合作夥伴意見反應，以遊戲本身的名義提交意見反應，因為它的可信度很高。

[返回本主題頂端。](#top)

<a id="epfus" />

## 合作夥伴意見反應使用案例範例

### 玩家在比賽中途退出遊戲

一位玩家在遊戲中落敗，並使用遊戲選單退出遊戲，拋棄了他的隊友。
當遊戲偵測到此行為時，可以使用 `FairPlayQuitter` 來回報此行為。

### 找到比賽後在遊戲中閒置

一位玩家與其他玩家配對進行遊戲，但在遊戲中一直閒置不動，而不是協助團隊。
遊戲可以使用 `FairPlayIdler` 來回報此玩家行為。

### 在遊戲中擊殺隊友

遊戲中的一位玩家為了好玩而不斷擊殺隊友。
當遊戲偵測到某位玩家持續擊殺隊友時，可以使用 `FairPlayKillsTeammates` 來檢舉該玩家。

### 遊戲具有社群踢除/投票功能

一位玩家因不良行為而被該回合的玩家投票從工作階段中移除。
如果遊戲將此玩家從工作階段中移除，可以使用 `FairPlayKicked` 來檢舉他。

### 熱心玩家社群投票

在幾回合的遊戲之後，遊戲提供一個選項，讓玩家選出對團隊幫助最大的玩家。
當遊戲偵測到此動作時，可以使用 `PositiveHelpfulPlayer` 來回報此行為。

### 高品質的使用者產生內容 (UGC)

遊戲有一個場景，玩家可以在其中選出最佳的車輛設計。
當遊戲偵測到此動作時，可以使用 `PositiveHighQualityUGC` 來回報此行為。

### 技術高超的玩家

在幾回合的遊戲之後，遊戲提供一個選項來選出 MVP (最佳玩家)。
當遊戲偵測到某位玩家持續獲得 MVP 身分時，可以使用 `PositiveSkilledPlayer` 來回報此行為。

### 玩家檢舉遊戲中有問題的 UGC

遊戲有一個場景，玩家可以在其中檢視車輛設計。
一位玩家注意到一個冒犯性的設計，並想要檢舉它。
當遊戲偵測到此動作時，可以使用 `UserContentInappropriateUGC` 來檢舉違規者。

### 遊戲想要要求對某位玩家進行 XBOX Live 停權審查

遊戲的社群管理員注意到一位低信譽的玩家持續在遊戲中製造麻煩。
遊戲可以使用 `FairPlayUserBanRequest` 要求 XBOX Family, Trust, and Safety (XFTS) 進行審查。

[返回本主題頂端。](#top)

<a id="cbfo" />

## 完整的行為意見反應選項

下表說明以您遊戲的名義提交玩家意見反應時可使用的意見反應類型。

信譽服務相當有彈性，如果您認為下列類型不符合遊戲的需求，可以輕鬆新增意見反應類型。
若要新增意見反應類型，請連絡您的客戶經理。

| **公平遊戲意見反應類型** | **描述** |
| - | - |
| `FairPlayKillsTeammates` | 檢舉故意擊殺自己隊友的玩家。 |
| `FairPlayCheater` | 檢舉確定在作弊的玩家。 |
| `FairPlayTampering` | 檢舉確定竄改過遊戲光碟，或以其他方式竄改過遊戲軟體或硬體的玩家。 |
| `FairPlayUserBanRequest` | 檢舉您認為應受到停權處分的玩家。 |
| `FairPlayConsoleBanRequest` | 檢舉您認為應禁止連線至 XBOX Live 的主機。 |
| `FairPlayUnsporting` | 檢舉確定有違反運動精神行為的玩家。 |
| `FairPlayIdler` | 檢舉進入多人遊戲比賽但未積極遊玩的玩家。 |
| `FairPlayLeaderboardCheater` | 檢舉確定為了在排行榜上名列前茅而作弊的玩家。 |
| **通訊意見反應類型** | **描述** |
| `CommsInappropriateVideo` | 檢舉在視訊聊天中有不當行為的玩家。 |
| **UCG 意見反應類型** | **描述** |
| `UserContentInappropriateUGC` | 檢舉玩家在您的遊戲中建立的不當內容。 |
| `UserContentReviewRequest` | 主動檢舉某項內容，讓 XFTS 可以進行審查。 |
| `UserContentReviewRequestBroadcast` | 主動檢舉某個廣播，讓 XFTS 可以進行審查。 |
| `UserContentReviewRequestGameDVR` | 主動檢舉某個 Game DVR 短片，讓 XFTS 可以進行審查 |
| `UserContentReviewRequestScreenshot` | 主動檢舉某個螢幕擷取畫面，讓 XFTS 可以進行審查。 |
| **正面意見反應類型** | **描述** |
| `PositiveSkilledPlayer` | 如果玩家可以投票選出 MVP，當您確定某位玩家值得正面意見反應時，請回報該技術高超的玩家。 |
| `PositiveHelpfulPlayer` | 如果遊戲提供 UI 讓玩家回報另一位玩家很熱心，請回報該熱心的玩家。 |
| `PositiveHighQualityUGC` | 如果遊戲提供 UI 讓玩家稱讚另一位玩家的內容，請正面回報該內容。 |

[返回本主題頂端。](#top)

<a id="fac" />

## 意見反應 API 呼叫

遊戲可以使用兩種策略來呼叫信譽服務。

* 使用服務權杖進行驗證，從合作夥伴服務彙總檢舉玩家 (建議)。
* 直接從用戶端檢舉玩家。

用戶端 API 具有內建的反詐騙技術。需要對同一位玩家有多份檢舉，才會被視為有效。

這兩個 API 都是批次處理的，可以同時檢舉多位玩家。

遊戲可以使用下列 XBOX Live API 來提交玩家信譽意見反應。

| 語言 | API |
| - | - |
| C | `XblSocialSubmitBatchReputationFeedbackAsync` |
| C++ | `xbox::services::social::reputation_service.submit_batch_reputation_feedback(...)` |

或者，遊戲可以使用下列直接 REST 方法。

| API | URL | 驗證需求 |
| - | - | - |
| 服務 `POST` | `https://reputation.xboxlive.com/users/batchfeedback` | 具有合作夥伴和沙箱宣告的 `S-token` |
| 用戶端 `POST` | `https://reputation.xboxlive.com/users/batchtitlefeedback` | 具有遊戲和沙箱宣告的 `Xtoken` |

[返回本主題頂端。](#top)

<a id="fo" />

## 意見反應物件

`Feedback` 物件在最新版本 (101) 中具有下列規格。
這兩個 API 都預期接收下列物件的批次。

| 成員 | 類型 | 描述 |
| - | - | - |
| `sessionRef` | Object | 描述此意見反應相關之多人遊戲工作階段目錄 (MPSD) 工作階段的物件，或 `null`。 |
| `feedbackType` | String | 意見反應的類型。可能的值定義於 `ReputationFeedbackType` 列舉中。 |
| `textReason` | String | 傳送者新增的玩家提供文字，用以說明提交意見反應的原因。此文字對 XFTS 非常有價值。 |
| `evidenceId` | String | 可作為所提交意見反應之證據的資源識別碼。例如，在遊戲過程中錄製的影片檔案或活動摘要項目。 |
| `titleID` | String | 所玩遊戲的遊戲識別碼。只有在權杖中沒有此識別碼時才需要。 |
| `targetXuid` | String | 您要檢舉之玩家的 XUID。 |

下列範例程式碼示範 `FairPlayKillsTeammates` 的用法。

```json theme={null}
POST https://reputation.xboxlive.com/users/batchtitlefeedback
{
    "items" :
    [
        {
            "targetXuid": "33445566778899",
            "titleId" : null,
            "sessionRef": {
  "scid": "372D829B-FA8E-471F-B696-07B61F09EC20",
  "templateName": "CaptureFlag5",
  "name": "Title56932",
           },
            "feedbackType": "FairPlayKillsTeammates",
            "textReason": "Title detected this player killing team members 19 times",
            "evidenceId": null
        }
    ]
}
```

[返回本主題頂端。](#top)

<a id="fqaa" />

## 意見反應問與答

### 問：我可以傳送提示給系統，以協助可能正在查看玩家檢舉的人員嗎？

\*\*答：\*\*可以。這些提示非常有幫助。使用 `textReason` 參數來協助 XFTS。它會查看所提交的意見反應。例如，對於閒置者，您可以新增文字原因，例如：「在遊戲開始的前五秒之後，我們沒有收到此玩家的任何使用者輸入。」

此文字原因對 XFTS 很有價值。請確保文字原因有幫助且具描述性。

### 問：我應該考慮針對某位玩家傳送意見反應的頻率嗎？

\*\*答：\*\*不需要。當遊戲確信某位玩家應該獲得意見反應時，就應該呼叫信譽服務。
此服務有數個安全系統，可防止遊戲和玩家過度影響其他玩家。

### 問：我可以調整所傳送意見反應的權重嗎？

\*\*答：\*\*不可以。信譽服務會決定意見反應的權重。
我們會持續調整權重，以改善評分的公平性。

### 問：我可以復原已針對某位玩家傳送的意見反應嗎？

\*\*答：\*\*不可以。意見反應是最終的。
如果您認為您的遊戲有錯誤並傳送了錯誤的意見反應，請告訴我們。我們會封鎖您的遊戲，直到您修正錯誤為止。

### 問：我可以看到玩家針對我的遊戲傳送的意見反應嗎？

\*\*答：\*\*可以。目前，您無法自行檢視此資訊。
若要查看意見反應，請連絡您的客戶經理。我們有每個遊戲的資料可以分享。

### 問：當我提交主機或玩家停權審查要求時，如何得知結果？

\*\*答：\*\*目前，審查的資訊會傳送給 XFTS，但您不會收到停權審查的更新。

### 問：每個遊戲都有信譽分數嗎？

\*\*答：\*\*沒有。
目前，信譽有公平遊戲、通訊和 UGC 的子分數，但沒有每個遊戲的分數。

[返回本主題頂端。](#top)


## Related topics

- [信譽概觀](/zh-TW/services/xbox-services/community/reputation/live-reputation-overview.md)
- [信譽概念](/zh-TW/services/xbox-services/community/reputation/concepts/live-reputation-concepts-nav.md)
- [概念](/zh-TW/services/xbox-services/community/reputation/concepts/index.md)
- [提交信譽意見反應](/zh-TW/services/xbox-services/community/reputation/how-to/live-submitting-reputation-feedback.md)
- [信譽範例程式碼](/zh-TW/services/xbox-services/community/reputation/how-to/live-reputation-howto-nav.md)