# Rhopoint COM Agent

> Section of the Rhopoint Instruments Manual.

This file bundles all 11 pages of this section as Markdown.

# Rhopoint COM Agent

Rhopoint COM Agent は、FT3 膜厚計などの Rhopoint 計測器がシリアル (COM) 接続を通じて送信する測定データをキャプチャし、それを役立つ形に変換する Windows アプリケーションです。具体的には、ディスク上の構造化されたファイルとして保存したり、値を別のプログラムに直接入力したりできます。

計測器が結果を出力するたびに、COM Agent はそれを読み取り、データ形式を認識し、選択した形式で書き出します。形式には、生データの **TXT** ファイル、構造化された **CSV** ファイル、または **キーストロークのエミュレーション** によって現在フォーカスのあるフィールド (スプレッドシートのセル、QA データベース、ERP フォームなど) に値を直接表示する方法があります。

![](../_images/com-agent-main-screen-ja.png)

## COM Agent でできること

1. [COM Agent のインストール](rhopoint-com-agent-install-com-agent.md) — アプリケーションのダウンロード、インストール、起動を行います。
2. [計測器の接続](rhopoint-com-agent-connecting-an-instrument.md) — COM ポートとボーレートを選択し、データが届いていることを確認します。
3. [出力形式](rhopoint-com-agent-output-formats.md) — 各測定値を TXT および/または CSV ファイルに書き出します。
4. [キーボードエミュレーション](rhopoint-com-agent-keyboard-emulation.md) — 設定可能な区切り文字を使って、測定値を別のアプリケーションに直接入力します。
5. [測定値のキャプチャ](rhopoint-com-agent-capturing-measurements.md) — キャプチャの開始と停止を行い、ライブのアクティビティを確認します。
6. [デモモード](rhopoint-com-agent-demo-mode.md) — 計測器を接続せずにアプリケーションを試します。
7. [ライセンス](rhopoint-com-agent-licensing.md) — ライセンスを追加してライブキャプチャを有効にします。デモモードはライセンスがなくても常に使用できます。
8. [設定と言語](rhopoint-com-agent-settings-and-language.md) — 設定が記憶され、インターフェイスは 13 言語で利用できます。
9. [コマンドラインでの起動](rhopoint-com-agent-command-line-launch.md) — 事前に設定した状態で起動し、自動的にキャプチャを開始します (自動化向け)。
10. [COM Agent の更新](rhopoint-com-agent-updating-com-agent.md) — アプリケーションを最新の状態に保ちます。

## 対応計測器

COM Agent は、以下を含む Rhopoint 計測器のシリアル出力を読み取ります。

- **FT3** 膜厚計

> [!info] COM Agent は現在、FT3 の *「全サンプル印刷」* 膜厚形式について、完全な構造化 (CSV) 解析を提供しています。その他の計測器は生のテキストとしてキャプチャされ、サンプルデータが入手可能になり次第、構造化解析が追加されます。キーボードおよび TXT 出力はすべての計測器で動作します。

> [!info] COM Agent は Windows でのみ動作します。自己完結型アプリケーションとして配布されるため、別途 .NET をインストールする必要はなく、自動的に最新の状態を維持します。


---

# COM Agent のインストール

Rhopoint COM Agent は軽量な Windows アプリケーションです。インストーラーが必要なものをすべてセットアップし、アプリケーションを自動的に最新の状態に保ちます。

## ダウンロード

COM Agent の最新バージョンは [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent) からダウンロードしてください。

## インストール

1. 上記のリンクから COM Agent インストーラーをダウンロードします。
2. インストーラーをダブルクリックし、画面の指示に従います。
3. スタートメニューから **Rhopoint COM Agent** を起動します。

> [!info] COM Agent は自己完結型であり、別途 .NET ランタイムをインストールする必要はありません。また、インストーラーはアップデートを確認し、バックグラウンドで自動的にインストールするため、常に最新バージョンを実行できます。

## システム要件

