setSettings

Description: Set VideoSDK/Room settings.

All settings are global which means that they apply to the entire application and do not depend on the authorized user.

Request example:

{
    "method" : "setSettings",
    "requestId" : "1",
    "settings" : {
         "audioPlayLevel" : 0.55,
         "enableAutologin" : true
    }
}

Response example:

{
    "method" : "setSettings",
    "requestId" : "1",
    "result" : true
}

Parameter description:

• aecEnable — the flag indicating if echo cancellation is enabled

• agcEnable— the flag indicating if automatic gain control is enabled

• appShowUserNameLabels — the flag indicating if users’ display names will be shown in the video layout

• audioCapturerLevel — the audio capture level. It is a read-only property if automatic gain control is enabled

• audioPlayLevel — Audio playback level

• autoAccept — Accept calls and invitations automatically

• autoAcceptPodiumFromOwner— the flag indicating if a VideoSDK/Room user can automatically accept podium invitations in a role-based conference

• autoAllowPartToTakePodium — the flag indicating if participants can automatically take the podium (without having to ask for the permission) in a role-based conference where VideoSDK/Room is the owner

• bestQualityForHttpServerImages — Flag for receiving images from the HTTP server with enhanced quality

• cameraRemoteControlAccess — the response to the request for the remote control of the VideoSDK/Room camera. The following values are possible:

  • 0 — Allow for all automatically

  • 1 — Ask permission every time

  • 2 — Always forbidden

• changeUserAuthPinAfterConf — change a user’s PIN for authorization after each conference session

• defaultMultiConfMatrix — Default layout for a group conference. It can be as follows:

  • 0 — Show only one window. If there are more windows in the list, the first one will be shown.

  • 1 — All windows are the same size.

  • 2 — One window is large (in the upper left corner), other smaller windows are placed around the large one.

  • 3 — One large window (in the center at the top), other smaller windows are placed at the bottom.

  • 4 — One window is large (in the left corner), other smaller windows are placed to the right of the large one.

  • 5 — One window is large (in the center at the top), other smaller windows are placed at the bottom and can overlap the larger one within reasonable limits.

  • 7 - one large window (centered at the top) and one small window in the bottom left corner overlaying the large one

• defaultP2PMatrix — the default layout for point-to-point video calls. It is a local setting. The following options are possible:

  • 0 — Show only one window. If there are more windows in the list, the first one will be shown.

  • 1 — All windows are the same size.

  • 2 — One window is large (in the upper left corner), other smaller windows are placed around the large one.

  • 3 — One large window (in the center at the top), other smaller windows are placed at the bottom.

  • 4 — One window is large (in the left corner), other smaller windows are placed to the right of the large one.

  • 5 — One window is large (in the center at the top), other smaller windows are placed at the bottom and can overlap the larger one within reasonable limits.

  • 7 - one large window (centered at the top) and one small window in the bottom left corner overlaying the large one

• defaultOutputSelfVideoRotateAngle — the default turn angle of the self-view video (specified in degrees). The following values are possible: 0, 90, 180, 270.

• displayNameAlign — the location of display names in video windows. The following values are possible:

  • 1 — above

  • 2 — below

• enableAutologin — the flag indicating if VideoSDK/Room should be automatically authorized when connecting to the server if authorization has been done previously

• forbidDirectConnection — prohibit direct connection in a video call

• highlightActiveSpeakers — spotlight active speakers in the layout

• inputBandWidth - incoming bandwidth limit in kbps. Acceptable values range from 32..20480

• language — the UI language of VideoSDK/Room. The following values are possible:

  • "ru"— Russian locale

  • "pl" — Polish locale

  • "en" — English locale

  • "es" — Spanish locale

  • "pt" — Portuguese locale

• outputBandWidth - limitation of the outgoing bandwidth in kbit/s. Acceptable values range from 32..20480

• qrCodeRecognition — the flag indicating if real-time QR code scanning is enabled for the current camera; this feature will be needed for automatic processing of trueconf links

• record — the settings allowing recording of the content shared from VideoSDK/Room during video calls and group conferences. The following values are possible:

  • 0 — do not allow recording to anyone

  • 1 — always request permission for recording

  • 2— allow recording to all contacts from the address book

  • 3 — allow recording to everyone

• rejectCallsNotFromAB — the flag indicating if it is necessary to block the calls from users who are not in the VideoSDK/Room address book

• restoreWindowWhenCall — display the VideoSDK/Room window in full size and show it over other windows during a conference

• selfViewMirror — the flag indicating if the self-view can be mirrored. Available only on the side of VideoSDK/Room

• showCurrentUserWidget — PRO flag indicating if it is necessary to display information about the current user in the VideoSDK/Room window

• showIncomingRequestWidget — PRO flag which indicates if it is necessary to display the widget with incoming requests in the VideoSDK/Room window

• showInfoConnect — PRO flag which indicates if it is necessary to display the information needed for connection in the VideoSDK/Room window

• showInfoWidgets — PRO flag which indicates if it is necessary to display all information widgets in the VideoSDK/Room window

• showLogo — PRO flag which indicates if it is necessary to display the logo in the VideoSDK/Room window

• showTime — PRO flag which indicates if it is necessary to display time and date in the VideoSDK/Room window

• showUpcomingMeetings — PRO flag which indicates if it is necessary to display information about upcoming meetings in the VideoSDK/Room window

• switchToActiveSpeaker — move the active speaker to the spotlighted window in the layout

• stickToDisplay — the flag indicating if the VideoSDK/Room main window should be pinned to the current display.

• requestId - a unique request identifier. You can learn more about it here.

• hideNonVideoParticipants - hiding video slots from participants who are not sending video

• alwaysDisplaySelfView - flag for positioning self-view over the video layout in all types of conferences

• allowHIDControl - a flag indicating the status of functionality for working with HID devices

See also:

• getSettings
• settingsChanged