カスタムメーター

Each custom meter has a script.スクリプト内の main() は描画エントリであり、組み込みの View で構成される画面を返します。 Text はテキストを表示し、 Circle は円を描画し、 LineChart は曲線を表示します。レイアウト コンテナーはこれらのコンテンツを配置する役割を果たします。

スクリプトは、main() で現在の速度、回転速度 (RPM) などの読み取り値を取得し、表示する数値、色、または角度を計算し、その結果を View の内容と属性として返すことができます。たとえば、速度を読み取った後、その値を Text に書き込むか、その値を Circle の円弧角度に変換できます。

CapDrive は、画面を更新して返された結果を描画する必要がある場合に、再度 main() を呼び出します。インストルメントコードはこの入力を元に画面を記述するだけでよく、属性アニメーションも描画側で実行されます。画像リソースは機器とともに保存し、コード内のリソース名で使用できます。

メーターは .instrument ファイル経由でインポートおよび共有されます。既存のファイルはカスタム機器メニューの メーターを読み込む から開くことも、CapDrive を使用して開くこともできます。インポートした作品は別途ダッシュボードに追加する必要があります。

インポートされたメーターは その他（…）→ カスタムメーター に保存されます。 その他（…）→ ダッシュボードを編集 → + 経由で選択し、完了 をクリックしてダッシュボードに表示します。

車両パラメータを使用する作品では、既存の OBD 入力に対して メーター設定 → 入力の割り当て で独自の車両パラメータを選択する必要もあります。入力識別子を変更しないことで、スクリプトにデバイス識別子を記述することなく、作品のコードを継承できます。

その他（…）→ カスタムメーター の 新しいメーターを追加 を選択してエディターに入ります。編集領域は、main() および View を書き込むために使用されます。上部の名前をクリックして、メーター名、入力バインディング、その他のオプションを設定します。歯車を開くと パラメータ設定 が開き、数値、テキスト、スイッチ、選択項目、基本データ、OBD データの 6 種類の入力を管理できます。新しいメーターには、識別子 speed の基本速度入力がすでにあります。

編集中にいつでもテキスト、レイアウト、グラフィック、アニメーションをプレビューできます。プレビューには、駐車中に簡単に機器をチェックできるアナログ入力が備わっています。コード エラーが発生した場合は、ログの行番号からエラーを特定できます。保存後、メーターをダッシュ​​ボードに追加して、実際の測定値を使用します。

「First Speed Gauge」は完全なコードと説明を提供します。 API リファレンスには、使用可能な View、プロパティ、タイプ、およびランタイム インターフェイスがリストされています。

$data は、現在の読み取り値と最近のサンプルをスクリプトに提供します。速度や距離などの基本フィールドを数値表示に直接使用できます。車速 (RPM) や冷却水温度などのパラメータは、構成された OBD デバイスを通じて提供されます。スクリプトは、履歴サンプリングを使用して曲線を生成することもできます。

main() が実行されるたびに、必要なフィールドが読み取られ、値が処理されて、View が生成されます。測定値は一時的に利用できない可能性があるため、表示コードは欠落している測定値に対して適切なコンテンツを提供する必要があります。機器データ ドキュメントでは、フィールド構造、OBD 参照、履歴サンプリング、および null 値の処理について中心的に説明します。