グローバルプラグインの利用

mc_rtcでは、すべてのインタフェースは mc_control::MCGlobalController クラスをコントローラの初期化及び実行に使用します。より詳細には、mc_control::MCGlobalController::run() が実行周期毎に実行されます。

プラグインシステムはこのrun関数の最初と最後の両方または一方で実行されるコンポーネントを追加する機能を提供します。

これらのプラグインは以下のような様々な用途で利用が可能です。

• サードパーティのミドルウェアを用いてデータを出力する (例：ROSプラグイン)
• mc_rtcとは別のインタフェースを用いて取得されたセンサ情報をmc_rtcに取り込む
• 単一のコントローラよりもより上位の機能を提供する

mc_rtcでのプラグイン実装方法の詳細は new plugin tutorial で確認できます。

プラグインで利用可能なオプションやプラグインの利用方法は各プラグインのドキュメントで確認できます。このチュートリアルではこれらのプラグインの設定方法や有効化の方法を説明します。

大域的にプラグインを有効化する方法

プラグインは mc_rtc configuration の Plugins リストに追加することで有効化できます。例えば以下のように記述します。

Plugins: [Joystick, OculusVR]

ここにリストアップされたプラグインは指定されているコントローラに関係なく有効化されます。

参照される設定ファイル

以下の2つのファイルがmc_rtcによって読み込まれます（存在する場合）。

1. ${PLUGIN_RUNTIME_INSTALL_PREFIX}/etc/${PLUGIN_NAME}.yaml
2. Linux/macOS: $HOME/.config/mc_rtc/plugins/${PLUGIN_NAME}.yaml
   Windows: %APPDATA%/mc_rtc/plugins/${PLUGIN_NAME}.yaml

ここで ${PLUGIN_RUNTIME_INSTALL_PREFIX} はLinux/macOSにおいては ${INSTALL_PREFIX}/lib/mc_plugins であり、Windowsにおいては ${INSTALL_PREFIX}/bin/mc_plugins を意味します。

コントローラレベルでのプラグインの有効化

プラグインをコントローラレベルで有効化するにはコントローラの設定に Plugins エントリを追加します。

参照される設定ファイル

大域的な設定ファイルに加えて、以下のファイルが存在する場合プラグインの設定に使用されます。

1. ${CONTROLLER_RUNTIME_INSTALL_PREFIX}/etc/${CONTROLLER_NAME}/plugins/${PLUGIN_NAME}.yaml
2. Linux/macOS: $HOME/.config/mc_rtc/controllers/${CONTROLLER_NAME}/plugins/${PLUGIN_NAME}.yaml
   Windows: %APPDATA%/mc_rtc/controllers/${CONTROLLER_NAME}/plugins/${PLUGIN_NAME}.yaml

ここで ${CONTROLLER_RUNTIME_INSTALL_PREFIX} はLinux/macOSにおいては ${INSTALL_PREFIX}/lib/mc_controllers でありWindowsにおいては ${INSTALL_PREFIX}/bin/mc_controllers を指します。