FVideoRenderingTracingInfo

视频帧渲染过程中的指标信息。

C++

USTRUCT(BlueprintType)
struct FVideoRenderingTracingInfo {
GENERATED_BODY()
public: 
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VideoRenderingTracingInfo")
int elapsedTime = 0;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VideoRenderingTracingInfo")
int start2JoinChannel = 0;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VideoRenderingTracingInfo")
int join2JoinSuccess = 0;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VideoRenderingTracingInfo")
int joinSuccess2RemoteJoined = 0;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VideoRenderingTracingInfo")
int remoteJoined2SetView = 0;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VideoRenderingTracingInfo")
int remoteJoined2UnmuteVideo = 0;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VideoRenderingTracingInfo")
int remoteJoined2PacketReceived = 0;
FVideoRenderingTracingInfo() {}
FVideoRenderingTracingInfo(const agora::rtc::VideoRenderingTracingInfo& AgoraData) {
elapsedTime = AgoraData.elapsedTime;
start2JoinChannel = AgoraData.start2JoinChannel;
join2JoinSuccess = AgoraData.join2JoinSuccess;
joinSuccess2RemoteJoined = AgoraData.joinSuccess2RemoteJoined;
remoteJoined2SetView = AgoraData.remoteJoined2SetView;
remoteJoined2UnmuteVideo = AgoraData.remoteJoined2UnmuteVideo;
remoteJoined2PacketReceived = AgoraData.remoteJoined2PacketReceived;
}
agora::rtc::VideoRenderingTracingInfo CreateAgoraData() const {
agora::rtc::VideoRenderingTracingInfo AgoraData;
AgoraData.elapsedTime = elapsedTime;
AgoraData.start2JoinChannel = start2JoinChannel;
AgoraData.join2JoinSuccess = join2JoinSuccess;
AgoraData.joinSuccess2RemoteJoined = joinSuccess2RemoteJoined;
AgoraData.remoteJoined2SetView = remoteJoined2SetView;
AgoraData.remoteJoined2UnmuteVideo = remoteJoined2UnmuteVideo;
AgoraData.remoteJoined2PacketReceived = remoteJoined2PacketReceived;
return AgoraData;
}
void FreeAgoraData(agora::rtc::VideoRenderingTracingInfo& AgoraData) const {
}
};

elapsedTime

从调用 StartMediaRenderingTracing 到触发 OnVideoRenderingTracingResult 回调的时间间隔 (ms)。建议在加入频道前调用 StartMediaRenderingTracing。

start2JoinChannel

从调用 StartMediaRenderingTracing 到调用 JoinChannelWithOptions 的时间间隔 (ms)。负数表示在调用 JoinChannelWithOptions 后调用 StartMediaRenderingTracing。

join2JoinSuccess

从调用 JoinChannel 或 JoinChannelWithOptions 到成功加入频道的时间间隔 (ms)。

joinSuccess2RemoteJoined

• 如果本地用户成功加入频道前调用 StartMediaRenderingTracing，则该值为从本地用户成功加入频道到远端用户加入频道的时间间隔 (ms)。
• 如果本地用户成功加入频道后调用 StartMediaRenderingTracing，则该值为从调用 StartMediaRenderingTracing 到远端用户加入频道的时间间隔 (ms)。

信息

• 如果本地用户在远端用户加入频道后调用 StartMediaRenderingTracing，则该值为 0，无参考意义。
• 为提升远端用户出图速度，建议远端用户加入频道中后，本地用户再加入频道，以降低该值。

remoteJoined2SetView

• 如果本地用户在远端用户加入频道前调用 StartMediaRenderingTracing，则该值为从远端用户加入频道到本地用户设置远端视图的时间间隔 (ms)。
• 如果本地用户在远端用户加入频道后调用 StartMediaRenderingTracing，则该值为从调用 StartMediaRenderingTracing 到设置远端视图的时间间隔 (ms)。

信息

• 如果本地用户在设置远端视图后再调用 StartMediaRenderingTracing，则该值为 0，无参考意义。
• 为提升远端用户出图速度，建议在远端用户加入频道之前设置远端视图，或者远端用户加入频道后立即设置远端视图，以降低该值。

remoteJoined2UnmuteVideo

• 如果本地用户在远端用户加入频道前调用 StartMediaRenderingTracing，则该值为从远端用户加入频道到订阅远端视频流的时间间隔 (ms)。
• 如果本地用户在远端用户加入频道后调用 StartMediaRenderingTracing，则该值为从调用 StartMediaRenderingTracing 到订阅远端视频流的时间间隔 (ms)。

信息

• 如果在订阅远端视频流后再调用 StartMediaRenderingTracing，则该值为 0，无参考意义。
• 为提升远端用户出图速度，建议在远端用户加入频道后，本地用户立即订阅远端视频流，以降低该值。

remoteJoined2PacketReceived

• 如果本地用户在远端用户加入频道前调用 StartMediaRenderingTracing，则该值为从远端用户加入频道到本地用户接收到首个远端数据包的时间间隔 (ms)。
• 如果本地用户在远端用户加入频道后调用 StartMediaRenderingTracing，则该值为从调用 StartMediaRenderingTracing 到接收到首个远端数据包的时间间隔 (ms)。

信息

• 如果在接收到远端视频流后再调用 StartMediaRenderingTracing，则该值为 0，无参考意义。
• 为提升远端用户出图速度，建议在远端用户加入频道后立即发布视频流，本地用户立即订阅远端视频流，以降低该值。