目次
1. はじめに
2. ユーザーガイド
- ▢2.1 アカウントとデータセンター
- ▢2.2 ダッシュボードの概要
- ▢2.3 アプリケーション概要
- ▢2.4 デバイスの概要
- 2.4.1 デバイスの追加
- 2.4.2 デバイスの管理
- 2.4.3 デバイスの設定
- 2.4.4 デバイスのアップグレード
- 2.4.5 デバイスの共有
- 2.4.6 リモートアクセスデバイス
- 2.4.7 デバイスリストの列をカスタマイズする
- ▢2.5 リソース概要
- ▢2.6 タスク センター 概要
- ▢2.7 RPSの概要
3. APIレファレンス
- ▢3. Milesight開発プラットフォームAPIの概要
- 3.1.1 APIリクエスト
- 3.1.2 API インターフェース一覧
- 3.1.3 API 認証
- 3.1.4 デバイス管理
- 3.1.5 RPS管理
- 3.1.6 タスク管理
- 3.2 Webhookイベント通知
4. デバイスレファレンス
5. よくある質問
このトピックでは、TSL モデルとプロファイルテンプレートとは何か、その形式と構造について紹介します。
TSL モデル
- はじめに
-
- Thing Specification Language (TSL) モデルは、Milesight 開発プラットフォーム内でデバイスの特性、機能、および動作を定義する標準化されたデータモデルです。TSL モデルは、デバイスの ID、機能、データ提供など、デバイス情報を構造化して表現する方法を提供します。
- フォーマット
- TSL モデルファイルのフォーマット:
JSON
.
- 構造
- Milesight 開発プラットフォーム用の TSL モデルには、以下の例に示すように、バージョン、プロパティ、イベント、およびサービスが含まれます
{ "data": { "version": "v1.0", // Version of the TSL model. "properties": [ // Status or information of this device. { "id": "", "name": "", "accessMode": "", // The access mode of the property. "dataSpec": {} // Detailed info (data definition) of this property. } ], "events": [ // Data that a device reports to Milesight Developement Platform. { "id": "", "name": "", "type": "", "outputs": [] // The reported data when this event occurs. } ], "services": [ // Available services that can be invoked on this device. { "id": "", "name": "", "callType": "", // The type of this service invocation: "inputs": [], // The downlink data when this service is invoked. "outputs": [] // The reported data when this service is invoked. } ] } }
- 説明
-
- 項目
- 説明
version
- このTSLモデルのバージョン
properties
- プロパティは、アクセスモードに応じて読み取りまたは書き込み可能なデバイスの特性または属性です。プロパティは以下のように分類されます:
- 読み取り専用:変更できない静的なデータまたは値で、デバイスのステータスや情報を表します。例えば、デバイスの SN (シリアル番号) やファームウェアのバージョンなどです。
- 書き込み専用:設定可能なパラメータで、デバイスの設定を表します。例えば、センサーのデータ報告間隔などです。注:書き込み専用プロパティの値は、API を使用して変更し、デバイスの設定を更新することができます。
- 読み取り/書き込み:デバイス情報を記述するだけでなく、変更も可能なパラメータ。例えば、スマートソケットのオン/オフの状態など。注:読み取り/書き込みプロパティの値は、API を使用して変更し、デバイスの設定を更新することができます。
events
- イベントとは、特定のイベントが発生したときにデバイスが Milesight 開発プラットフォームに報告するデータを指します。たとえば、人数カウントセンサーがライン越えを報告するように設定されている場合、センサーがラインを越える人を検出すると、関連データを Milesight 開発プラットフォームに報告します。
services
- サービスとは、デバイスで実行できるアクションのことです。デバイスと対話するために呼び出すことができるメソッドや操作を表します。たとえば、デバイスの再起動、デバイスの履歴データの照会などです。
注:サービスは API 経由で呼び出すことができます。
プロファイルテンプレート
- はじめに
-
- プロファイルテンプレートは、Milesight 開発プラットフォームで設定できる、インターネットにアクセス可能なデバイスのすべての設定の概要です。デフォルトのプロファイルテンプレートを使用して、デバイスに標準設定を適用したり、カスタムプロファイルテンプレートを作成して必要に応じて設定を更新し、デバイスに適用したりすることができます。
- フォーマット
- プロファイルテンプレートのフォーマット:
JSON
.
- 構造
- プロファイルテンプレートは、次の例に示すように、バージョンとキーと値のペアのリストで構成されています。
-
{ "version": "v1.0", // Version of the Profile template. "values": [ { "key": "********", // The configurable setting. "value": 1 }, { "key": "*********", "value": 0 }, .......... ] }
関連記事
ソリューション / IoT サポート
- ▢4. デバイス・リファレンスの概要サポートされているデバイス、対応する TSL モデル、プロファイルテンプレート、および関連する参考資料と使用ガイドラインについて概要を説明します。
- 4.2 TSL モデルとプロファイル テンプレートの概要TSL モデルとプロファイルテンプレートとは何か、その形式と構造について紹介します。