Skip to content

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):

FieldTypeMax. lengthDefault valueDescription
allowCameraSelectionbooleanfalseEnables learners to select which camera to use when taking exams.
alwaysShowChatbooleanfalseEnables 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.
beforeExamListbooleanfalseDisplays the pre-exam instructions with the list of steps for the pre-exam check.
desktopCheckFirstbooleanfalsePlaces the step for checking screen-sharing access before the camera check.
disabledWorkersstring[]['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_watchWindowSizebooleanfalseEnables 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.
focusRespectsRulesbooleantrueEnables tracking of mouse focus changes and active window switching when use of external apps (like calculator, Excel, messengers, or websites) is allowed.
fullScreenWatchFocusAlertbooleantrueDisplays 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.
identificationOnboardingBulletsobject{}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"] }
openAgreementLinksInIframebooleanfalseOpens external links within the application rather than a new browser tab.
shouldEnableAudioNotificationbooleantrueEnables sound notifications for chat messages.
showFinishExamButtonForSessionsWithoutProctorbooleantrueControls visibility of the Finish exam button for sessions without live proctoring. When set to false, the button is hidden.
showSyscheckSupportNewbooleanfalseDisplays the support link on pre-exam check pages.
syscheckHelpURLstring[]URL(s) for the support link.
translationsOverrideobject{}Changes key–value pairs for translations into any languages.