AFK Module - User inactivity

Arcware Cloud user portal - Advanced Settings

Description

The AFK (away from keyboard) module is used for controlling the behaviour of user inactivity. It is located in Arcware's WebSDK Player and thus tracked and controlled in the browser.

Nevertheless, there are three locations from where the WebSDK player can source the AFK settings.

  1. Property settings directly in frontend

  2. Project settings on platform

  3. ShareID from platform

If there are no settings in any of the three locations, then no user inactivity is tracked and if someone leaves the stream open in the browser it will continue running until it hits the limit of "maximum instance run-time".

Properties

AFK properties
  • Overwrite afk-module (Only for options in project settings and ShareID)

  • Enable timeouts

    • Warn timeout

    • Error timeout

    • Action timeout

The "overwrite afk-module" option governs if the settings made in either project settings or share ID should overwrite the settings made in frontend, regardless if they are event present there or not. Whereas the ShareID would on top overwrite the values set in project settings.

Priority => ShareID Settings -> Project Settings -> Frontend Settings

if none are present, no user inactivity is tracked

The "Enable timeouts" will tell the frontend module if user inactivity should be tracked or not. This way one can forcefully disable / enable tracking of user inactivity on frontend, regardless of all the settings made there. If "Enable timeouts" is set to true, then frontend will track user inactivity in three stages: Warn, Error, Action. The time set always goes on top of the previous stage.

"Warn timeout" is the time of user inactivity until the player shows a message to warn about the inactivity.

"Error timeout" is the time after the warning appeared until an error message is shown for user inactivity

"Action timeout" defines how long an error message remains visible on the screen and how long the system waits for the user to interact with the stream before marking them as inactive. Once the action timeout expires, the frontend will close the connection.

The total time from the last user action to session closure is the sum of all three stage timeouts, measured in seconds.

Defaults

When working with the WebSDK, no defaults are set for the AFK module. The frontend developer is responsible on their own to set up values.

When previewing the project via the Arcware platform or with a ShareID link, if no custom AFK values are set, then the defaults AFK values are imposed by Arcware. The AFK module is active with following default values:

  • Warn: 600

  • Error: 60

  • Active: 10

Recommendation: Enable the AFK-module in project settings and control the behaviour for user inactivity in accordance with your needs.

Default Arcware Cloud AFK window inactivity is detected. Can be customized using the WebSDK for custom integration.

Last updated