デスクトップアプリガイド

目次:

  1. 概要
  2. インストールプロセス
  3. アプリウォークスルー
  4. LSL統合: EEGのような外部デバイスの接続

概要

デスクトップアプリを使用すると、研究をラボのコンピュータにローカルで同期できます。これにより、オフラインモードでデータ収集に集中でき、EEGのような外部デバイスを統合し、すべてを1つのアプリで行えます。詳細については、デスクトップアプリ技術ページを参照してください。

注意: デスクトップアプリは、グループライセンスおよび部門ライセンスを保有する方のみに提供されています。

インストールプロセス

以下は、インストールプロセスの概要です。

Labvancedデスクトップアプリに対応するオペレーティングシステム

デスクトップアプリは以下のオペレーティングシステムと互換性があります:

  • Windows
  • MacOS
  • Linux Ubuntu

ダウンロードとインストールプロセス

  1. 以下のページにアクセスすることで、ローカルコンピュータにダウンロードしたいオプションを選択できます: https://www.labvanced.com/page/desktop
  2. ダウンロードが完了したら、.zipフォルダを解凍します
  3. ファイルをスクロールして、Labvanced実行可能ファイル（_Labvanced.exe_ファイル）をダブルクリックします
  4. 数秒後に、アプリファイルを保存するディレクトリまたは場所を選択できます
  5. ‘インストール’をクリックします
  6. インストールには約10-20秒かかります
  7. 完了後、FFmpegライセンスをダウンロードするかどうかを尋ねられます。

注意: FFmpegライセンスは無料で、実験で音声や動画ファイルなどのメディアファイルをサポートするために重要です。それがなければ、メディアファイルは使用できません。

  1. これにはさらに数秒を要します
  2. この段階で、ダイアログボックスで次のことができます: a.) デスクトップにショートカットを作成し、b.) ダウンロードが完了すると同時にアプリを起動するオプションを選択します

特別な注意: MacOS用デスクトップアプリのダウンロード

‘プライバシーとセキュリティ’メニューの‘システム設定’の下に、最新のMacOSバージョンでは‘どこからでもダウンロードしたアプリを許可する’オプションが隠されています。したがって、デスクトップアプリのダウンロードを進める前に、これを選択する必要があります。

初期設定では、‘どこからでもダウンロードしたアプリ’が許可されません。
初期設定では、‘どこからでもダウンロードしたアプリ’が許可されません。

  1. このオプションを表示させるために:
  2. アプリケーションを検索するために検索バーに移動します
  3. ‘ターミナル’アプリケーションを見つけて開きます（これはすべてのコンピュータの一部です）
  4. このコマンドをターミナルに貼り付けsudo spctl --master-disable、Returnキーまたはエンターキーを押してください
  5. 確認のためにパスワードを尋ねられます
  6. ‘プライバシーとセキュリティ’メニューに戻り、‘どこでも’を選択します
  7. これで、上記のインストールプロセスに戻り、デスクトップアプリのインストールを続行できます

ターミナルコマンドを実行すると、MacOSのプライバシー設定に‘どこでも’オプションが表示されます。
ターミナルコマンドを実行すると、‘どこでも’オプションが利用できます。

アプリウォークスルー

メインビュー

デスクトップアプリを起動すると、ログイン画面が表示されます。ユーザー名とパスワードを使用してサインインできます。更新がある場合は、希望に応じて受け入れることができます。

研究は、ブラウザ版と同様に読み込まれます。一般的に、labvanced.comを開いたときに見るものに類似点がありますが、いくつかの違いがあります。たとえば、ダッシュボードビューがなく、上部や下部にナビゲーションタブはありません。しかしそれ以外の点では、研究の作成や編集時にブラウザ版と同じように使用されます。たとえば、新しい研究を作成し、アプリケーション内で直接編集を開始できます。

オンラインモードのデスクトップアプリのビュー [左上トグル]。
オンラインモードのデスクトップアプリのビュー [左上トグル]。

ローカル – オンラインモード

1つの大きな違いは、ここにある‘ローカル’と‘オンライン’モードの間のトグルです。‘ローカル’に切り替えると、ローカルでコンピュータに利用可能な研究のみが表示されます。

