Constructor Proctor SDK
SDK configuration parameters
The SDK config parameter that is passed within the await startProctoring function contains a JSON structure with the following parameters (key–value pairs):
| Field | Type | Max. length | Default value | Description |
|---|---|---|---|---|
allowCameraSelection | boolean | — | false | Enables learners to select which camera to use when taking exams. |
alwaysShowChat | boolean | — | false | Enables showing the chat in any proctoring mode, including Post-exam review. For example, for non-proctored exams a test taker can use the chat to seek assistance from the administrator through the dashboard interface. |
beforeExamList | boolean | — | false | Displays the pre-exam instructions with the list of steps for the pre-exam check. |
desktopCheckFirst | boolean | — | false | Places the step for checking screen-sharing access before the camera check. |
disabledWorkers | string | — | 'watchUploading', 'ping' | Disables violation checks during exams (e.g., missing video from the learner's desk). For the full list of violations, contact the Constructor Support team. |
experiment_watchWindowSize | boolean | — | false | Enables monitoring the size of the active browser window during the exam. If the exam window is reduced below a critical size, a modal window will open, informing the user of a rule violation. |
focusRespectsRules | boolean | — | true | Enables tracking of mouse focus changes and active window switching when use of external apps (like calculator, Excel, messengers, or websites) is allowed. |
fullScreenWatchFocusAlert | boolean | — | true | Displays full-screen alerts about exam rule violations. If set to false, no alerts are shown to test takers, but the system still detects focus changes. |
identificationOnboardingBullets | object | — | Sets a separate list of items for the PhotoOnboarding page for each language. Example: json { "en": ["item one", "item two", "item #"], "es": ["item one in es translation", "item two in es translation"], "it-ch": ["item one in it-ch translation"] } | |
openAgreementLinksInIframe | boolean | — | false | Opens external links within the application rather than a new browser tab. |
shouldEnableAudioNotification | boolean | — | true | Enables sound notifications for chat messages. |
showFinishExamButtonForSessionsWithoutProctor | boolean | — | true | Controls visibility of the Finish exam button for sessions without live proctoring. When set to false, the button is hidden. |
showSyscheckSupportNew | boolean | — | false | Displays the support link on pre-exam check pages. |
syscheckHelpURL | string | — | — | URL(s) for the support link. |
translationsOverride | object | — | Changes key–value pairs for translations into any languages. |