Como usar as configurações de layout - Amazon Chime SDK

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como usar as configurações de layout

Os tópicos a seguir explicam como usar os diferentes layouts de configuração. Os layouts só entram em vigor quando alguém inicia um compartilhamento de conteúdo. Expanda cada seção para saber mais.

A ActiveSpeakerOnlyConfiguration exibe o compartilhamento de conteúdo e o vídeo de quem está falando, o que significa que a pessoa que está falando aparece no pequeno bloco de vídeo que se sobrepõe à transmissão de compartilhamento de conteúdo.

A imagem a seguir mostra a configuração e os locais disponíveis para o bloco de quem está falando.

Imagem mostrando um grande bloco de vídeo no centro de uma janela e um pequeno bloco no canto superior esquerdo.

O exemplo a seguir mostra como implementar o layout ActiveSpeakerOnly de forma programática. Nesse caso, o bloco do apresentador aparece no canto superior esquerdo.

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

Descrição: As configurações de um bloco de vídeo ActiveSpeakerOnly

Tipo — ActiveSpeakerOnlyConfiguration objeto

Obrigatório – Não

ActiveSpeakerOnlyConfiguration.ActiveSpeakerPosition

Descrição: A posição do bloco de vídeo de quem está falando

Tipo: String

Valores válidos: TopLeft | TopRight | BottomLeft | BottomRight

Obrigatório: Não

Padrão: TopRight

A PresenterOnlyConfiguration exibe o compartilhamento de conteúdo e somente o vídeo do apresentador, independentemente de quem fala. A imagem a seguir mostra a configuração.

Imagem de quatro telas. Cada tela tem uma janela de compartilhamento no meio e um bloco de vídeo em cada canto.

O exemplo a seguir mostra como implementar o layout de forma programática com o apresentador no canto superior direito.

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

Descrição: As configurações de um layout PresenterOnly

Tipo: objeto da PresenterOnlyConfiguration

Obrigatório: Não

PresenterOnlyConfiguration.PresenterPosition

Descrição: A posição do bloco de vídeo do apresentador

Tipo: String

Valores válidos: TopLeft | TopRight | BottomLeft | BottomRight

Obrigatório: Não

Padrão: TopRight

A HorizontalLayoutConfiguration exibe o compartilhamento de conteúdo e as transmissões de vídeo horizontalmente. Você pode usar a configuração TilePosition para exibir os blocos acima ou abaixo da transmissão de compartilhamento de conteúdo. Os apresentadores sempre aparecem à esquerda. Os blocos adicionais aparecem na ordem ditada pela JoinSequence.

A imagem a seguir mostra os blocos abaixo da transmissão de compartilhamento de conteúdo.

Imagem mostrando um bloco central grande e 4 blocos menores em uma linha abaixo.

O exemplo a seguir mostra como implementar um layout horizontal de forma programática. Nesse caso, o layout ordena os blocos por SpeakerSequence e os coloca abaixo do compartilhamento de tela. O layout permite no máximo quatro blocos e aplica uma proporção de 16/9.

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

Descrição: As configurações de um layout horizontal

Tipo — HorizontalLayoutConfiguration objeto

Obrigatório – Não

HorizontalLayoutConfiguration.TilePosition

Descrição: Coloca os blocos acima ou abaixo de um compartilhamento de conteúdo.

Tipo - String

Valores válidos: Bottom | Top

Obrigatório: Não

Padrão: Parte inferior

HorizontalLayoutConfiguration.TileOrder

Descrição: Ordena os blocos de acordo com o momento em que os usuários entram ou quando falam

Tipo: String

Valores válidos: JoinSequence | SpeakerSequence

Obrigatório: Não

Padrão — JoinSequence

HorizontalLayoutConfiguration.TileCount

Descrição: Especifica o número de blocos que permanecem visíveis durante um compartilhamento de tela

Tipo: Inteiro

Valores válidos: 1–10

Obrigatório: Não

Padrão: 4

HorizontalLayoutConfiguration.TileAspectRatio

Descrição: Especifica a proporção dos blocos

Tipo: Inteiro

Valores válidos: n/n

Obrigatório: Não

Padrão: 16/9, o valor se aplica a todos os blocos

A VerticalLayoutConfiguration exibe o compartilhamento de conteúdo e os quatro vídeos mais recentes empilhados à direita. Os apresentadores sempre aparecem no topo. Outros participantes aparecem na ordem ditada por. TileOrder

Imagem mostrando um grande bloco de vídeo no centro de uma janela e 4 blocos menores empilhados à direita.

O exemplo a seguir mostra como implementar o layout vertical de forma programática. Nesse caso, o layout ordena os blocos JoinSequence e os coloca à direita do compartilhamento de tela. O layout permite no máximo quatro blocos e aplica uma proporção de 16/9.

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

Descrição: As configurações para um layout vertical

Tipo — VerticalLayoutConfiguration objeto

Obrigatório – Não

VerticalLayoutConfiguration.TilePosition

Descrição: Coloca blocos à direita ou à esquerda de um compartilhamento de conteúdo.

Tipo: String

Valores válidos: Bottom | Top

Obrigatório: Não

Padrão: Parte inferior

VerticalLayoutConfiguration.TileOrder

Descrição: Ordena os blocos de acordo com o momento em que os usuários entram ou quando falam

Tipo: String

Valores válidos: JoinSequence | SpeakerSequence

Obrigatório: Não

Padrão — JoinSequence

VerticalLayoutConfiguration.TileCount

Descrição: Especifica o número de blocos

Tipo: Inteiro

Valores válidos: 1–10

Obrigatório: Não

Padrão: 4

VerticalLayoutConfiguration.TileAspectRatio

Descrição: Especifica a proporção dos blocos

Tipo: Inteiro

Valores válidos: n/n

Obrigatório: Não

Padrão: 9/16, o valor se aplica a todos os blocos