MAM e DAM via armazenamento compatível com S3
Conecte a um espaço de trabalho o armazenamento compatível com S3 do seu MAM ou DAM. O ShowBits passa então a importar episódios das pastas dele, a monitorar pastas em busca de arquivos novos e a entregar os clipes liberados, com todos os metadados, em uma pasta de entrega. Isso faz parte dos planos Enterprise e OnPremise.
- Quem configura
- Administradores do espaço de trabalho
- Planos
- Enterprise e OnPremise; nos outros planos, os administradores podem solicitar
- O que o ShowBits pode fazer
- Ler arquivos no bucket e gravar clipes liberados na pasta de entrega; ele não exclui nada lá
Conectar o armazenamento
Somente os administradores do espaço de trabalho conectam o armazenamento. Você precisa do endpoint dele, da região, do bucket e de uma chave de acesso com a respectiva chave secreta (veja a próxima seção).
- Abra Integrations.
- Em Developers & systems, clique em Connect no card MAM / DAM.
- Em Endpoint, digite o endereço do serviço S3, não o do bucket, por exemplo,
https://s3.eu-central-1.amazonaws.com. - Preencha Region e Bucket.
- Se o seu armazenamento espera o bucket no caminho dos endereços, marque Bucket in the path instead of the host name (MinIO and similar).
- Preencha Access key e Secret key.
- Clique em Connect. O ShowBits verifica os dados com o seu armazenamento; depois, o card mostra o bucket e o host aos quais está conectado.
O ShowBits guarda os dados criptografados e nunca mais mostra a chave secreta. Ele só se conecta a endereços https acessíveis pela internet.

A chave de acesso e as permissões dela
Dê ao ShowBits uma chave de acesso exclusiva, de preferência de um usuário que só possa usar este bucket. Para navegar, importar e monitorar pastas, a chave precisa listar o bucket e ler os arquivos dele; para entregar clipes, ela também precisa gravar arquivos na pasta de entrega. Nos termos do AWS S3, que muitos armazenamentos compatíveis com S3 adotam, essas permissões são s3:ListBucket e s3:GetObject, além de s3:PutObject somente para a pasta de entrega.
- No console do seu provedor de armazenamento, crie um usuário ou uma conta de serviço para o ShowBits.
- Permita que ele liste o bucket e leia os arquivos dele.
- Permita que ele grave arquivos na pasta que vai receber os clipes.
- Crie uma chave de acesso para ele e copie a chave de acesso e a chave secreta.
Cada armazenamento dá a essas permissões um nome próprio; a documentação dele explica como limitar uma chave a um bucket ou a uma pasta. O ShowBits não exclui arquivos no seu armazenamento.
Importar episódios e monitorar pastas
Depois de conectado, o armazenamento funciona no ShowBits como o Google Drive: as pastas são os prefixos das chaves dos objetos, e o ShowBits lê o arquivo onde ele está, sem copiá-lo. Na página Overview, MAM / DAM também aparece entre as origens de importação.
- No card MAM / DAM, clique em Import files. Os administradores veem Files and delivery folder enquanto nenhuma pasta de entrega for escolhida.
- Abra a pasta com o episódio. Bucket leva você de volta ao nível superior do bucket.
- Clique em Import ao lado do arquivo de vídeo ou áudio.
Os administradores também podem clicar em Make import folder em uma pasta, para que a equipe comece por ela, ou em Watch folder, para que arquivos novos virem episódios sozinhos: veja Pastas monitoradas.
Escolher a pasta de entrega
Os administradores escolhem a pasta em que o ShowBits entrega os clipes liberados.
- No card MAM / DAM, clique em Files and delivery folder.
- Abra a pasta que vai receber os clipes.
- Clique em Deliver clips here. A pasta passa a ter a marcação Delivery folder.
- Para que cada clipe liberado seja entregue sozinho, ative Deliver automatically no card MAM / DAM.
Com a entrega automática, um clipe vai para lá assim que a última etapa de aprovação o libera; sem ela, os clipes são entregues manualmente, no próprio clipe. Para usar outra pasta, abra-a por Import files e clique em Deliver clips here nela; Stop delivering encerra as entregas.

