プラグイン
プラグインは、Input.Observer と連携して動作する別のプログラムです。ほとんどは描画を行います。Input.Observer に付属する Styles プラグインは、アニメーションする軌跡のスタイルと、装飾されたヒントとメッセージを描きます。ほかに、スクリプトが呼び出す関数を追加するものや、別の言語で書かれたアクションを実行するものもあります。Input.Observer はすべてのプラグインの起動、監視、停止を自分で行います。プラグインを手動で起動することはありません。
このページではプラグインの管理について説明します。プラグインの作成については、別のプラグイン開発者向けドキュメントで説明しています。
詳細モード。 プラグイン ページはナビゲーションの エンジン セクションにあり、このセクションはシンプル モードでは非表示になります。プラグインはシンプル モードでも実行され続け、外観 ページではどちらのモードでもレンダラーのスタイルを表示および制御できます。
このページでの変更はすぐに有効になります。 これらは構成の未保存の変更には含まれません。適用 は不要で、破棄 でも元に戻りません。プラグインがエクスポートやインポートされることはありません。
プラグイン ページ
| 名前 | パス | 機能 | 状態 | 操作 |
|---|---|---|---|---|
| Input.Observer.Styles | C:\Program Files\Input.Observer\Input.Observer.Styles.exe | スタイル | 正常 | 無効にする |
| サンプル プラグイン | D:\Tools\SamplePlugin.exe | スクリプト関数 | 未使用 | レンダラーとして使用 |
ページには、登録されているすべてのプラグイン ② が一覧表示され、一覧の上には検索ボックスと状態のフィルター (すべての状態、正常、要対応、無効) があります。タイトル行には、登録済みのプラグインと正常なプラグインの数が表示されます。
| 列 | 表示内容 |
|---|---|
| 名前 | プラグインの名前。レンダラーの行には レンダラー バッジが付きます。コピー ボタンで名前を正確にコピーできます。スクリプトの PluginSendMessage の呼び出しにはこれが必要です。 |
| パス | プラグインのプログラム ファイル。右端のボタンで、ファイルが選択された状態でエクスプローラーが開きます。 |
| 機能 | プラグインが提供するもの: ジェスチャの軌跡、ヒント、表示メッセージ、スタイル、スクリプト コマンド、スクリプト関数、スクリプト エンジン、設定、ここで設定。実行されていないプラグインには、最後に実行されたときに提供していたものが表示されます。 |
| 状態 | 下の表を参照してください。 |
| 操作 | 現在このプラグインに使えるボタン (下記)。 |
| 状態 | 意味 |
|---|---|
| 正常 | 実行中で応答しています。 |
| 起動中… | 起動されています。ページは、状態が落ち着くまで 1 秒ごとに再確認します。 |
| 未使用 | レンダラーではない描画プラグイン、または何も設定されていないときのレンダラー。実行されておらず、メモリも使いません (下記の「未使用」)。 |
| 応答なし | 実行中ですが、10 秒間応答していません。Input.Observer が再起動します。 |
| 無効 | 無効にする でオフにされています。 |
| 自動的に無効化 -- 起動に失敗しました | 連続して何度も起動に失敗しました。Input.Observer は試すのをやめました (下記の「プラグインが失敗したとき」)。 |
| プラグインにより終了 | プラグインが意図的に自分で終了しました。再試行 を選ぶか、無効にしてから有効にするか、Input.Observer を再起動するまで、閉じたままです。 |
操作 のボタン:
| ボタン | 表示される条件 | 動作 |
|---|---|---|
| レンダラーとして使用 | オンになっていて、レンダラーではない描画プラグイン | それをレンダラーにします (下記)。 |
| 設定 (歯車) | プラグインに設定があり、実行中または未使用の場合 | その設定を開きます (下記)。 |
| プレビュー / プレビューを停止 | プラグインが軌跡、ヒント、メッセージを描く場合 | 描くものを表示します (下記)。 |
| 再試行 | 自動的に無効化された場合、またはプラグインにより終了した場合 | 再び起動し、失敗の回数をクリアします。 |
| コールバックを許可 / コールバックをブロック | プラグインがスクリプト関数またはスクリプト エンジンを提供する場合 | 下記の「コールバック」を参照してください。 |
| 有効にする / 無効にする | 常に | プラグインを登録したまま、起動または停止します。 |
| 削除 | 常に | プラグインを停止し、登録を解除します。プログラム自体は削除されません。 |
構成内のスクリプト (プラグインのスクリプト エンジンで実行されるもの、またはその関数を呼び出すもの) がプラグインを必要としている場合、無効にする と 削除 は先に確認し、それらのスクリプトを一覧表示します。プラグインがない間、それらのスクリプトは機能しなくなります。
プラグインを追加する
- プラグインの追加… ① を選び、プラグインのプログラム (
.exe) を選びます。 - Input.Observer は、名前を尋ねるためにプログラムを一度起動し、その後もう一度起動して、接続して応答することを確認します。これには数秒かかります。
- 確認に通ると、プラグインは一覧の先頭に追加され、実行され続けます。軌跡、ヒント、メッセージを描くプラグインの場合はレンダラーにもなり、「レンダラーを変更しました」のメモにそのことが示されます。
確認に通らなかった場合は、「プラグインを追加できませんでした」で理由が説明されます。ファイルがない、プログラムが応答しないか誤った応答をした (Input.Observer のプラグインではない可能性があります)、時間がかかりすぎた、名前が登録済みの別のプラグインで既に使われている、スクリプト関数やスクリプト エンジンが別のプラグインで既に使われている名前を使っている、のいずれかです。どの場合も、何も追加されません。
プラグインが Input.Observer のフォルダー内にある場合、Input.Observer はプラグインのパスを自分のフォルダーからの相対パスで保持するため、Input.Observer の横にインストールしたプラグインは、Input.Observer を移動しても機能し続けます。
プラグインを信頼する
- プラグインを追加すると、それが実行されます。 手順 2 ではプログラムがあなたのアクセス許可ですぐに起動され、それ以降、Input.Observer は起動するたびにそれを起動します。Input.Observer は、プラグインの作成者や署名の有無を確認しません。どのプログラムを実行する前とも同じように、信頼できる入手元のプログラムだけを追加してください。
- プラグインは独自のプログラムとして実行されます。Input.Observer の中で実行されることはなく、Input.Observer がマウスとキーボードを処理している間にプラグインを待つこともないため、遅いプラグインや壊れたプラグインによって入力が遅れることはありません。
- 描画を行うプラグインは、それを描くために、ジェスチャのストロークとヒントやメッセージのテキストを受け取ります。
- スクリプト関数を持つプラグインは、スクリプトがそれらの関数に渡す値を受け取ります。
レンダラー
レンダラーは、Input.Observer のために描画を行う 1 つのプラグインです。軌跡のスタイルと、外観 ページで スタイルに合わせる に設定されているときのヒントとメッセージを描きます。レンダラーになれるプラグインは一度に 1 つだけです。標準のインストールでは、Styles プラグインがレンダラーとして登録されます。
別の描画プラグインをレンダラーにするには、その行の レンダラーとして使用 を選びます。エンジンはすぐに切り替えます。新しいレンダラーが起動し、以前のレンダラーは停止して 未使用 と表示され、新しいプラグインが描ける軌跡、ヒント、メッセージがそれに設定されます。その後、何を描くかは 外観 ページの選択で決まります (外観)。スタイルを提供しないプラグインは、ギャラリーに独自の名前で 1 つのタイルとして表示され、描き方はその独自の設定で決まります。
レンダラーを無効にしたり削除したりするとレンダラーがなくなり、別のものを選ぶまで、Input.Observer のクラシックの軌跡、ヒント ウィンドウ、メッセージ ウィンドウが描画します。
未使用
Input.Observer は、何もすることのないプラグインは実行しません。描画プラグインが実行されるのは、それがレンダラーで、外観 ページの何かがそれに設定されている間だけです。スクリプト関数やスクリプト エンジンを提供するプラグインは、有効である間は常に実行されます。
未使用のプラグインは、その設定を開いたりプレビューしたりするときに一時的に起動され、その後 未使用 に戻ります。Styles プラグインは、設定を最後に変更してから約 1 分後に停止します。実行されていない描画プラグインに対するスクリプトの PluginSendMessage の呼び出しは、その旨のエラーで失敗し、プラグインは起動されません。
プラグインの設定
プラグインの行の歯車で、その設定が開きます。
- ここで設定 の印が付いたプラグインは、構成ウィンドウが描くウィンドウに、左側にセクションの一覧が付いた形で設定を表示します。Styles プラグインの設定についてはジェスチャの軌跡で説明しています。
- 設定 を持つそれ以外のプラグインは、独自の設定ウィンドウを開きます。
実行されていないプラグインは先に起動されるため、ウィンドウの内容が表示されるまで数秒かかることがあります。変更はすぐに有効になり、プラグイン自体によって 構成ファイルの横にあるプラグイン独自のファイルに 保存されます。適用 を待たず、破棄 でも元に戻りません。既定値に戻す で、選択したセクションがプラグインの既定値に戻ります。変更できない場合は、ウィンドウのメモに理由 (プラグインが起動しなかったかこれらの設定を提供していない、時間内に応答しなかった、変更を拒否した、変更したが保存できなかった) が示されます。
プレビュー
プレビュー では、実際のジェスチャなしで、描画プラグインが描くもの (ポインターを追う軌跡、サンプルのヒント、サンプルのメッセージ) が表示されます。右クリックすると、軌跡が終了して再び始まります。プレビュー中は、右クリックで何も開きません。
プレビューの実行中は、ジェスチャはどこでも一時停止 し、ページにその旨のバナーが表示されます。Esc キーを押すか、プレビューを停止 を選ぶか、プラグイン ページから離れるか、プラグインが停止すると、プレビューは終了します。マクロの記録中やジェスチャのトレーニング中は、プレビューを開始できません。
プラグインが失敗したとき
Input.Observer は、実行中のすべてのプラグインを 5 秒ごとに確認します。
- 応答しなくなったプラグイン は、10 秒 (2 回の確認) 応答がないと 応答なし と表示され、再起動されます。
- 予期せず終了したプラグイン は、10 秒後に再起動されます。
- 起動に失敗したプラグイン は、2 秒、5 秒、10 秒後に再試行されます。3 回目の試行に失敗すると 自動的に無効化 -- 起動に失敗しました になり、再試行 を選ぶまで、再起動をまたいでも Input.Observer はそのプラグインに手を出しません。失敗の回数は、プラグインが 5 分間問題なく実行されると 0 に戻ります。
- 意図的に自分で終了したプラグイン は プラグインにより終了 と表示され、再試行 を選ぶか、無効にしてから有効にするか、Input.Observer を再起動するまで再起動されません。
レンダラーが停止している間は、Input.Observer のクラシックの軌跡、ヒント ウィンドウ、メッセージ ウィンドウが代わりに描画し、外観 ページにその旨が 再起動 ボタンと共に表示されます。これが起こるたびに、コンソールの システム セクションに 1 行書き込まれます (コンソール)。
Input.Observer は起動時に、することのある各プラグインを起動し、それぞれ最大約 5 秒待ちます。スプラッシュ画面には、読み込み中のプラグインの名前が表示されます。その時間に間に合わなかったプラグインは、少し後で取り込まれます。Input.Observer は終了時にすべてのプラグインを閉じ、Input.Observer が停止した後もプラグインが実行され続けることはありません。セーフ モードでは、プラグインは起動されません (トラブルシューティング)。
コールバック
スクリプト関数やスクリプト エンジンを提供するプラグインは、呼び出しを処理している間に Input.Observer のスクリプトを実行するよう求めることがあります。これは、その行で コールバックを許可 を選んで確認しない限りブロックされます。信頼できるプラグインにだけ許可してください。許可すると、プラグインの要求は、ここでスクリプトができることをすべて (キーの押下、ウィンドウの移動や終了、プログラムの実行) 行えるようになり、プラグイン単独ではアクセスできない、管理者として実行中のウィンドウも対象になります。コールバックをブロック で、再びその許可を取り消します。