了解用户报告

在您设置用户报告后,用户报告将显示在 Unity 仪表盘上。如果它们没有显示,请验证您的报告大小是否未超过 10MB。

查看用户报告

  1. 使用您的 Unity ID 登录Unity 仪表盘
  2. 选择相关项目。
  3. 从主菜单中选择 + 按钮,然后转到 云诊断 > 用户报告
  4. 选择一个报告以查看其详细信息。

用户报告页面显示您收到的报告。选择一个用户报告以打开其详细信息。

您可以使用 维度 下拉菜单过滤报告。要应用过滤器,请选择 应用。要删除任何报告过滤器,请选择 清除。有关创建自定义维度的更多信息,请参阅配置用户报告

用户报告页面的顶部根据您的 Unity 计划显示您当前的报告限制和使用情况。要增加您的报告计数限制和使用情况,请升级到使用 Unity Pro 或更高版本的 Advanced Cloud Diagnostics

了解用户报告详细信息

从用户报告页面选择用户报告卡以打开其详细信息。

后续页面将显示所选报告的详细数据。页面顶部显示收到报告的日期和摘要描述。

要删除或下载报告,请使用 报告操作 下拉菜单。

用户报告详细信息页面还包括数据,例如指标、屏幕截图、字段、设备元数据和事件

  • 指标:报告的指标部分显示了收集指标的帧号范围、指标的平均值以及特定指标的值范围。
  • 屏幕截图:此部分包含与报告一起提交的任何屏幕截图。选择图像以更详细地查看屏幕截图。
  • 字段:此部分显示与报告一起提交的任何用户定义的维度-值字段。
  • 附件:此部分包含与报告一起提交的任何附件。要下载附件,请选择下载图标或附件名称。
  • 元数据:此部分提供有关生成报告的设备和应用程序的详细信息,包括您可能添加的任何自定义元数据。
  • 事件:此部分显示控制台日志消息或开发人员手动提供的消息。事件条目包含
    • 事件:发生的事件的摘要。
    • :发生事件的帧。
    • 日期和时间:发生事件的日期和时间。
    • 状态:事件状态。不同的状态包括信息性(蓝色圆圈)、成功(绿色圆圈)、警告(黄色三角形带感叹号)和错误(红色圆圈带感叹号)。

从未处理的异常发送用户报告

注意:虽然这种方法是可行的,但强烈建议您使用 Cloud Diagnostics 的崩溃和异常报告功能来处理未处理的异常。此功能提供未处理异常的完整堆栈跟踪、事件的日志以及跟踪发生情况和发现模式,这些模式在 Unity仪表盘中可见。崩溃和异常报告会汇总崩溃和异常报告。

当出现未处理的异常时,您可以发送用户报告,以获取日志文件和更多有用的数据。

将以下脚本添加到用户报告包的示例场景中

void OnEnable()
{
    Application.logMessageReceived += UhandledExceptionCallback;
}
 
void OnDisable()
{
    Application.logMessageReceived -= UnhandledExceptionCallback;
}
 
void UnhandledExceptionCallback(string condition, string stackTrace, LogType type)
{
    if (type == LogType.Exception)
    {
         // Insert your desired behavior here, such as creating and sending a user report.
    }
}

这种方法来自 Application.logMessageReceived C# 事件,该事件在许多情况下触发,包括未处理的异常。通过检查消息的 LogType 是否为 Exception,代码仅在发生未处理的异常时执行。请注意,出于性能考虑,在响应不再需要时,请从事件中删除您的回调。