1. 概述
適用場景:安裝了「FineVis資料視覺化」插件的使用者,可參考本文了解 FVS 範本的相關功能。
1.1 版本
報表伺服器版本 | 插件版本 | 功能變動 |
---|---|---|
11.0.16 | V1.x | V1.x 版本文檔請參考 三維場景漫遊路徑動畫歷史版本 |
11.0.16 | V2.0.0 | 場景編輯介面跳出預覽提示優化 |
11.0.22 | V2.3.1 | 新增視角參數配置項,動畫效果優化 |
1.2 應用場景
在三維場景中,支援透過新增多個視角形成一條漫遊路徑,再透過點選事件可實現三維場景漫遊動畫效果。
2. 功能介紹
2.1 新增漫遊路徑
1)進入三維組件編輯介面,在「場景>相機」配置面板中,點選「新增漫遊路徑」,進入漫遊路徑設定面板。
2)先調整好三維場景視角後,再點選「新增當前視角」,即可將當前視角新增到列表中。再調整下一個視角,再點選新增,如此反覆進而形成一條路徑。
漫遊路徑各設定項如下表所示:
注:視角變化、刪除等操作不支援廢除,請謹慎操作。
設定項 | 說明 |
---|---|
路徑名稱 | 支援自訂漫遊路徑名稱 |
漫遊模式 | 支援兩種漫遊模式切換:
|
視角列表 |
|
視角名稱 | 選中視角後,支援自訂視角名稱,不支援重名 |
視角參數 |
|
停留時間 | 選中視角後,可設定到達該視角後停留的時間 |
飛行時間 | 選擇「自訂漫遊」模式時可設定飛行時間 表示當前視角飛往下一個視角的飛行時間,最後一個視角不生效 |
3)完成一條漫遊路徑設定後,點選「完成」傳回「場景>相機」配置面板,在漫遊路徑列表中,支援編輯、預覽、刪除漫遊路徑。
「預覽」則可以在當前三維場景編輯介面查看播放漫遊動畫效果。
預覽途中可點選「跳出預覽」或使用快捷鍵 esc 停止播放動畫,空格鍵可暫停/繼續播放動畫。
中途跳出預覽或結束漫遊動畫,均停留在當前視角位置。
注:V2.0.0 及之後版本,若預覽途中點選設計器介面除「跳出預覽」按鈕外的其他地方,會提示「請跳出漫遊路徑預覽後,再進行其他操作」。
如下圖所示:
2.2 設定播放漫遊動畫
2.2.1 播放漫遊動畫事件
組件交互屬性 新增一種點選事件「播放漫遊動畫」。所有支援點選事件的組件,均支援設定點選播放漫遊動畫效果。
功能設定項包括:
事件名稱:設定該事件名稱
播放模式:可選擇「單次播放」或「循環播放」
觸發物件:選擇三維組件物件
漫遊路徑:選擇漫遊路徑,可新增多條漫遊路徑,依次播放動畫
例如:
2.2.2 JavaScript事件
「播放漫遊動畫」事件僅支援透過點選觸發,若想實現自動播放,可透過 playRoamAnimations API在「頁面載入結束事件」中使用 JavaScript 程式碼實現。
若範本僅有一個分頁,程式碼如下:
若範本包含多個分頁,程式碼如下:
例如:
2.3 設定暫停/繼續/跳出動畫
若要在範本預覽時,實現漫遊動畫的暫停、繼續或跳出,不支援快捷鍵實現,需透過 updateRoamAnimationAction API實現。
暫停播放程式碼如下:
繼續播放程式碼如下:
跳出播放程式碼如下:
例如:
2.4 注意事項
1)範本預覽時,若其他組件對正在播放漫遊動畫的三維組件呼叫 focus、refresh API,將終止播放漫遊動畫。
2)範本預覽時,若播放漫遊動畫的三維組件設定有監視重新整理,重新整理時將終止播放漫遊動畫。
3. 模板下載
點選下載範本:三維場景漫遊範例.fvs