- **OS:** Windows 10 (ビルド 19041 / 20H1) 以降
- **CPU:** x64 または ARM64
- **空いているシリアル (COM) ポート** — 内蔵ポートまたは USB-シリアル変換アダプターのいずれか — を使用して計測器を接続します。一部の計測器には専用ケーブルが必要です ([概要](rhopoint-com-agent.md) を参照)。

## 初回起動

COM Agent を起動すると、メインウィンドウは 2 つの領域に分かれています。

- **左側** には設定があります。接続設定と出力オプションです。
- **右側** にはライブのアクティビティがあります。ステータス、受信した測定値の数、最新の測定値、アクティビティログです。

**開始 / 停止** ボタンは右上、測定カウンターの上にあり、常に表示されています。

![](../_images/com-agent-main-screen-ja.png)

[次へ: 計測器を接続する](rhopoint-com-agent-connecting-an-instrument.md)


---

# 計測器の接続

**ライブ** モードでは、COM Agent はシリアル (COM) 接続を通じて計測器から測定データを直接読み取ります。

![](../_images/com-agent-connection-ja.png)

## 1. ハードウェアを接続する

1. 計測器のシリアルケーブルまたは USB-シリアル変換アダプターを使用して、計測器を PC に接続します。一部の計測器 (CBT1.2、NovoHaze TX) には専用ケーブルが必要です。[概要](rhopoint-com-agent.md) を参照してください。
2. 計測器の電源を入れます。

## 2. 接続設定を選択する

左側の **接続** セクションで設定します。

| 設定 | 説明 |
| --- | --- |
| **モード** | シリアルポートから読み取るには **ライブ** に設定します。(ハードウェアなしでアプリを試すには **デモ** を使用します — [デモモード](rhopoint-com-agent-demo-mode.md) を参照。) |
| **COM ポート** | 計測器が接続されているポートを選択します。アダプターを差し込んだ後にポートを再スキャンするには、**更新** ボタンをクリックします。 |
| **ボーレート** | シリアル速度です。Rhopoint 計測器の既定値は **19200** です。 |
| **パートマーカー** | 計測器が完全なデータセットの各パートを区切るために出力する文字です。既定値は **^** です。 |
| **パート数** | 1 つの完全なデータセットを構成するパートマーカーの数です。既定値は **4** です。 |

> [!info] **パートマーカー** と **パート数** は、測定が完了したタイミングを COM Agent に伝えます。データセットは、想定される数のマーカーを受信し、行が終了して初めて書き出されます。これにより、受信途中の測定値が保存されるのを防ぎます。既定値は Rhopoint 計測器に合わせてあります。Rhopoint サポートから指示があった場合にのみ変更してください。

## 3. データの処理方法を選択する

各測定値をどのように保存または転送するかを決めます。

- ファイルに書き出す — [出力形式](rhopoint-com-agent-output-formats.md) を参照。
- 別のアプリケーションに値を入力する — [キーボードエミュレーション](rhopoint-com-agent-keyboard-emulation.md) を参照。

これらを組み合わせることもできます (たとえば、CSV ファイルに書き出し *かつ* 平均値をスプレッドシートに入力する)。

## 4. キャプチャを開始する

**開始** (右上) を押し、計測器で測定を実行します。右側のアクティビティログでデータが届いていることを確認できます。詳細は [測定値のキャプチャ](rhopoint-com-agent-capturing-measurements.md) を参照してください。

> [!warning] 選択した COM ポートを開けない場合 (たとえば、別のプログラムがすでにそのポートを使用している場合)、COM Agent はエラーを表示します。他のプログラムを閉じるか別のポートを選択してから、もう一度お試しください。

[次へ: 出力形式を選択する](rhopoint-com-agent-output-formats.md)


---

# 出力形式

COM Agent は、完了した各測定値をファイルに書き出すことができます。**出力フォルダー** を選択し、1 つ以上の **出力形式** にチェックを入れます。形式は自由に組み合わせられます。

![](../_images/com-agent-output-formats-ja.png)

## 出力フォルダー

*出力フォルダー* の横にある **参照…** をクリックし、ファイルの書き出し先を選択します。測定のたびに、一意のタイムスタンプ付きの名前で新しいファイルが作成されるため、既存のファイルが上書きされることはありません。

