user_event

Allows the user to set and send events to the connected client on the call. This is useful for triggering actions on the client side. Commonly used with the browser-sdk. Accepts an object mapping event names to values. The event object can be any valid JSON object.

Properties

Event Object

The event parameter can be any valid JSON object. Any key-value pair in the object is sent to the client as an event type called: user_event.

The client can listen for these events using the on-method.

Examples

Send a custom event to the client

1
version: 1.0.0
2
sections:
3
  main:
4
    - user_event:
5
        event:
6
          myCustomEvent: 'Hello, world!'
7
    - play:
8
        url: 'say: Custom event sent.'

Send multiple events with different payloads

1
version: 1.0.0
2
sections:
3
  main:
4
    - user_event:
5
        event:
6
          eventA:
7
            foo: bar
8
          eventB:
9
            count: 42
10
            active: true
11
    - play:
12
        url: 'say: Multiple events sent.'