Entregar um clipe manualmente ou de novo
Depois que uma pasta de entrega é escolhida, cada clipe liberado (aprovado, agendado ou publicado) mostra uma caixa MAM / DAM abaixo do editor, indicando se e quando ele foi entregue. Ali, qualquer membro do espaço de trabalho pode entregar o clipe manualmente.
- Abra o clipe.
- Na caixa MAM / DAM, clique em Deliver to MAM ou, se o clipe já tiver sido entregue antes, em Deliver again.
Em Integrations, o card lista as Latest deliveries, com Deliver again para uma entrega que falhou. Quando um clipe liberado ganha um vídeo novo ou imagens novas, por exemplo, depois de Apply to all assets, o ShowBits o entrega de novo, como nova versão, em todos os lugares para onde ele já foi. Um clipe cujo vídeo está sendo renderizado espera o vídeo ficar pronto.

O que uma entrega contém
Na pasta de entrega, cada clipe recebe uma pasta própria para cada versão: uma pasta por episódio, dentro dela uma por clipe, ambas com o ID como nome, e dentro dela uma por versão (v1, v2 …). Assim, uma versão nova nunca sobrescreve o que o seu MAM possa estar importando. A pasta de um clipe contém video.mp4, subtitles.vtt se o vídeo tiver legendas, e as miniaturas thumbnail-16x9.jpg e cover-9x16.jpg; a pasta de um card de citação contém card-4x5.jpg, card-9x16.jpg e card-1x1.jpg. O ShowBits grava o clip.json por último: quando ele aparece, a pasta está completa.
O clip.json informa o espaço de trabalho, o programa, o episódio (título, idioma, embargo e arquivo de origem; para um episódio do mesmo bucket, a chave do objeto dele) e o clipe (tipo, título, formato, pontos de entrada e saída em segundos do arquivo do episódio, duração, texto, idioma das legendas, chamada, hashtags, citação, textos por canal e horário da aprovação), além da lista de arquivos com tamanho e tipo. Os sistemas de playout recebem os clipes pelo seu MAM.
Alterar as credenciais ou desconectar
Para usar outra chave de acesso, clique em Change credentials no card e preencha todos os dados de novo. Outro bucket ou host conta como um armazenamento diferente: a pasta de importação, as pastas monitoradas e a pasta de entrega são encerradas.
- No card MAM / DAM, clique em Disconnect.
- Confirme com Disconnect.
O ShowBits exclui as credenciais. As pastas monitoradas, a pasta de importação e a pasta de entrega são encerradas; o que já foi entregue continua no seu armazenamento. Você também pode desativar a chave de acesso no seu armazenamento a qualquer momento.
Perguntas
Estamos no Creator ou no Business. Podemos conectar o nosso MAM?
A conexão com sistemas MAM e DAM faz parte dos planos Enterprise e OnPremise. Nos outros planos, os administradores clicam em Request no card MAM / DAM, em Integrations; o card passa então a mostrar Requested.
Um clipe vai para o MAM antes do fim do embargo?
Sim. A entrega no seu próprio MAM não é uma publicação: o ShowBits entrega os clipes liberados na hora e informa o embargo no clip.json (embargoUntil). Os posts nas redes sociais continuam aguardando o fim do embargo.
O ShowBits diz que o armazenamento recusou as credenciais.
Verifique a chave de acesso e a chave secreta e se a chave pode listar este bucket: o ShowBits testa isso com uma listagem do bucket antes de salvar os dados.
O ShowBits diz que o armazenamento não responde.
Verifique o endpoint e a região. O endpoint é o endereço do serviço S3, começando com https://, não o do bucket.
Uma entrega falhou. E agora?
Na maioria dos erros, o ShowBits tenta de novo sozinho após 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas e 24 horas. Se o armazenamento recusar as credenciais, os administradores as preenchem de novo com Change credentials; se o bucket ou a pasta de entrega não existir mais, eles escolhem uma pasta de entrega de novo. Depois, clique em Deliver again.
Um arquivo do bucket não aparece no ShowBits.
O navegador de arquivos mostra pastas e arquivos de vídeo e áudio, inclusive MXF. Um arquivo cuja chave completa, incluindo as pastas, tenha mais de 150 bytes não aparece; dê a ele um caminho mais curto.
O nosso sistema de playout pode receber os clipes?
Pelo seu MAM: configure-o para buscar os clipes na pasta de entrega, por exemplo, com uma hot folder ou um perfil de ingest, e repassá-los ao playout. O clip.json fornece a ele os pontos de entrada e saída e o embargo.
Os nossos sistemas podem ser avisados das entregas?
Sim. Um webhook para os eventos clip.delivered e clip.delivery_failed informa cada entrega: veja Webhooks.