```
2025-10-11T11-03-56Z-00007-3f9c1a2b-….csv
```

この名前には、UTC タイムスタンプ、連番カウンター、一意の識別子が含まれます。

## 形式

| 形式 | 生成される内容 |
| --- | --- |
| **テキストファイル (.txt)** | 計測器から受信したままの生データで、処理は行われません。すべての計測器で動作します。 |
| **CSV ファイル (.csv)** | 名前付きの列とメートル単位を備えた、構造化されたスプレッドシートファイルです。認識されたデータ形式 (現在は FT3 の *「全サンプル印刷」* 膜厚形式) が必要です。 |
| **キーボードエミュレーション** | ファイルに書き出す代わりに、値を別のアプリケーションに入力します — [キーボードエミュレーション](rhopoint-com-agent-keyboard-emulation.md) を参照。 |

> [!info] 複数の形式を同時に有効にできます。たとえば、**テキスト** と **CSV** にチェックを入れて生データのアーカイブと構造化ファイルの両方を保持したり、**CSV** と **キーボード** にチェックを入れてデータをファイルに保存 *しつつ* QA システムに値を入力したりできます。

## CSV エクスポートオプション

![](../_images/com-agent-csv-options-ja.png)

**CSV** を有効にすると、ファイルの書き出し方法を制御する 4 つの設定を備えた **CSV オプション** パネルが表示されます。COM Agent はお使いの言語と地域から適切な既定値を選ぶため、ほとんどの場合はそのままにしておけます。

| オプション | 選択肢 | 効果 |
| --- | --- | --- |
| **区切り文字** | カンマ "," · セミコロン ";" · タブ "→" | 列と列の間に置かれる文字。 |
| **時刻形式** | ISO 8601, UTC · ISO 8601, ローカル | *Timestamp* 列の形式: UTC (例: `2025-10-11T11:03:56Z`) またはオフセット付きのローカル時刻 (例: `2025-10-11T13:03:56+02:00`)。 |
| **小数点記号** | ピリオド "." · カンマ "," | 数値に使用される小数点の記号。日付や識別子は変更されません。 |
| **ファイルエンコード** | UTF-8 · UTF-8, BOM 付き | ファイルの先頭にバイトオーダーマークを書き込むかどうか。BOM は一部のスプレッドシートプログラム (例: Excel) が UTF-8 を検出し、µm の見出しを正しく表示するのに役立ちます。 |

> [!tip] **区切り文字** と **小数点記号** は、既定でお使いの地域の慣習に従います。リストの値をセミコロンで区切る地域 (ヨーロッパの大部分) は **セミコロン + カンマ小数点** で始まり、それ以外 (例: 英語) は **カンマ + ピリオド小数点** で始まります。これにより、ローカルのスプレッドシートプログラムでダブルクリックするだけでファイルがきれいに開きます。設定を変更すると、その選択が記憶されます。

## CSV の構造

FT3 膜厚形式の場合、COM Agent は個々のサンプルごとに 1 行を生成し、併せて集計統計と計測器のメタデータを出力します。単位はマイクロメートル (µm) で示されます。

| Column | 例 | 意味 |
| --- | --- | --- |
| Index | 1 | セット内のサンプル番号 |
| Measurement (µm) | 1090.9 | 個々のサンプルの測定値 |
| Min (µm) | 1088.4 | セットの最小値 |
| Max (µm) | 1090.9 | セットの最大値 |
| Mean (µm) | 1089.4 | セットの平均値 |
| StdDev (µm) | 0.990 | セットの標準偏差 |
| Template | 10 | 計測器のデータ形式 |
| Device_ID | FTG38041012H | 計測器のシリアル番号 / ID |
| Test_Date | 2025-10-07 | 試験日 (ISO 8601) |
| Calibration_Date | 2025-10-11 | 前回の校正日 |
| Test_Time | 11:03:56 | 試験時刻 |
| Sample_Count | 5 | セット内のサンプル数 |
| Timestamp | 2025-10-11T11:03:56Z | COM Agent がセットを受信した時刻。選択した *時刻形式* で表示 |

