故障排除.md

一、问题排查

1.卡顿问题

云渲染SDK导致卡顿问题的常见原因是网络问题。 要确认卡顿是否由网络原因引起，可以通过监听TcrSession.Observer#onEvent()接口的TcrSession.Event.CLIENT_STATS事件来获取运行时的性能指标。

StatsInfo对象的rtt字段表示SDK内部心跳发送到服务端并收到响应的往返时间。通常，合理的rtt范围在10到50之间。如果rtt值明显增大（例如超过200），表示网络出现波动。 StatsInfo对象的packetLost字段表示SDK接收的视频包丢失的累计值。当该值持续增长时，意味着网络非常糟糕，用户可能会看到明显的卡顿或画面卡住的情况。

如果在某次运行过程中，rtt明显增大且packetLost也相应增加，表示当前网络环境较差。客户端可以监听这种情况并向用户提供相应提示，另外也建议客户端上报这些数据，并以图标形式展示。 除此之外，您还可以在腾讯云控制台查询本次链接sdk上报的一些数据，例如rtt、fps等性能信息。

2.应用闪退/未响应问题

可在腾讯云控制台配置应用日志上传路径，配置后云渲染将会上传应用日志到cos桶中，便于应用/游戏开发者定位游戏问题。

二、问题反馈

若您无法通过以上手段自行排查问题，请将问题反馈给云渲染团队。为了更好地帮助您解决问题，我们需要您提供以下信息：

1.崩溃问题

当云渲染SDK在您的产品中运行出现崩溃时，我们需要提供以下信息。

崩溃环境：请提供您接入的云渲染SDK版本、设备型号、Android系统版本

问题描述：请尽可能详细地描述崩溃发生场景，包括崩溃时机以及崩溃前的现象。

日志文件：您需要提前在应用中通过TcrSdk.getInstance().setLogger监听SDK的日志回调，并将运行过程中的日志存储起来(或打印到logcat中, 但请确保崩溃发送后能够获取到logcat日志)

崩溃信息：您需要将运行过程中的崩溃信息反馈给我们，包括Java层的崩溃堆栈、异常类型和描述，或者C++层的崩溃堆栈、错误类型(SIGSEGV、SIGABRT)等

复现步骤：如果您能提供复现问题的具体步骤，那将非常有助于我们重现并解决问题。