mirror of
https://github.com/simplex-chat/simplex-chat.git
synced 2026-11-14 15:37:41 +00:00
Evgeny @ SimpleX Chat
d00513ed27
* docs: user guide for the 7.1 apps * docs, website: guide order, badge benefits, message expiry; soft line breaks on the site * docs: guide videos for the first profile, invitations, joining and the address * docs: guide screens with the iPhone status bar * docs: guide shows full and cut screens only * docs: guide pages corrected in place, keeping master's structure * docs: group chat and SimpleX address pictures in the iPhone frame * docs: plainer wording in the guide * docs: guide checked against how SimpleX explains its features * docs: guide answers on profiles, channel privacy, SOCKS and names * docs: android guide picture from the emulator in the pixel 7 frame
111 lines
4.7 KiB
Markdown
111 lines
4.7 KiB
Markdown
---
|
||
title: Audio & video calls
|
||
---
|
||
# Audio and Video Calls
|
||
|
||
SimpleX Chat allows you to make end-to-end encrypted audio and video calls with your contacts via WebRTC. Note: Group calls are not supported at this time.
|
||
|
||
A call is end-to-end encrypted when both devices support it, and the call
|
||
screen shows its encryption status.
|
||
|
||
## Making and accepting the calls
|
||
|
||
### How to make an audio call
|
||
|
||
1. Tap on a contact.
|
||
2. Tap on the phone icon to the right of your contact's name in the chat toolbar,
|
||
and choose **Audio call**. The chat toolbar is at the top of the screen on
|
||
iOS, and at the bottom on Android and desktop by default.
|
||
|
||
The phone icon is shown when the contact is connected and the **Audio/video
|
||
calls** preference allows calls with this contact. Calls are allowed by default.
|
||
|
||
### How to make a video call
|
||
|
||
1. Tap on a contact.
|
||
2. Tap on the phone icon to the right of your contact's name.
|
||
3. Choose **Video call**.
|
||
|
||
### Accepting the calls
|
||
|
||
When there is an incoming call you have three options:
|
||
|
||
- accept: to connect the call
|
||
- reject: to reject the call, _without_ notifying the caller.
|
||
- ignore: to temporarily dismiss the call, but in a way that it can be accepted
|
||
later, if the caller is still waiting, via the **Answer call** message in the
|
||
conversation with this contact.
|
||
|
||
There is no time limit that the call invitation can remain active - as long as the caller is still waiting, you can accept the call any time later.
|
||
|
||
The call can be accepted from the lock screen, both on Android (it needs to be enabled via options) and on iOS (by default, using native iOS call interface that can be disabled).
|
||
|
||
### Calls on lock screen on Android
|
||
|
||
SimpleX Chat shows an incoming call on your device's lock screen by default. However, you can change this behavior in the app settings menu.
|
||
|
||
1. Open the app settings menu.
|
||
2. Tap **Audio & video calls**.
|
||
3. On the **Calls on lock screen** drop-down list, choose from the following three options:
|
||
- Disable - the call will show as a notification.
|
||
- Show - the call will show on the lock screen, you need to unlock the device and the app to accept it.
|
||
- Accept - the call can be accepted and rejected directly from the lock screen, without opening the app.
|
||
|
||
**Please note**: some Android systems/devices prohibit full screen views on lock screen - in this case the call will show as a usual notification.
|
||
|
||
### Calls on lock screen on iOS
|
||
|
||
By default, SimpleX Chat uses native iOS call interface, where allowed, to show incoming calls on the lock screen. You can disable it:
|
||
|
||
1. Open the app settings menu.
|
||
2. Tap **Audio & video calls**.
|
||
3. Toggle the **Use iOS call interface** switch off.
|
||
|
||
**Please note**: iOS call interface allows accepting the calls without unlocking the device and the app. If this is undesirable, please disable it – the calls will show as notifications in this case.
|
||
|
||
### During a call
|
||
|
||
On iOS and Android, the buttons on the call screen turn the microphone and the
|
||
camera on and off, switch the speaker, flip the camera and end the call. To use
|
||
the app during a call, tap the back button on the call screen. Tap the green bar
|
||
at the top of the app to return to the call.
|
||
|
||
On desktop, the call opens in a tab of your default web browser. Closing the tab
|
||
ends the call.
|
||
|
||
## Advanced call settings
|
||
|
||
### WebRTC ICE servers
|
||
|
||
SimpleX Chat uses a preset relay server to hide your IP address from your contacts by default, but it can also observe the duration of your calls. If you don't want that, you can configure and use your self-hosted WebRTC relay servers instead for further control of your calls.
|
||
|
||
1. Open the app settings menu.
|
||
2. Tap **Audio & video calls**.
|
||
3. Tap **WebRTC ICE servers**.
|
||
4. Toggle the **Configure ICE servers** switch on.
|
||
5. Enter your ICE server addresses (one per line).
|
||
6. Tap **Save**.
|
||
|
||
**Please note**: the configuration of WebRTC ICE servers is saved with the other
|
||
app settings in the exported chat database, and it is restored when you import
|
||
the database or migrate to another device.
|
||
|
||
### Always use relay
|
||
|
||
Audio and video calls on SimpleX Chat are routed via a TURN relay server by default. Optionally you can disable this and use peer-to-peer (P2P) instead, when it is supported by your network. However, your IP address will be known to your contacts.
|
||
|
||
1. Open the app settings menu.
|
||
2. Tap **Audio & video calls**.
|
||
3. Toggle the **Always use relay** switch on to use a relay server or off for P2P.
|
||
|
||
**Please note**: disabling this option allows P2P calls, but it does not prohibit
|
||
the use of TURN relays – in case your network providers block P2P connections,
|
||
the call will still use relays if they are available. To prohibit the use of
|
||
relays you need to change WebRTC ICE server configuration to only include STUN
|
||
servers, for example:
|
||
|
||
```
|
||
stuns:stun.simplex.im:443
|
||
stun:stun.simplex.im:443
|
||
```
|