Esta página reorganiza a especificação numa forma mais fácil de usar durante a implementação. Não substitui os ficheiros markdown incluídos, mas ajuda a separar o contrato do formato, as variantes de transporte e a profundidade descritiva ligada a cada nível de qualidade.
Os documentos de referência definem três regras de base. Primeiro, EEV é um formato textual e versionável. Segundo, deve descrever um som produzido completo, com início, evolução e fim identificáveis. Terceiro, a fundamental isolada não é tratada como a identidade principal do som.
Um ficheiro EEV não é nem um fluxo áudio bruto, nem uma simples imagem de espectro, nem uma promessa terapêutica. É um documento estruturado que resume o comportamento sonoro numa forma que o código pode reler, comparar, arquivar e voltar a emitir.
A especificação contém muitos detalhes, mas a estrutura útil é estável. Para uma primeira implementação séria, o mais importante é saber onde colocar cada família de informação.
Bloco de identidade da impressão: identificadores, tipo, instrumento, contexto, qualidade e estado documental. É o ponto de entrada lógico de cada item.
Vista global da captação: ruído de fundo, SNR, métricas transversais, duração útil e outros indicadores gerais. Algumas marcas legacy podem ser toleradas na leitura, mas não devem ser reemitidas canonicamente.
Estes blocos contêm resumos compactos e mapas energéticos usados para comparar, indexar e fazer matching mais rapidamente sem perder toda a estrutura do som.
Estes blocos descrevem estruturas dominantes e trajetórias finas ao longo do tempo. Tornam-se particularmente importantes quando se pretende acompanhar estabilidade, deriva, batimentos ou reconstrução avançada.
ENTRY é o contentor de item único. Contém exatamente uma impressão. Para troca, testes, demonstrações e muitas APIs, é o caso mais simples e muitas vezes o mais prático.
LIB é o contentor de biblioteca. Agrupa uma ou mais entradas. É útil para coleções, bibliotecas embebidas, importações em lote e fluxos que manipulam várias impressões em conjunto.
As variantes comprimidas não alteram o modelo documental. Apenas mudam a forma como o texto é transportado.
| Extensão | Papel | A reter |
|---|---|---|
| .eev | texto público editável | fonte canónica funcional do canal aberto |
| .eevz | transporte comprimido de .eev | descomprime-se primeiro e depois lê-se o mesmo texto canónico |
| .eevc / .eevcz | compatibilidade apenas de leitura | ler ficheiros certificados existentes se necessário; a verificação certificada pertence a eevc.link |
Os quatro níveis não definem quatro formatos incompatíveis. Regulam a profundidade descritiva e o custo computacional.
| Nível | Intenção | O que um leitor pode esperar |
|---|---|---|
| eco | retrato leve mas real | base descritiva, resumo utilizável, custo reduzido |
| standard | comparação mais robusta | matrizes e resumos mais ricos sem passar para o perfil mais pesado |
| high | melhor respeito temporal | captação temporal mais fina e descrições comportamentais mais estáveis |
| ultra | ambição descritiva máxima | trajetórias avançadas, dados de controlo mais ricos e espaço para futuras extensões orientadas para síntese |
