百度天工物可视私有部署使用指南

一、目录结构

离线包解压后,能够获得一个命名规则为 'output-offline-{dashboardId}-{timestamp}' 的目录(例如 output-offline-5dd5f03831d7b1b5e97b97c3-1574301911822)。进入目录后,结构大致如下:

                
├── index.html
├── player.html
├── README.html
└── static
    ├── css
    ├── font
    ├── bdiotvizplayer.min.js
    ├── echarts.min.js
    ├── echarts-gl.min.js
    ├── echarts-liquidfill.min.js
    ├── playermain.min.js
    ├── vendors~playermain.min.js
    └── worker.js
            

其中,本说明文件(README.html)和离线包运行无关,用户可自行决定是否删除。

二、启动方式

使用静态服务器启动即可,例如 nginx 或者 nodeJS 的 http-server 等。

启动根目录为解压后的根目录,即上述列出的目录结构。

启动端口可随意选择

不要直接双击打开 index.html !!!,否则可能无法正常运行

下面我们以 http-server 为例,假设离线包解压后目录名称为 output-offline-5dd5f03831d7b1b5e97b97c3-1574301911822,那么启动命令如下:
                
# 安装命令,需要实现安装 nodeJS。如果已经安装了 http-server,则此步骤可以忽略
npm i http-server -g

# 启动命令,假设以 9100 为启动端口号。用户可自行选择。
cd output-offline-5dd5f03831d7b1b5e97b97c3-1574301911822
http-server -p 9100
            

(再次提醒,离线包目录的名称根据不同仪表盘而变化,请不要直接复制命令)

三、访问方式

假设在本地启动,端口号为 9100,那么浏览器的访问路径为

http://localhost:9100/index.html

注意1:localhost 只适用于本机访问,如果需要给同网段的其他用户访问,则需要使用 IP 地址。假设本机的 IP 地址是 192.168.0.1,那么访问路径也可以是

http://192.168.0.1:9100/index.html

注意2:像 http-server 会自动把 index.html 识别为默认文件(nginx 也可以自行配置)。那么访问路径也可以是:

http://192.168.0.1:9100/

四、调整界面为自适应

物可视离线包的展现模式默认为 none,即仪表盘按画布设置大小在屏幕左上角显示。如果需要修改,可以在离线包根目录内的 index.html 文件的末尾对 fillMode 的取值进行修改。

                
var myDashboard = bdIotVizPlayer({
    fillMode: 'none', // 可选值:none, responsive, fill, cover, contain
    containerElement: containerElement,
    dashboardSpec: '很长的 spec,不必理会',
    dashboardName: '仪表盘的名字',
    dashboardSign: '一串字符串,也不必理会'
});
            

每个可选值的含义如下:

或者可以参考百度天工官网

修改值后刷新页面就可以看到最新的效果,用户可以自己尝试一下对哪个更满意。

五、更新数据

私有部署不会发送任何连接公网的请求,因此目前只支持静态和仿真两种数据源。如果用户想连接内网的数据源,可以采用如下方式:

1. 选择静态数据源,并设置初始值(只需一条数据)用于在加载数据前做占位使用

2. 使用 PlayerAPI 按需(如周期性地)更新数据,界面会根据数据自行变化。

更详细的操作步骤可以参考官网的使用 PlayerAPI 更新数据