Skip to content

Commit 919463c

Browse files
AntreesyAntreesy
committed
fix(user): Split call.rst into focused pages
- 'Joining a call', 'Screen sharing', 'Call layout', 'Transcription and translation', audio quality (stub) - AI-assisted changes Signed-off-by: Maksim Sukharev <antreesy.web@gmail.com>
1 parent 205cec7 commit 919463c

6 files changed

Lines changed: 69 additions & 56 deletions

File tree

‎user_manual/talk/call.rst‎

Lines changed: 5 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,6 @@
1-
====
2-
Call
3-
====
4-
5-
Starting a call
6-
---------------
1+
================
2+
Joining a call
3+
================
74

85
When you're in a conversation, you can start a call any time with the ``Start call`` button. Other participants will get notified and can join the call.
96

@@ -24,7 +21,7 @@ You can access your settings and choose a different webcam, microphone and other
2421
.. image:: images/media-settings.png
2522
:width: 300px
2623

27-
From media settings dialog, you can also change the background of your video.
24+
From the media settings dialog, you can also change the background of your video.
2825

2926
.. image:: images/background-settings-in-call.png
3027
:width: 500px
@@ -39,37 +36,8 @@ You can change other settings in the ``Talk settings`` dialog.
3936
.. image:: images/talk-settings.png
4037
:width: 600px
4138

42-
Starting a screen share
43-
-----------------------
44-
45-
You can click the monitor icon on your video stream to share your screen. Depending on your browser, you will get the option to share a monitor, an application window or a single browser tab.
46-
If video from your camera is also available, other participants will see it in a small presenter view next to the screen share.
47-
48-
.. image:: images/share-screen-with-camera.png
49-
:width: 700px
50-
51-
You can zoom in and out of the shared screen with mouse wheel, double click or touchpad gestures.
52-
53-
Changing view in a call
54-
-----------------------
55-
56-
You can switch the view in a call in the bottom bar between promoted view and grid view.
57-
58-
.. image:: images/call-view-toggle-button.png
59-
:width: 300px
60-
61-
The grid view will show as many people as the screen can fit, allowing navigation with buttons on the left and right.
62-
63-
.. image:: images/talk-grid-view.png
64-
:width: 700px
65-
66-
The promoted view shows the speaker large and others in a row below. If the people do not fit on the screen, buttons will appear on the left and right that let you navigate.
67-
68-
.. image:: images/talk-promoted-view.png
69-
:width: 700px
70-
7139
Download call participants list
72-
-------------------------------
40+
--------------------------------
7341

7442
You can download the list of participants in a call from the ``...`` menu in the top bar. This will download a CSV file with the names and email addresses of all participants in the call.
7543

@@ -83,25 +51,6 @@ The table in the CSV file contains the following columns:
8351
- **Type**: Indicates whether the participant is a registered user or a guest.
8452
- **Identifier**: Unique identifier for the participant.
8553

86-
Call live transcription
87-
-----------------------
88-
89-
Call live transcription transcribes speech in real-time during a call. It is set up by the system administration (High-performance backend and `Live Transcription App <https://apps.nextcloud.com/apps/live_transcription>`_ are required).
90-
Moderators need to set the language of the transcription in the conversation settings. All participants then can enable or disable the transcription for themselves in the call bottom bar.
91-
When enabled, the transcription will appear in the bottom and will be updated in real-time.
92-
93-
.. image:: images/call-transcription.png
94-
:width: 500px
95-
96-
With `live_transcription` provider app enabled, you can also use live translation. Instead of receiving the transcription in the original message, it will be translated to the language of your choice.
97-
98-
.. image:: images/call-translation-actions.png
99-
:width: 400px
100-
101-
Audio quality settings
102-
----------------------
103-
104-
.. FIXME Document echo cancellation, noise suppression and auto-gain control settings available in the media settings dialog before and during a call.
10554

10655

10756

‎user_manual/talk/call_audio.rst‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Audio quality settings
2+
============================
3+
4+
.. FIXME Document echo cancellation, noise suppression and auto-gain control settings available in the media settings dialog before and during a call.

‎user_manual/talk/call_index.rst‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,7 @@ Calls
55
:maxdepth: 1
66

77
call
8+
call_screenshare
9+
call_views
10+
call_transcription
11+
.. call_audio

‎user_manual/talk/call_screenshare.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
==============
2+
Screen sharing
3+
==============
4+
5+
You can click the monitor icon on your video stream to share your screen. Depending on your browser, you will get the option to share a monitor, an application window or a single browser tab.
6+
If video from your camera is also available, other participants will see it in a small presenter view next to the screen share.
7+
8+
.. image:: images/share-screen-with-camera.png
9+
:width: 700px
10+
11+
You can zoom in and out of the shared screen with the mouse wheel, double-click, or touchpad gestures.

‎user_manual/talk/call_transcription.rst‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
=============================
2+
Transcription and translation
3+
=============================
4+
5+
Call live transcription
6+
-----------------------
7+
8+
Call live transcription transcribes speech in real-time during a call. It is set up by the system administration (High-performance backend and `Live Transcription App <https://apps.nextcloud.com/apps/live_transcription>`_ are required).
9+
Moderators need to set the transcription language in the conversation settings. All participants can then enable or disable the transcription for themselves in the call bottom bar.
10+
When enabled, the transcription appears at the bottom of the screen and is updated in real-time.
11+
12+
.. image:: images/call-transcription.png
13+
:width: 500px
14+
15+
Live translation
16+
----------------
17+
18+
With the `live_transcription` provider app enabled, you can also use live translation. Instead of receiving the transcription in the original language, it will be translated to the language of your choice.
19+
20+
.. image:: images/call-translation-actions.png
21+
:width: 400px

‎user_manual/talk/call_views.rst‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
===========
2+
Call layout
3+
===========
4+
5+
You can switch between promoted view and grid view using the toggle in the bottom bar.
6+
7+
.. image:: images/call-view-toggle-button.png
8+
:width: 300px
9+
10+
Grid view
11+
---------
12+
13+
Grid view shows as many participants as the screen can fit. Use the navigation buttons on the left and right to scroll through participants when there are more than the screen can display.
14+
15+
.. image:: images/talk-grid-view.png
16+
:width: 700px
17+
18+
Promoted view
19+
-------------
20+
21+
Promoted view shows the active speaker large, with other participants in a row below. Use the navigation buttons on the left and right to scroll through participants when the row overflows.
22+
23+
.. image:: images/talk-promoted-view.png
24+
:width: 700px

0 commit comments

Comments
 (0)