> [!info] 計測器自身の *Test_Date* / *Test_Time* は装置の時計に由来し、タイムゾーンを持ちません。**Timestamp** 列はお使いの PC がセットを受信した時点であり、*時刻形式* オプション (UTC またはローカル) を反映します。

> [!info] COM Agent が構造化形式として認識できないデータを受信した場合、その測定値については CSV ファイルがスキップされ、アクティビティログにメモが表示されます。生の **TXT** 出力 (有効な場合) は、形式に関わらず常に書き出されます。

[次へ: 別のアプリケーションに値を入力する](rhopoint-com-agent-keyboard-emulation.md)


---

# キーボードエミュレーション

キーボードエミュレーションを使用すると、COM Agent は **測定値を別のプログラムに直接入力** できます。まるでキーボードで自分が入力したかのように動作します。これは、コピー＆ペーストすることなく、測定値をスプレッドシート、QA データベース、ERP 画面、その他のアプリケーションに入力するのに最適です。

測定が完了すると、COM Agent は選択された値を **その時点でキーボードフォーカスのあるウィンドウとフィールド** に入力します。

![](../_images/com-agent-keyboard-options-ja.png)

## 有効にする

[出力形式](rhopoint-com-agent-output-formats.md) の下にある **キーボードエミュレーション** にチェックを入れます。その下に **キーボードオプション** が表示されます。

## 値

入力する値を 1 つ以上選択します。既定では **平均値** が選択されています。

| 値 | 入力される内容 |
| --- | --- |
| **平均値** | 測定セットの平均値 |
| **最小値** | 最も小さい測定値 |
| **最大値** | 最も大きい測定値 |
| **標準偏差** | 標準偏差 |
| **測定値** | 個々のサンプルの測定値すべて |
| **生データ** | 計測器から受信したままの完全な生データ |

複数の値を選択した場合は、上記の順序で入力され、それぞれが選択した **区切り文字** で区切られます。

## 区切り文字とサフィックス

| オプション | 目的 |
| --- | --- |
| **区切り文字** | 値の *間* (および個々の測定値の間) で押されるキーです。**Tab**、**Enter**、**なし** から選択します。 |
| **サフィックス** | *最後の* 値の *後* に押されるキーです。**Tab**、**Enter**、**なし** から選択します。 |

> [!info] 次のセルやフィールドに移動するには **Tab** を、入力を確定する / 次の行に移動するには **Enter** を使用します。たとえば、*区切り文字 = Tab*、*サフィックス = Enter* とすると、セルの行を埋めてから次の行に移動します。スプレッドシートに最適です。

## 小数点記号

**小数点記号** は、入力先のアプリケーションに合わせて設定します。通常、英語ロケールではピリオド (`.`)、ドイツ語 / フランス語ロケールではカンマ (`,`) です。

## キーボード遅延

**キーボード遅延** は、エミュレートされた各キーストロークの後に短い待機時間を設定します。

> [!warning] 入力された値が **文字化けしたり文字が重複したりする** 場合は、キーボード遅延を大きくしてください。アプリケーションや PC によっては、挿入されたキーストロークの受け付けが遅い場合があります。既定値から始めて、値が正しく表示されるまで (たとえば 100 ms まで) 大きくしてください。この設定は PC ごとに保存されます。

## 例

**平均値** と **最小値** を選択し、*区切り文字 = Tab*、*サフィックス = Enter* として、スプレッドシートに入力すると次のようになります。

```
1089.4 ⇥ 1088.4 ⏎
```

平均値が最初のセルに、最小値が次のセルに入り、カーソルは次の行に移動して、次の測定の準備が整います。

> [!info] キーボードエミュレーションはファイルを書き出しません。記録を保持 *しつつ* 値を入力するには、[出力形式](rhopoint-com-agent-output-formats.md) の下で **テキスト** または **CSV** にもチェックを入れてください。

[次へ: 測定値をキャプチャする](rhopoint-com-agent-capturing-measurements.md)


---

# 測定値のキャプチャ

[接続](rhopoint-com-agent-connecting-an-instrument.md) を設定し、[出力](rhopoint-com-agent-output-formats.md) を選択したら、キャプチャの準備は完了です。

