Feedback (JSON)
反馈对象
Feedback 对象具有以下规范。
| 成员 | 类型 | 说明 |
|---|---|---|
| sessionRef | 对象 | 描述此反馈与之相关的 MPSD 会话的对象，或为 null。 |
| feedbackType | 字符串 | 反馈的类型。 在 Microsoft.Xbox.Services.Social.ReputationFeedbackType 中定义的可能值。 |
| textReason | 字符串 | 发件人添加的用来说明反馈提交原因的用户提供的文本。 |
| voiceReasonId | 字符串 | 发件人添加的用来解释反馈提交原因的 Kinect 中用户提供的语音文件的 ID (Base-64)。 |
| evidenceId | 字符串 | 可用作所提交反馈的证据的资源的 ID，例如，玩游戏时录制的视频文件。 |
反馈类型
“发送者”列指示谁可以提交反馈。
- “用户”表明可以由主机使用用于身份验证的 XToken 提交，因此 API 可以接受 SubmitFeedback。
- “合作伙伴”表明可以由合作伙伴使用声明证书提交，因此 API 可以接受 SubmitBatchFeedback。
- “隐私”表明只有 SLS 隐私服务可以发送反馈。
- “无”表明反馈由用于审核的 SLS 声誉服务内部生成，无法由任何调用方发送。
| 类型 | 发送者 | 说明 |
|---|---|---|
| CommsAbusiveVoice | 用户 | 用户发送反馈来报告游戏内和 Xbox 操作面板中不适宜的语音交流。 |
| CommsInappropriateVideo | 用户、合作伙伴 | 用户与合作伙伴发送反馈来报告游戏内和 Xbox 操作面板中不适宜的视频。 |
| CommsMuted | 隐私 | 当用户将其他玩家静音时，“隐私”会将此反馈发送到声誉服务。 |
| CommsPhishing | 用户 | 用户发送此反馈来报告网络钓鱼消息。 |
| CommsPictureMessage | 用户 | 收件箱服务调用声誉服务，这会根据图片通信更新发件人的声誉，并将反馈报告给执行团队。 |
| CommsSpam | 用户 | 用户发送此反馈来报告垃圾邮件。 |
| CommsTextMessage | 用户 | 收件箱服务调用声誉服务，这会更新发件人的声誉，并将反馈报告给执行团队。 注意：收件箱 UI 应该有一个允许用户标记邮件的按钮。 |
| CommsVoiceMessage | 用户 | 收件箱服务调用声誉服务，这会根据语音消息通信更新发件人的声誉，并将反馈报告给执行团队。 |
| FairPlayBlock | 隐私 | 当用户阻止另一个玩家时，“隐私”会将此反馈发送到声誉服务。 |
| FairPlayCheater | 用户、合作伙伴 | 确定用户在作弊的游戏可以发送此反馈，无需用户干预。 |
| FairPlayConsoleBanRequest | 合作伙伴 | 合作伙伴作为建议发送此反馈以从 Xbox Live 禁用主机。 |
| FairPlayIdler | 用户、合作伙伴 | 确定用户在游戏中故意空闲的游戏（通常是多轮）可以发送此反馈，无需用户干预。 |
| FairPlayKicked | 用户、合作伙伴 | 检测到用户被赶出（踢出）游戏的游戏可以发送此反馈，无需用户干预。 |
| FairPlayKillsTeammates | 用户、合作伙伴 | 可以自动确定玩家何时杀害队友的游戏可以发送此反馈，无需用户干预。 |
| FairPlayQuitter | 用户、合作伙伴 | 确定用户提前退出游戏的游戏可以发送此反馈，无需用户干预。 |
| FairPlayTampering | 用户、合作伙伴 | 确定用户使用磁盘上的内容加以篡改的游戏可以发送此反馈，无需用户干预。 |
| FairPlayUnblock | 隐私 | 当用户取消阻止另一个玩家时，“隐私”会将此反馈发送到声誉服务。 |
| FairPlayUserBanRequest | 合作伙伴 | 合作伙伴作为建议发送此反馈以从 Xbox Live 禁止用户。 |
| InternalAmbassadorScoreUpdated | 无 | 这是内部反馈类型，不适用于调用方。 |
| InternalReputationReset | 无 | 这是内部反馈类型，不适用于调用方。 |
| InternalReputationUpdated | 无 | 这是内部反馈类型，不适用于调用方。 |
| PositiveHelpfulPlayer | 用户、合作伙伴 | 用户与合作伙伴发送此反馈来在游戏、论坛内等提交帮助他人的玩家伙伴的正面信息。 |
| PositiveHighQualityUGC | 用户、合作伙伴 | 用户与合作伙伴发送此反馈来指示游戏应该允许用户在游戏内提交有关共享 UGC 的正面反馈，例如，优化 Forza 中的设置。 |
| PositiveSkilledPlayer | 用户、合作伙伴 | 用户与合作伙伴发送此反馈来指示游戏可以允许用户在 MPSD 会话结束时对 MVP 投票。 |
| UserContentGamerpic | 用户 | 用户发送此反馈来直接从玩家卡报告不适宜的玩家图片。 |
| UserContentGamertag | 用户 | 用户发送此反馈来直接从玩家卡报告不适宜的玩家代号。 |
| UserContentInappropriateUGC | 用户、合作伙伴 | 用户与合作伙伴发送此反馈来指示游戏应该允许用户在游戏内标记不适宜的共享 UGC，例如，Forza 中的绘画作业。 |
| UserContentPersonalInfo | 用户 | 用户发送此反馈来直接从玩家卡报告个人简介及其他个人信息。 |
示例 JSON 语法
{
"sessionRef": {
"scid": "372D829B-FA8E-471F-B696-07B61F09EC20",
"templateName": "CaptureFlag5",
"name": "Halo556932",
},
"feedbackType": "CommsAbusiveVoice",
"textReason": "He called me a doodoo-head!",
"voiceReasonId": null,
"evidenceId": null
}