Documentation
  • Welcome to Odyssey
  • Upload a project
    • Getting Started
    • Set up your project
    • Package for Linux (it's easy)
    • Upload your project
    • Create and publish your space
  • Instant Multiplayer
    • Quickstart
    • Spatial voice & video
      • Add spatial comms to player
      • Huddle
      • Share your screen
    • Avatars
      • Using Avatars
      • Avatar Blueprints
  • Realtime Configurator
    • Quickstart
    • Sketchfab importer
    • Actor importer
    • Level & object configurator
      • Level configurator
      • Object configurator
      • Configurator blueprint API
    • Media importer
      • Vimeo & web panels
      • Dolby.io in-world streams
  • Embed in a website
    • Enable embedding
    • Pass messages to and from Unreal
      • Sending messages to Unreal
      • Receiving messages from Unreal
    • Manage your stream
      • Stream loading states
      • Session states
      • Stream quality settings
      • Dynamic styling
  • Admin
    • Sharing and permissions
    • Subscriptions
    • Purchase stream hours
  • FAQ
    • Our GPUs (Coreweave)
    • Concurrent user limits
    • Vulkan renderer
    • In-world video support on Linux
  • Guides
    • Add the Odyssey plugin
    • Validate your project settings
    • Troubleshoot "Project zip is invalid"
Powered by GitBook
On this page
  • Overview
  • Example payload
  1. Embed in a website
  2. Manage your stream

Session states

Overview

If you want to learn more about the local session status you can watch for MessageChannel event payloads with type == "session-state".

This can be particularly useful when developing your own user interface and seeking information about user-related events, such as a user's AFK status or when a user reaches the maximum session length. Each will contain a value field with one of the following values:

  • afk-warning - A user has been idle, and if no activity is detected within the next 2 minutes, they will be removed

  • afk-reset - Activity detected from an idle user; the AFK timer has been reset

  • afk-closing - The user has been idle for an extended period and will be removed from the space immediately

  • max-session-reached - The user has reached the maximum session duration and will be removed from the space immediately

Example payload

{
  "type": "session-state",
  "value": "max-session-reached"
}

Last updated 1 year ago