ビデオ会議オブジェクト
概要
Video Conference Objectは、2人以上の参加者がLabvancedの研究中に通話に参加できるようにします。これは、社会心理学やチーム研究の設計の一部として使用できるほか、単に通話に参加して参加者に追加の指示を提供する方法としても使用できます。Video Conference Objectには、画面共有やビデオの切り替えが許可されているかを指定するなど、多くの制御オプションが付属していますが、イベントを介して実験のニーズに合わせて調整することもできます。
内容:
研究設定
あなたの研究のStudy Settingsタブの下で、Stream IO (Video Conferencing) Integrationのオプションが有効になっていることを確認してください。ここで、Stream IOビデオ会議プラットフォームによって提供されたAPIキーとAPI秘密キーを入力します。
ビデオ会議オブジェクトのためのAPIキーの取得
StreamIOにアカウントを作成すると、ダッシュボードに移動し、ページ右上隅にあるCreate Appという青いボタンをクリックできます。ここで、希望するサーバーの位置やその他の設定オプションを指定できます。それを作成すると、APIキーとAPI秘密キーにアクセスできるようになり、それらを上記のLabvancedStudy Settingsに貼り付ける必要があります。
基本プロパティと機能
エディターにビデオ会議オブジェクトを追加する
Video Conference Objectをエディターに追加できるようにするには、最初に前のセクションで説明したように、Study SettingsタブにAPIキーを入力する必要があります。
それを行った後、タスクエディターツールバーのMediaグループを開き、Video Conferenceを選択します。それを選択すると、ユニークな変数名を割り当てるように求められます。
変数が作成されると、音声とビデオの設定を有効にするように求められます。研究に基づいて、音声だけを有効にすることや、ビデオだけを有効にすること、またはどちらも有効にすることができます。
ビデオ会議変数について
Variablesタブから、作成された変数がリストされているのを見ることができます。Start Valueは自動的に作成されることに注意してください。これは、特定の通話を区別するためのCall IDの既定値として使用されます（たとえば、研究に複数の通話が設定されている場合、ユニークなIDは通話の設計および調整に重要です）。
この値は、特定の通話に関するstreamIOとのすべてのインタラクションを処理するために使用されます。
高度または複雑な設計がある場合は、質問があればお気軽にお問い合わせください。
注意: ビデオ会議オブジェクトを含む研究の基本ケースは、すべての参加者が同じ会議に参加することです。これは、このオブジェクトをタスクに追加して何も他に行わない場合の既定の動作です。参加者が別々の通話に参加する必要がある場合は、いくらかの作業が必要です（例：Call ID変数の設定および制御） また、通話を特定の参加者数に制限する場合は、カスタマイズされたイベントアクションが必要になります。
ビデオ会議オブジェクトのプロパティ
- 会議の録音: 録音オプションを使用すると、会議中に各参加者の個別の.mp4ファイルを録音できます。
- 画面共有を許可: 通話中に画面共有を有効にします。これを設定する方法については、次のセクションを参照してください。
- マイクの切り替えを許可: 参加者がマイクをオン/オフに切り替えることを許可します。
- カメラの切り替えを許可: 参加者がカメラをオン/オフに切り替えることを許可します。
- 通話ボタンを表示: 参加者がクリックして通話に参加するための通話ボタンを表示します。これを無効にすることができ、イベントを使用して参加者が通話に自動的に入るようにすることができます（研究の開始時やその他の特定の時点でのいずれか）。
追加オプションには次のものがあります:
- 音声を必要: 通話中に音声が必要です。つまり、マイクの権限がオンである必要があります。
- ビデオを要求: 通話中にビデオが必要です。つまり、カメラの権限がオンである必要があります。
- 持続的な会議: 他の試行が行われている間も会議接続がバックグラウンドで続き、参加者がビデオ会議オブジェクトがあるタスクまたは試行に戻ると、再度会議に参加できるようにします。
データのダウンロード
Dataview & Exportタブの下で、特定のセッションに移動して参加者の録音をプレビューできます。録音フォルダーを右クリックすると、.mp4録音をzipフォルダーにダウンロードできます。そのフォルダー内で、特定の録音を見つけることができます。
重要な注意: 録音はStreamIO統合の性質上、わずか2週間しか保持されません。通話関連データ、つまりビデオファイルをその前にダウンロードするようにしてください!!!
画面共有の有効化
研究が画面共有を含む場合は、これを有効にするためにいくつかの追加ステップが必要です。画面共有を有効にするには、Labvanced実験で使用するために作成した特定のアプリのStreamIOダッシュボードに移動する必要があります（つまり、APIキーを取得するために作成したアプリ）。
その後、Video & Audio → Roles & Permissionsの設定で、ゲストユーザーに画面共有の権限を追加する必要があります。
最上部で、Roleドロップダウンからguestオプションを選択し、Scopeドロップダウンからdefaultオプションを選択することに注意してください。
ただし、ページの上部にある編集ボタンを使用して、ゲストユーザーの権限としてScreenshare権限を追加する必要があります。
イベント: ビデオ会議オブジェクトのさらなる制御
以下は、実験を設計する際に考慮すべきビデオ会議オブジェクトのハンドリングに関連する便利なイベント（トリガーとアクション）です。
メディアオブジェクトトリガー
Media Object Triggerオプションでは、通話の側面をアクション発生の前提条件として使用できます。たとえば、参加者がJoinedConferenceした場合、実験内で特定のアクションセットが発生することができ、動画が再生されたり、特定の指示が表示されたりします。
オブジェクトプロパティアクションの設定
アクションメニューからObject Actions → Set Object Propertyを選択して、ビデオ会議オブジェクトの特定のプロパティを制御できます。
ビデオ会議オブジェクトをTargetとして指定することで、任意のオブジェクトプロパティ（下の画像のドロップダウンメニューを参照）を指すことができ、実験中にそれを変更できます。
メディアオブジェクトアクションの制御
アクションメニューからObject Actions → Control Media Objectを選択して、ビデオ会議オブジェクトの機能を制御できます。
オブジェクトをTargetに設定することで、トリガーが発生した際に発生すべき効果を指示できます。たとえば、誰かがボタンをクリックすると（トリガー）、メディアオブジェクトを制御して（ターゲットであるビデオ会議オブジェクト）、参加者が通話に参加できるようにします。
注意: 'LeaveConference'と'EndConference'オプションの間の重要な違いに注意してください。'LeaveConference'は本質的に通話を切るようなもので、参加者が通話を離れることを許可します。一方、'EndConference'はより影響力のある意味を持ち、通話を完全に閉じて将来的に使用できなくします。
ビデオ会議オブジェクトの役立つデモ（インポータブル）
以下は、パブリック実験ライブラリで見つけることができるいくつかの役立つ研究です。ビデオ会議オブジェクトの特定の機能を示すオブジェクトとイベントがどのように設定されているかを見ることができます。
このデモでは、参加者がSCS-SF質問票を記入する前に会議通話をホストし、質問票を提出した後に彼らと会うことができます: https://www.labvanced.com/page/library/71890