読み込みと共有

.instrument ファイルを使用して楽器を保存および共有します。ファイルには表示コード、機器構成、画像リソースが含まれており、インポート後に独自のダッシュボードで使用できます。

計器ファイルの内容

.instrument は、manifest.json、main.jsx、および assets/ を含む ZIP パッケージです。レコード名、アプリのバージョン、HUD サポート、および parameters 入力定義 (デフォルト値、スコープ、オプションを含む) を構成します。スクリプトとリソースは外観を定義します。

ローカルに入力された入力値と OBD デバイス バインディングはアプリ データに個別に保存され、計測器パッケージと一緒にエクスポートされません。入力定義のデフォルトのテキストは引き続きエクスポートされるため、共有する前に確認する必要があります。一時的な実行ステータスと $sessionStorage もエクスポートされません。

エクスポートとインポート

保存後、機器メニューからエクスポートするか、システム共有パネル経由で送信するか、「ファイル」に保存します。受信者は、CapDrive でファイルを開くか、カスタム機器メニューからファイルをインポートし、ダッシュボードを編集 → + 経由でページに追加します。

受信機は定義されたデフォルト値から開始し、入力の割り当て に独自の値を入力できます。 OBD 入力の場合、受信者は自分のデバイスに対応する車両パラメータを選択する必要があります。コードを継承するには、入力識別子を変更しないでください。計器パッケージには車両の Bluetooth 接続は含まれておらず、受信者のパラメータも設定されません。

例:計器の設定

以下の parameters は、ベース速度、OBD 冷却液温度、および数値上限入力を定義します。

分野 意味
identifier スクリプトフィールド名を決定する識別子を入力します。
kind 入力タイプ。
basicData 基本的なデータソース。
valueType OBD 入力の期待値のタイプ。
defaultValue 共有可能なデフォルト値。
supportsHUD HUD をサポートするかどうか。
appVersion 互換性チェックに必要なアプリのバージョン。

マニフェストには、OBD デバイス バインディングまたはネイティブ変更の入力値は含まれません。完全なインストルメンテーション パッケージには、スクリプトとリソースも必要です。

{
  "formatVersion": 1,
  "title": "My instrument",
  "appVersion": "1.3.1",
  "parameters": [
    {
      "name": "Speed",
      "identifier": "speed",
      "kind": "basic",
      "basicData": "speed"
    },
    {
      "name": "Coolant",
      "identifier": "coolant",
      "kind": "obd",
      "valueType": "number"
    },
    {
      "name": "Limit",
      "identifier": "limit",
      "kind": "number",
      "defaultValue": 120,
      "minimum": 0,
      "maximum": 300
    }
  ],
  "supportsHUD": true
}