Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari Discord

Modo Rádio e streaming PCM

O Modo Rádio da Hikari no Discord combina reprodução contínua sem baixar o arquivo inteiro antes de tocar, resolução automática entre múltiplas plataformas e controle por botões ou voz.

Streaming PCM progressivo (youtubeBufferStream.js)

Seção intitulada “Streaming PCM progressivo (youtubeBufferStream.js)”
  • Redireciona a saída do yt-dlp para o ffmpeg gerando fluxo contínuo PCM s16le 48.000 Hz estéreo 16-bit.
  • Pré-buffer de 4 segundos (768.000 bytes): inicia o áudio no canal cerca de ~4 segundos após o pedido.
  • Backpressure (20s / 10s): pausa a leitura quando o buffer chega a 20 segundos (3.840.000 bytes) e retoma ao baixar para 10 segundos, mantendo consumo baixo de RAM.
  • Anti-underflow e transição: insere frames de silêncio de 20 ms em oscilações de rede e usa travas (transitioningGuilds) que evitam erros Premature close entre faixas.
Origem Como funciona
YouTube e YouTube Music Suporta vídeos e playlists via extração NDJSON; metadados rápidos com YouTube oEmbed (~50 ms) e yt-dlp -j
Spotify Extrai metadados de faixas, álbuns e playlists (open.spotify.com/...) e busca o áudio equivalente no Deezer
Deezer direto Suporta links individuais, playlists e álbuns do Deezer
Busca livre Calcula confiança fonética no Deezer: com score >= 80% entra na fila direto; se ambígua, exibe menu suspenso de escolha
Modo Latência típica Comportamento
Voz: Off Zero custo STT Desativa escuta de voz na call e mantém apenas botões e comandos
Voz: IA Conforme LLM + TTS Envia a fala transcrita ao modelo completo com as 13 funções de radioMCPTools.json
Voz: Direct Abaixo de 50 ms após STT Identifica intenções por palavras-chave localmente no meio de frases curtas ou longas sem passar pelo LLM

Intenções suportadas no Direct: Pausar, Retomar, Parar, Próxima, Anterior, Embaralhar, Repetir, Ver Fila, Info da Música, Remover Faixa e Busca/Adição de Música (“Hikari, tocar Welcome to the Jungle”). Exibe notificação mencionando o autor e apaga automaticamente após 4 segundos.

Em caso de erro 429/492 na API Whisper, a escuta pausa por 1 minuto, avisa no chat e agenda reativação automática. Por padrão, radio_voice_stt inicia desabilitada por servidor e pode ser ativada em /ia_ferramentas.

Botões do painel (radioEmbed.js) e limpeza (radioCleaner.js)

Seção intitulada “Botões do painel (radioEmbed.js) e limpeza (radioCleaner.js)”
  • Controles: Adicionar (modal), Remover (modal por posição #x), Play/Pause, Parar, Anterior, Próxima, Embaralhar, Loop (Off → Playlist → Música), alternância de Voz (Off → IA → Direct), Fila (menu efêmero) e Sair.
  • Limpeza temporária: radioCleaner.js monitora src/music/data/temp_radio_audio, preserva faixas em execução nas sessões ativas e remove arquivos inativos há mais de 15 minutos na inicialização e a cada 10 minutos.