はじめに
このガイドでは、Proctorioをお使いの学習プラットフォームにゼロから統合する方法を説明します。
前提条件
- Proctorio APIキー（アカウントマネージャーにお問い合わせください）
- URLでアクセス可能な試験ページを持つLMSまたは試験プラットフォーム
- HTTPS対応の試験URL（試験監督に必須）
統合フロー
統合はシンプルなパターンに従います：
- お使いのプラットフォーム 試験設定を含むPOSTリクエストをProctorio APIに送信します
- Proctorio API 安全なURLを返します
- お使いのプラットフォーム 受験者をそのURLにリダイレクトします
- Proctorio 事前チェック、監視、録画を処理します
- 試験が終了する 受験者が
exam_endのURLパターンに到達した時点で終了します
URLパターンマッチング
Proctorioは正規表現パターンを使用して試験のライフサイクルを把握します：
exam_start— 試験が始まる場所（起動ページ）exam_take— 試験の一部であるページ（問題、ナビゲーション）exam_end— 試験が提出された場所
重要：
launch_urlの値はexam_startパターンと一致する必要があります。試験ページ間のすべてのリダイレクトはexam_takeパターンと一致する必要があります。
シングルページアプリケーション
試験の状態間でURLが変わらないSPAの場合は、postMessage APIを使用してください：
// Transition to exam-taking state
window.top.postMessage(
["exam_state_change", "exam_take"],
"https://getproctorio.com"
);
// Exam completed
window.top.postMessage(
["exam_state_change", "exam_end"],
"https://getproctorio.com"
);postMessageを使用する場合、対応するパラメータ値を"post_message_notification"に設定してください。
試験設定クイックリファレンス
| 設定 | 目的 | 依存関係 |
|---|---|---|
record_video | Webカメラの録画 | なし |
record_audio | マイクの録音 | なし |
record_screen | デスクトップ全体の録画 | なし |
verify_video | Webカメラの検証 | record_video |
verify_id | 本人確認 | record_video、verify_video（レベル2の場合） |
full_screen | フルスクリーンを強制 | close_tabs、one_screen、tabs: 1 |
live_proctor | リアルタイム監視 | record_video、verify_video |
エラー処理
すべてのAPIエラーは構造化されたJSONを返します。詳細についてはエラー処理ガイドをご覧ください。