Essa documentação tem como intuito instruir na configuração da ferramenta VideoTools da 4yousee, utilizado para realizar a divisão e a junção de vídeos, que por sua vez serão utilizados em telas com a finalidade de criação de conteúdos sincronizados ou VídeoWall.
Em seguida os passos para a configuração e uso do 4YouSee Video Tools.
- Criar um Token de Integração em 4YouSee Manager
- Baixar o 4YouSee Video Tools
- Configurar o 4YouSee Video Tools
- Configuração do formato Videowall
- Dividir um Video em espaço
- Publicar formato de Videowall
- Juntar Videos em espaço
Pré-requisitos
Para que a ferramenta funcione corretamente, é necessário que o computador onde a aplicação vai rodar tenha o programa FFMPEG instalado. Seguem as instruções para instalação em cada sistema operacional:
Linux
sudo apt install ffmpeg
Mac
brew install ffmpeg
Windows
Baixar FFMPEG para Windows de 32 Bits.
Baixar FFMPEG para Windows de 64 Bits.
*Para a instalação de FFMPEG pode seguir esta documentação que explica cada passo no Windows. Instalar FFMPEG no Windows. Se já baixou o ffmpeg, pode ir direto desde o passo 4 em diante desse tutorial.
1. Criar um token de integração em 4YouSee Manager
Neste artigo você consegue aprender a gerar um token de integração em 4YouSee Manager.
Como gerar um token para integrar com API do 4YouSee Manager
2. Download do aplicativo 4YouSee Video Tools
Baixar 4YouSee Video Tools para Windows : Após baixado o arquivo, você deve abrir o 4YouSee Video Tools.exe que esta dentro do .zip.
Baixar 4YouSee Video Tools para Linux
Baixar 4YouSee Video Tools para Mac
3. Configurar o 4YouSee Videotools
Ao iniciar o aplicativo, (surgirá uma janela como a da imagem a seguir) ele é aberto na aba Split. Inicialmente é necessário acessar a aba Settings (1) e associar o aplicativo ao 4YouSee Manager. Segue abaixo a imagem com as informações para preenchimento.
- URL Account (2): Neste campo será inserida a URL do seu ambiente no 4YouSee Manager
- API Token (3): Neste campo será inserida a chave gerada anteriormente no 4YouSee Manager.
- Confirmação para uso de formato do 4YouSee Manager (4): É necessário habilitar esta opção para que o aplicativo busque no 4YouSee Manager os formatos cadastrados.
- Save (5): Salvar os dados para utilizar o aplicativo.
4. Configuração do Formato Videowall
Para acessar a tela de formatos de videowal no 4YouSee Manager, selecione o menu Conteúdos(1) -> Formatos de Videowall(2). A tela apresentada abaixo mostra uma lista de formatos já cadastrados ordenados com os mais novos por último. Clique em Adicionar (3):
4.1 Adicionar formato de videowall
Ao clicar no botão Adicionar (3) da tela anterior, será aberto um formulário para cadastro. Preencha este formulário com as informações, conforme listadas e explicadas abaixo.
- Nome do Formato (1): Digite o nome desejado para o formato de videowall;
- Duração (2): Este campo pode ser habilitado ou não. Se for habilitado, ele deverá ser preenchido com o valor de tempo que os próximos vídeos devem ter. Caso não seja preenchido, esse tempo será calculado automaticamente;
- Partes (3): O número de partes é representado respectivamente pelo número de linhas e colunas que o videowall terá. O valor total de telas será representado pela multiplicação desses dois valores;
- Gerar (4): É o botão que cria as partes do videowall, ou seja, em quantas partes seu vídeo será dividido e em que posição no videowall ele ficará;
- Nome (5): O nome explicado em teste (1) será replicado nos nomes das partes, acrescido da informação de localização dentro do videowall. No entanto, esse campo é editável, podendo receber também o valor desejado;
- Largura e Altura (6): Os campos de dimensão do formato devem ser escolhidos de acordo com as dimensões originais dos vídeos que serão utilizados neste formato e divididos pelo número de partes que o videowall terá. Por exemplo: dado que eu tenha um vídeo com largura de 1280px, altura de 720px e queira um videowall com dimensões 1x2, eu terei que dividir o valor da largura por 2 e o valor da altura eu mantenho o mesmo, pois ele não mudará. Sendo assim, os campos de largura serão preenchidos com 640 e 720 respectivamente;
- Adicionar (7): Ao clicar neste botão, os dados preenchidos são gravados;
- Nomes conforme as posições (8): Os nomes gerados automaticamente mostram a localização de cada parte dentro do videowall;
Lembrete: Caso no meio do processo você resolva alterar a quantidade de partes, seja o número de linhas e/ou número de colunas, todos os dados já editados nos campos das partes serão substituídos pelo valor padrão na geração inicial das partes, isso se você confirmar essa ação após clicar em Gerar (4) novamente.
4.2 Editar formato de videowall
Para editar um formato, segue-se os mesmos passos da tela adicionar. A tela de editar oferece a opção de Excluir o formato, ao lado do botão Adicionar.
Lembrete: Caso no meio do processo você resolva alterar a quantidade de partes, seja o número de linhas e/ou número de colunas, todos os dados já editados nos campos das partes serão substituídos pelos valores salvos anteriormente, isso se você confirmar essa ação após clicar em Gerar (4) novamente.
5. Dividir um vídeo
O vídeo escolhido será dividido conforme as especificações do formato escolhido no 4YouSee Manager. Para isso, seguem o passo a passo para a divisão do vídeo e a tela usando 4YouSee Video Tools.
- Split (1): É o utilitário de divisão de vídeos;
- Select file (2): Selecione o vídeo desejado a partir de uma pasta no seu computador;
- Dados do vídeo (3): Os dados do vídeo selecionado são carregados e exibidos; largura (Width), altura (Height) e duração (Duration);
- Videowall Format List (4): Este campo traz uma lista dos formatos de videowall cadastrados no 4YouSee Manager para que o usuário possa escolher um entre eles;
- Refresh (5): Esse botão serve para atualizar a lista de formatos cadastrados no 4YouSee Manage;
- List Formats in 4YouSee Manager (6): Caso o usuário deseje criar, editar, ou excluir formatos de videowall no 4YouSee Manager, basta clicar neste link para redirecionamento para a página de listagem dos mesmos. Após fazer as alterações desejadas, o usuário, ao voltar para a tela de Split (1) do aplicativo Videotools, deve clicar em Refresh (5) para carregar as informações de formatos de videowall mais recentes gravadas;
- Video Partes (7): Ao selecionar um formato, Videowall Format List (4), o usuário poderá observar que os dados das partes de videowall serão geradas e exibidos, contendo suas referências de local dentro do videowall e as respectivas dimensões;
- Split Video (8): Após revisar suas preferências, o usuário pode efetuar a divisão do vídeo nas partes desejadas.
Logo após o vídeo ser carregado irá aparecer uma pergunta para você subir o vídeo para o manager:
Clicando em Yes(1) você seguirá para próxima página te dando a opção de carregamento para o 4YouSee Manager. Clicando em Locate files in disk (2) abrirá a pasta onde os vídeos estão alocados em seu sistema.
A próxima página abrirá as seguintes opções:
Em Nome(1) você colocará um nome no vídeo que irá para o manager. Em Category você selecionará uma categoria de conteúdo no qual o vídeo será inserido. Em Close(3) você voltará para página anterior. Em Upload(3) carregará os vídeos para o Manager.
Feito isso, uma seguinte tela aparecerá:
A opção OK (1) fechará a guia e os conteúdos ficarão carregados na sua conta. Sendo assim, poderá continuar com o passo seguinte Publicando um Formato de Videowall. Já a opção Click here to publish a Videowall (2) te direcionará para onde o vídeo (cortado) foi alocado.
6. Publicando um formato de Videowall
Após feito os procedimentos acima, acesse o Manager em seu navegador e vá em Conteúdos(1) -> Formatos de Videowall(2) -> Publicar(3) .
Uma página semelhante a esta será exibida:
No campo Formato aparecerá as opções de formatos criados pelo usuário. Escolhendo o formato desejado, aparecerá as opções:
No exemplo feito acima o vídeo foi dividido em 1x2, então, apareceu duas Fileiras com o campo Conteúdo em opção. Dentro desse campo, selecione os vídeos que foram cortados no aplicativo 4YouSee Video Tools. Repare que na frente dos vídeos aparecerá as partes cortadas (1x1 - 1x2).
Neste passo, você deve selecionar os vídeos que foram cortados para cada uma das partes do formato do videowall. Se o conteúdo já estiver selecionado, basta conferir se as configurações estão de acordo com largura, altura e duração esperada então é só clicar em "Avançar".
Logo, aparecerá uma tela semelhante a seguinte:
Esta tela é a forma como são mostrados todos players da sua conta. Aqui em "Para selecionar grupos do players utilize a árvore abaixo:" (1) Selecione o player ou grupo de players que já tenha uma playlist de Videowall habilitado para enviar o videowall criado.
Em Para a distribuição nas Playlists utlize as informações abaixo:(2) você selecionará como o Videowall será anexado em sua playlist.
Selecionado todas as opções desejadas, clique em Publicar(3). Desta forma o Videowall será criado na playlist do máster ou dos másters, se o grupo de players escolhido tem mais de um máster.
7. Juntar videos no 4YouSee Video Tools
A função Merge funciona ao contrário da Split que ao invés de cortar o vídeo tem como objetivo junta-los.
Para acessar a função no aplicativo 4YouSee Video Tools acesse a aba Merge.
Selecione a opção Select multiple files para selecionar os vídeos que foram cortados:
Após selecionar os vídeos e clicar em Abrir, voltará para tela do aplicativo com o vídeo e seus respectivos dados:
Confira os dados e clique em Merge Videos para fazer a junção dos vídeos cortados. Finalizado o processo o vídeo se encontrará na mesma pasta onde foram localizados anteriormente.