{"__v":8,"_id":"569590f7fcb1032d0089e033","category":{"__v":10,"_id":"55e75b39e06f4b190080dbfe","pages":["56959043fe18811700c9c09e","569590bfcb14e11700f8a877","569590f7fcb1032d0089e033","5695917dfcb1032d0089e035","5695964a77ba0d2300cf3912","5695967edcaf0d1700cb8752","569618eccb14e11700f8a910","56961d937596a90d0014e571","5696ba13480534370022a37a","56dd002ee5c8570e00a79865"],"project":"55d535ca988e130d000b3f5c","version":"55d535cb988e130d000b3f5f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-02T20:25:29.622Z","from_sync":false,"order":3,"slug":"frame-for-business","title":"Frame for Business"},"parentDoc":null,"project":"55d535ca988e130d000b3f5c","user":"55d535835082980d0009c965","version":{"__v":12,"_id":"55d535cb988e130d000b3f5f","hasDoc":true,"hasReference":false,"project":"55d535ca988e130d000b3f5c","createdAt":"2015-08-20T02:04:59.052Z","releaseDate":"2015-08-20T02:04:59.052Z","categories":["55d535cc988e130d000b3f60","55d6b238d2a8eb1900109eef","55d6b4f3250d7d0d004274cd","55d7967960fc730d00fc2852","55da9804e835f20d009fc5d0","55e75b1de06f4b190080dbfd","55e75b39e06f4b190080dbfe","55e75b7ae06f4b190080dbff","564f5a4e33082f0d001bb709","570fb64aa38d470e0060cbff","586d0dd89a854123001acd65","586d0e3b9a854123001acd66"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":["56959419fe18811700c9c0fe"],"next":{"pages":[],"description":""},"createdAt":"2016-01-12T23:49:11.230Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"Frame Platform and Frame for Business/Education accounts give you three parameters to control how long sessions can run:\n\n**Max session duration** (set in the SETTINGS/PRODUCTION tab of the Dashboard): this is the maximum length of time that a session can run. It is also what is shown in the status bar countdown timer in the session itself.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3XIauOBTQjmxbGFv8yAN_Screenshot%202016-01-13%2018.25.43.png\",\n        \"Screenshot 2016-01-13 18.25.43.png\",\n        \"535\",\n        \"329\",\n        \"#447cb4\",\n        \"\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n**User inactivity timeout** (set in the SETTINGS/GENERAL tab of the Dashboard): this is the maximum amount of time that Frame will keep a session connected when there is no user activity (no mouse/keyboard events). Frame will pop up a warning at the 1 minute to go mark and then disconnect the session afterwards.\n\n**Idle timeout** (set in the SETTINGS/GENERAL tab of the Dashboard): when you are using only the embedded player (e.g., Frame Platform with anonymous users), this setting does not apply and should be set to 0. This setting applies to sessions that are launched from the Frame Launchpad (e.g., the typical case for Frame for Business/Education accounts), which uses authenticated users who can disconnect from a session and reconnect later to the same running session. The idle time is the amount of time that a session will be kept active AFTER an authenticated user disconnects from the session (either by closing the app with the \"x\" in the top right corner of the app or by hitting \"Disconnect\" from the gear menu).  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/r1EeXCnyQUKT1Wcyu0C6_Screenshot%202016-01-13%2018.24.41.png\",\n        \"Screenshot 2016-01-13 18.24.41.png\",\n        \"518\",\n        \"343\",\n        \"#447cb3\",\n        \"\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Example\"\n}\n[/block]\nNote that these three settings work together. For example, assume the following settings:\n\n  * Max session duration = 120 minutes\n  \n  * User inactivity timeout = 10 minutes\n   \n  * Idle timeout = 30 minutes\n\nLet's say a user starts a session at 1:00 p.m., works actively for 15 minutes, then leaves off. Here's what happens:\n\n**1:00 p.m.** Session start\n\n**1:15 p.m.** The user stops working and the User Inactivity timer starts\n\n**1:24 p.m.** After 9 minutes of inactivity, a notice telling the user that the session will disconnect in 1 minute pops up.  \n\n**1:25 p.m.** If the user didn't click anything (is away from the desk), the session will be disconnected, and the Idle Timeout timer starts. The session is still running in the background.\n\n**1:25 to 1:55 p.m.** The session continues running in the background, and the user could resume the session if he or she wishes (from the same or another device).\n\n**1:55 p.m.** The session is ended.\n\nIn this case, the Max Session timer never ran out, so it was not used to end the session. If the Max Session timer had been set to 45 minutes, it would have ended the session at 1:45 p.m.","excerpt":"Keep control of over hourly usage","slug":"set-up-session-time-limits","type":"basic","title":"Set up session time limits"}

Set up session time limits

Keep control of over hourly usage

Frame Platform and Frame for Business/Education accounts give you three parameters to control how long sessions can run: **Max session duration** (set in the SETTINGS/PRODUCTION tab of the Dashboard): this is the maximum length of time that a session can run. It is also what is shown in the status bar countdown timer in the session itself. [block:image] { "images": [ { "image": [ "https://files.readme.io/3XIauOBTQjmxbGFv8yAN_Screenshot%202016-01-13%2018.25.43.png", "Screenshot 2016-01-13 18.25.43.png", "535", "329", "#447cb4", "" ], "border": true } ] } [/block] **User inactivity timeout** (set in the SETTINGS/GENERAL tab of the Dashboard): this is the maximum amount of time that Frame will keep a session connected when there is no user activity (no mouse/keyboard events). Frame will pop up a warning at the 1 minute to go mark and then disconnect the session afterwards. **Idle timeout** (set in the SETTINGS/GENERAL tab of the Dashboard): when you are using only the embedded player (e.g., Frame Platform with anonymous users), this setting does not apply and should be set to 0. This setting applies to sessions that are launched from the Frame Launchpad (e.g., the typical case for Frame for Business/Education accounts), which uses authenticated users who can disconnect from a session and reconnect later to the same running session. The idle time is the amount of time that a session will be kept active AFTER an authenticated user disconnects from the session (either by closing the app with the "x" in the top right corner of the app or by hitting "Disconnect" from the gear menu). [block:image] { "images": [ { "image": [ "https://files.readme.io/r1EeXCnyQUKT1Wcyu0C6_Screenshot%202016-01-13%2018.24.41.png", "Screenshot 2016-01-13 18.24.41.png", "518", "343", "#447cb3", "" ], "border": true } ] } [/block] [block:api-header] { "type": "basic", "title": "Example" } [/block] Note that these three settings work together. For example, assume the following settings: * Max session duration = 120 minutes * User inactivity timeout = 10 minutes * Idle timeout = 30 minutes Let's say a user starts a session at 1:00 p.m., works actively for 15 minutes, then leaves off. Here's what happens: **1:00 p.m.** Session start **1:15 p.m.** The user stops working and the User Inactivity timer starts **1:24 p.m.** After 9 minutes of inactivity, a notice telling the user that the session will disconnect in 1 minute pops up. **1:25 p.m.** If the user didn't click anything (is away from the desk), the session will be disconnected, and the Idle Timeout timer starts. The session is still running in the background. **1:25 to 1:55 p.m.** The session continues running in the background, and the user could resume the session if he or she wishes (from the same or another device). **1:55 p.m.** The session is ended. In this case, the Max Session timer never ran out, so it was not used to end the session. If the Max Session timer had been set to 45 minutes, it would have ended the session at 1:45 p.m.