Cloud Chat

Text chat between the web and in event experience

Experimental - Customers are encouraged to test and use this feature in their experiences, but it may still require some additional support

Overview

The ability to chat on web and in game, including:

  • Chat from Web to Unreal and back

  • Works on Mobile and Desktop

  • Text appears in game above the head

  • Ability to hide and show the widget, and custom sizing

  • User name and profile image appending to the message

The in-and-out-experience chat is backed by PubNub. For battle-tested, in-experience only chat, see Legacy Text Chat.

Integration

  1. Make sure you have a safe internal launch context id set up for your editor users.

  2. Configure the variable Social.Chat.Editor.LaunchContextId in deployment.json with this value (see below)

How to enable

  1. Enable TextChat.UseCloudChat in game.json.

  2. Make sure your in-game HUD is set up to use the new chat system

The following settings in game.json influence the Text Chat feature:

Setting

Description

Default Value

TextChat.UseCloudChat

Enables the cloud chat functionality

true

TextChat.ForceMobileView

Forces mobile view regardless of detected platform

false

The following deployment.json influence the Text

SettingDescriptionDefault Value

Social.Chat.LaunchContextSource

Determines how the client should determine the launch context id to use for chat.

The values are as follows:

“LiveConfigWorldId” (use the legacy M2.Domains.WorldId value) - this is how the previous system worked

“LiveConfigChatLaunchContext” - a setting provided from live config (Social.Chat.LaunchContextId)

“CommandLineLaunchContext” - use the -LaunchContextId command line argument the game was booted from (default behaviour if not set)

CommandLineLaunchContext (the game uses the commandline argument -LaunchContextId)

Social.Chat.LaunchContextId

Use this launch context id for chat.

Only when Social.Chat.LaunchContextSource is set to LiveConfigChatLaunchContext)

Social.Chat.Editor.LaunchContextSource

Similar to Social.Chat.LaunchContextSource, but determine how the editor should find its chat launch context.

LiveConfigChatLaunchContext

Social.Chat.Editor.LaunchContextId

Set this to a “known good” (safe/internal) launch context that should be used for chat in your project.

This is required for editor users to use chat.

You can create one in the M2 Web Platform Admin UI

M2.Domains.WorldId

(LEGACY)

The launch context id in the web to scope the chat to.

This must match the web portals if you want cross-experience chat.

Last updated