オブジェクト

説明: オブジェクトの操作

オブジェクトはタスク階層の最も低いインスタンスであり、フレームに配置されます。タスクエディタでは、オブジェクトはメディア、形状、テキスト、ボタンとナビゲーション、質問オプション、質問入力、および質問のさまざまな7つのグループに分けられています。これらの要素は、実験タスクと刺激を作成するための構築ブロックとして使用されます。

Labvancedで利用可能なオブジェクトの概要については、このイントロダクションビデオをご覧ください：

オブジェクトは、フレームの左側にあるオブジェクトツールバーから追加できます。

現在選択されているフレームに配置されたすべてのオブジェクトのリストは、エディタの右側の「オブジェクト」タブに表示されます。ユーザーはオブジェクトのz-indexを変更（他のオブジェクトの前に表示されるオブジェクト）、コピー、およびオブジェクトを削除できます。

オブジェクトはイベントシステムの一部として使用され、特定のアクションが発生したときに刺激が何らかの方法で操作されます。たとえば、参加者が画像をクリックしたときにそのサイズを大きくしたい場合、それはイベントによって処理されます。

「現在選択されているオブジェクト」は、フレーム上で直接クリックするか、オブジェクトリスト内の該当オブジェクトをクリックすることによって選択できます。

オブジェクトを選択した後、適切な修正子（デフォルトトライアル、ファクターレベル、条件、または単一トライアル）を選択すると、変更はキャンバス上で直接行うか、右側の「オブジェクトプロパティ」パネルを使用して行うことができます。このパネルには、現在選択されているオブジェクトのすべてのプロパティが表示され、入力フィールドやチェックボックスなどを使用して修正できます。 オブジェクトプロパティについて詳しく読む.

オブジェクトリストとカスタムプロパティ

利用可能なオブジェクトの完全な概要とその説明は次の通りです:

画像と描画オブジェクト

オブジェクトのサイドメニューの最初のアイコンをクリックすると、利用可能な画像と描画オブジェクトのリストが表示されます。ここでは、画像刺激、SVG、キャンバス描画を許可したり、ポリゴンを作成したりできます。

以下の表は、Labvancedで利用可能な画像と描画オブジェクトの概要を示しています:

インターフェイス	オブジェクト名	説明
	画像オブジェクト	画像オブジェクトは、キャンバスフレーム上に画像を表示するために使用できます。画像はファイルマネージャーを介して手動で設定できますが、実験の実行中にイベントと変数を使用して動的に変更もできます（データタイプファイル）。 詳しく学ぶ.
	SVGオブジェクト	SVGはキャンバスエディタにアップロードできます。このオブジェクトはLabvancedに基づく眼球追跡研究で人気があります。SVGは複雑な形状をとることができ、特定のSVG領域での注視数など、眼球追跡関連のイベントをトリガーする「マスク」として使用されます。
	キャンバス描画オブジェクト	キャンバス描画要素は、参加者がデバイスのマウス、指、またはトラックパッドを使用して画面に「描く」ことを許可します。描画スペースは、オブジェクトタブのチェックボックスを使用してこの機能を有効にすると、サイズを変更できます。参加者は描画、消去、および三角形、長方形、円などの形状を追加できます。形状は追加後に描画内をドラッグして移動できます。参加者はペンや形状の色を変更することもできます。研究者は、参加者がそのボックス内で描画できないように「参加者による描画を許可」ボックスのチェックを外すことで、実験用に静的画像を描画するためにこのツールを使用することができます。いずれにせよ、描画は参加者のプライベートファイルに画像として保存され、カメラスナップショットオブジェクトと同様です。各ツールバーは、該当するボックスをチェックすることで有効または無効にできます。
	ポリゴンオブジェクト	ポリゴンオブジェクトは、Labvancedエディタ内で複雑な形状を作成するためにクリックしてマスクやAOIを作成するために眼球追跡研究でも使用できます。このオブジェクトはポリラインを作成するためにも使用できます。 このデモでは、ポリゴンオブジェクトが眼球追跡研究の一部としてどのように注視数をカウントするために使用できるかを示しています。

