1# 帧渲染数据解析的逻辑 2帧的解析分为应用帧的解析和渲染帧的业务解析。 3## 应用帧 4应用帧解析主要是进行应用帧业务的开始和结束，并对其帧编号进行记录，以便在RS的业务中进行匹配（RenderService简称为RS）。 5### 主线程应用帧 6主线程应用帧包含以下调用栈： 7H:ReceiveVsync 8H:OnVsyncEvent 9H:MarshRSTransactionData 10H:ReceiveVsync包含H:OnVsyncEvent, H:OnVsyncEvent包含H:MarshRSTransactionData. 11特别地，当一个栈没有H:MarshRSTransactionData事件时，是无效的帧。 12H:MarshRSTransactionData内会包含线程号和应用的帧标号。 例如： H:MarshRSTransactionData cmdCount:3 transactionFlag:[32402,146] 13### 非主线程应用帧 14非主线程应用帧包含以下调用栈 15H:UV_TRACE 16H:OnVsyncEvent 17H:UIVsyncTask[timestamps:time][vsyncID:xxx][instanceID:xxx] 18H:MarshRSTransactionData 19与主线程相似，如果没有H:MarshRSTransactionData事件则认为是无效帧。 20 21## 渲染帧 22渲染帧会有下面一些调用栈： 23H:ReceiveVsync 24H:RSMainThread::DoComposition 25H:RSMainThread::ProcessCommandUni 26H:ReceiveVsync包含H:RSMainThread::DoComposition, H:RSMainThread::DoComposition包含H:RSMainThread::ProcessCommandUni. 27特别地：当渲染帧不包含H:RSMainThread::ProcessCommandUni时，为无效的渲染帧。 28H:RSMainThread::ProcessCommandUni内包含被渲染帧所属的线程号和帧编号。例如： H:RSMainThread::ProcessCommandUni [32402,146] 29## 应用帧和渲染帧关联 30应用帧和渲染帧通过H:MarshRSTransactionData和H:RSMainThread::ProcessCommandUni事件挟带的[tid, id]关联。 31## 应用帧数据计算 32expect: 开始时间为应用帧H:ReceiveVsync事件中now字段指定的时间， 结束时间为end字段指定的时间。 33 需要注意这里的now和end指定的时间并非boottime，需要经过时钟同步后使用。 在文本格式的数据中无时钟源信息，所以无法进行时钟同步。进而导致文本和htrace解析结果不一致。 非主线程没有expect数据, 只有actural数据。 34actural: 开始时间为应用帧H:ReceiveVsync/H:UV_TRACE事件B子事件发生时间，结束时间为应用帧H:OnVsyncEvent事件E子事件发生时间。 35## 渲染帧数据计算 36expect: 开始时间为渲染帧H:ReceiveVsync事件中now字段指定的时间， 结束时间为end字段指定的时间。 37 需要注意这里的now和end指定的时间并非boottime，需要经过时钟同步后使用。 在文本格式的数据中无时钟源信息，所以无法进行时钟同步。进而导致文本和htrace解析结果不一致。 38actural: 开始时间为渲染帧H:ReceiveVsync事件B子事件发生时间，结束时间为渲染帧H:ReceiveVsync事件E子事件发生时间。 39## FrameTimeline的数据计算 40expect: 开始时间为应用帧expect的开始时间， 结束时间为渲染帧expect的结束时间。 41actrual: 开始时间为应用帧H:ReceiveVsync事件B子事件发生时间，结束时间为渲染帧H:ReceiveVsync事件E子事件发生时间。 42## GPU渲染时长 43和渲染帧同步并发的，是渲染线程的gpu信息，在事件中是H:M: Frame queued事件。 44只有当H:M: Frame queued事件的开始时间在渲染帧的H:ReceiveVsync时间的开始到结束的时间范围时，将该H:M: Frame queued事件和H:ReceiveVsync做关联，两者构成一个完整的渲染事件（也可能没有H:M: Frame queued事件）。 45而应用的渲染帧编号，和渲染线程中H:RSMainThread::ProcessCommandUni事件所携带的被渲染的帧编号，所属的线程号关联之后，形成应用帧的一个完整渲染事件。 46## 关于帧卡顿的定义 47关于帧卡顿的定义：帧的实际渲染时间晚于期望被渲染的时间，认为帧卡顿。数据库中标识为1，否则为0。 48期望帧不做任何标识，为默认的255(max u8)，导出db时为空。 49特别地：以上事件发出的线程，必须是进程中的主线程，即线程号和进程号一致，否则，不做处理。 50另外，|渲染帧actural开始时间 - 应用帧actural结束时间| > 1ms时， 认为渲染状态异常。 数据库中标识为3. 51## 关于无效帧的定义 52如果应用帧不包含FrameNum，则其为无效帧。 53无效帧的标识为2。 54当帧为无效帧时，会同时标识其实际帧和期望帧为无效帧。