使用布局配置 - Amazon Chime SDK

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

使用布局配置

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

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

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

显示窗口中央一个大视频磁贴以及左上角一个小磁贴的图片。

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

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

描述 — ActiveSpeakerOnly 视频磁贴的配置设置

类型- ActiveSpeakerOnlyConfiguration 对象

必填 — 否

ActiveSpeakerOnlyConfiguration.ActiveSpeakerPosition

描述 — 当前发言人视频磁贴的位置

类型 — 字符串

有效值 — TopLeft | TopRight | BottomLeft | BottomRight

必填 — 否

默认值 — TopRight

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

四个屏幕的图像。每个屏幕的中间都有一个共享窗口，每个角落都有一个视频磁贴。

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

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

描述 — PresenterOnly 布局的配置设置

类型 — PresenterOnlyConfiguration 对象

必填 — 否

PresenterOnlyConfiguration.PresenterPosition

描述 — 主讲人视频磁贴的位置

类型 — 字符串

有效值 — TopLeft | TopRight | BottomLeft | BottomRight

必填 — 否

默认值 — TopRight

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

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

显示一个大的中央磁贴和下面一行 4 个较小磁贴的图片。

以下示例说明如何以编程方式实现水平布局。在这种情况下，布局会根据 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 在右侧显示内容共享和四个最新的视频。主讲人始终显示在顶部。其他与会者按以下顺序出现。TileOrder

显示窗口中央一个大视频磁贴以及右上角四个小磁贴的图片。

以下示例说明如何以编程方式实现垂直布局。在这种情况下，布局会按图块排序 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，该值适用于所有磁贴