腾讯im a客户端不内置“导入本地文档”功能,但支持通过系统文件选择器发送word、pdf等本地文件,需sdk启用文件消息类型并配置正确权限与鉴权参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

腾讯IM A(即即时通信 IM 的 Android UIKit 或 Web SDK 等客户端环境)本身不提供“导入本地文档”功能,它专注消息收发、群组管理、音视频通话等实时通信能力;但如果你指的是在聊天界面中发送手机或电脑上已有的 Word、PDF、Excel 等本地文件,那实际是通过调用系统文件选择器完成上传——这一步必须依赖 SDK 已集成文件发送能力且服务端开通对应权限。
确认 SDK 是否支持文件消息
Android UIKit 默认支持文件消息类型,但需检查 Demo 工程中是否启用:【GenerateTestUserSig.java 中的 SDKAppID 和 SECRETKEY 已正确填写】,否则文件上传请求会因鉴权失败直接被拦截,连选择文件的界面都弹不出来。
Web SDK 需手动开启文件消息支持:在初始化 TIM 实例时传入 messageTypes: ['file'],否则调用 sendMessage({type: 'file'}) 会报错“unsupported message type”。
Android 客户端发送本地文档
方法一:使用 UIKit 内置文件选择器(推荐)
1. 在聊天页点击右下角「+」→ 选择「文件」图标 → 系统弹出文件管理器。
2. 浏览到目标文档(如 test.pdf),点击选中 → 自动触发上传流程。
3. 上传成功后,对方将收到带文件名和预览图的消息卡片,点击即可下载。
注意:若点击「文件」无反应,大概率是 manifest.xml 中缺失 android.permission.READ_EXTERNAL_STORAGE(Android 10 及以下)或 android.permission.READ_MEDIA_DOCUMENTS(Android 11+),权限未动态申请也会导致白屏。
Web 端发送本地文档
第一步:确保页面已加载 TIM SDK 并完成登录
第二步:绑定文件上传事件
<input type="file" id="fileInput" accept=".doc,.docx,.pdf,.xlsx,.xls">
第三步:监听 change 事件并构造 FileMessage
这一步操作起来很简单,直接把文件拖进去就行——但必须用 tim.createFileMessage({file: fileObj}) 构造,不能用 tim.createTextMessage() 强转,否则服务端会拒绝解析。
第四步:调用 tim.sendMessage() 发送,返回 Promise,成功后消息立即出现在聊天窗口。








