用途
dts-docs 用于在使用飞渡科技 DTS 产品进行开发、配置、操作或排障时,识别产品和版本并查询匹配的官方文档。它强调在回答 DTS 的产品用法、配置、接口或故障问题前,先查官方文档,不要仅凭旧项目代码或经验推断产品要求。
覆盖产品
资料列出的相关产品包括 DTS Cloud、CloudMaster、NodeService、Explorer、Engine、JavaScript SDK 等。云渲染前端通常同时涉及 Cloud 与 SDK:服务部署查 Cloud,播放器参数和场景 API 查 SDK。
主要能力
- 识别产品与版本:结合用户明确说明、当前问题、项目引用的 SDK、配置、日志及安装包信息判断,并区分服务端产品版本与前端 SDK 版本。
- 选择文档入口:从 DTS 文档中心首页版本导航进入目标版本,再跟随产品与章节链接;不通过替换 URL 中版本号猜链接。
- 按问题定位章节:创建工程、编辑场景、材质、图层、导览和客户端操作查 Explorer;云渲染部署、CloudMaster 服务配置、节点、实例、连接、NodeService 查 Cloud;数据转换、3DT、输入格式和处理软件查 Engine;Web 集成、播放器、fdapi、场景接口与回调查 SDK 与快速入门;错误码、日志、授权或产品间共性问题从首页支持或专题导航进入。
- 查询与核实:优先读取已知页面与站内链接;找不到时用 site:doc.freedo3d.com 加产品、版本、接口名或错误码搜索,并打开结果正文。对配置和 API,核实字段名、必选性、默认值、参数所在对象、回调时机及适用版本。
- 交叉核对:代码变更前,同时核对项目实际加载的 ac.min.js、随包示例或类型声明;文档有某能力不代表当前 SDK 已支持。
使用方式
当问题涉及 DTS 产品时,先判断产品与版本;版本未知时先检查可访问的项目证据,必要时询问版本,同时继续不依赖版本的定位,不默认为最新版本。用户提供某版本文档时先读该文档;本地证据不一致时指出差异。随后按上述文档入口定位并读取相关章节。遇到 ac_conf.js、ws://undefined 或播放器连接问题时,沿“HTML 加载配置 → 全局配置字段 → 应用拼接地址 → SDK 构造参数 → 实际请求”的链路检查,并分别确认播放器连接和管理连接的用途。
适用场景
适用于 DTS 产品的开发集成、配置说明、接口查询、版本迁移和故障排查,尤其是需要区分文档明确规定、示例用法和本地实现行为的场合。
限制
输出需先给结论和适用的产品/版本,并提供具体官方章节链接;涉及项目问题时指出相关配置或代码位置,并区分文档核实、静态检查、模拟测试和真实服务验证。文档没有提及不等于明确不支持;历史版本文档不与目标版本参数静默拼接;当前文档与本地 SDK 有差异时分别给出证据,按用户实际环境选择适配方式,不自动升级 SDK。读取失败可尝试其他读取工具、官方站内搜索或本地随包资料,仍无法确认时说明缺失证据,不编造 API,也不把搜索摘要当作完整规格。查文档不自动授权部署、重启服务、修改远端实例或安装工具。资料未提供收费、价格或平台等信息。