2.3.1 O que é Canal
Ao contratar os serviços da Netshow.me e/ou seus parceiros é disponibilizado o acesso a plataforma Netshow.me Live. Por meio dela é criado o canal para armazenar, organizar, gerenciar e disponibilizar vídeos, transmissões e diretórios com esses conteúdos.
Orientamos que o primeiro passo ao acessar a plataforma seja sempre a configuração do canal.
2.3.2 Como configurar Canal
Para iniciarmos, realize login no gerenciador da plataforma. Ao acessar, as configurações do canal abrirá automaticamente. Caso navegue pelo gerenciador e precise voltar para o painel de configurações do canal, basta clicar no botão com o ícone de Engrenagem no canto superior direito da plataforma.
Canal
Nome do Canal
Dê um ao seu canal. O nome ficará visível para seu usuário, logo abaixo do header do canal. Como exemplificado na imagem abaixo:
Descrição do canal
Faça uma breve descrição do canal. Ela ficará disposta logo abaixo do nome do canal. Como exemplificado na imagem abaixo:
URL
A URL é definida automaticamente pelo sistema após a criação do nome do canal. A URL será estruturada dessa maneira: https://videos.netshow.me/nomedocanal. Apesar do preenchimento automático, é possível fazer a alteração manualmente para a nomenclatura que desejar.
Redes sociais da marca
Nos campos Twitter, Instagram, Facebook, Youtube e Linkedin, preencha com os links da sua marca. Ao informá-los o ícone de cada rede social preenchido será acrescentado abaixo da descrição no canal.
SITE
Acrescente o link da página da sua marca. Ele ficará visível no canal junto aos ícones da rede social, sendo representado pelo ícone da corrente.
Bloqueio de sessão
Habilitar essa opção é uma medida de segurança para seu produto, pois ele bloqueia a exibição simultânea em mais de um dispositivo de acesso por cadastro.
Whitelabel
Habilitando esta opção o seu canal terá apenas componentes da sua marca. Ou seja, não haverá referências visual à marca Netshow.me.
Acessar conteúdos diretamente pelo Netshow.me
Ao habilitar esta opção, o espectador conseguirá acessar o canal usando a URL vídeos.netshow.me/nomedocanal. Ao realizar embed do canal em sua plataforma e desabilitando a opção Acessar conteúdo diretamente pelo Netshow.me o espectador só conseguirá acessar o canal pelo acesso determinado por você.
Personalização
A personalização do canal é muito importante, pois deixa o seu canal a cara da sua marca. Mas atenção, para que seu canal tenha um carregamento fluído, as imagens que o compõem devem ter peso máximo de 200kb.
Brand
Sugerimos que coloque o logotipo da marca como imagem de brand, pois ela ficará localizada em áreas como cabeçalho e rodapé da página.
Deve seguir as seguintes especificações:
Resolução: 300x100
Formato: JPG
Imagem de Capa
A imagem de capa está localizada no topo do canal. Capriche na arte, afinal ela é a imagem de maior visibilidade que compõem a área. É preciso que a imagem tenha as seguintes especificações:
Resolução: 1920x600
Formato: JPG
Cor promocional
A cor promocional é definida para dar destaque em botões, palavras clicáveis, link entre outras funcionalidades.
A definição pode ser feita manualmente na escala de cores. Mas também pode ser alterada mencionando o código hexadecimal da cor que deseja, basta digitar no campo.
Definir emojis
Durante as transmissões ao vivo é possível disponibilizar emojis no chat para interação entre os espectadores. Nós da Netshow.me deixamos um pack de emojis padrão, mas é possível fazer a alteração para um outro pack de emojis personalizado.
Os emojis definidos em configurações do canal entram como padrões para todas as transmissões ao vivo. Caso deseje alterar para uma transmissão específica, é possível fazê-lo na hora da criação da estrutura da própria transmissão.
Engajamento
Lembrete da transmissão
Habilitando a opção de Lembrete através das configurações do canal automaticamente a opção ficará ativa para todas as transmissões ao vivo criadas. No entanto, caso deseje alterar para alguma transmissão, é possível nas configurações da transmissão específica.
O comportamento do sistema, quando o usuário selecionar a opção de lembrete na transmissão, é questionar em qual agenda ele deseja anotar, e em seguida o sistema disponibilizar um invite em sua agenda.
Selecione nas configurações quais agendas deseja disponibilizar para que um convite seja criado.
Login social
Habilite a opção de login por redes sociais e selecione quais redes sociais terão liberação.
Não recomendamos que habilite login social para transmissões pagas pois pode haver conflito de dados, ou seja, o espectador compra o acesso da transmissão com um e-mail e o e-mail da rede social dele ser diferente.
Embed
O painel de embed é responsável em possibilitar o acesso do espectador no canal através da sua página.
Base externa
Ative a flag de base externa caso tenha um ambiente fechado para seu espectador, ambiente no qual o espectador precisa fazer um login para ter acesso. Ativando a flag, o espectador na sua página não precisará fazer login novamente ao clicar no acesso ao canal .
EMBED DO CANAL
Copie o código HTML disponibilizado na plataforma e o utilize para realizar o embed do canal em sua página.
DOMINIOS PERMITIDOS
A plataforma Netshow.me Live precisa dar permissão à sua página para que ela possa incorporar o canal. Caso deseje liberar a incorporação do canal em mais de uma página, basta acrescentar as outras URLs neste campo.
REDIRECIONAR PARA EMBED
Ao desabilitar a opção de acesso pela URL: videos.netshow.me/nomedocanal, o espectador se deparará com uma página de erro 403 ao tentar acessar. Ativando a opção de redirecionar para embed, ao invés do usuário ver o erro, ele será redirecionado para sua página automaticamente.
Caso tenha mais de uma página com a transmissão incorporada, o sistema seguirá a regra de redirecionar para o primeiro link listado em whitelist.
Embed JWT
CONCEITO JWT
JWT ou JSON Web Token, é um formato para troca de informações entre aplicações, ou é utilizado em mecanismos de autenticação. Realizando a troca de informações de forma segura, por meio de algoritmo de hashing para validação da integridade do token.
EM QUE SITUAÇÃO UTILIZAMOS JWT
Aqui na Netshow.me, utilizamos o JWT como uma forma segura de autenticação de usuários quando uma transmissão é incorporada em um sistema terceiro. Ou seja, uma vez que o usuário está autenticado em sua plataforma, recebemos alguns dados básicos do espectador (Nome e E-mail) encapsulados em um JWT e suprimir a necessidade de uma nova autenticação na plataforma Netshow.me Live. Além disso, também pedimos algumas informações adicionais (IP e data de expiração) para adicionar mais um nível de segurança em seu consumo de conteúdos, inibindo o compartilhamento do código de embed.
PROCEDIMENTO PARA UTILIZAR JWT
Nós da Netshow.me já temos tudo pronto em nosso sistema, agora só precisamos receber as informações da sua aplicação (sistema). Os desenvolvedores da sua equipe, devem aplicar no código JWT o envio dessas informações: IP do usuário, Nome, E-mail e Horário de geração do token de acesso em formato epoch + 30 segundos; utilizando o seguinte código:
{
ip: “endereco_ip”,
user: { "email": "e-mail", "name": "nome" },
exp: "Hora atual em epoch + 30 segundos"
}
Observações importantes: Todas as informações devem ser enviadas para a Netshow.me com letra minúscula. É fundamental que utilizem no código apenas aspas duplas.
Além disso, é necessário que o token seja gerado utilizando a assinatura disponível nas configurações do seu canal da Netshow.me Live. Assim, impedimos que terceiros possam gerar acessos indevidos a sua plataforma.
É importante mencionar que o JWT tem a expiração de 30 segundos, por isso este token deve ser gerado constantemente. Caso contrário, os tokens utilizados ou expirados resultam em erro 403 (Forbidden).
Leia também:
Saiba como utilizar o padrão de codificação de dados JWT, clicando aqui
Para ter acesso ao token, acesse o gerenciador da plataforma netshow.me Live, em seguida selecione a opção Embed.
Ao habilitar a integração do login no embed via JWT, o token é disponibilizado logo abaixo.
Existem outras configurações nesta página que precisam ser feitas. Portanto, acrescente no campo Whitelist a URL do seu sistema. E habilite a opção redirecionar para embed. Desta forma, apenas o seu sistema terá permissão para fazer embed do seu canal Netshow.me Live. E caso um usuário acesse seu canal da Netshow.me Live, automaticamente será redirecionado para o link do seu canal oficial.
Ao final deste processo você terá em mãos o JWT (JSON WEB TOKEN) e é necessário que ele seja enviado como parâmetro no embed da transmissão, assim será possível autenticar o usuário dentro do iframe. Para fazê-lo é bem simples, basta adicionar o parâmetro jwt parâmetro na url (que está preenchida no atributo src) do código iframe disponibilizado na seção “Embed” da sua transmissão.
Exemplo de código
Código padrão:
<script type='text/javascript' src='https://static.netshow.me/integration/embed.js'></script>
<iframe allowfullscreen='yes' frameborder='0' scrolling='yes' src='https://embed-videos.netshow.me/t/YkQ2P7EMCwE' width='100%' height='100%'></iframe>
Código com parâmetro JWT:
<script type='text/javascript' src='https://static.netshow.me/integration/embed.js'></script>
<iframe allowfullscreen='yes' frameborder='0' scrolling='yes' src='https://embed-videos.netshow.me/t/YkQ2P7EMCwE?jwt=' width='100%' height='100%'></iframe>
Código com JWT de exemplo:
<script type='text/javascript' src='https://static.netshow.me/integration/embed.js'></script>
<iframe allowfullscreen='yes' frameborder='0' scrolling='yes' src='https://embed-videos.netshow.me/t/YkQ2P7EMCwE?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpcCI6IjE4Ni4xOTIuODEuNTo0NDMiLCJ1c2VyIjp7ImVtYWlsIjoiZS1tYWlsIiwibmFtZSI6Im5vbWUifSwiZXhwIjoiSG9yYSBhdHVhbCBlbSBlcG9jaCArIDMwIHNlZ3VuZG9zIn0.MMGFfqW7wmLNV09gykixEl2o6dDjRy-VlS-6n-rl0_M' width='100%' height='100%'></iframe>
Realizando essas configurações e passando aos seus desenvolvedores o código, token e as observações importantes. Tudo estará pronto para a integração via JWT.