annotate doc/user/calls.rst @ 1550:4b0464b2a12b

doc: add end-user A/V calls documentation: rel 423
author Goffi <goffi@goffi.org>
date Wed, 09 Aug 2023 00:22:18 +0200
parents
children 1dc23ba67f47
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1550
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
1 =================
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
2 Audio/Video Calls
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
3 =================
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
4
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
5 Libervia provides the capability for one-to-one audio and video calls. This section will guide you on how to use this feature effectively.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
6
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
7 Accessing the Call Feature
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
8 --------------------------
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
9
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
10 1. Navigate to the main menu.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
11 2. Select the "Calls" option.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
12
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
13 Initiating a Call
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
14 -----------------
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
15
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
16 Upon entering the "Calls" page:
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
17
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
18 1. An interface will display a search box at the top and a list of your contacts below.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
19 2. To the right of the search box, there is a button labeled "Video Call," indicating that both audio and video will be enabled for the call.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
20 3. To make an audio-only call, click the adjacent icon. The "Video Call" button will change to "Audio Call."
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
21 4. To start a call:
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
22 a. Enter a full JID into the search box, then click on either "Audio Call" or "Video Call."
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
23 b. Alternatively, directly click on a contact's name to initiate a call with them.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
24
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
25 *Note:* The search box functions as expected – inputting a portion of a contact's name or the group they belong to will filter the displayed contacts.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
26
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
27 Receiving a Call
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
28 ----------------
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
29
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
30 *Currently, you must be on the "Calls" page to receive an incoming call. This limitation will be addressed in future updates.*
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
31
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
32 Upon receiving a call:
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
33
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
34 1. An audible ring will sound.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
35 2. A dialog box will appear, prompting you to either **Answer** or **Reject** the incoming call.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
36 3. If you choose to answer and it's a video call, the call interface will display both the caller's video feed and your video in the bottom right corner. For audio-only calls, no video feeds will be shown.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
37
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
38 During a Call
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
39 -------------
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
40
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
41 The call interface offers the following features:
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
42
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
43 1. **Fullscreen Mode:** The top right button allows you to expand the video feeds to cover the entire screen.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
44 2. **Mute Options:** Two buttons at the bottom of the interface enable you to mute your audio or video.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
45 - Muted audio: The audio icon will turn yellow with a red strike-through, indicating that your audio is off and the other party cannot hear you.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
46 - Muted video: The video icon will turn yellow with a red strike-through, signaling that your video is off and the other party cannot see you.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
47 3. **End Call:** Click the "Hang Up" button to conclude the call.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
48
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
49 Security Considerations for Calls
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
50 ---------------------------------
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
51
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
52 When using Libervia's call feature, it's essential to consider certain privacy aspects:
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
53
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
54 **1. Sharing Your "Online Presence" and Address:**
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
55
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
56 Making or receiving a call not only shares your device's unique online address (similar to a unique phone number) but also informs others that you're currently online. This means people can see when you're active, much like noticing you're home when the lights are on.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
57
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
58 **2. Privacy Implications:**
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
59
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
60 This information is standard when chatting with trusted contacts. However, with unfamiliar individuals, it might slightly reveal your activity pattern and general location.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
61
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
62 **3. Safety Recommendations:**
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
63
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
64 - **Be Selective:** Only initiate or accept calls from people you trust.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
65 - **Network Usage:** While the call feature is designed for use anywhere, including public networks like in restaurants or hotels, be mindful that unfamiliar networks might be less secure.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
66 - **Stay Informed:** If you have questions or concerns, you can join our community chat room for guidance. Visit `Libervia's Chat Room <xmpp:libervia@chat.jabberfr.org?join>`_.
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
67
4b0464b2a12b doc: add end-user A/V calls documentation:
Goffi <goffi@goffi.org>
parents:
diff changeset
68 Always prioritize your privacy and be aware of the information you share while using the call feature.