メディアオブジェクト

サイドメニューの2番目のアイコンをクリックすると、すべての利用可能なメディアオブジェクトが表示されます。

以下の表は、Labvancedで利用可能なメディアオブジェクトの概要を示しています:

インターフェイス	オブジェクト名	説明
	ビデオオブジェクト	ビデオオブジェクトはキャンバスフレーム上にビデオを表示するために使用されます。ビデオはファイルマネージャーを介して手動で設定できますが、実験の実行中にイベントと変数を使用して動的に変更することもできます（データタイプファイル）。
	オーディオオブジェクト	オーディオオブジェクトはキャンバスフレーム上にオーディオファイルを表示するために使用されます。オーディオファイルはファイルマネージャーを介して手動で設定できますが、実験の実行中にイベントと変数を使用して動的に変更することもできます（データタイプファイル）。
	オーディオ録音オブジェクト	オーディオ録音オブジェクトは、実験中の音声録音の視覚的インターフェイス/ハンドルとして機能します。録音はボタン、フレームイベント、または他のオブジェクトトリガーイベントを介して開始および停止可能で、Labvancedの安全なサーバーにアップロードされます。
	ビデオ録画オブジェクト	このオブジェクトは参加者のビデオを録画したり、参加者のスクリーンを録画したり、両方を同時に録画するために使用されます。有効または無効にできるいくつかのオプションがあります: 録画されたビデオを参加者にリアルタイムまたは実験の後で表示するか（または全く表示しないか）、参加者がビデオの開始/停止/アップロードを制御できるか、ビデオが変数としてどこに保存されるかを決定します。ビデオ録画オブジェクトは参加者からの音声も録音します。 詳しく学ぶ.
	カメラスナップショットオブジェクト	このオブジェクトは参加者の写真スナップショットを撮影するために使用されます。これを行うには、実験に対してビデオ録画が有効である必要があります。カメラボタン、スナップショットボタン、およびアップロードボタンを参加者に表示するか、隠すかを選択できます。イベントを使用してカメラスナップショットをトリガーしたり、参加者自身が制御することもできます。このツールは参加者の身元/人口統計情報を確認するのに役立ちますが、高度に機密情報として扱う必要があります。スナップショットはファイル変数として保存されます。 注意 1: 被験者またはその画面のビデオ/画像を録音することは高機密です。参加者が実験の内容を十分に理解していることを確認してください。 注意 2: いかなる種類のウェブカメラが研究で使用される場合（眼球追跡、ビデオ、スナップショットなど）、参加者は研究の開始時にどのカメラを使用するかを選択するよう求められます。これにより、参加者は内蔵ウェブカメラシステムを使用したくない場合に接続された外部カメラを選択できます。
	ビデオ会議オブジェクト	ビデオ会議オブジェクトは、実験の期間中に参加者間でビデオまたは音声通話を埋め込んだりホストしたりすることを許可します。 詳しく学ぶ.

テキストとコードオブジェクト

オブジェクトサイドメニューの3番目のオプションはテキストとコードであり、そこにあるオブジェクトは次の通りです：

インターフェイス	オブジェクト名	説明
	テキストオブジェクト	このオブジェクトは、参加者にフレーム上でテキストおよび/または変数を提示します。ユーザーは、フレームの上部にある「ワードライク」テキストエディタ（ツールバー）を使用してテキストを入力および編集できます（下の画像を参照）。変数はテキスト要素に挿入でき、現在の値が表示され（自動的に更新されます）、画面に表示されます。
	HTMLオブジェクト	このオブジェクトは挿入したHTMLをレンダリングします。このオブジェクトをキャンバスエディタに追加した後、選択されている間にオブジェクトプロパティ（右側のパネル）に移動し、下部にHTMLコードを挿入します。
	変数オブジェクト	このオブジェクトを追加することで、エディタ内で特定の変数値をリアルタイムで表示できます。

