Mercurial > libervia-desktop-kivy

annotate doc/calls.rst @ 508:d87b9a6b0b69

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc (calls): updated documentation to describe the new UI features: fix 425
author Goffi <goffi@goffi.org>
date Wed, 25 Oct 2023 15:29:33 +0200
parents 4d45bed01183
children 290b405940b5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
1 =================
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
2 Audio/Video Calls
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
3 =================
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
4
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
5 Libervia's Kivy desktop application provides the capability for one-to-one audio and video calls. This guide provides a step-by-step approach to utilizing this functionality.
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
6
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
7 Accessing the Call Feature
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
8 --------------------------
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
9
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
10 1. Navigate to the main menu.
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
11 2. Click on the phone icon labeled "Calls" or, alternatively, select the phone icon in the "widget selection" zone, situated on the top left corner.
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
12
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
13 Initiating a Call
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
14 -----------------
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
15
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
16 Upon accessing the call feature, you are presented with the "search" UI:
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
17
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
18 1. A search bar is available at the top for entering the full JID (akin to an email address) of the person you wish to call.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
19 2. Below, contact icons are displayed. These icons get filtered based on the terms you enter in the search bar.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
20 3. To initiate a call:
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
21
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
22 a. Type the full JID of the person you wish to call into the search bar and click the "Call" button or press ``[ENTER]``.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
23 b. Alternatively, click on a contact icon at the bottom of the screen to call directly.
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
24
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
25 Receiving a Call
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
26 ----------------
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
27
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
28 When someone calls you:
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
29
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
30 1. A ringtone will play.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
31 2. A desktop notification displays the caller's details.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
32 3. In the header zone, a dialog with the right "bird head" icon appears. Click on this icon and choose "yes" to accept the call or "no" to decline.
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
33
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
34 During a Call
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
35 -------------
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
36
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
37 Once the call begins, the interface shifts to the "call" UI:
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
38
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
39 1. The main portion of the screen displays the caller's video feed.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
40 2. Your own video feed appears in the bottom right corner.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
41 3. On the top right:
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
42
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
43 - An icon lets you toggle between fullscreen and the regular view.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
44
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
45 4. Below the video feeds, three buttons are available:
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
46
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
47 a. Mute/unmute video: When muted, the video icon turns yellow with a red strike-through.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
48 b. Mute/unmute audio: When muted, the audio icon turns yellow with a red strike-through.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
49 c. Hang Up: A red phone icon in a horizontal direction to end the call.
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
50
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
51 Fullscreen Mode
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
52 ---------------
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
53
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
54 While in fullscreen:
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
55
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
56 1. Click on the same icon in the top right corner to revert to the standard view.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
57 2. The "Hang Up" button allows you to end the call and return to the regular view.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
58 3. Use the shortcut ``Alt+n`` to toggle the notification bar on or off. By default, it's hidden.
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
59
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
60 Security Considerations for Calls
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
61 ---------------------------------
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
62
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
63 When using Libervia's call feature, prioritize your privacy and safety:
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
64
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
65 **1. Sharing Your "Online Presence" and Address:**
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
66
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
67 Engaging in a call shares your unique online address (akin to a phone number), indicating you're online and active. It's like turning the lights on at home, letting others know you're present.
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
68
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
69 **2. Privacy Implications:**
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
70
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
71 Although it's common to share this information with trusted contacts, unfamiliar users may infer your activity patterns and general vicinity.
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
72
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
73 **3. Safety Recommendations:**
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
74
508
d87b9a6b0b69 doc (calls): updated documentation to describe the new UI features:
Goffi <goffi@goffi.org>
parents: 502
diff changeset
75 - **Be Selective:** Only make or receive calls from trusted individuals.
502
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
76 - **Network Usage:** Though designed to function anywhere, remember that public networks (like those in coffee shops or hotels) might be less secure.
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
77 - **Stay Informed:** For any queries or concerns, join our community chat room. You can find it at the provided link on our website.
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
78
4d45bed01183 doc: add forgotten file:
Goffi <goffi@goffi.org>
parents:
diff changeset
79 Remember to stay vigilant and make informed decisions while using the call feature. Regularly check for updates, as we continually work to enhance your experience.