一、rtc_event_log 简介
在学习分析webrtc的过程中，发现其内部提供了一个实时数据捕获接口RtcEventLog。通过该接口可以实时捕获进出webrtc的RTP报文头数据、音视频配置参数、webrtc的探测数据等。其内容实现可参考RtcEventLogImpl类的定义。其文件所在路径 logging/rtc_event_log/rtc_event_log_impl.h / cc。
在android demo中也可以发现平台层api也有rtc_event_log的对应实现RtcEventLog。其使用方式代码如下
public void start(final File outputFile) {
if (state == RtcEventLogState.STARTED) {
Log.e(TAG, "RtcEventLog has already started.");
return;
}
final ParcelFileDescriptor fileDescriptor;
try {
fileDescriptor = ParcelFileDescriptor.open(outputFile,
ParcelFileDescriptor.MODE_READ_WRITE | ParcelFileDescriptor.MODE_CREATE
| ParcelFileDescriptor.MODE_TRUNCATE);
} catch (IOException e) {
Log.e(TAG, "Failed to create a new file", e);
return;
}
// Passes ownership of the file to WebRTC.
boolean success =
peerConnection.startRtcEventLog(fileDescriptor.detachFd(), OUTPUT_FILE_MAX_BYTES);
if (!success) {
Log.e(TAG, "Failed to start RTC event log.");
return;
}
state = RtcEventLogState.STARTED;
Log.d(TAG, "RtcEventLog started.");
}然而你在打开写入的log文件后，你会发现一通乱码无法阅读，那是因为webrtc内部使用protobuf协议，以二进制的格式存储这批数据。那怎么办？此时我们需要借助webrtc系统自带的工具。
二、rtc_event tools
webrtc以源码的方式提供了一系列自带的工具，其中就有 rtc_event_log_to_text 和 event_log_visualizer，我们需要先自己编译构建出来，编译前置条件请参考 探讨如何在AS上构建webrtc(1)再谈webrtc的下载&编译
gn gen out/tools --verbose \
--args='rtc_include_tests=true rtc_build_examples=false rtc_build_tools=true rtc_enable_protobuf=true treat_warnings_as_errors=false ' \
--extra-gn-switches='-v'
ninja -C out/tools编译指令如上，必须设置rtc_include_tests=true、rtc_enable_protobuf=true这两项。等构建完成后就可以在out/tools目录下找到rtc_event_log_to_text等一系列工具。之后使用命令把proto格式的log文件，转化成可以人类可阅读的txt文本。
tools/rtc_event_log_to_text event_log_20250221_0945_37.log event_log_0945_totext.txt内容格式大致如下：
还可以使用如下指令工具 event_log_visualizer 将事件日志转换成简易的图表。（需要依赖python3 pyplotlib）
tools/event_log_visualizer event_log_20250221_0945_37.log | python3三、启用消息日志
但对于初学者来说，事件日志可能难于捡取到有用的信息，常用的自定义打印跟踪日志更易于使用。那么如何开启？
对于Android平台为例，我们在全局配置PeerConnectionFactory的时候，可以向webrtc注入logger，这样就可以捕获到webrtc运行时的消息日志了。
PeerConnectionFactory.InitializationOptions initializationOptions = PeerConnectionFactory
.InitializationOptions.builder(ApplicaitonContext())
.setEnableInternalTracer(true) //启用内部跟踪器。内部跟踪器用于WebRTC组件的调试和性能分析
.setInjectableLogger(new MyInjectableLogger(), Logging.Severity.LS_INFO) //设置可注入的日志记录器
.createInitializationOptions();
PeerConnectionFactory.initialize(initializationOptions);
public class MyInjectableLogger implements Loggable {
@Override
public void onLogMessage(String msg, Logging.Severity severity, String tag) { }
}That‘s it。欢迎补充。
