模模搭API2.0已全新升級為ThingJS開發平臺,免插件,更方便!

立即體驗

概述

模模搭API是嵌入在模模搭系統內部的、可動態執行的類Javascript腳本,它提供了對模模搭場景內對象、界面行為和效果的控制,可實現特定第三方行業應用,諸如倉儲管理、預案演練、檔案管理、智能大廈等。

模模搭API具有數據交互能力。通過數據接口,第三方行業應用驅動特定3D場景各類信息動態變化,滿足實時狀態可視化展示的要求

概念說明

基本概念:模型和場景

在模搭體系中有2個重要的概念:模型和場景。

1 模型

模型是物體的多邊形表示,3D模型表達的物體可以是現實世界的實體,也可以是虛構的物體。任何物理自然界存在的東西都可以用3D模型表示。

模搭系統中的“模型”和一般3D模型概念完全一致。模模搭系統中的3D模型都可以像積木一樣放到一個場景中,組合出一個現實的生活場景。

模搭提供官方的3D模型庫,其中公開免費模型庫中的模型可供使用者在搭建過程中免費使用;模搭也可(有償)提供各類行業模型庫,方便用戶完成各類更專業的行業應用場景搭建;模模搭還提供了一個3DSMax模型上傳插件,用戶可使用該插件自行上傳自己需要增補的3D模型。理論上模搭模型庫提供了無限模型擴展可能。

2 場景

場景是模搭的基本概念。使用者在模搭中通過組合、擺放模搭模型庫中的模型,可像搭積木一樣搭建完成任意現實生活場景,可以是一個園區、一個工廠車間、一個港口碼頭或其它任意模3D模型組合,上述搭建成的每個場景我們稱之為一個“模搭場景”。

每個模搭場景都可保存在模模搭云平臺上,并可在模搭平臺隨時打開編輯、預覽或通過API進行二次開發。模搭場景在一定限制條件下(有償),也可從模模搭云平臺下載本地,并可導入到“模搭離線部署版”中預覽、使用。

模型庫內容:模型、貼圖與功能

在搭建系統的右側列表中,用戶可以使用3種常見的物體:模型、貼圖與功能。

1 模型

一般常見的物體如建筑、車輛、人物、桌子等;支持用戶上傳。

2 貼圖

覆于普通模型表面的平面材質圖;支持用戶上傳。

3 功能

動態效果如火、雨、閃電;輔助功能如畫線、畫水管、寫文字等;目前不支持用戶上傳。

場景層級:室外、建筑、樓層、房間

在模模搭體系中有4個層級:室外、建筑、樓層、房間。

1 室外

視野范圍最大的層級:

2 建筑

不含外立面的建筑層級:

3 樓層

樓層層級:

4 房間

房間層級:

API腳本調試

模模搭API可以在線調試和保存代碼,開發者進入調試頁面以后,可發現調試頁面分為腳本編輯窗口和可視化場景窗口兩部分。在場景區域的左下方輸入場景ID后點擊“場景預覽”按鈕載入場景,可開始調試API腳本。開發者也可以在輸入場景ID后點擊“場景編輯”按鈕,對場景進行編輯和保存。

調試頁面地址:在線調試

API腳本應用

腳本調試完成后,可在調試環境中點擊頁面下方的“代碼部署”按鈕,代碼部署成功后預覽模式打開場景即可實現腳本應用。

也可將腳本內容粘貼到“我的作品”對應場景的“配置場景”彈出框里來實現。

代碼配置:我的作品

調試頁面快捷鍵

調試頁面可以支持快捷鍵操作,目前具有如下快捷鍵:

Ctrl+Enter:執行腳本

Ctrl+R:重置場景

Ctrl+S:保存場景

Ctrl+/ :代碼/注釋文本切換

API

模模搭API2.0目前提供如下17個API類 :

camera

用于管理場景內的攝像機對象

object

用于管理場景內的物體對象

gui

用于管理場景內的圖形界面對象

ugui

用于管理場景內的高級圖形界面對象

BaseObject

用于對場景內已存在物體進行具體操作

ScriptObject

用于對場景內已存在物體添加腳本

util

一般的常用方法

input

用于判定鍵盤鼠標的輸入狀態

selector

用于選取場景內對象

fps

用于管理場景內第一人稱行走

level

用于管理場景內層級對象

console

用于管理控制臺

array

用于管理數組數據類型

string

用于對字符串進行計算處理

table

用于管理表數據類型

server

用于與服務端進行數據交互

臨時函數

并非模搭規范化函數,但仍可用于模API開發

查看明細:API說明

 

主要功能

API腳本目前可以提供如下功能:

 

常見Q&A

1、模模搭腳本語法與JavaScript語法是一致的嗎?

模模搭腳本是嵌入在模模搭系統內的、類似Javascript語言腳本,并不完全一致,由于是內部腳本,所以沒有documentwindow等這樣瀏覽器上才有的對象。

2、模模搭腳本調試界面如何載入已經搭建好的場景?

模模搭腳本可以用在線編輯器開發,在場景區域的左下方輸入場景ID后點擊“場景預覽”按鈕載入場景。

3、如何將調試好的腳本加入場景中?

在模模搭【我的作品】中找到對應場景,在【配置場景】中填入調試好的腳本代碼。如下:

4、為什么我創建的物體不能執行動畫?

物體動畫是在建模階段內置于物體的,建模時如果沒有添加動畫則該物體無動畫。

5、為什么我在使用調試界面時會遇到插件無響應?

模模搭調試界面需要加載3D插件,同時開多個3D頁面會影響性能,并容易造成插件崩潰。建議同時開啟頁面數量不大于3個。

6、為什么我對物體添加的點擊事件并不能執行?