## 開始と停止

**開始** (右上) を押します。COM Agent はシリアルポートを開き、受信を開始します。ボタンは **停止** に変わります。これを押すとセッションが終了し、ポートが解放されます。

キャプチャの実行中は、左側の設定が **ロック** され、セッションの途中で変更できないようになっています。

![](../_images/com-agent-running-ja.png)

## ライブパネル

右側には、リアルタイムで何が起きているかが表示されます。

| 要素 | 意味 |
| --- | --- |
| **ステータスバッジ** | 開始前は **待機中**、キャプチャ中は **受信中**、接続に失敗した場合は **エラー** と表示されます。 |
| **受信セット数** | このセッションでキャプチャした完全な測定値の累積数です。 |
| **最新の測定値** | 直近の測定値の平均値、最小値、最大値、標準偏差です (認識された形式の場合)。 |
| **アクティビティログ** | イベントのスクロール表示リストです。データの受信、書き出されたファイル (フルパス付き)、キーボード出力、各種の警告が表示されます。空にするには **クリア** を使用します。 |

## 測定を行う

1. COM Agent で **開始** を押します。
2. 通常どおり計測器で測定をトリガーします。
3. アクティビティログに *「データを受信中…」* と表示され、続いて書き出された各ファイルのパスが表示されます。キーボードエミュレーションが有効な場合は *「[Keyboard]」* のエントリが表示されます。
4. **受信セット数** カウンターが増加し、**最新の測定値** が更新されます。

> [!info] 完了した各測定値は個別に処理されます。1 つのセッションで好きなだけ測定を行えます。測定ごとに停止と開始を繰り返す必要はありません。

> [!warning] ステータスが **エラー** に変わった場合 (たとえば、ケーブルが抜けている、または計測器の電源が切れている場合) は、セッションを停止し、接続を確認してから、もう一度開始してください。

[次へ: 計測器なしで試す](rhopoint-com-agent-demo-mode.md)


---

# デモモード

デモモードを使用すると、**計測器を接続せずに** COM Agent を試すことができます。COM Agent はシリアルポートから読み取る代わりに、要求に応じてリアルな測定値を生成します。アプリケーションの操作を学んだり、出力フォルダーやキーボードの設定をテストしたり、デモンストレーションを行ったりするのに便利です。

![](../_images/com-agent-demo-mode-ja.png)

## デモモードの使い方

1. 接続セクションで **モード** を **デモ** に設定します。COM ポートとボーレートの設定は不要になるため、表示されなくなります。
2. ライブモードと同じように、[出力形式](rhopoint-com-agent-output-formats.md) と、必要に応じて [キーボードオプション](rhopoint-com-agent-keyboard-emulation.md) を選択します。
3. **開始** を押します。
4. どこでも (別のアプリケーション内でも) **右 Alt** キーを押すと、デモ測定値が挿入されます。

右 Alt キーを押すたびに、完全なデモ測定値が 1 つ生成されます。これは実際の測定値と同じように、出力設定に従って書き出され、また入力されます。

> [!info] デモモードは、**キーボードエミュレーション** の設定を確認する最も手早い方法です。モードをデモに設定し、キーボード出力を有効にして、スプレッドシートをクリックし、開始を押して、右 Alt をタップすると、値がセルに表示されます。

> [!info] デモデータは FT3 膜厚形式を使用しているため、CSV 出力およびすべてのキーボード値 (平均値、最小値、最大値、標準偏差、測定値) で動作します。

[次へ: ライセンス](rhopoint-com-agent-licensing.md)


---

# ライセンス

COM Agent が計測器から **ライブで測定値をキャプチャ** するには、有効なライセンスが必要です。[デモモード](rhopoint-com-agent-demo-mode.md) はライセンスがなくても常に使用できるため、いつでもアプリケーションを試したり、出力やキーボードの設定をテストしたりできます。

ライセンスの状態は、ウィンドウの右上に常に表示されます。

- 緑色の **有効なライセンス: N** バッジは、ライブキャプチャが有効になっていることを示します。
- 赤色の **有効なライセンスがありません** バッジは、デモモードのみが利用可能であることを示します。

