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

概要

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

注: デスクトップアプリは、グループライセンスおよび部門ライセンスの保有者のみが利用可能です。

インストールプロセス

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

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

デスクトップアプリは、以下のオペレーティングシステムに対応しています:

Windows
MacOS
Linux Ubuntu

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

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

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

これにはさらに数秒かかります
この時点で、ダイアログボックス内で以下のことができます: a.) デスクトップにショートカットを作成し、b.) ダウンロードが完了次第、アプリを起動するよう選択する

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

最新のMacOSバージョンでは、「プライバシーとセキュリティ」メニュー内の「任意の場所からダウンロードされたアプリケーションを許可する」オプションが隠されています。そのため、デスクトップアプリをダウンロードする前に、これを選択する必要があります。

MacOSプライバシーとセキュリティのデフォルトビューでは‘Anywhere’からダウンロードされたアプリが許可されていません。
デフォルトビューでは‘Anywhere’からダウンロードされたアプリが許可されていません。

このオプションを選択できるように表示させるためには:
アプリケーションを検索するために検索バーに移動します
‘Terminal’アプリケーションを見つけて開きます（これはすべてのコンピュータに存在する一部です）
このコマンドをターミナルに貼り付けて sudo spctl --master-disable と入力し、Returnまたはエンターキーを押します
確認のためにパスワードを尋ねられます
‘プライバシーとセキュリティ’メニューに戻り、‘Anywhere’を選択します
これで、上記で説明したインストールプロセスに戻り、デスクトップアプリのインストールを続けることができます

ターミナルコマンドを実行すると、MacOSのプライバシー設定で‘Anywhere’オプションが利用可能になります。
ターミナルコマンドを実行すると、‘Anywhere’オプションが利用可能になります。

アプリのウォークスルー

メインビュー

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

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

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

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

大きな違いは、ここにある「ローカル」と「オンライン」モードの上部トグルです。このトグルを「ローカル」に切り替えると、ローカルに利用可能な研究のみが表示されます。

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

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

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

この‘ローカル’または‘オフライン’ビューでは、研究が表示されるようになります。これは他のオンラインモードに似ていますが、データ収録専用の研究のより集中した、クリーンなビューです。

同期設定

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

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

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

同期設定オプション	説明
`自動ダウンロード`	研究デザインを更新します。インターネット接続が再接続された際、実験デザインに加えた変更が自動的にローカルバージョンに反映されます。これにより、自分で同期することを毎回思い出す必要がありません。
`自動アップロード`	参加者データをアップロードし、サーバーにバックアップします。ローカルで記録されたデータはLabvancedサーバーにアップロードされます。したがって、これが選択されていない場合、そのデータはローカルに保持され、希望に応じてエクスポートできます。
`双方向同期`	実験とデータの両方が更新されます。変更があった場合、実験デザインが自動的に同期し、またデータの記録がサーバーに送信されます。
`自動同期なし`	研究を完全にローカルに保持します。オンライン中に変更があった場合、実験は更新されず、データ記録はサーバーに送信されません。

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

研究を実行する

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

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

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

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

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

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

EEGシステム
眼球追跡装置
動きセンサー
ウェアラブル
その他多くのデバイス

詳細なウォークスルー: EEG接続での研究設定の詳細なウォークスルーと例については、このページを参照してください。

以下は、Labvancedで作成されたEEG研究からのデータ記録セッションの画像です:

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

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

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