Skip to content

Commit 11490d5

Browse files
authored
Merge pull request #204839 from minnieliu/peiliu/mediaCompConcept
Updating Media Composition Concept page
2 parents 04c0fad + b1c04b9 commit 11490d5

File tree

6 files changed

+19
-16
lines changed

6 files changed

+19
-16
lines changed
16 KB
Loading
9.4 KB
Loading
6.08 KB
Loading
6.89 KB
Loading
7.62 KB
Loading

articles/communication-services/concepts/voice-video-calling/media-comp.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -36,28 +36,31 @@ Media Composition REST APIs (and open-source SDKs) allow you to command the Azur
3636

3737
This functionality is activated through REST APIs and open-source SDKs. Below is an example of the JSON encoded configuration of a presenter layout for the above scenario:
3838

39-
```
39+
```json
4040
{
41-
layout: {
42-
type: ‘presenter’,
43-
presenter: {
44-
supportPosition: ‘right’,
45-
primarySource: ‘1’, // source id
41+
"layout": {
42+
"presenter": {
43+
"presenterId": "presenter",
44+
"supportId": "translatorSupport",
45+
"supportPosition": "topLeft",
46+
"supportAspectRatio": 3/2
4647
}
47-
},
48-
sources: [
49-
{ id: ‘1’ }, { id: ‘2’ }
50-
]
48+
}
5149
}
52-
5350
```
54-
The presenter layout is one of several layouts available through the media composition capability:
5551

56-
- **Grid** - This is the typical video calling layout, where all media sources are shown on a grid with similar sizes. You can use the grid layout to specify grid positions and size.
57-
- **Presentation.** Similar to the grid layout but media sources can have different sizes, allowing for emphasis.
58-
- **Presenter** - This layout overlays two sources on top of each other.
59-
- **Weather Person** - This layout overlays two sources, but in real-time Azure will remove the background behind people.
52+
The presenter layout is one of several layouts available through the media composition capability:
6053

54+
- **Grid** - The grid layout shows the specified media sources in a standard grid format. You can specify the number of rows and columns in the grid as well as which media source should be placed in each slot of the grid.
55+
:::image type="content" source="../media/two-by-two-grid-layout.png" alt-text="A diagram showing an example of the grid layout.":::
56+
- **Auto-Grid** - This layout automatically displays all the media sources in the scene in an optimized way. Unlike the grid layout, it does not allow for customizations on the number of rows and columns.
57+
:::image type="content" source="../media/five-cell-auto-grid.png" alt-text="A diagram showing an example of the auto grid layout.":::
58+
- **Presentation** - The presentation layout features a fixed media source, the presenter, covering the majority of the scene. The other media sources are arranged in either a row or column in the remaining space of the scene.
59+
:::image type="content" source="../media/top-presentation.png" alt-text="A diagram showing an example of the presentation layout.":::
60+
- **Presenter** - This is a picture-in-picture layout composed of two sources. One source is the background of the scene. This commonly represents the content being presented or the main presenter. The secondary source is cropped and positioned at a corner of the scene.
61+
:::image type="content" source="../media/top-left-presenter.png" alt-text="A diagram showing an example of the presenter layout.":::
62+
- **Custom** - You can customize the layout to fit your specific scenario. Media sources can have different sizes and be placed at any position on the scene.
63+
:::image type="content" source="../media/custom-grid-with-single-cell-overlayed.png" alt-text="A diagram showing an example of the custom layout.":::
6164
<!----To try out media composition, check out following content:----->
6265

6366
<!---- [Quick Start - Applying Media Composition to a video call](../../quickstarts/media-composition/get-started-media-composition.md) ----->

0 commit comments

Comments
 (0)