テキストオブジェクトを操作する際に、「テキストエディタ」が表示され、さらにテキスト関連の編集を行うことができます。これらのオプションの中で、[x] リンクされた変数オプションが非常に人気で、左上に表示されます。このオプションは基本的にテキストをハイライトし、変数にリンクさせてその値を表示させるものです。

表示されるオプション/設定の完全な概要については、テキストエディタページをご覧ください.

ボタンとナビゲーションオブジェクト

インターフェイス	オブジェクト名	説明
	ボタンオブジェクト	標準的なボタンで、ラベルを編集でき、"ButtonClick"トリガーを使用してイベントをトリガーできます。ボタンクリックは参加者の応答変数として記録されることもあります。
	ナビゲーションオブジェクト	このオブジェクトは、2つのボタンとして表示され、前のフレームに戻ったり、次のフレームに進んだりするための2つの事前作成された関連イベントを持っています。
	プログレスバーオブジェクト	プログレスバーは、実験の進行状況をパーセンテージで表示するために使用できます。

質問オブジェクト

インターフェイス	オブジェクト名	説明
	チェックボックスオブジェクト	参加者が1つ以上の回答を選択できる質問要素です。
	複数選択オブジェクト	参加者が1つの選択肢のみを選択しなければならない質問要素です。
	リッカートスケールオブジェクト	通常、声明に対する合意のレベルを示すために使用される質問要素です。参加者は二つのプロンプトの間にぶら下がる回答を選択できます。
	マトリックスオブジェクト	複数の質問や声明を行として表示できる要素です。各声明は同じスケールで回答され、列に表示されます。

これらのオブジェクトの「必須」プロパティは、研究の実行中に動的に変更できます。オブジェクトは表示されていない限り（可視性 = 0）、必須として表示されます。

これらのオブジェクトの応答の順序は、オブジェクトプロパティウィンドウの「アイテム順をランダム化」チェックボックスを使用してランダム化できます。選択肢をランダムに設定した後に提示される順序を記録したい場合は、「リンク順を配列に」ボックスをチェックできます。これにより、「itemOrderArrVar」と呼ばれる要素の提示された選択肢の順序を保存する配列変数が作成されます。配列は、エディタで定義された選択肢の整数値を、要素の上から下に表示される順に記録します。各「itemOrderArrVar」変数の変数タブで、エントリの位置と値を編集できます。

質問入力オブジェクト

インターフェイス	オブジェクト名	説明
	入力オブジェクト	参加者が短い応答を挿入するために使用されます。この要素は、数字（数値）、テキスト（文字列）、日付、時間、色の形式で応答を収集できます。
	段落オブジェクト	入力オブジェクトに似ていますが、より長い応答に使用されます。応答はテキスト（文字列）変数です。
	範囲オブジェクト	この要素を使用すると、参加者はスライドツールを使用して応答を提供できます。ユーザーはこのオブジェクトを設定して数値を表示させることができます（左端、右端、およびスライダーの上の参加者の応答としての数値）または空白のままにすることもできます。 注意 1: ハンドルを最初に隠す: このオプションは、参加者がオブジェクトをクリックするまでハンドル（参加者が応答をするためにスライドする円）を隠します。これにより、参加者が範囲オブジェクトの中央に最初にハンドルを見る際に存在する可能性のあるバイアスが除去されます。
	選択オブジェクト	事前に実験者が可能な応答で満たしたドロップダウンメニューから応答を選択する質問要素です。 注意: このオブジェクトは異なる言語に翻訳できます。 注意 2: 利用可能な応答は、オブジェクトを配列変数にリンクさせることで動的に変更できます。

さまざまなオブジェクト

