Voice and video calls
rChat makes voice and video calls through your relay. Calls are available in rChat for Android today; they are coming to rChat for iPhone in a future update (see On iPhone). Calls are end-to-end encrypted: your relay can’t hear them or read their keys. Calls use the same HTTPS port as your messages, with no extra ports and no calling servers. That helps on networks that block the ports other calling apps use. It doesn’t hide that a call is happening: someone watching your relay or your network can tell that a call is happening while it runs, and roughly how long it lasts.
Making a call
Section titled “Making a call”The steps here and in the next section are for rChat for Android.
Open a chat with a contact and tap the phone button at the top. The button appears only for contacts you’ve accepted, not for message requests. You see Calling…, then Ringing… once their phone confirms. If nobody answers within 45 seconds, the call ends as No answer.
- To answer, tap Answer on the incoming-call screen, or in the notification.
- During a call you can mute, switch to the speaker or a Bluetooth headset, and end the call. Leave the call screen and the call goes on: tap the green Return to call bar to come back.
- The Calls tab lists your calls, newest first, with a button to call back. A badge counts missed calls you haven’t seen.
- Call history stays on your phone. In a chat with disappearing messages, call entries disappear on the chat’s timer.
The first time you call or answer, rChat asks for the microphone.
Video calls
Section titled “Video calls”During a call, tap the camera button to ask the other person to switch to video. They see “[Name] wants to switch to video” with Accept and Not now. If they accept, they see your video; their own camera stays off until they turn it on. If they choose Not now, you see “[Name] stayed on voice”, and you can ask again after 30 seconds. You can also start a video call from the video button at the top of a chat. It rings as an Incoming video call: Answer turns your camera on, Answer with video off shows their video and keeps your camera off, and answering from the lock screen always starts with your camera off.
- Your own camera is a small tile in the corner, and you can drag it. The other person sees you the right way round.
- The picture gets softer before it stutters. When the connection is poor you see Your connection is unstable if the problem is on your side, or [Name]‘s connection is unstable if it’s on theirs. If the connection can’t carry video at all, video pauses (Video paused) and the call goes on as voice, then video resumes by itself.
- Leave rChat during a video call and the other person’s video shows in a small floating window. Your camera stops while you’re away and they see Camera off; it starts again when you return.
- Settings → Calls → Video quality is the largest picture you want to see: 720p (the default) or 1080p. 1080p uses more data on both phones and is used only when the connection allows.
- If the other person’s rChat or your relay doesn’t support video, you see Video isn’t available on this call and the call goes on as voice.
- Call history shows a call that had video as Video call.
The first time you turn on your camera, rChat asks for camera permission.
On iPhone
Section titled “On iPhone”rChat for iPhone will make the same voice and video calls, and a call from an iPhone will be able to reach an Android phone and the other way round.
- Calls use the iPhone’s own call screen. An incoming call shows the contact’s name on that screen, on the lock screen and on an Apple Watch. rChat uses one fixed handle for every call, so calls are not listed in the iPhone’s Recents.
- An iPhone rings while rChat is open, and for a short time after you leave it (about 30 seconds, the standard background time iOS gives an app). rChat doesn’t use Apple’s notification service to wake the app for calls.
- When rChat isn’t running, calls don’t ring. The caller is told they can’t be reached, and you see a missed call in the Calls tab and in the chat when you next open rChat. There is nothing to switch on. Settings → Calls says so in the same words.
- The Calls tab sits between Chats and Contacts. Calls also appear as entries in the chat.
- Answering a video call from a locked phone, or from a banner while rChat isn’t in front, starts with your camera off. Your camera turns on only if the phone was unlocked and rChat was in front when you answered.
- Leave rChat during a video call and the other person’s video continues in a small picture-in-picture window. Your camera turns off while you’re away and comes back only if it was on.
- Settings → Calls → Video quality is 720p (the default) or 1080p.
- rChat isn’t offered on the App Store for mainland China, because the iPhone’s call screen isn’t permitted there.
On Android: ringing while rChat is closed
Section titled “On Android: ringing while rChat is closed”On Android, with Settings → Background → Receive messages in the background on, calls ring while rChat is closed. With it off, they ring only while rChat is open, and a call that came in meanwhile shows as missed. See Receiving messages on Android.
On Android: full-screen calls and the lock screen
Section titled “On Android: full-screen calls and the lock screen”On Android, rChat shows an incoming call on the full screen, also on the lock screen, when Android allows it. The caller’s name shows on the incoming-call screen and in the notification, including on the lock screen, whatever your message-preview setting is. rChat asks once; you can change it later in Settings → Apps → rChat → Full-screen notifications (the name differs a little between phones). Without it, a call shows as a notification at the top of the screen.
Xiaomi, Redmi and POCO (HyperOS, MIUI)
Section titled “Xiaomi, Redmi and POCO (HyperOS, MIUI)”Settings → Apps → Manage apps → rChat → Other permissions: allow Show on lock screen and Display pop-up windows while running in the background. rChat has buttons for both under Settings → Background → Make sure rChat isn’t stopped. Also follow the battery steps on Receiving messages on Android.
What your relay sees during a call
Section titled “What your relay sees during a call”Your relay can’t hear a call or read its keys. While a call runs, it can see:
- that two people with a conversation open started a call;
- roughly when and for how long, and how much data it carries;
- two extra connections from each phone.
When video runs, your relay can’t see the picture or read its keys. It can also see:
- that this is a video call, with four connections from each phone instead of two;
- how much video data there is. Unlike voice, which is a constant stream, video data changes with how much is moving, so your relay can tell roughly when there’s movement on camera.
Steady traffic doesn’t cover calls. Comparing your safety number with a contact covers calls too: during a call, the call screen shows Safety number compared, or offers Compare safety number so you can read it aloud.
When a call doesn’t connect
Section titled “When a call doesn’t connect”- “Your relay needs an update for calls”: your relay’s operator needs to update the relay.
- “Couldn’t reach [name]. They may need to update rChat.”: their phone didn’t confirm within 15 seconds. They may be offline, or on an older version of rChat. They get a missed call when their phone next connects.
- “Busy”: they’re on another call, including a regular phone call.
- “Declined”: they declined the call.
- “Call failed”: the call was answered but failed before any audio came through.
- “Couldn’t connect”: the call couldn’t be set up with their phone.
- “Poor connection”: more than a twentieth of the last few seconds of audio had to be filled in. rChat lowers the call’s bitrate after a while to help.
- “Reconnecting…”: nothing has arrived for 3 seconds, for example after switching from Wi-Fi to mobile data. The call ends if it doesn’t recover within 20 seconds.