Documentation menu

Cursos, aulas e vídeo

Um curso é um contêiner — título, descrição, imagem de capa e uma lista ordenada de aulas — criado e editado em Cursos (/dashboard/courses) no painel. Cada aula contém um vídeo enviado, notas escritas opcionais e um quiz de compreensão opcional.

Criando um curso

Um novo curso começa como rascunho — visível apenas para você, nunca no catálogo público. Adicione aulas na ordem que preferir (reordene quando quiser; as aulas aparecem para os assinantes nessa ordem), podendo criar cada aula primeiro só com a estrutura, se preferir escrever o roteiro antes de gravar qualquer coisa — o vídeo de uma aula pode ser anexado depois.

Enviando o vídeo da aula

Anexar um vídeo a uma aula é um fluxo de três etapas com envio direto para o armazenamento, não um único envio de formulário:

  1. O MailInApp cria um documento videoAssets e uma URL de envio assinada de curta duração, depois de verificar que o envio não excederia o limite de armazenamento de vídeo do seu plano.
  2. O navegador envia os bytes brutos do arquivo diretamente para essa URL assinada — o arquivo nunca passa por um servidor do MailInApp.
  3. Quando o envio termina, uma chamada de finalização inicia a transcodificação: um job da Transcoder API converte o envio em uma versão HLS privada mais um quadro de capa (poster frame), e o status do recurso passa por uploadingprocessingready (ou failed, com um motivo curto e legível exibido para você). O editor de cursos consulta periodicamente e exibe o estado atual do recurso — não há nada para acompanhar manualmente, mas um arquivo grande pode levar alguns minutos para terminar o processamento antes de ficar disponível para assistir.

O vídeo é armazenado e disponibilizado de forma privada — nunca é uma URL pública que você poderia colar em outro lugar. A reprodução só é concedida por meio de uma verificação de direito de acesso a cada requisição (veja Portal de membros e cobrança de assinatura), não um link que funciona para qualquer pessoa que o tenha.

Pré-visualizações gratuitas

Ative Pré-visualização gratuita em qualquer aula (normalmente a aula 1) para que ela seja reproduzida para qualquer pessoa que chegue ao seu portal, assinante ou não — a alavanca óbvia de "dar uma amostra antes de cobrar". Todas as outras aulas exigem uma assinatura ativa.

Verificações de compreensão da aula

Anexe um quiz curto a uma aula: um limite de aprovação mais um conjunto de perguntas, cada uma com suas próprias opções e resposta correta, verificadas no servidor da mesma forma que o bloco de Quiz do estúdio. É uma implementação separada, exclusiva do portal, já que uma aula não tem uma campanha à qual anexar um bloco de quiz enviado por e-mail. Mas o modelo de pontuação (correspondência exata de respostas em relação a uma nota de aprovação) é o mesmo que você já conhece do bloco de Quiz, se já o usou em uma campanha.

Progresso de visualização

Enquanto um assinante assiste, a posição dele é salva a cada ~15 segundos e novamente no momento em que a aula termina, para que voltar a uma aula retome de onde ele parou. Uma aula marcada como concluída permanece concluída mesmo que ele reassista a uma parte anterior dela. Você vê contagens agregadas de conclusão por aula na página de detalhes do curso — um número simples de "quantos assinantes terminaram isso", a versão do portal para os agregados por pergunta que você já tem no painel de Respostas de uma pesquisa.

Publicação e a etapa de revisão da comunidade

Um curso permanece em rascunho até você enviá-lo para revisão, momento em que passa para pendente. É uma fila de revisão manual por um administrador, o mesmo formato "uma pessoa analisa antes de publicar" do status pendente da galeria pública de modelos. Uma vez aprovado, ele se torna publicado e aparece no catálogo do seu portal. Se for devolvido, você verá um breve motivo de rejeitado e poderá reenviá-lo depois de corrigir o que foi apontado. Você só pode, por conta própria, solicitar rascunho ou enviar para revisão — nada que você faça leva um curso diretamente a publicado ou rejeitado.

Um curso publicado também pode ser retirado do ar separadamente desse processo de revisão, caso o MailInApp receba uma notificação válida de violação de direitos autorais contra ele — veja a política de direitos autorais para saber como isso funciona e como contestar uma notificação.

Notificando assinantes sobre uma nova aula

Publicar uma aula não envia e-mail automaticamente para ninguém — um botão Notificar assinantes na página de detalhes do curso é um envio deliberado e opcional, para que lançar cinco aulas de uma vez não dispare cinco e-mails separados. Ele alcança todo assinante com direito de acesso no momento pelo mesmo caminho de e-mails de ciclo de vida das suas notificações de boas-vindas/cancelamento, não pelo pipeline de campanhas do estúdio — é um aviso simples do tipo transacional, não a renderização de um projeto.

Veja também