Loading [MathJax]/jax/output/CommonHTML/config.js
首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >移动直播、实时音视频、即时通信终端sdk日志输出配置

移动直播、实时音视频、即时通信终端sdk日志输出配置

原创
作者头像
腾讯云-chaoli
修改于 2025-09-09 10:06:41
修改于 2025-09-09 10:06:41
75.3K15
举报

一、概述

在音视频产品及即时通信(IM)的开发与运维过程中,SDK 运行日志是定位和解决问题的关键依据。本文详细介绍了腾讯云相关 SDK 的默认日志存储路径、配置方法、日志获取策略及 Crash 排查方案,适用于移动直播、短视频、播放器、实时音视频(LiteAVSDK)、即时通信(IMSDK)等产品线的终端开发场景。

二、本地日志存储路径

各 SDK 在不同平台的默认日志存储路径如下表所示,支持自定义路径、日志等级过滤及关闭日志输出功能。

SDK

产品线

平台

日志路径

LiteAVSDK

iOS&Mac

Sandbox 路径:Documents/log

Android

- 8.5 及以上版本: /sdcard/Android/data/包名/files/log/liteav/LiteAV_日期.xlog - 6.8~~~8.4 版本: /sdcard/Android/data/包名/files/log/tencent/liteav/LiteAV_日期.xlog - 6.7 以前版本: /sdcard/log/tencent/liteav/*.xlog

Windows

- 8.8 及以上版本: C:\Users{userId}\AppData\Roaming\liteav\log - 8.7 以前版本: C:\Users\{userId}\AppData\Roaming\tencent\liteav\log

Web&小程序

Web:浏览器控制台或 vConsole 小程序:启用<debug>标签并通过 vConsole 记录 小程序线上问题: iOS / Android: 微信主界面 -【我】-【设置】-【帮助与反馈】-右上角【🔧】图标-【上传日志】,日期选择前面所填的【发生问题的时间】 Windows: 无 macOS: 微信主界面 - 会话列表上方的搜索框 - 输入:up(包含冒号),日期选择前面所填的【发生问题的时间】 上传日志后,提供如下信息给腾讯技术员 微信号:xxxx 出现问题时间点(非上传日志时间点):xxx

Flutter

日志路径与上述Native端相同

HarmonyOS

/data/app/el2/100/base/包名/haps/模块名/files/*.clog(需切换到沙箱视图)

IMSDK

iOS&Mac

App 目录:Library/Caches/imsdk_C_日期.xlog

Android

- 4.8.50 及以上版本: /sdcard/Android/data/包名/files/log/tencent/imsdk/imsdk_日期.xlog - 4.8.10 以前版本: /sdcard/tencent/imsdklogs/包名/*.log

Windows

.exe文件同级目录

Web&小程序

Web:浏览器控制台或 vConsole 小程序:vConsole 记录

Flutter

日志路径与上述Native端相同

HarmonyOS

/data/app/el2/100/base/包名/cache/imsdk_C_yyyymmdd.xlog(需切换到沙箱视图)

代码语言:txt
AI代码解释
复制
TRTCSDK的native端的日志文件,名称是:TRTC_日期
9.9版本后LiteAVSDK所有产品线的日志后缀,由xlog变成clog

三、日志配置方法

通过 SDK 提供的 API 可灵活调整日志输出等级(最高等级可关闭日志)和存储路径,以下为关键平台的配置示例:

SDK

产品线

平台

修改

LiteAVSDK

直播 短视频 播放器 视立方

iOS&Mac

//设置日志输出等级,最高级可关闭 [TXLiveBase setLogLevel:LOGLEVEL_DEBUG];

安卓

//设置日志输出等级,,最高级可关闭TXLiveBase.setLogLevel(TXLiveConstants.LOG_LEVEL_DEBUG);

TRTC

iOS&Mac

//设置输出 Log 级别,最高级可关闭 [TRTCCloud setLogLevel:TRTCLogLevelDebug]; //修改日志路径 [TRTCCloud setLogDirPath:自定义路径];

安卓

//设置输出 Log 级别,最高级可关闭trtcCloud.setLogLevel(TRTCCloudDef.TRTC_LOG_LEVEL_DEBUG); //修改日志路径 trtcCloud.setLogDirPath(自定义路径);

Windows

//设置输出 Log 级别,最高级可关闭 getTRTCCloud()->setLogLevel(TRTC_LOG_LEVEL_DEBUG); //修改日志路径 getTRTCCloud()->setLogDirPath(自定义路径);

IMSDK

IM

iOS&Mac

//本地写 log 文件的等级,最高级可关闭 TIMSdkConfig *config = [[TIMSdkConfig alloc] init]; config.logLevel = TIMLogLevelDebug; //修改log文件路径,不设置时为默认路径 config.logPath = 自定义路径;

安卓

//设置写日志等级,最高级可关闭 TIMSdkConfig config = new TIMSdkConfig(); config.setLogLevel(TIMLogLevel.TIM_LOG_LEVEL_DEBUG); //设置日志路径,不设置时为默认路径 config.setLogPath(自定义路径);

Windows

static const char* kLogPathKey = "sdk_config_log_file_path"; Json::Value jsonConfig; jsonConfig[kLogPathKey] = path; std::string jsonStr = jsonConfig.toStyledString(); TIMInit(sdk_app_id, jsonStr.c_str());

四、日志获取与管理策略

(一)常规日志获取

  • 线上环境:建议在代码中集成日志上传功能,将本地日志实时同步至自有服务器,便于远程问题排查。
  • 开发阶段:可引导用户通过 USB 连接开发工具(如 Android Studio),通过logcat命令导出日志,或使用文件管理器手动提取日志文件。提取手机本地文件,参考这里:安卓iOS

(二)LiteAVSDK 日志生成规则

  • 存储限制:单个日志目录最大占用 200MB 空间,超出后自动删除最早的日志文件。
  • 时间保留:仅保留最近 10 天的日志,过期文件将被自动清理。

(三)Crash 日志排查

当发生 Crash 时,需结合堆栈信息定位问题,支持以下两种方案:

  1. 手动复现法 通过开发工具连接设备,复现 Crash 场景,从logcatAndroid)或 Xcode 控制台(iOS)中提取完整堆栈日志,保存为 TXT 文件后提交给腾讯云技术支持。提取崩溃堆栈操作,参考这里:安卓iOS
  2. 云端上报法 集成第三方 Crash 监控工具(如腾讯 Bugly),自动捕获堆栈信息并生成报表:
    • 登录 Bugly 后台,添加腾讯支持人员 QQ 号(204356973、3531448318)至查看权限列表。
    • 将 Crash 详情页链接发送给技术支持,支持人员可通过 QQ 号登录查看详细信息(推荐此方案,信息更全面)。

五、SDK 版本号查询

排查问题时需同步确认 SDK 版本,各平台获取版本号的 API 如下:

sdk

平台

api

LiteAVSDK

安卓

TXLiveBase.getSDKVersionStr();

iOS/Mac

[TXLiveBase getSDKVersionStr]

小程序

查看微信版本(音视频组件版本随微信版本发布)

webrtc

查看引入的trtc-js-sdk文件版本

windows

ITRTCCloud.getTRTCShareInstance().getSDKVersion();

IMSDK

安卓

TIMManager.getInstance().getVersion();

ios/mac

[TIMManager sharedInstance].getVersion;

小程序/webim

查看引入tim-js-sdk文件版本

windows

TIMGetSDKVersion();

六、附录

LiteAVSDK -> 安卓 -> log相关api文档;

LiteAVSDK -> ios&Mac -> log相关api文档;

IMSDK -> 安卓 -> log相关api文档;

IMSDK -> ios&Mac -> log相关文档:

TRTC日志打印类似于LiteAVSDK,参考《腾讯实时音视频(TRTC)如何打印日志》

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
15 条评论
热度
最新
文章中部分内容未更新,请各位开发者按照腾讯云IM官网文档指引操作:https://cloud.tencent.com/document/product/269/75291?from_wecom=1
文章中部分内容未更新,请各位开发者按照腾讯云IM官网文档指引操作:https://cloud.tencent.com/document/product/269/75291?from_wecom=1
回复回复2举报
新版本的解压缩工具链接挂了
新版本的解压缩工具链接挂了
回复回复点赞举报
clog解压缩工具又不能下载了,求上新
clog解压缩工具又不能下载了,求上新
22点赞举报
https://cloud.tencent.com/developer/article/2079442
https://cloud.tencent.com/developer/article/2079442
回复回复点赞举报
已更新,谢谢反馈
已更新,谢谢反馈
回复回复点赞举报
clog解压缩工具链接下载不了
clog解压缩工具链接下载不了
22点赞举报
https://cloud.tencent.com/developer/article/2079442
https://cloud.tencent.com/developer/article/2079442
回复回复点赞举报
已更新,谢谢反馈
已更新,谢谢反馈
回复回复点赞举报
TRTC的日志现在是clog扩展名不是xlog扩展名了,提供的工具已经不适用的样子
TRTC的日志现在是clog扩展名不是xlog扩展名了,提供的工具已经不适用的样子
22点赞举报
是的,最新的clog文件
是的,最新的clog文件
回复回复点赞举报
文档已更新
文档已更新
回复回复点赞举报
IM解析日志脚本无法正常下载
IM解析日志脚本无法正常下载
11点赞举报
好的,地址过期了,已更新下载地址。
好的,地址过期了,已更新下载地址。
回复回复点赞举报
所以呢?真机调试的时候,怎么导出日志
所以呢?真机调试的时候,怎么导出日志
11点赞举报
是啊,我也想知道
是啊,我也想知道
回复回复点赞举报
推荐阅读
编辑精选文章
换一批
TRTC/MLVB/IM案例:SDK用户日志提取与管理的一种实现方案
音视频SDK(实时音视频TRTC/移动直播MLVB)、即时通信SDK都有默认把sdk运行的log输出到本地文件。本地文件详细记录了SDK各模块的操作和质量信息,在遇到问题需要分析,很多时候需要获取本地日志文件配合问题定位。但是,往往位于用户手机本地的文件,受限于用户的it知识,很难从手机里取出来并发送给运营人员。因此本文提供一种参考方案,供用户方便上传日志文件。
singleli
2020/10/25
1.8K0
TRTC/MLVB/IM案例:SDK用户日志提取与管理的一种实现方案
腾讯实时音视频(TRTC)如何打印日志
如果您产品已经上线了,线上用户反馈出现问题,开发者跟用户获取 SDK 输出到本地设备的日志,然后进行排查。各个系统日志文件的默认路径如下:
腾讯云-yyuanchen
2019/09/12
3.6K0
实时音视频(TRTC)如何打印日志?
开发者在集成 TRTCSDK 过程中,需要调试查看SDK内部打印的日志,可以参考以下代码实现日志输出。
腾讯云-yyuanchen
2019/07/25
2.8K0
实时音视频 TRTC 常见问题汇总---集成接入篇
TRTC 的日志默认压缩加密,后缀为 .xlog。日志是否加密是可以通过 setLogCompressEnabled 来控制,生成的文件名里面含 C(compressed) 的就是加密压缩的,含 R(raw) 的就是明文的。
腾讯视频云-Zachary
2019/11/01
14.8K1
实时音视频 TRTC 常见问题汇总---集成接入篇
iOS音视频接入 - TRTC常见问题
在 TRTC SDK 的示例代码中提供了一个叫做GenerateTestUserSig的开源模块,您只需要将其中的 SDKAPPID、EXPIRETIME 和 SECRETKEY 三个成员变量修改成您自己的配置,就可以调用genTestUserSig()函数获取计算好的 UserSig。
小明同学接音视频
2020/10/21
3K0
iOS音视频接入 - TRTC常见问题
iOS音视频接入 - TRTC实时屏幕分享
应用内分享的方案非常简单,只需要调用 TRTC SDK 提供的接口 startScreenCaptureInApp 并传入编码参数TRTCVideoEncParam 即可。该参数可以设置为 nil,此时 SDK 会沿用开始屏幕分享之前的编码参数。
小明同学接音视频
2020/10/13
2.6K0
iOS音视频接入 - TRTC实时屏幕分享
实时音视频SDK迎来最新的 6.8 版本
腾讯实时音视频=TRTC,全称Tencent Real-Time Communication。拥有QQ十几年来在音视频技术上的积累,致力于帮助企业快速搭建低成本、高品质音视频通讯能力的完整解决方案。 1.我们在 Windows 版本中新增了 socks5 的支持,对于金融和保险类客户,可以通过搭建代理服务器解决内外网通信问题。 该功能通过调用 ITXLiteAVNetworkProxy.h 中的 setSocks5Proxy 接口进行设置,可以参考 Socks5 代理服务器的的搭建方案: /*
腾讯即时通信IM
2020/06/19
2.5K0
腾讯实时音视频 TRTC SDK 升级至7.2版本
新版本 TRTCCloud 为移动端开放了 startScreenCapture、stopScreenCapture、pauseScreenCapture 和 resumeScreenCapture 四个接口,分别用于实现开始、结束、暂停和恢复屏幕分享的功能。
smiling
2020/04/24
1.6K0
腾讯实时音视频 TRTC SDK 升级至7.2版本
实时音视频V2版本,如何进行纯音频旁路直播
实时音视频TRTCSDK适用的业务场景是视频会议、坐席通话、在线教育等,也可以实现类似微信的语音通话、语音会议功能,
腾讯云-chaoli
2019/03/13
3.5K0
实时音视频V2版本,如何进行纯音频旁路直播
实时音视频SDK,如何实现类似微信的纯语音通话功能?
实时音视频TRTCSDK适用的业务场景是视频会议、坐席视频、在线教育等,如果您希望实现类似微信的语音通话、语音会议功能,TRTCSDK也是支持的,只需要微调几个参数就可以实现,将采集音视频的api,换成只采集音频。
腾讯云-chaoli
2019/03/05
8.4K2
实时音视频SDK,如何实现类似微信的纯语音通话功能?
云直播(CSS)“你问我答”第三季(2020.3月&4月)
(1)Android:SDK 默认会将 log 写到 /sdcard/Android/data/应用包名/files/log/tencent/liteav/ 下。
腾讯云音视频
2020/04/30
1.8K0
云直播(CSS)“你问我答”第三季(2020.3月&4月)
iOS音视频接入-TRTC底层架构组成了解
要更好的使用TRTC必须要先仔细的了解此产品,所谓知己知彼,百战不殆,我们就先了解下TRTC的底层基本架构组成。TRTC既然是提供实时音视频的SDK,那按照一般的音视频流程(采集-处理-渲染-传输)处理来看TRTC。
小明同学接音视频
2020/10/09
3.4K0
iOS音视频接入-TRTC底层架构组成了解
你问我答 | 实时音视频TRTC(2021年8月-10月)
实时音视频TRTC 你问我答 第2季 本期共解答10个问题 Q1:TRTC通话,实现大小屏切换,类似微信通话效果,点击自己的画面和对方的画面展示位置互换。 支持大小屏切换,使用updateView功能,但需要给TXCloudVideoView调用addview添加一个textureview。 解决方案: 通话过程中,保证双方通话画面正常; 直接调用stop,再调用start,会有一段时间黑屏; 直接调用updateView对调,会导致远端画面不显示,或者没有效果; updateView
腾讯云音视频
2021/11/26
1.3K0
【版本发布】腾讯实时音视频TRTC SDK 6.9
新的版本围绕视频画质、直播 CDN 融合、Android 10.0 系统兼容,以及云端录制等几个方面,增加了很多新的功能特性,期待您的使用:
shixin
2020/01/21
3K0
实时音视频(TRTC)常见问题
一般而言,媒体音量指播放音乐、视频的声音、游戏声音等的音量,而通话音量指打电话的音量,视频通话的音量。
腾讯云-yyuanchen
2019/09/27
13.8K1
实时音视频开发学习14 - 常见问题
V1和V2主要区别在于IM的SDK是否内嵌于TRTC中,V1线路是内嵌,而V2则可选,默认不打包IM的SDK包。V2在通话质量、线路规格、接入难度以及功能扩展上均比V1更有优势。
金林学音视频
2020/08/30
2.9K0
实时音视频开发学习14 - 常见问题
实时音视频开发学习9 - 进房权限和画质
开启进房权限的目的是为了避免非会员模式能够进入高级房间,同时解决客户端限制被破解的问题。目前进房权限在iOS、Android、Windows、Electron、微信小程序和Chrome 浏览器都支持。
金林学音视频
2020/08/27
1.9K0
实时音视频开发学习9 - 进房权限和画质
实时音视频 TRTC 常见问题汇总---咨询问题篇
支持的平台包括 iOS、Android、Windows(C++)、Windows(C#)、Mac、Web、Electron、微信小程序、Flutter,更多详情请参见 平台支持。
腾讯视频云-Zachary
2019/11/01
13.5K0
实时音视频 TRTC 常见问题汇总---咨询问题篇
产品动态 | 即时通信IM TUIKit 新增支持uni-app架构
uni-app 是目前比较火的跨平台利器,腾讯云即时通信 IM 正式推出支持三大平台的 uni-app TUIKit。TUIKit 是基于 IM SDK 实现的一套 UI 组件,其包含会话、聊天、群组管理等功能,基于 UI 组件您可以像搭积木一样快速搭建起自己的业务逻辑。 目前我们提供了示例客服群 + 示例好友的基础模版,在线客服功能包括: 支持发送文本消息、图片消息、语音消息、视频消息等常见消息。 支持常用语、订单、服务评价等自定义消息。 支持创建群聊会话、群成员管理等。 uni-app TUI
腾讯云音视频
2021/11/26
3.1K0
iOS音视频接入 - TRTC接入实时视频通话
(前面我们已经了解TRTC的基本架构和功能,现在我们就来接入实时视频通话功能,此功能和微信的一对一视频通话是一致的,需要两个角色,一个角色是主动呼叫、一个为呼叫接听,结合使用场景我们来接入此功能。
小明同学接音视频
2020/10/13
6.8K0
iOS音视频接入 - TRTC接入实时视频通话
推荐阅读
相关推荐
TRTC/MLVB/IM案例:SDK用户日志提取与管理的一种实现方案
更多 >
领券
一站式MCP教程库,解锁AI应用新玩法
涵盖代码开发、场景应用、自动测试全流程,助你从零构建专属AI助手
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档