![](../_images/com-agent-licence-manager-ja.png)

## ライセンスの仕組み

COM Agent のライセンスは、次の 2 つのいずれかの方法でバインドできます。

- **このコンピューターに (ホスト ID)** — この PC でのライブキャプチャを、接続されたあらゆる計測器について有効にします。
- **デバイスのシリアル番号に** — その特定の計測器から送られてくる測定値のみを、あらゆる PC で有効にします。ライセンスをコンピューターではなく計測器に紐付けたい場合に使用します。

## ライセンスの申請

1. 右上のライセンスバッジ (または **ライセンスを追加**) をクリックして、**ライセンスマネージャー** を開きます。
2. 横にあるコピーボタンで **ホスト ID** をコピーします。デバイスバインドのライセンスの場合は、代わりに計測器のシリアル番号を控えてください。
3. ホスト ID (またはシリアル番号) を Rhopoint Instruments に送信して、ライセンスファイルを取得します。

> [!info] ホスト ID はこの特定のコンピューターを識別します。ホストバインドのライセンスは、そのホスト ID 向けに発行されたコンピューターでのみライブキャプチャを有効にします。

## ライセンスのインポート

1. **ライセンスマネージャー** を開き、**ライセンスをインポート…** をクリックします。
2. 受け取ったライセンスファイル (`.lic`、`.txt`、`.json`) を選択します。複数のファイルを同時に選択することもできます。
3. ライセンスが一覧に表示され、バッジが緑色に変わります。これでライブキャプチャが有効になります。

## ライセンスの管理

ライセンスマネージャーには、インストールされているすべてのライセンスが次の情報とともに一覧表示されます。

- **バインド先** — *このコンピューター*、*デバイスシリアル番号: …*、または *任意のコンピューター*。
- **状態と有効期限** — たとえば *有効 · 有効期限 2027-01-31*。

ライセンスを削除するには、その横にある **ごみ箱** アイコンを使用します。

> [!info] デバイスのシリアル番号にバインドされたライセンスは、デバイス ID が一致する測定値のみを処理します。同じ PC に接続された他の計測器は、それらもライセンスされていない限り無視されます。

> [!warning] 有効なライセンスなしでライブキャプチャのために **開始** を押すと、COM Agent はメッセージを表示し、開始しません。ライセンスをインポートするか、**モード** を **デモ** に切り替えてください。

[次へ: 設定と言語](rhopoint-com-agent-settings-and-language.md)


---

# 設定と言語

## 設定は記憶されます

COM Agent は設定を自動的に保存します。モード、COM ポート、ボーレート、パートマーカーとパート数、出力フォルダー、出力形式、すべてのキーボードオプションが対象です。次回アプリケーションを起動したときには、すべてが終了時のままになっているため、そのまま **開始** を押すだけで使えます。

設定は Windows ユーザーごとに保存されます。

## 言語

COM Agent は 13 言語で利用できます。**英語**、**チェコ語**、**ドイツ語**、**スペイン語**、**フランス語**、**イタリア語**、**オランダ語**、**ポーランド語**、**ポルトガル語**、**トルコ語**、**韓国語**、**日本語**、**中国語** です。ウィンドウの左上、ロゴの横にあるドロップダウンから言語を選択します。インターフェイスはただちに切り替わり、選択した言語は次回のために記憶されます。

![](../_images/com-agent-language-ja.png)

[次へ: コマンドラインでの起動](rhopoint-com-agent-command-line-launch.md)


---

# コマンドラインでの起動

COM Agent は、事前に設定した状態でコマンドラインから起動し、ただちにキャプチャを開始できます。これは自動化に便利です。別のプログラム、デスクトップのショートカット、起動スクリプトから、固定の構成で起動できます。

アプリケーションウィンドウは通常どおり開きます。パラメーターは設定を自動的に入力するだけで、キャプチャは自動的に開始されます。

```
RhopointComAgent.exe --mode live --port COM3 --output "C:\Data" --file-extension csv+txt
```

## オプション

オプション名はウィンドウ内の設定に対応しています。省略したオプションは、保存されている値が維持されます。

