Files
jhonny-editor/code/engine
João Henrique bb4e7ba663 feat: integrado o classificador Essentia de gênero e humor ao resu
- integrado o classificador Essentia de gênero e humor ao resultado musical
- reorganizado o fluxo da aba Editar vídeo para revisar o plano antes de aplicar

Resumo:
- 3 arquivos alterados
- 0 novos
- 3 modificados
- 0 removidos

 3 files changed, 32 insertions(+), 21 deletions(-)

Arquivos:
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/engine/integracoes/audio/provider_de_analise_musical_essentia.py
2026-09-10 13:36:42 -04:00
..

Engine

Núcleo Python orientado a objetos para o fluxo de scanner.

from engine import Scanner
from engine.domain import Content

result = Scanner().scan(Content("asset-1", " texto "))
assert result.valid

As integrações reais devem implementar os protocolos em content_analyzer.py, decision_engine.py, edit_plan.py, plan_applicator.py, validator.py e persistence.py. O pacote não cria dependências externas por padrão.

Análise de músicas instrumentais

A análise musical local fica separada da análise de voz e segue este fluxo:

caso de uso da engine
        ↓
AnalisadorDeMusica (contrato)
        ↓
AnalisadorDeMusicaInstrumentalEssentia
        ↓
ResultadoDaAnaliseMusical

Arquivos principais:

  • integracoes/audio/contratos.py: contrato substituível do analisador;
  • integracoes/audio/modelos_de_analise_musical.py: resultado interno em PT-BR;
  • integracoes/audio/provider_de_analise_musical_essentia.py: adaptador local do Essentia;
  • testes/test_analisador_de_musica_essentia.py: testes unitários sem instalar Essentia.

Exemplo de uso:

from engine.integracoes.audio import AnalisadorDeMusicaInstrumentalEssentia

resultado = AnalisadorDeMusicaInstrumentalEssentia().analisar("musica.wav")
print(resultado.generos, resultado.humores, resultado.batidas_por_minuto)

A dependência é carregada sob demanda. Para habilitar a análise, instale as dependências de requirements-audio.txt. O adaptador não persiste o resultado nem gera a descrição narrativa; essas responsabilidades ficarão no caso de uso e na apresentação, respectivamente.