YouTube
Incluída no Macro DeckMostre o chat ao vivo e as estatísticas da sua transmissão no YouTube, mude título e tags e reaja a Super Chats e membros.
Um widget Chat do YouTube e widgets Estatísticas da transmissão do YouTube
- Widgets Chat do YouTube e Estatísticas da transmissão do YouTube
- Defina o título, a descrição e as tags da transmissão
- Entre no ar, encerre a transmissão e inicie intervalos comerciais
- Gatilhos para Super Chats, Super Stickers e associações
- Usa o seu próprio projeto e cota do Google Cloud
A integração YouTube conecta o seu canal do YouTube ao Macro Deck. Ela mostra o estado da sua transmissão ao vivo como variáveis, dispara gatilhos para Super Chats, Super Stickers e associações, mostra o chat ao vivo em um widget onde é possível moderá-lo e muda a transmissão a partir de um botão.
O YouTube não oferece um login compartilhado que o Macro Deck possa usar para todos. Você se conecta por um projeto próprio no Google Cloud, o que leva cerca de dez minutos uma única vez. O projeto é gratuito, e a cota e as permissões dele pertencem só a você.
O que dá para fazer
- Envie uma mensagem para o chat ao vivo da sua transmissão atual.
- Mude o título, a descrição ou as tags da transmissão ao vivo, ou da próxima programada quando você não estiver ao vivo.
- Inicie a próxima transmissão programada com Entrar no ar, encerre-a com Encerrar transmissão e peça ao YouTube um intervalo comercial.
- Mostre o chat ao vivo no widget Chat do YouTube e, a partir dele, exclua mensagens, suspenda temporariamente ou bana participantes.
- Mostre se você está ao vivo, os espectadores, curtidas e inscritos, o título e o tempo no ar no widget Estatísticas da transmissão do YouTube.
Alguns exemplos de uso:
- Um botão Entrando ao vivo que define o título e as tags da próxima transmissão.
- Um botão Intervalo que pede ao YouTube um intervalo comercial de 60 segundos.
- Um fluxo executado em Super Chat que mostra uma notificação com o autor e o valor.
- Um fluxo executado em Novo membro que publica uma mensagem de agradecimento no chat.
Como funciona
O Macro Deck lê o estado da transmissão mais ou menos uma vez por minuto e o chat a cada poucos segundos enquanto você está ao vivo. Cada leitura e cada alteração consomem cota do seu projeto do Google Cloud, que recebe 10.000 unidades por dia. O Macro Deck faz a contagem. Quando a cota está quase esgotada, ele pausa as atualizações do chat e lê o status ao vivo com menos frequência. Quando a cota se esgota, ele pausa as atualizações do status ao vivo e do chat até a meia-noite no horário do Pacífico, quando o Google redefine a cota.
Chat, Super Chats e eventos de associação só chegam durante uma transmissão ao vivo. Eventos que aconteceram enquanto o Macro Deck não estava rodando não são disparados depois. É possível conectar mais de um canal: toda ação tem um campo Canal, e todo gatilho pode ser limitado a um canal.
O que é necessário
- Macro Deck 3 no Windows, macOS ou Linux, com acesso à internet
- Um canal do YouTube que possa transmitir ao vivo
- Um projeto do Google Cloud com a YouTube Data API v3 ativada
- Um ID do cliente OAuth do tipo TVs e dispositivos de entrada limitada, com o segredo do cliente
- Iniciar intervalo comercial exige uma transmissão ao vivo em um canal que possa exibir anúncios no meio do vídeo
Configuração
Passo 1: Crie um projeto no Google Cloud
Abra o Google Cloud console com a conta do Google dona do seu canal e crie um projeto, por exemplo Macro Deck. Em APIs e serviços > Biblioteca, procure YouTube Data API v3 e clique em Ativar.
Passo 2: Configure a tela de permissão
Abra APIs e serviços > Tela de permissão OAuth (nos consoles mais novos, Google Auth Platform). Escolha Externo, informe um nome de app e o seu endereço de e-mail e salve. Em Público-alvo (ou Usuários de teste), adicione a conta do Google dona do seu canal como usuário de teste.
Passo 3: Crie um ID do cliente OAuth
Abra APIs e serviços > Credenciais, clique em Criar credenciais > ID do cliente OAuth e escolha o tipo de aplicativo TVs e dispositivos de entrada limitada. Qualquer outro tipo é recusado no login. Copie o ID do cliente e o Segredo do cliente que o Google mostra.
Passo 4: Informe o cliente no Macro Deck
No Macro Deck, clique em Integrações na barra lateral e depois em YouTube. Na aba Visão geral, clique em Adicionar configuração na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo, e a integração fica ativada assim que a configuração é concluída. Na caixa de diálogo Conectar um canal do YouTube, cole o ID do cliente e o Segredo do cliente. Só se o Google tiver concedido mais cota ao seu projeto, ative Configuração avançada e informe-a em Cota diária (unidades). Clique em Continuar.
Passo 5: Aprove o acesso no Google
A caixa de diálogo agora mostra Aprove o acesso no Google com um Código do dispositivo. Clique em Abrir o Google e aprovar, faça login com a conta dona do seu canal, informe o código, escolha o seu canal e permita o acesso. O Google avisa que o app não foi verificado: é o seu próprio projeto, então continue. Volte ao Macro Deck e clique em Continuar. A configuração recebe o nome do seu canal, por exemplo YouTube (My Channel). Quando a caixa de diálogo mostrar Configuração concluída., clique em Concluído.
Passo 6: Adicione uma ação do YouTube a um botão
Na página Deck, clique no botão que você quer usar. O deck precisa estar desbloqueado: se o botão no canto superior direito mostra Bloquear, ele está desbloqueado. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione YouTube à esquerda da caixa de diálogo Adicionar ação e escolha uma ação como Definir título da transmissão. Escolha o Canal, informe o Título e clique em Salvar.
Ações7
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Enviar mensagem no chat
- Publica uma mensagem de até 200 caracteres no chat ao vivo da sua transmissão atual.
- Definir título da transmissão
- Muda o título da sua transmissão atual, ou da próxima programada quando você não estiver ao vivo.
- Definir descrição da transmissão
- Muda a descrição da sua transmissão atual, ou da próxima programada.
- Definir tags da transmissão
- Substitui as tags da sua transmissão atual, ou da próxima programada.
- Iniciar intervalo comercial
- Pede ao YouTube que exiba um intervalo comercial de 30 segundos a 3 minutos durante a sua transmissão ao vivo.
- Entrar no ar
- Inicia a próxima transmissão programada que estiver pronta. Abra antes o seu software de transmissão.
- Encerrar transmissão
- Encerra a sua transmissão ao vivo atual.
Gatilhos8
Um botão ou fluxo pode reagir a estes eventos.
- Transmissão iniciada
- O canal entrou ao vivo.
- Transmissão encerrada
- A transmissão ao vivo do canal terminou.
- Super Chat
- Alguém enviou um Super Chat, com autor, valor, moeda e comentário.
- Super Sticker
- Alguém enviou um Super Sticker.
- Novo membro
- Alguém se tornou membro do canal ou fez upgrade da associação.
- Marco de membro
- Um membro compartilhou um marco da associação no chat.
- Associações presenteadas
- Alguém presenteou associações para outros espectadores.
- Evento do YouTube (avançado)
- Todos os eventos do YouTube desta lista em um único gatilho, opcionalmente filtrados por tipo.
Variáveis8
Mostre estes valores em botões e widgets ou use-os em condições.
youtube_<channel>_display_name- O nome do canal.
youtube_<channel>_is_live- Se o canal está ao vivo.
youtube_<channel>_stream_title- O título da transmissão ao vivo.
youtube_<channel>_viewer_count- Os espectadores atuais. Fica vazio quando você oculta o número de espectadores.
youtube_<channel>_like_count- As curtidas da transmissão ao vivo.
youtube_<channel>_subscriber_count- Os inscritos do canal, arredondados como o YouTube faz.
youtube_<channel>_uptime_seconds- Há quanto tempo a transmissão está rodando, em segundos.
youtube_<channel>_stream_thumbnail_url- A miniatura da transmissão.
Widgets2
Adicione estes widgets ao seu deck pelo seletor de widgets.
- Chat do YouTube
- Mostra o chat ao vivo da sua transmissão atual, incluindo Super Chats e novos membros. Pressione para moderar em uma caixa de diálogo maior.
- Estatísticas da transmissão do YouTube
- Mostra o status ao vivo, espectadores, curtidas e inscritos, título e tempo no ar, no estilo escolhido.
Perguntas frequentes
Por que preciso de um projeto próprio no Google Cloud?
O YouTube não oferece um login compartilhado que o Macro Deck possa usar para todos. Com um projeto próprio, a cota e as permissões pertencem só a você. O projeto é gratuito.
Por que preciso fazer login de novo toda semana?
Enquanto a tela de permissão do seu projeto estiver em teste, o Google encerra o login após 7 dias. Integrações mostra então que o login expirou; reconecte com o mesmo ID do cliente e segredo do cliente. Para continuar conectado, publique a tela de permissão no Google Cloud console.
O que acontece quando a cota acaba?
O Macro Deck pausa as atualizações do status ao vivo e do chat, e a página do YouTube em Integrações mostra Cota do YouTube esgotada. O Google redefine a cota à meia-noite no horário do Pacífico, e as atualizações voltam nesse momento. As ações continuam funcionando até o Google recusá-las.
Por que Entrar no ar não inicia a minha transmissão?
Entrar no ar inicia a próxima transmissão programada cujo sinal já está chegando ao YouTube, então abra antes o seu software de transmissão. Transmissões que começam sozinhas, e Transmitir agora no YouTube Studio, são iniciadas pelo YouTube e não por esta ação.
Posso desbanir alguém pelo widget de chat?
Só banimentos feitos pelo Macro Deck durante a transmissão atual, até o Macro Deck ser reiniciado. O YouTube não informa ao Macro Deck quais banimentos existem, então remova os outros banimentos no YouTube Studio.
Onde minhas credenciais ficam armazenadas?
O segredo do cliente e os tokens ficam armazenados criptografados no computador em que o Macro Deck está rodando e só são enviados ao Google.
Mais em Transmissão
OBS Studio
Incluída no Macro DeckTroque cenas, controle transmissão, gravação e áudio e reaja ao que acontece no OBS Studio.
Meld Studio
Incluída no Macro DeckTroque e prepare cenas, controle camadas, efeitos e faixas de áudio e entre ao vivo no Meld Studio.
Streamlabs Desktop
Incluída no Macro DeckTroque cenas e controle a transmissão, a gravação e as fontes de áudio no Streamlabs Desktop.
Streamer.bot
Incluída no Macro DeckExecute ações do Streamer.bot, envie mensagens no chat e reaja a todos os eventos que o Streamer.bot informa.
Twitch
Incluída no Macro DeckMostre o chat e as estatísticas da sua live na Twitch, modere, faça enquetes e anúncios e reaja a follows, subs e raids.