腾讯浏览服务常见问题_办公协同解决方案
一般性问题
什么是公网？
公网指客户端网络环境，属于移动公共互联网环境，区别于专网，局域网或无网络情况的网络环境。
公网版本和离线版本有什么区别？
公网版本只能在公网环境下使用，SDK 授权打开文档需要网络环境，而离线版本可以在任意网络下使用，打开文档不受网络限制。
licensekey 有什么作用？
licenseKey 跟客户端包名绑定，用于接入 SDK 后的授权校验等功能。在授权以后，请不要随意更改包名，若需要更换包名，需要重新申请 licensekey。
如何查看 licensekey？
查看 licensekey，需要账户登录以后，到客户端管理页面查看生成的 licensekey，请妥善保管 licensekey。
公网版是否支持调用量包消耗进度提醒？
当公网版调用量包的使用额度剩余50%、20%、5%、0%或调用量包距到期还有5天、3天、1天时收到腾讯云短信、站内信或个人邮件提醒。同时，日常运营中，您可在腾讯浏览服务控制台首页查看每天的实时调用量。可参见 查看公网版调用量和使用进度。可在腾讯云 > 账号中心 > 消息订阅 > 订阅管理中管理您的消息接收渠道：
公网版调用量包消耗完后重新购买并且绑定新的调用量包是否会立即生效？
V1.0.5.6000019 版本及以上版本
在套餐包使用完毕后，SDK 会关闭文档打开能力，SDK 返回报错：args=212,result=license invalid，重新购买并且绑定启用新的调用量包后，App 重启立即生效。
V1.0.5.6000018、V1.0.5.6000017 和 V1.0.5.6000016 版本
在套餐包使用完毕后，SDK 会关闭文档打开能力，SDK 返回报错：args=212,result=license invalid，重新购买并且绑定启用新的调用量包后，需要以下任一操作才可恢复：卸载重装。App 清除应用数据。App 初始化 SDK 前主动清理 /data/data/包名/app_tbs/ 目录，激活状态会重置生效。
针对V1.0.5.6000018 版本以下的优化建议
针对历史版本，及时绑定新的调用量包，避免出现调用量包使用完毕，SDK 关闭功能后不可用的情况，或者升级到最新 SDK，避免历史版本出现消耗完后恢复不及时，需要卸载重装等操作。
SDK 接入问题
SDK 是否支持打开远程服务器文档？
不支持，SDK 只支持打开本地文档，只能传入一个本地文档的路径。服务器文档需要先下载到本地，再调 SDK 打开。
SDK 主要支持什么接入？
SDK 主要只支持 Android 接入，是将文档 API 和文档浏览引擎集成在一起的 SDK 包。
SDK 集成有多大包大小增量？
SDK 集成支持的是32位、64位混合集成，也支持单独64位集成，不同位数包大小不一样，64位数 SDK 在5-10MB区间。个别小众格式单独集成，例如 DWG 格式。详情见 SDK 接入文档。
SDK 集成后首次无法授权成功？
请检查宿主（App）网络环境，是否正常打开联网功能，是否连接了代理，VPN 等网络技术，影响授权请求的正常进行。
Poi 库是否能和 SDK 一起集成？
开发者如果接入了其他的文档解析方案，一般会集成 Poi 库，会跟文档 SDK 产生冲突。
使用这个 SDK 是否还需要下载 X5 内核
文档 SDK 是一个独立的 SDK，不需要下载 x5 内核。
使用这个 SDK 是否可以和 TBS SDK 一起集成？
支持和 TBS SDK 44286 版本（不支持文档 API 接口）以后一起集成。
使用 SDK 是否需要联网
公网版本需要一直联网使用，离线授权版本，可以通过离线的方式授权，用户可以在专网或者无网络下打开文档。
SDK 体验问题
显示文件预览失败
请检查：filePath 参数传入的文件路径是否正确。本地文件是否存在。本地文件是否损坏。是否有文件读取权限，某些机型上需开启权限设置-特殊权限设置-授予所有文件访问权限。（可查看 logcat 是否有文件权限报错的堆栈）
SDK 错误码
初始化接口错误码intEngine 接口错误码为方法返回值。initEngineAsync 接口错误码为回调 actionType == ITbsReader.OPEN_FILEREADER_ASYNC_LOAD_READER_ENTRY_CALLBACK 时 args 的值。
| 错误码 | 说明 |
| 102 | 未设置 licenseKey。 |
| 202 | 请检查调用接口是否正确，应调用 setLicenseKey 接口而不是 setLicense 接口。 |
| 103 、305 | 1. 请检查设备网络是否连通。2. 尝试切换网络。 |
| 212、322 | 调用量包次数用完。 |
| 4001 | licenseKey 不存在，请检查设置的 licenseKey 是否正确。 |
| 4002 | 客户端包名和 licenseKey 不匹配。 |
文件打开接口错误码openFileReader 接口错误码为返回值。
| 错误码 | 说明 |
| – 3 | 未设置 filePath。 |
| – 4 | 未设置 fileExt。 |
| – 5 | 未对应具体错误，请 联系我们。 |
| – 6 | filePath 对应的本地文件不存在。 |
| – 7 | 不支持的文件类型。 |
| – 8 | 文件流模式。 |
PDF 文件打开失败 （java.io.FileNotFoundException: reader/libmttpdfcore.so）
请检查是否使用了32位的应用集成了64位的 SDK。请勿使用集成32位+64位 SDK 的应用覆盖安装集成只支持64位 SDK 的应用，请选用一种合适 SDK 即可。
SDK 如何计算调用量
常规模式下 openFileReader 接口返回0则计算为1次。文件流模式下 write 接口返回0则计算为1次。
App 首次初始化加载组件影响界面卡顿
首次加载组件会进入授权流程，initEngine 接口可在子线程调用，或调用 initEngineAsync 接口。
文件缓存目录如何指定，是否可以删除
tempPath 为文件缓存目录，建议指定在 App 沙盒目录下，无需主动创建目录。在关闭文件（closeFileReader 接口调用）后可以删除，删除后再次打开文件无法跳转到上次打开的位置。
数据安全问题
SDK 是否会上传文档内容到云端？
文档是本地存储读取，并解析文档渲染展示。除 SDK 初始化会进行授权请求，正常打开文件会上报文件打开次数，无其他敏感数据网络传输，详情请参见 隐私合规文档。
对腾讯办公协同的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠
阿里云解决方案也看看？： 点击对比阿里云的解决方案
