常见问题

产品 / 插件
平台 / 框架

如何处理白板或文件显示不完整或留白的问题?

产品 / 插件:互动白板 / 文件共享

平台 / 框架:全平台

更新时间:2022-02-17 18:15


问题描述

  1. 创建一个普通白板,渲染后出现白板超过父容器尺寸的现象。
  2. 创建一个文件白板,渲染后出现白板没有正好铺满父容器,而是上下留白、左右留白或者居中的现象。
  3. 多页文件白板(PDF、Office 等)在滚动时会短暂出现部分区域留白。

问题原因

  1. 对于普通白板,如果需要挂载的父容器宽高比例与创建该白板时传入的单页的宽度与高度的比例不相同,就会出现渲染后的实际大小超过父容器尺寸的现象。

  2. 对于文件白板,渲染策略与普通白板不同,且不同的文件类型也有差异:

    • 尺寸小于等于 640*400 的图片,会等比放大到 640*400 后居中显示。

    • 静态 PPT、动态 PPT 以及自定义 H5 文件都是按照文件的原始尺寸等比缩放显示,确保文件可完整显示。

    • 其他文件等比缩放至自身宽度与父容器宽度一致。

      如果文件单页比例与需要挂载的父容器宽高比例不一致,就可能出现周边留白的现象。 需要注意的是,当 PDF 文件满足以下条件时,文件共享 SDK 会将其视为 PDF 转成了 PPT,适用 PPT 的渲染策略: PDF 每一页的宽高比例相同,且 ‘614 / 1280 <= 高/宽 <= 1’。

  3. 文件共享 SDK 内部对文件内容的每一页的加载方式是懒加载的模式,在网速较慢的情况下,会出现短时间的空白,表示当前文件内容还未渲染完成。

解决方案

以 web 平台为例

  1. 对于问题描述中的 1,请确保创建白板时传入的 aspectWidth 与 aspectHeight 的比例和要挂载的父容器宽高比一致。
  2. 对于问题描述中的 2,请按照实际情况修改父容器的尺寸,使其与要展示的文件页等比例。
  3. 对于问题描述中的 3,非功能问题,无需解决。

相关链接

  1. 创建普通白板可参考 实现流程
  2. 创建文件白板可参考 互动白板与文件共享的搭配使用