Typing Indicators

If you use Stream's UI components, typing indicators are automatically handled. The typing indicators can be turned on or off in the channel type settings. This example below shows how to integrate typing indicators into your own message input UI.

Sending Typing Events

When a user starts typing call the keystroke method. Optionally you can specify a thread id to have a thread specific typing indicator. A few seconds after a user stops typing use stopTyping.

// Sends a typing.start event at most once every two seconds
channelClient.keystroke().enqueue()

// Sends a typing.start event for a particular thread
channelClient.keystroke(parentId = "threadId").enqueue()

// Sends the typing.stop event
channelClient.stopTyping().enqueue()// Automatically

// Sends a typing.start event
channelClient.keystroke().enqueue();

// Sends a typing.start event for a particular thread
channelClient.keystroke("threadId").enqueue();

// Sends the typing.stop event
channelClient.stopTyping().enqueue();

Receiving typing indicator events

Listening to typing indicators uses the event system, an example is shown below

// Add typing start event handling
channelClient.subscribeFor<TypingStartEvent> { typingStartEvent ->
  // Handle event
}

// Add typing stop event handling
channelClient.subscribeFor<TypingStopEvent> { typingStopEvent ->
  // Handle event
}

// Add typing start event handling
channelClient.subscribeFor(
   new Class[]{TypingStartEvent.class},
   event -> {
     // Handle change
   }
);

// Add typing stop event handling
channelClient.subscribeFor(
   new Class[]{TypingStopEvent.class},
   event -> {
     // Handle change
   }
);

Typing Privacy Settings

Please take into account that typing.start and typing.stop events delivery can be controlled by user privacy settings:

// user object with privacy settings where typing indicators are disabled
{
  // other user fields
  "privacy_settings": {
    "typing_indicators": {
      "enabled": false
    }
  }
}

If privacy_settings.typing_indicators.enabled is set to false , then typing.start and typing.stop events will be ignored for this user by Stream's server and these events will not be sent to other users. In other words other users will not know that the current user was typing.