---
title: 预览与转码
description: 文件预览格式、可选模块、BabelViewer 能力及私有部署转码机制。
slug: preview-transcoding
lang: zh
category: 产品功能介绍
category_order: 2
order: 6
keywords:
  - 预览
  - 转码
  - BabelViewer
  - 文件格式
---

# 预览与转码

巴别鸟通过预览器和服务端转码提供文件在线预览。用户可以在不下载原文件的情况下查看预览内容；这不意味着能阻止拍照、截图或其他形式的内容复制。

## 支持在线预览的文件类型

以下是产品提供的预览支持清单。标为“可选”的能力需要相应服务器模块。所有支持预览的格式，除 Excel 和音视频外，都支持 BabelViewer 批注；可选格式需先启用对应预览模块。预览和批注支持不等于可在线编辑。所有可平面预览的文件均属于转 PDF 范围，音视频和 3D 除外；所需预览及转换模块须已启用。具体文件的编码、内容及模块会影响能否成功打开。

| 类型 | 基础支持 | 可选支持与条件 |
| --- | --- | --- |
| 文本、代码、Office 与文档 | pdf、md、js、xml、htm、html、css、scss、jsp、c、cpp、java、php、m、h、hpp、mm、mail、msg、epub、doc、docx、ppt、pptx、xls、xlsx、txt、rtf、wps、wpt、dps、dpt、et、ett | key、numbers、pages，需要服务器模块 |
| 思维导图 | xmind、km | — |
| 音视频 | mp3、mp4、wav、asf、ape | flv、f4v、m4v、webm、3gp、3gpp、wmv、avi、rm、rmvb、mkv、mov、mpeg、swf、mpg、mts、m2ts、ogv |
| 3D | dae、3ds、abc、fbx、mtl、obj、ply、stl、x3d | 可选模块一：m3d；Revit、SOLIDWORKS、3ds Max 支持截至 2026 年的各版本文件，需购买相应 3D 转码服务，扩展名见下文 |
| 图片 | bmp、jpg、jpeg、gif、png、psd、tif、tiff、raw、cr2、arw、dng、nef、pef、dcm、ico | — |
| 医疗影像 | dicom | — |
| 矢量与设计文件 | ai、svg、eps、indd、indt、idml | — |
| CAD | dwg、dwt、dxf、dcm | — |
| 压缩文件 | — | rar、zip |

可选清单已去除基础模块包含的重复格式；MP4、ASF、X3D、PLY、3DS、ABC 保留在基础清单。音视频的浏览器与编码兼容以 DPlayer 支持播放标准为主，不能仅凭扩展名保证播放成功。按产品提供的格式清单，dcm 同时列于图片和 CAD；此处保留该归类，不将扩展名作为区分两类内容的依据。

## BabelViewer 预览与协作

BabelViewer 基于 HTML5，组合多种渲染库处理不同类型文件，并使用多图层支持多人绘制和在线批注讨论。

- 查看当前版本与历史版本的批注列表。
- 对多种文件进行版本对比，支持快速切换文件。
- 对矢量内容进行高倍率放大。
- 使用 WebGL 渲染 3D 内容，并提供 3D 批注能力。

除 Excel 和音视频外，支持预览的格式均支持 BabelViewer 批注；这不意味着每种格式都提供相同的绘制、对比或文字选择工具。巴别鸟深度定制的 ONLYOFFICE 提供 Office 在线编辑、Office 评论和 PDF 转换，与 BabelViewer 是两个独立组件。Excel 虽不支持 BabelViewer 批注，仍支持 ONLYOFFICE 中的单元格评论；具体入口受模块及权限配置控制。详见[在线编辑](online-editing.md)、[预览、批注与评审](preview-annotation-review.md)和[自动转 PDF](automation-pdf.md)。

## 私有部署的转码处理

私有部署可使用专用服务器或虚拟机运行转码服务，通过多种转换工具生成预览内容和缩略图。

1. 系统空闲时，文件上传后即可进行预转码，减少之后打开预览的等待。
2. 繁忙或批量上传时，系统可暂缓预转码；用户打开预览的文件优先进入队列，按需转码。
3. 转码通过异步队列执行，已生成的预览缓存可复用；多个处理节点可进行负载均衡。

优先入队不等于立即完成。等待时间受文件内容、任务队列和处理资源影响；繁忙判定阈值、并发数量及缓存保留策略没有在此资料中给出，不应据此估算固定完成时间。

## 文件无法预览时

先确认上传已完成、当前账号有访问权限，再核对扩展名、文件本身是否完整及可选模块是否已部署。需要转换的文件可能仍在排队或处理；保留原文件，记录错误提示、文件类型、客户端或浏览器版本，交由管理员检查转码任务和模块。预览失败本身不能证明原文件已损坏。

相关问题见[预览与搜索 FAQ](faq-preview-search.md)和[批注与预览排障 FAQ](faq-archive-annotation.md)。

## 专业 3D 文件的原生扩展名

Revit、SOLIDWORKS、3ds Max 转码服务支持截至 2026 年的各版本文件，需另外购买相应的 3D 转码服务。以下原生扩展名依据软件厂商资料列出，便于识别文件。部署时应一并准备模型引用的关联资源，并检查转换结果。

| 软件 | 原生扩展名与用途 | 官方资料 |
| --- | --- | --- |
| Revit | RVT 项目、RFA 族、RTE 项目模板、RFT 族模板 | [Revit 文件类型](https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Revit-file-types.html) |
| SOLIDWORKS | SLDPRT 零件、SLDASM 装配体、SLDDRW 工程图 | [SOLIDWORKS 文件类型](https://help.solidworks.com/2020/English/SolidWorks/acadhelp/c_Types_of_Files.htm) |
| 3ds Max | MAX 场景 | [MAX 文件](https://help.autodesk.com/cloudhelp/2022/ENU/3DSMax-Reference/files/GUID-88DE2443-6869-4820-973A-10E7695B6DE6.htm) |

## 音视频播放与 DPlayer

音视频浏览器及编码兼容以 DPlayer 支持播放标准为主。普通播放依赖浏览器 HTML5 媒体能力；HLS、DASH、FLV 等路径还依赖对应适配库（如 hls.js、dash.js/Shaka、flv.js）及浏览器的 codec/MSE 支持。是否启用这些路径须核对巴别鸟部署，不能由上游列表推断全部已开启。DPlayer 是播放组件，不替代服务端转码。参考 [DPlayer 播放与 MSE 支持](https://dplayer.diygod.dev/guide#mse-support)。

## 平面预览与 PDF 转换

所有可平面预览的文件均属于转 PDF 范围，排除音视频和 3D。Office 文档由巴别鸟定制 ONLYOFFICE 提供相应转换能力，图片、CAD 等由对应转码工具处理；所需模块须已启用。压缩包可查看目录列表，不等于把整个压缩包内容转换为 PDF；应针对其中具备平面预览能力的具体文件判断。操作见[自动转 PDF](automation-pdf.md)。