研究をローカルで利用可能にする

研究をローカルで利用可能にするには、単に研究を選択し、左側のメニューから‘ローカルアクセス’ボタンをクリックします。これにより、研究がコンピュータにダウンロードされ、この時点以降はインターネット接続なしで使用でき、完全にラボ内で使用できます。

ローカルで研究にアクセスするには、研究を選択してこのボタンをクリックします。
ローカルで研究にアクセスするには、研究を選択してこのボタンをクリックします。

この‘ローカル’または‘オフライン’ビューでは、今度は研究が表示されます。これは他のオンラインモードに似ていますが、データ収集専用に焦点を当てた、クリーンなビューです。

同期設定

‘同期設定’オプションを使用すると、インターネット接続が再確立されたときに実験がどのように更新されるか（または更新されないか）を指定できます。たとえば、変更があった場合に自動的に研究を更新したり、データをサーバーに送信するように設定できます。

クラウドアイコンをクリックすると同期設定が表示されます。
クラウドアイコンをクリックすると同期設定が表示されます。

以下の表は、これらの設定オプションの詳細を説明します:

同期設定オプション説明
Auto-download研究設計を更新します。インターネット接続が再確立されると、実験設計に加えられた変更がローカルバージョンに自動的に反映されます。これにより、毎回自分で同期することを思い出さなくて済みます。
Auto-upload参加者データをアップロードし、サーバーにバックアップします。ローカルで記録したデータはLabvancedサーバーにアップロードされます。したがって、これが選択されていない場合は、データはローカルに存在し、必要に応じてエクスポートできます。
Two-ways sync実験とデータの両方が更新されます。実験設計が自動的に同期され、変更が加えられた場合、データ記録もサーバーに送信されます。
No auto-sync研究を完全にローカルのままにします。オンライン中に加えられた変更が実験に反映されず、データ記録はサーバーに送信されません。

このようにして、これらの設定オプションを使用して、研究がどのように動作するか、同期されて更新されるか、どの方向に進むか、または完全にローカルのままにしたいのかを決定できます。

研究を実行

ローカルモードで研究を選択すると、サイドメニューから‘オープン’オプションをクリックできます。

研究を選択してこの‘オープン’ボタンをクリックしてローカルで研究にアクセスします。
研究を選択してこの‘オープン’ボタンをクリックしてローカルで研究にアクセスします。

ここから、テスト実行またはローカルでの録音セッションを進めることができます。

ローカルでテスト実行または録音セッションを開始するオプション。
ローカルでテスト実行または録音セッションを開始するオプション。

LSL統合: 外部デバイスの接続

Lab Streaming Layer (LSL)は、外部デバイスとLabvancedを接続するために使用されます。LSLは、データを記録するために一般的に使用されるラボ機器との接続を確立するために使用されます:

  • EEGシステム
  • 眼追跡装置
  • 動作センサー
  • ウェアラブル
  • そして多くの外部デバイス

詳細なウォークスルー: EEG接続での研究の設定方法について、始めから終わりまでの詳細なウォークスルーはこちらのページを参照してください。

下の画像は、Labvancedで作成および設定されたEEG研究からのデータ録音セッションの一部です:

Labvancedデスクトップアプリを使用して行われたEEG研究のプレビュー。イベントマーカーは上部にピンクと緑で縦に表示されています。
Labvancedデスクトップアプリを使用して行われたEEG研究のプレビュー。イベントマーカーは上部にピンクと緑で縦に表示されています。

これは、Labvancedと外部デバイス間の接続を確立するための2つの一般的なシナリオです:

シナリオ1シナリオ2
Labvancedの‘研究設定’とデスクトップアプリを介して外部デバイスを接続します。古いデバイス（シリアルポート付きEEGなど）やカスタムプロトコルの場合、シナリオ2を考慮する必要があります。デフォルト設定で十分でない場合や、別のプロトコルに従う必要がある場合は、Websocket APIを利用して、デバイスとLabvanced間のLSL接続を確立できます。詳細については、Websocket APIドキュメントを参照してください。