record-participant-video は何をしますか？
Playwrightによる操作、スクリーンショット、ffmpegによる画面/音声キャプチャを用いて、PsyNet参加者のフローに関する視覚的な証拠を記録します。参加者の証拠収集、participant.mp4の作成、参加者向け動作のドキュメント作成時に使用します。
概要
このスキルは、PsyNetプラットフォーム上で参加者が体験する操作フローを自動的に記録します。Playwrightを使用してブラウザ操作をシミュレートし、重要な時点でスクリーンショットを取得し、ffmpegで画面と音声をキャプチャすることで、完全な参加者体験を動画として保存します。
使用方法
-
必要な依存関係をインストールします：
- Playwright（
npm install playwright） - ffmpeg（システムにインストールされていることを確認）
- Playwright（
-
スキルを呼び出して記録を開始します：
const { recordParticipantVideo } = require('record-participant-video');
await recordParticipantVideo({
participantId: 'participant-123',
startUrl: 'https://example-psynet-study.com/start',
outputPath: './recordings/participant.mp4'
});
機能
- Playwright操作: 参加者のブラウザ操作を自動化します。
- スクリーンショット: 指定したイベント（例：クリック、ページ遷移）でスクリーンショットを取得します。
- 画面/音声キャプチャ: ffmpegを使用して、画面全体と音声を連続的にキャプチャします。
- 証拠動画生成: すべてのキャプチャを結合し、参加者のフローを示す単一のMP4ファイルを生成します。
サポート環境
- PsyNet: このスキルはPsyNet実験プラットフォームとの統合を前提としています。
- Node.js: Playwrightを使用するため、Node.js環境が必要です。
- ffmpeg: インストール済みで、PATHが通っている必要があります。
注意事項
- 記録には十分なディスク容量とメモリが必要です。
- 参加者のプライバシーに配慮し、必要に応じて同意を得てから使用してください。
- ffmpegの出力設定（解像度、フレームレート、コーデック）は環境に応じて調整できます。