| オプション | 値 / 例 | 意味 |
| --- | --- | --- |
| `--mode` | `live` または `demo` | キャプチャモード。`demo` では COM ポートは不要です。 |
| `--port` | `COM3` | シリアルポート (ライブキャプチャに必須)。 |
| `--baud` | `19200` | ボーレート。 |
| `--part-marker` | `^` | 完全な測定セットを区切るマーカー。 |
| `--part-count` | `4` | 完全なセットを構成するパートの数。 |
| `--output` | `"C:\Data"` | TXT/CSV ファイルの出力フォルダー。 |
| `--file-extension` | `txt`、`csv`、`csv+txt`、`keyboard` | 出力形式。複数を `+` で組み合わせます。 |
| `--csv-delimiter` | `comma`、`semicolon`、`tab` | CSV の列区切り文字。 |
| `--csv-decimal` | `dot`、`comma` | CSV の数値の小数点記号。 |
| `--csv-time-format` | `utc`、`local` | CSV の *Timestamp* 列の形式。 |
| `--csv-encoding` | `utf8`、`utf8-bom` | CSV ファイルのエンコード (バイトオーダーマークの有無)。 |
| `--keyboard-value` | `mean`、`min`、`max`、`stddev`、`measurements`、`raw` | 入力する値。複数を `+` で組み合わせます。 |
| `--keyboard-separator` | `tab`、`enter`、`none` | 入力する値の間で押されるキー。 |
| `--keyboard-suffix` | `tab`、`enter`、`none` | 最後の値の後に押されるキー。 |
| `--keyboard-decimal` | `.` または `,` | 入力する値の小数点記号。 |
| `--keyboard-delay` | `40` | 各キーストロークの後の待機時間 (ミリ秒)。 |
| `--start` | *(値なし)* | 他のパラメーターが指定されていない場合に、保存された設定で開始します。 |

いずれかのパラメーターが指定されると (または `--start` 単独で)、キャプチャが自動的に開始されます。

## 例

COM3 からキャプチャして CSV および TXT ファイルに保存する:

```
RhopointComAgent.exe --port COM3 --output "C:\QA\Thickness" --file-extension csv+txt
```

平均値と最小値を、タブ区切りでフォーカスのあるアプリケーションに入力する:

```
RhopointComAgent.exe --port COM3 --file-extension keyboard --keyboard-value mean+min --keyboard-separator tab
```

デモモードで開始する (計測器は不要):

```
RhopointComAgent.exe --mode demo --output "C:\Data" --file-extension txt
```

> [!info] ウィンドウは通常どおり開くため、ライブのアクティビティを確認したり、いつでもキャプチャを停止したりできます。スペースを含むパスは引用符で囲んでください。

> [!warning] ライブキャプチャには引き続き有効な [ライセンス](rhopoint-com-agent-licensing.md) が必要です。起動構成が不完全または無効な場合 (たとえば、出力フォルダーが存在しない場合)、COM Agent は手動で開始したときと同じメッセージを表示します。

[次へ: COM Agent を最新の状態に保つ](rhopoint-com-agent-updating-com-agent.md)


---

# COM Agent の更新

COM Agent は自動的に最新の状態を維持します。

## 自動更新

COM Agent は起動時に、バックグラウンドで新しいバージョンを確認します。利用可能なバージョンがある場合は、ウィンドウの右上隅に小さな通知が表示されます。

![](../_images/com-agent-update-notification-ja.png)

- **今すぐ更新** をクリックすると、アップデートをダウンロードしてインストールします。COM Agent は新しいバージョンをダウンロードし、進行状況バーを表示してから、新しいバージョンで再起動します。
- **✕** をクリックすると通知を閉じ、現在のバージョンで作業を続けられます。次回アプリケーションを起動したときに、再び通知が表示されます。

> [!info] アップデートは任意であり、選択した場合にのみ適用されます。COM Agent がキャプチャセッションを中断して更新することはありません。

## バージョンの確認

現在のバージョンは、ウィンドウのタイトルバーに表示されます (たとえば *Rhopoint COM Agent 1.2.3*)。