iMotions Lab API
iMotions Labでは、iMotionsの機能を拡張するためのAPIを提供しています。以下に、このAPIを使ってできることのいくつかをご紹介します。詳細なドキュメントについては、ヘルプセンターをご覧ください。
このAPIを利用するには、高度なプログラミング知識と、APIへのイベントの送受信に関する経験が必要です。
イベントの転送
iMotions Labからのイベントを、リアルタイムのデータフィードを介してサードパーティ製アプリケーションに転送します。
被験者テストの実施中、ソフトウェアはさまざまなソースから多種多様なデータを収集します。 デュアルスクリーン環境では、このデータは視覚化に利用されます。また、データはメモリにキャッシュされ、テスト終了時にデータベースに記録されます。調査分析の際には、データベースからデータを読み込み、分析の実行や、視線追跡の再生などの各種視覚化に利用します。さらに、データをテキストファイルとしてエクスポートすることで、サードパーティ製アプリケーションを使用して独自の分析を行うことも可能です。
イベント転送インターフェースは、このモデルを拡張し、iMotionsシステムがデータを受信すると同時に、サードパーティ製アプリケーションがリアルタイムでそのデータを受信できるようにします。ソフトウェアがイベント（マウスクリックやアイトラッカーのサンプルなど）を受信すると、アプリケーションはイベント転送が有効になっているかどうかを確認します。有効になっている場合、イベントはテキスト文字列に変換され、その文字列がイベントメッセージとして転送されます。 外部アプリケーションは、これらのイベントメッセージをリッスンすることができます。その後、アプリケーション固有のタスクを実行する一環として、そのイベントを処理します。典型的な使用例としては、画面録画が挙げられます。この場合、テスト対象のアプリケーションは外部イベントを受信し、それに基づいて動作を調整します。例えば、
- 回答者には、前の画像のどこを見たかによって、異なる画像が表示される可能性があります。
- アイトラッカーデータの最終秒において、被験者が視線を外したり目を閉じたりしていることが確認された場合、被験者の注意を引くために音声による「ウェイクアップ」信号を再生することができます。Imotionsソフトウェアは、TCPまたはUDPを使用して外部アプリケーションにイベントを送信することができます。
- TCPを使用する場合、ソフトウェアはサーバーとして動作し、特定のポートで接続を待機します。クライアントとの接続が確立されると、iMotionsはこの接続を介してすべてのイベントメッセージをクライアントに転送します。クライアントアプリケーションは、この接続からイベントメッセージを読み取るだけで済みます。
- UDPを使用する場合、iMotionsは各イベントメッセージをUDPデータグラムとして、設定されたサーバーとポートの組み合わせに送信します。
イベント受信
カスタムデバイスやアプリケーションをiMotionsと連携させます。
iMotionsは現在、テスト中の被験者の状態を測定するための複数のセンサー（Emotiv EEG、Affectiva QSensorなど）に対応しています。しかし、お客様が使用しうるセンサーデバイスは他にも数多くあり、iMotionsがそれらすべてのデバイスに対応することは現実的ではありません。 その代わりに、お客様が希望するデバイス群と連携し、収集したデータをiMotionsソフトウェアに送信するサードパーティ製アプリケーションが開発されることが想定されています。 このデータは、iMotionsが標準でサポートするセンサーから収集されたデータと同様に扱われます。具体的には、他のすべての収集データと同期され、グラフ上で可視化され、データベースに保存されて調査データと共に保存され、さらなる分析のためにテキストデータとしてエクスポート可能になります。
このドキュメントでは、サードパーティ製アプリケーションが取得したセンサーの測定値をiMotionsソフトウェアに送信する方法について説明します。
注：
「非対応の外部センサー」というケースに焦点が当てられがちですが、サードパーティ製アプリケーションから送信されるデータの出所には制限がない点に留意する必要があります。そのデータは、外部イベントのストリームとしてソフトウェア内に保存されます。データが外部センサーデバイスから送信されたものであれ、サードパーティ製アプリケーション内部で生成されたものであれ、iMotionsにとっては重要ではありません。
リモコン
リモートコントロールAPIを使用すると、外部プログラムからiMotionsソフトウェアを制御し、ユーザーインターフェースを介さずに特定のタスクを実行することができます。以下のコマンドが利用可能です。
| コマンド | アクション |
| 最小化 | アイドル状態の場合、iMotionsはタスクバーに最小化されます。現在テストを実行中の場合は、ソフトウェアは最小化されません。 |
| 最大化 | iMotionsのウィンドウが復元されます。 |
| シャットダウン | iMotionsが終了します。テスト実行中の場合、そのコマンドは拒否されます。 |
| 実行 | iMotionsは、コマンドのパラメータを使用して、テスト対象の調査と回答者を選択します。その後、テストが実行されます。すでにテストが実行中の場合、そのコマンドは拒否されます。 |
| 次のスライド | スライドショーを次のスライドに進めるよう指示します。キーボードの「Shift + スペース」キーの組み合わせと同じ機能です。 |
| スライドショーを中止する | スライドショーを中止します。Shift+F1 キーを押すのと同じです。 |
| ステータス | 「Status」コマンドは、いつでもiMotionsに送信できます。これに対し、ソフトウェアがアイドル状態か、現在テストを実行中かを示す応答が返されます。テストが実行中の場合は、現在のテストの詳細が応答に含まれます。 |
| 保存 | iMotionsは、アイドル状態になると、選択された調査／回答者をファイルに保存します。生成されたzipファイルは、ファイルシステム内の設定可能なフォルダに保存されます。zipファイルの保存場所は、コマンドの応答に含まれます。 |
| 読み込み | 調査データのエクスポート内容をiMotionsに読み込みます。これにより、新しい調査が作成されるか、zipファイル内の対象回答者のデータが既存の調査に統合されます。 |
| 削除 | 調査を削除する。 |
| センサーデータのエクスポート | 調査データを、ExcelやMatlabなどに読み込めるプレーンテキストファイルとしてエクスポートします。 |
| 動画の録画データをエクスポートする | 画面またはフロントカメラの録画をフォルダに保存します。 |
この限定的なコマンドセットは、大規模なデータ収集ネットワークを持つお客様が、iMotionsソフトウェアを既存の試験データ配信インフラに統合できるようにすることを目的としています。
APIガイドとドキュメント
利用可能なコマンドの完全な一覧やAPIの使用方法については、ヘルプセンターをご確認ください。
