Configuration
Calls
Speaker, conference calls, voicemail and video call settings.
File: configs/config_calls.lua. What players see is on Calls.
#Speaker
| Setting | Type | Default | What it does |
|---|---|---|---|
Config.SpeakerBystanders |
boolean | true |
Players standing next to someone on speaker join the call. With pma-voice and mumble-voip they can also be heard by the other side, as those voice systems have no listen-only mode. SaltyChat handles the speaker itself and ignores this setting |
Config.SpeakerRange |
number | 3.0 |
Metres from a phone on speaker within which bystanders hear the call. Ringtones use Config.Sound.Range instead |
Config.SpeakerFalloff |
boolean | true |
pma-voice and mumble-voip: the call gets quieter the further a bystander stands from the phone, and so does the bystander for the other side. false plays it at full call volume anywhere inside SpeakerRange |
#Config.Calls
| Setting | Type | Default | What it does |
|---|---|---|---|
Calls.MaxParticipants |
number | 4 |
Conference calls: everyone in one call, the two parties included. 2 turns adding people off |
#Config.Voicemail
A caller whose call is not answered may leave a voice message. The owner turns it off in Phone > Voicemail.
| Setting | Type | Default | What it does |
|---|---|---|---|
Voicemail.Enabled |
boolean | true |
Voicemail on or off |
Voicemail.MaxSeconds |
number | 60 |
Longest message |
Voicemail.MaxMessages |
number | 50 |
Messages kept per character. The oldest go first |
Voicemail.OfferSeconds |
number | 90 |
How long after the missed call the caller may still record |
Voicemail messages are deleted after Config.Retention.voicemail days.
#Config.Video
Video calls. The picture travels between the two phones over WebRTC through a TURN relay (ServerConfig.Video in config_server.lua). The voice stays on the voice resource.
| Setting | Type | Default | What it does |
|---|---|---|---|
Video.Enabled |
boolean | true |
The camera button in calls and the Video app |
Video.Fps |
number | 24 |
Frames per second. Kept between 5 and 30 |
Video.Size |
{ long, short } |
{ 960, 540 } |
Picture size. At most { 1280, 720 }. The phone sends it upright |
Video.MaxBitrate |
number | 1500 |
Upper limit per direction in kbit/s, kept between 100 and 2500. Every call uses up to this much of the relay in each direction |
Video.RequireItem |
string or false |
false |
Item needed to turn the camera on in a call. false: none |
Video.TakeOverView |
boolean | true |
true: during a video call the phone's own lens is the camera. It stands where the phone is held and looks at its holder; the flip button turns it the other way. false: the call leaves the player's view alone and sends that instead, so the other side sees the caller's normal game view and there is nothing to flip or zoom |
On a weak relay or slow connections the config file suggests 15 fps, { 640, 360 } and a bitrate of 600.
The game draws one picture per player, and that picture is what a video call sends. With TakeOverView = true the player's own screen shows the lens while the call's camera is on.
Relay setup: Video relay. Live streams use the same picture size and frame rate; their own settings are on Live and social.