物模型是阿里雲物聯網平台為產品定義的資料模型，用於描述產品的功能。本文介紹物模型相關概念和使用限制。
功能說明
物模型是物理空間中的實體（如感應器、車載裝置、樓宇、工廠等）在雲端的數字化表示，從屬性、服務和事件三個維度，分別描述了該實體是什麼、能做什麼、可以對外提供哪些資訊。定義了物模型的這三個維度，即完成了產品功能的定義。
功能類型 | 說明 |
屬性（Property） | 用於描述裝置運行時具體資訊和狀態。 例如，環境監測裝置所讀取的當前環境溫度、智能燈開關狀態、電風扇風力等級等。 屬性可分為讀寫和唯讀兩種類型。讀寫類型支援讀取和設定屬性值，唯讀類型僅支援讀取屬性值。 |
服務（Service） | 指裝置可供外部調用的指令或方法。服務調用中可設定輸入和輸出參數。輸入參數是服務執行時的參數，輸出參數是服務執行後的結果。 相比於屬性，服務可通過一條指令實現更複雜的商務邏輯，例如執行某項特定的任務。 服務分為非同步和同步兩種調用方式。 |
事件（Event） | 裝置運行時，主動上報給雲端的資訊，一般包含需要被外部感知和處理的資訊、警示和故障。事件中可包含多個輸出參數。 例如，某項任務完成後的通知資訊；裝置發生故障時的溫度、時間資訊；裝置警示時的運行狀態等。 事件可以被訂閱和推送。 |
物聯網平台支援為產品定義多組功能（屬性、服務和事件）。一組功能定義的集合，就是一個物模型模組。多個物模型模組，彼此互不影響。
物模型模組功能，解決了工業情境中複雜的裝置建模，便於在同一產品下，開發不同功能的裝置。
例如，電暖扇產品的功能屬性有電源開關、檔位（高、中、低）和室內溫度，您可以在一個模組添加前2個屬性，在另一個模組添加三個屬性，然後分別在不同裝置端，針對不同物模型模組功能進行開發。此時，該產品下不同裝置就可以實現不同功能。
物聯網平台已提供預設模組，您可根據需要新增自訂模組。每個產品中預設模組和自訂模組總個數不能超過200個。
2021年01月01日（不含當日）之前已定義的產品功能，歸類於物模型預設模組。
使用說明
物聯網平台通過定義一種物的描述語言來描述物模型模組和功能，稱為TSL（Thing Specification Language）。
物模型模組下定義的功能不需要同時包含屬性、服務和事件，按需配置即可。
物模型TSL檔案格式為JSON。您可在物聯網平台控制台產品詳情頁面，單擊功能定義頁簽，單擊物模型TSL，查看或匯出JSON格式的TSL。相關欄位說明，請參見物模型TSL欄位說明。
物聯網平台支援單個和大量新增物模型。大量匯入時，您可自訂物模型TSL檔案，編寫要求，請參見下文限制說明。
限制說明
物模型功能定義限制，請參見產品與裝置的物模型功能定義。以下為大量匯入物模型TSL檔案時的使用限制。
使用方法 | 限制說明 |
單個物模型TSL檔案 | 檔案尾碼名為 有效字元，指JSON格式內容中，除換行和對齊字元之外的字元。 |
多個物模型TSL檔案 |
|