本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Chime SDK 会议中使用布局配置以便合成
<a name="compositing-layouts"></a>

以下主题介绍如何使用不同的配置布局。只有当有人开始共享内容时，布局才会生效。展开每个部分以了解更多信息。

## ActiveSpeakerOnlyConfiguration
<a name="active-speaker-only"></a>

`ActiveSpeakerOnlyConfiguration` 显示内容共享和当前发言人的视频，这意味着讲话的人会出现在覆盖内容共享流的小视频磁贴中。

下图显示发言人磁贴的配置和可用位置。

![显示窗口中央一个大视频磁贴以及左上角一个小磁贴的图片。](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/compositing-active-speaker-4x.png)


以下示例说明如何以编程方式实现 `ActiveSpeakerOnly` 布局。在这种情况下，主讲人磁贴会显示在左上角。

```
{
   "CompositedVideo":{
      "Layout":"GridView",
      "Resolution":"FHD",
      "GridViewConfiguration":{
         "ContentShareLayout":"ActiveSpeakerOnly",
         "ActiveSpeakerOnlyConfiguration":{
            "ActiveSpeakerPosition":"TopLeft"
         }
      }
   }
}
```

**ActiveSpeakerOnlyConfiguration**  
*描述* — `ActiveSpeakerOnly` 视频磁贴的配置设置  
*类型*- ActiveSpeakerOnlyConfiguration 对象  
*必填* — 否

**ActiveSpeakerOnlyConfiguration.ActiveSpeakerPosition**  
*描述* — 当前发言人视频磁贴的位置  
*类型* — 字符串  
*有效值* — `TopLeft` \| `TopRight` \| `BottomLeft` \| `BottomRight`  
*必填* — 否  
*默认值* — `TopRight`

## PresenterOnlyConfiguration
<a name="presenter-only"></a>

无论谁在讲话，`PresenterOnlyConfiguration` 都会显示内容共享以及仅主讲人的视频。下图显示配置。

![四个屏幕的图像。每个屏幕的中间都有一个共享窗口，每个角落都有一个视频磁贴。](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/compositing-presenter-only-4x.png)


以下示例说明如何以编程方式实现布局，并将主讲人放置在右上角。

```
{
    "CompositedVideo": {
    "Layout": "GridView",
    "Resolution": "FHD",
     "GridViewConfiguration": {
         "ContentShareLayout": "PresenterOnly",
         "PresenterOnlyConfiguration": { 
             "PresenterPosition": "TopRight"
             }
         }           
     }
}
```

**PresenterOnlyConfiguration**  
*描述* — `PresenterOnly` 布局的配置设置  
*类型* — `PresenterOnlyConfiguration` 对象  
*必填* — 否

**PresenterOnlyConfiguration.PresenterPosition**  
*描述* — 主讲人视频磁贴的位置  
*类型* — 字符串  
*有效值* — `TopLeft` \| `TopRight` \| `BottomLeft` \| `BottomRight`  
*必填* — 否  
*默认值* — `TopRight`

## HorizontalLayoutConfiguration
<a name="horizontal-layout"></a>

`HorizontalLayoutConfiguration` 水平显示内容共享和视频流。您可以使用 `TilePosition` 设置显示内容共享流上方或下方的磁贴。主讲人始终显示在左侧。其他磁贴根据 `JoinSequence` 所指示的顺序显示。

下图显示内容共享流下方的磁贴。

![显示一个大的中央磁贴和下面一行 4 个较小磁贴的图片。](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/compositing-horizontal-bottom.png)


以下示例说明如何以编程方式实现水平布局。在这种情况下，布局会根据 `SpeakerSequence` 对磁贴进行排序，并将其放在屏幕共享的下方。布局最多允许四个图块，并采用 16/9 宽高比。

```
{
   "CompositedVideo":{
      "Layout":"GridView",
      "Resolution":"FHD",
      "GridViewConfiguration":{
         "ContentShareLayout":"Horizontal",
         "HorizontalLayoutConfiguration":{
            "TileOrder":"SpeakerSequence",
            "TilePosition":"Bottom",
            "TileCount":4,
            "TileAspectRatio":"16/9"
         }
      }
   }
}
```

**HorizontalLayoutConfiguration**  
*描述* — 水平布局的配置设置  
*类型*- HorizontalLayoutConfiguration 对象  
*必填* — 否

**HorizontalLayoutConfiguration.TilePosition**  
*描述* — 将磁贴放在内容共享的上方或下方。  
*类型* — 字符串  
*有效值* — `Bottom`\|`Top`  
*必填* — 否  
*默认值* — 底部

**HorizontalLayoutConfiguration.TileOrder**  
*描述* — 根据用户何时加入或何时讲话对磁贴进行排序  
*类型* — 字符串  
*有效值* — `JoinSequence`\|`SpeakerSequence`  
*必填* — 否  
*默认值* — JoinSequence

**HorizontalLayoutConfiguration.TileCount**  
*描述* — 指定屏幕共享期间保持可见的磁贴数量  
*类型* — 整数  
*有效值* — 1—10  
*必填* — 否  
*默认值* — 4

**HorizontalLayoutConfiguration.TileAspectRatio**  
*描述* — 指定磁贴的纵横比  
*类型* — 整数  
*有效值* — *n***/***n*  
*必填* — 否  
*默认*- 16/9，该值适用于所有图块

## VerticalLayoutConfiguration
<a name="vertical-layout"></a>

`VerticalLayoutConfiguration` 在右侧显示内容共享和四个最新的视频。主讲人始终显示在顶部。其他与会者按照 `TileOrder` 所指示的顺序显示。

![显示窗口中央一个大视频磁贴以及右上角四个小磁贴的图片。](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/grid-vertical.png)


以下示例说明如何以编程方式实现垂直布局。在这种情况下，布局会按图块排序 JoinSequence 并将其放置在屏幕共享的右侧。布局最多允许四个图块，并采用 16/9 宽高比。

```
{
   "CompositedVideo":{
      "Layout": "GridView",
      "Resolution": "FHD",
      "GridViewConfiguration":{
         "ContentShareLayout": "Vertical",
         "VerticalLayoutConfiguration":{
            "TileOrder": "JoinSequence",
            "TilePosition": "Right",
            "TileCount": 4,
            "TileAspectRatio": "16/9"
         }
      }
   }
}
```

**VerticalLayoutConfiguration**  
*描述* — 垂直布局的配置设置  
*类型*- VerticalLayoutConfiguration 对象  
*必填* — 否

**VerticalLayoutConfiguration.TilePosition**  
*描述* — 将磁贴放在内容共享的右侧或左侧。  
*类型* — 字符串  
*有效值* — `Bottom`\|`Top`  
*必填* — 否  
*默认值* — 底部

**VerticalLayoutConfiguration.TileOrder**  
*描述* — 根据用户何时加入或何时讲话对磁贴进行排序  
*类型* — 字符串  
*有效值* — `JoinSequence`\|`SpeakerSequence`  
*必填* — 否  
*默认值* — JoinSequence

**VerticalLayoutConfiguration.TileCount**  
*描述* — 指定磁贴的数量  
*类型* — 整数  
*有效值* — 1—10  
*必填* — 否  
*默认值* — 4

**VerticalLayoutConfiguration.TileAspectRatio**  
*描述* — 指定磁贴的纵横比  
*类型* — 整数  
*有效值* — *n***/***n*  
*必填* — 否  
*默认*- 9/16，该值适用于所有图块