在搭建場景的過程中,需要勾選物體屬性“預覽時可選”,這樣在預覽狀態時物體才可以被選中,進而執行事件對應的代碼。

更新日志

  • 2018-06-28:新增函數

    1、增加【API類參考-臨時函數-系統類】時間軸函數;
    2、增加【API類參考-臨時函數-系統類】室內燈光函數;

  • 2018-01-02:新增API使用專題

    1、新增【API說明-API使用專題-API中特殊對象】內容;

  • 2017-12-06:新增API使用專題

    1、示例代碼支持按鈕復制;
    2、新增【API說明-API使用專題-鼠標框選物體】內容;

  • 2017-11-28:更新/新增API使用專題

    1、更新【API說明-API使用專題-API代碼使用方法】內容;
    2、新增【API說明-API使用專題-監控攝像頭使用】內容;

  • 2017-11-09:新增函數/API使用專題

    1、增加【API類參考-臨時函數】1個;
    2、增加【API說明-API使用專題-模模搭鷹眼圖使用】內容;
    3、增加【API說明-API使用專題-模模搭云圖使用】內容;
    4、函數擴充至212個;

  • 2017-10-25:新增函數/API使用專題

    1、增加【API類參考-userInfo屬性函數】2個;
    2、增加【API說明-API使用專題-數據源識別碼使用】內容;
    3、函數擴充至211個;

  • 2017-10-18:新增函數

    1、增加【BaseObject屬性函數】2個
    2、增加【臨時函數-系統類】函數2個;
    3、函數擴充至209個;

  • 2017-9-27:新增函數

    1、增加【API說明-API使用專題-數據推送工具】內容;
    2、增加【臨時函數-對象操作類】函數1個;
    3、函數擴充至205個;

  • 2017-9-21:修訂文檔

    1、修訂API數據接口文檔,增加在線調試內容;

  • 2017-9-15:新增API使用專題

    1、增加【API說明-API使用專題-自定義圖片路徑】內容;

  • 2017-9-13:新增函數

    1、增加BaseObject方法函數2個;
    2、函數擴充至204個;

  • 2017-9-1:新增函數

    1、增加BaseObject屬性函數1個;
    2、增加臨時函數3個;
    3、函數擴充至202個;
    4、API說明頁面增加API使用專題內容;
    5、專題內容包括API代碼使用方法、模模搭面板介紹

  • 2017-8-25:新增函數

    1、增加util方法函數1個;函數擴充至198個;
    2、更新API說明頁面,改進導航欄

  • 2017-8-10:新增函數

    1、增加ugui方法函數1個;
    2、更新util方法函數1個;
    3、函數擴充至197個

  • 2017-8-8:頁面樣式改進

    1、“API說明”頁面代碼瀏覽樣式變更;

  • 2017-8-4:新增函數

    1、增加camera方法函數1個;
    2、增加ugui方法函數2個;
    3、增加util方法函數1個;
    4、函數擴充至196個

  • 2017-8-1:新增函數

    1、增加camera屬性函數2個;
    2、函數擴充至192個

  • 2017-7-31:新增函數

    1、增加selector方法函數2個;
    2、增加selector屬性函數1個;
    3、函數擴充至190個

  • 2017-7-28:新增函數

    1、更新object.findByProperty函數;
    2、更新ugui.destroy示例;
    3、新增BaseObject屬性函數1個;
    4、新增臨時函數2個;
    5、函數擴充至187個

  • 2017-7-26:新增函數

    1、增加array類;
    2、增加array方法函數12個;
    3、函數擴充至184個

  • 2017-7-25:新增函數

    1、更新臨時函數分類
    2、增加臨時函數8個;
    3、更新ugui方法函數示例1個;
    4、增加table類;
    5、增加table方法函數6個;
    6、函數擴充至172個

  • 2017-7-24:新增函數

    1、增加BaseObject方法函數3個;
    2、增加BaseObject屬性函數2個;
    3、增加selector類;
    4、增加selector方法函數2個、屬性函數1個;
    5、增加函數分類索引表;
    6、函數擴充至158個

  • 2017-7-21:新增函數

    1、增加臨時方法函數13個;
    2、util方法函數1個;
    3、BaseObject方法函數1個;
    4、BaseObject屬性函數1個;
    5、函數擴充至150個;

  • 2017-7-20:新增函數

    1、增加gui方法函數3個;
    2、camera屬性函數1個;
    3、增加server類;
    4、增加server方法函數3個;
    5、函數擴充至134個;

  • 2017-7-19:新增函數

    1、增加string類;
    2、增加string方法函數14個;
    3、函數擴充至127個

  • 2017-7-17:新增函數

    1、增加camera屬性函數7個;
    2、增加ugui方法函數12個;
    3、增加BaseObject屬性函數4個;
    4、增加fps方法函數3個、事件函數2個;
    5、增加level方法函數3個;
    6、函數擴充至113個

  • 2017-6-23:新增函數

    1、增加object.findByProperty等函數7個;函數擴充至82個;
    2、函數對應參數增加至111個;

  • 2017-5-19:新增函數

    1、增加BaseObject.getProperty等函數3個;函數擴充至75個;
    2、函數對應參數增加至102個;

  • 2017-4-28:模模搭API2.0英文文檔發布

    1、海外用戶可以通過本頁右上角的鏈接訪問英文API文檔

  • 2017-4-1:API2.0開放平臺正式發布

    1、共發布API2.0函數72個;
    2、函數對應參數99個;
    3、離線部署版支持初始化數據接口、實時監控數據接口;
    4、數據接口支持內部API腳本調用,開發者可保存自定義的場景配置;
    5、修復了一個API腳本調用數據接口的BUG。

  • 過去





















全民彩票专业彩票平台