インターフェイス	オブジェクト名	説明
	ソート可能オブジェクト	ドラッグ＆ドロップ方式で並べ替え可能な複数の要素を持つ質問です。
	不可視要素オブジェクト	不可視要素は参加者には決して見えませんが、イベントをトリガーできるため、キャンバスの見かけ上空の領域でマウスのイベントによってイベントをトリガーすることができます。
	アップロードオブジェクト	参加者はこのオブジェクトを使用してファイルを研究にアップロードできます（その後Labvancedサーバーに保存され）、実験者が後でアクセスできます。
	i-フレームオブジェクト	I-フレームオブジェクトは、実験内にI-フレーム（埋め込まれた他のウェブサイト）を表示するために使用できます。 重要: I-フレームを表示するには、ターゲットURLを制御するサーバーがhttpヘッダー「Access-Control-Allow-Origin」を「*」または「labvanced.com」を含めるように設定する必要があり、httpヘッダー「X-Frame-Options」を設定しないこと。
	サブスタディオブジェクト	この強力なオブジェクトでは、単一の「親」実験内に他のLabvanced研究を埋め込むことができます。 詳しく学ぶ.

オブジェクトプロパティ

現在選択されているオブジェクトのプロパティは、エディタの右側に表示されます。これらのプロパティは、フレーム上のオブジェクトが参加者にどのように見えるかを決定します。多くのオブジェクトプロパティはトライアル間で修正可能ですが、一部のプロパティ（オブジェクトの名前など）は固定されており、トライアルごとに異なることはできません。修正されたプロパティ（デフォルト値と異なるもの）は、濃い灰色の背景色で表示されます。トライアル間で修正可能なすべてのプロパティは、イベント実行中に「set obj property」アクションを使用して動的に修正できます。オブジェクトの「必須」プロパティは、研究の実行中に動的に変更できます。オブジェクトは表示されていない限り（可視性 = 0）、必須として表示されます。これにより、非常にインタラクティブで動的な実験が可能になります。すべてのオブジェクトタイプとそのプロパティの詳細なチャートについては、「オブジェクトプロパティテーブル」ページを参照してください。

タスクエディタでは、オブジェクトの外観を変更して研究の編集を容易にすることができます。これを行うために、ロックと非表示の2つのオブジェクトプロパティがあります。

• ロック: オブジェクトタブのオブジェクト名の隣にある小さな錠前アイコンをクリックすると、その位置がフレーム上でロックされます。これにより、研究を編集しているときにオブジェクトの accidental movement や変更が防止されます。
• 非表示: オブジェクトタブのオブジェクト名の隣にある小さな目アイコンをクリックすると、そのオブジェクトがフレーム上で見えなくなります。これは、フレームに複数のオブジェクトがある場合に便利で、編集中に一度に1つまたは複数のオブジェクトだけを表示することができます。

これらのプロパティはすべて、研究を編集中のみ有効です。タスクエディタでオブジェクトをロックまたは非表示にしても、参加者が研究中にそのオブジェクトを見る方法には影響しません。

カスタムCSSプロパティ

CSSプロパティは、HTMLコードで記述された要素のスタイルです。要素のCSSプロパティは、オブジェクトプロパティタブで要素をクリックして「CSSプロパティを変更」ボックスをチェックすることで変更できます。サンプルコードは、例として灰色のテキストで提供されています。

カスタムコードを書くには、参照要素、そのセレクタ名、コマンド、および値が必要です。編集したい要素のセレクタ名を見つけるには、その要素を右クリックして「検査」をクリックします。これにより、デバイスのコンソールが開きます。たとえば、テキスト要素のセレクタは文字のpです。

コードには中括弧を使用する必要があります。テキスト要素の色を変更するためのコードのサンプルは次のとおりです。

p{

background-color:green

}

背景色などのプロパティはオブジェクトプロパティウィンドウを使用して簡単に変更できますが、CSSプロパティをより具体的にしたい場合もあります。たとえば、マトリックス要素では、要素をカスタマイズするために複数の異なるCSSプロパティを使用できます。

複数の行のコードで同じ要素に多くのカスタムCSSプロパティを追加できます。

コーディングに不慣れな場合やCSSについての詳細情報を希望する場合は、MDNのこのモジュールをご覧ください。