Plug-in AudioInsights

Visão geral

O AudioInsights é um plugin de mecanismo que fornece um conjunto de ferramentas para criar perfis, depurar e monitorar aspectos de tempo de execução de áudio no Unreal Engine. Usando várias janelas com abas, o AudioInsights pode fornecer visualizações e valores numéricos para tom atual, volume e outros valores de parâmetros para Fontes, Barramentos de Áudio, Submixes e muito mais durante o jogo ao vivo. Ele pode fornecer informações para sessões JNE, além de jogos independentes.

Início Rápido

O AudioInsights não está habilitado por padrão. Para habilitá-lo, selecione Editar > Plugins no Editor Unreal e habilite o plugin AudioInsights. Você precisará clicar em Reiniciar agora para que o plugin seja carregado.

Uma vez habilitado para o projeto, você pode abrir uma janela AudioInsights no menu Ferramentas na janela do editor, selecione Audio Insights:

Iniciar uma sessão JNE começará a preencher a janela AudioInsights com dados do mecanismo de áudio. O AudioInsights requer gravação de rastreamento usando UnrealInsights, e abrir a janela do AudioInsights iniciará automaticamente a gravação de um rastreamento quando você entrar em uma sessão JNE. O AudioInsights é uma janela com abas e pode ser encaixado em qualquer lugar do seu editor para sua conveniência. 

Usar o AudioInsights com um jogo independente requer o uso do UnrealInsights. No menu Rastreamento no canto inferior direito da janela do editor, selecione Unreal Insights (navegador da sessão) e saia do editor quando o UnrealInsights for iniciado.

Como alternativa, você pode executar o UnrealInsights na linha de comando com:

/Engine/Binaries/Win64/UnrealInsights.exe -DisableFramerateThrottle

O sinalizador extra permitirá que o UnrealInsights seja executado a 60 fps mesmo quando não estiver em foco. Inicie seu jogo independente com o sinalizador -Messaging e conecte-se a ele a partir do UnrealInsights usando a aba Conexão, garantindo que cpu, áudio e mixador de áudio (sem espaços após as vírgulas) estejam indicados no campo Canais Iniciais e clique em Conectar.

Isso se conectará ao jogo em execução no momento. Na aba Armazenamento de Rastreamentos, encontre o rastreamento marcado como AO VIVO e clique duas vezes para abrir a janela da sessão de rastreamento. No Menu, selecione a opção Audio Insights.

Isso abrirá uma janela do AudioInsights que funciona de forma semelhante àquela conectada ao JNE acima. Uma instância independente do AudioInsights não tem a mesma mensagem que ao trabalhar com o JNE; apenas as abar Sons, Fontes e Loops Virtuais estão disponíveis.

Abas Detalhes de Dados de Áudio

As abas visíveis são configuradas usando o menu Visualizar na aba Audio Insights:

As abas detalhadas podem ser reposicionadas em qualquer lugar dentro da aba Audio Insights ou exibidas como uma janela flutuante livre. Selecionar Restaurar Layout corrigirá qualquer caos descontrolado resultante na aba.

Controles de Nível Superior:

• Rastrear sinais de áudio apenas durante JNE: o AudioInsights usa os recursos de rastreamento do UnrealInsights, que podem gerar muitos dados. Se você estiver habilitando o rastreamento apenas para o AudioInsights, habilitar esta caixa de seleção reduzirá a quantidade de dados armazenados enquanto você monitora e depura sua sessão com o AudioInsights

• Filtro Mundo: este menu suspenso oferece a opção de selecionar dados de áudio dos mundos em execução no momento, incluindo o editor

Aba Log

A aba Log é outra maneira conveniente de filtrar e observar os logs do Unreal Editor ao lado de qualquer informação de áudio pertinente que você esteja visualizando. Esses dados exibem, por padrão, todas as categorias de log específicas de áudio, mas você pode alterar os filtros para incluir ou excluir quaisquer outras categorias de log e verbosidades.

Aba Sons

A aba Sons exibe todos os ativos sonoros atualmente em reprodução, listados por categoria, com exibições de texto de dados de tempo de execução para cada um. Ela permite que você interaja com os sons reproduzidos para silenciar e isolar elementos de mixes. Os nomes usados para identificar sons são o nome Uasset e não o nome da instância de tempo de execução.

Categorias de Som

• MetaSound: ativos Fontes de MetaSound

• Indicação Sonora: indicações sonoras e quaisquer Ondas Sonoras filhas

• Fonte Procedural: qualquer objeto de entrada do mixador que herda de USoundWaveProcedural no código

• Onda Sonora: ativo de onda simples

• Modelo de Indicação Sonora: indicações sonoras criadas no tempo de execução de um modelo

• Outro: barramentos de fonte de áudio

Dados

• Silenciado: exibe se esta instância do som está silenciada

• Modo solo: exibe se esta instância do som está em modo solo

• Nome: nome UAsset do som, não o nome da instância de tempo de execução

• Prioridade: definido para simultaneidade, um valor de float positivo com números mais altos indicando maior prioridade

• Distância: distância positiva do renderizador de som em unidades de mapa

• Amp (Pico): valor de um seguidor de envelope que acompanha a amplitude do som, valor de float de 0,0 a 1,0 para amplitude máxima de saída

• Volume: a soma de todos os valores de volume e moduladores para esta instância do som, excluindo a atenuação de distância, um valor de float positivo como um multiplicador de amplitude linear

• Tom: a soma de todos os valores de tom e moduladores para esta instância do som, um valor de float positivo como um multiplicador de taxa de reprodução linear

• Agregação: em um objeto hierárquico, como uma Indicação Sonora que contém várias Ondas Sonoras filhas, o Volume de Indicação Sonora e o Tom mostrarão os valores de nível superior, mas a Onda Sonora mostrará o valor agregado do nível superior da Indicação Sonora e quaisquer outras modulações que ocorram com essa Onda Sonora dentro da Indicação Sonora

Opções de Exibição

• Mostrar Interrompidos: quando selecionado, permitirá que os sons que foram interrompido recentemente continuem a ser exibidos na lista em cinza por alguns segundos, facilitando a observação de sons curtos

  

• Categorias de Filtro: mostra botões de categoria no cabeçalho da aba, permitindo filtragem rápida dos sons listados

  

• Exibição de Dados: clicar com o botão direito na barra de cabeçalho exibirá opções para selecionar os dados de áudio mostrados

  

Controles

• Menu de Contexto de Sons: clicar com o botão direito do mouse em um som selecionado permitirá que você Fixe um som no topo da tela, Navegue até o ativo no navegador de conteúdo ou Edite para abrir o editor de ativos desta janela

  

• Silenciar Selecionado: enquanto um som estiver selecionado na lista, pressionar o botão Silenciar selecionado silenciará esse ativo sonoro

  

• Solo Selecionado: enquanto um som estiver selecionado na lista, pressionar o botão Solo Selecionado fará o solo daquele ativo sonoro

  

• Limpar Todos os Silenciados/Solos: restaura para a mixes de reprodução padrão

Aba Fontes

A aba Fontes exibe todas as entradas atuais para o Mixer de Áudio em uma lista simples. Os ativos apresentados são consistentes com os ativos listados na aba Sons, exibindo dados de áudio diferentes.

Dados exibidos

• Ordem de Reprodução: ID de instância de som que aumenta monotonicamente, indica a ordem em que os sons foram iniciados no mixador

• Nome: nome Uasset do som, não o nome da instância de tempo de execução

• Amp (Pico): valor de um seguidor de envelope que acompanha a amplitude da fonte do mixador

• Volume: soma de todos os controles de volume e moduladores para esta fonte de mixador, não incluindo atenuação de distância, valor de float positivo como um multiplicador de amplitude linear

• Atenuação de Distância: multiplicador de ganho baseado na distância desta fonte do mixador ao renderizador de som, valor de float de 0,0 a 1,0

• Tom: soma de todos os controles de tom e moduladores para esta fonte do mixador, valor de float positivo como um multiplicador de taxa de reprodução linear

• LPF: soma de todos os controles de filtro passa-baixa e moduladores para esta fonte de mixador, indicando a frequência de corte em Hertz

• HPF: soma de todos os controles de filtro passa-alta e moduladores para esta fonte de mixador, indicando a frequência de corte em Hertz

Controles

• Filtro de Dados: clicar com o botão direito na barra de cabeçalho da lista revelará um menu de contexto para selecionar quais valores de dados de áudio são mostrados por fonte do mixador

  

• Silenciado/Solo Global: este controle depende do que está sendo filtrado pela janela de texto, os botões M e S silenciarão e isolarão a lista filtrada de fontes. Se nada estiver sendo filtrado, pressionar os botões M e S retornará ao mix padrão. Isso impede qualquer ação de silenciar ou criar solo na aba Sons

• Mostrar/Ocultar Gráfico de Evolução: pressionar o botão de gráfico no canto superior direito da aba mostrará um gráfico de tempo dos dados selecionados da tabela

  

• Editar Ativo: clicar duas vezes em uma fonte de mixador na exibição da lista abrirá o editor de ativos com esse ativo

Gráfico de Evolução

Se Gráfico de Evolução for selecionado, a parte inferior da aba Fontes mostrará um gráfico de linhas dos históricos de valores de fonte do mixador para os dados escolhidos nos últimos 5 segundos. Os valores da linha do tempo são do início do rastreamento, normalmente o início da sessão de jogo. O valor dos dados do Gráfico de Evolução é escolhido usando o menu suspenso no canto superior direito do gráfico e é exibido nas mesmas unidades da exibição numérica descrita acima. O Gráfico de Evolução mostrará as primeiras 16 fontes da lista.

Aba Loops Virtuais

Esta aba exibe uma lista de todos os Sons Ativos que estão sendo rastreados pelo renderizador, mas não estão produzindo amostras para o mixador devido a fatores de simultaneidade ou atenuação de distância.

Dados exibidos

• Ordem de Reprodução: ID de instância de som que aumenta monotonicamente, indica a ordem em que os sons foram iniciados no mixador

• Nome: nome Uasset para a fonte do mixador virtualizado

• Tempo (virtualizado): o tempo em segundos desde a última vez que este som foi amostrado para o mixador

• Tempo (total): o tempo total em segundos em que este som está sendo reproduzido, tanto virtualmente quanto não

• Intervalo de Atualização: o tempo em segundos entre atualizações de posição ou simultaneidade que determinariam se este som permaneceria virtual. Este valor varia com a distância do renderizador

Controles

• Navegar: este botão mostrará o ativo selecionado no Navegador de Conteúdo

• Abrir: este botão abrirá o editor de ativos para o ativo selecionado

• Filtro de Dados: clicar com o botão direito na barra de cabeçalho da lista revelará um menu de contexto para selecionar quais valores de dados de áudio são mostrados por fonte do mixador

  

• Editar Ativo: clicar duas vezes em uma fonte de mixador na exibição da lista abrirá o editor de ativos com esse ativo

Aba Submixes

Esta aba lista todos os Submixes de Som no projeto atual e indica quais deles têm sinais ativos no momento. Você pode selecionar um conjunto de submixes para exibir os níveis de sinal na aba Medidores de Áudio.

Dados exibidos

• Ativo: um ponto nesta coluna indica um sinal ativo naquele submix

• Selecionar: uma caixa de seleção nesta coluna indica que os níveis de submixes estão sendo mostrados visualmente nos medidores na aba Medidores de Áudio. Observe que você precisa abrir manualmente a aba Medidores de Áudio se ela não for exibida na sua configuração atual

• Nome: o nome do ativo Submix de Som

Controles

• Editar Submix: clicar duas vezes em um submix na lista abrirá o editor de ativos para esse ativo

Aba Barramentos de Áudio

Os barramentos de áudio são buffers de uma determinada configuração de canal para os quais qualquer fonte de áudio pode "enviar" áudio. O áudio enviado para um barramento é mixado em um único sinal. Os barramentos de áudio não estão conectados em nenhum tipo de gráfico ou relacionamento entre si. Sua utilidade é que eles são um lugar para realizar análises de áudio (por exemplo, envelope seguinte) que pode acionar outros sistemas ou pode ser roteado para "barramentos de origem" (que sonificam sua saída para uma fonte de som) ou pode ser lido de um MetaSound (e sonificado ou analisado posteriormente em um gráfico MetaSound DSP).

Dados exibidos

• Ativo: um ponto nesta coluna indica um sinal ativo nesse barramento de áudio

• Selecionar: uma caixa de seleção nesta coluna indica que os níveis de barramento de áudio estão sendo mostrados visualmente nos medidores na aba Medidores de Áudio. Observe que você precisa abrir manualmente a aba Medidores de Áudio se ela não for exibida na sua configuração atual

• Nome: o nome do ativo do barramento de áudio

Controles

• Filtro de Tipo: permite que você exiba ativos de barramento de áudio, barramentos gerados em código ou ambos

  

• Editar Barramento de Áudio: clicar duas vezes em um barramento de áudio na lista abrirá o editor de ativos para esse ativo

Aba Medidores de Áudio

Esta aba mostra visualizações medidas de Submixes (texto verde) e Barramentos de Áudio (texto azul) selecionados em cada uma dessas abas. A amplitude medida usa uma escala logarítmica de dB. Cada canal em uma configuração de barramento é representado com um medidor separado em ordens canônicas de alto-falantes. A janela rolará para acomodar todos os submixes e barramentos selecionados. Não há controles para esta aba.

Aba Analisadores

A aba Analisadores é uma série de 5 visualizações em tempo real da saída de áudio principal do Engine. Selecione as visualizações no menu de reticências no canto superior direito da aba.

Medidor: exibe a amplitude RMS de saída principal em uma escala logarítmica de dB. O número de canais corresponde à configuração de canais do dispositivo de áudio. Não há controles adicionais para este analisador.

Osciloscópio: exibe um gráfico de amplitude de amostra do domínio do tempo dos últimos 0,5 segundos de áudio provenientes da saída de áudio principal. A escala é um float linear de 0,0 a um máximo de 1,0. Não há controles adicionais para este analisador.

Vetorscópio: exibe uma amplitude de domínio de tempo linear do canal esquerdo no eixo horizontal em relação ao canal direito no eixo vertical. Isso é bom para observar relações de fase e coerência de canal. Não há controles adicionais para este analisador.

Espectrograma: exibe um gráfico de domínio de frequência da saída de áudio mais recente mixada em um canal mono. O tempo está no eixo horizontal e a frequência de áudio está no eixo vertical. Cada linha vertical no gráfico representa uma única janela temporizada de áudio e a cor do pixel representa a potência do sinal de áudio naquela frequência. Existem vários controles para o gráfico, selecionados clicando com o botão direito em qualquer lugar do analisador:

• Tipo de Analisador: selecione entre uma Transformada Rápida de Fourier (FFT) e uma Transformada Q Constante (CQT) para representar o sinal de áudio no domínio da frequência

• Tamanho da FFT: o número de amostras de áudio usadas em cada transformação em janela. Um tamanho maior proporcionará maior resolução de frequência, em troca de menor resolução de tempo

• Modo de Gráfico de Pixel: escolha entre Amostra, Pico ou Média em como as amostras são ponderadas para exibir a intensidade do sinal. Isso pode ser usado para enfatizar frequências transitórias ou não

• Escala de Frequência: escolha da escala linear ou logarítmica para ver diferentes detalhes no espectro

• Mapa de Cores: escolha entre branco ou preto representando maior intensidade de sinal

• Orientação: escolha entre horizontal (mostrado acima) ou vertical, que troca os eixos de modo que o tempo fique na vertical e a frequência na horizontal

Analisador de Espectro: exibe um gráfico instantâneo do domínio de frequência da saída principal mixada em um canal mono com frequência de áudio no eixo horizontal e intensidade do sinal no eixo vertical. Mover o mouse para uma frequência específica exibirá a intensidade do sinal naquela banda do espectro. Há várias opções de exibição para este analisador.

• Balística: escolha entre Analógica ou Digital, que simula a persistência do sinal entre janelas de áudio para ter a aparência de medidores de áudio profissionais analógicos ou digitais. Isso determina o quão suave (analógica) ou precisa (digital) a transição entre os quadros pode ser

• Tipo de Analisador: selecione entre uma Transformada Rápida de Fourier (FFT) e uma Transformada Q Constante (CQT) para representar o sinal de áudio no domínio da frequência

• Tamanho da FFT: o número de amostras de áudio usadas em cada transformação em janela. Um tamanho maior proporcionará maior resolução de frequência, em troca de menor resolução de tempo

• Espectro de Inclinação: uma quantidade de atenuação dada por frequência para achatar o gráfico de um espectro que é mais fortemente ponderado nas frequências mais baixas

• Modo de Gráfico de Pixel: escolha entre Amostra, Pico ou Média em como as amostras são ponderadas para exibir a intensidade do sinal. Isso pode ser usado para enfatizar frequências transitórias ou não

• Escala de Frequência: escolha da escala linear ou logarítmica para ver diferentes detalhes no espectro

• Exibir rótulos do eixo de frequência: rotula as linhas da grade do gráfico horizontal com valores numéricos em Hertz

• Exibir rótulos do eixo do nível de som: rotula as linhas da grade do gráfico vertical com valores numéricos em decibéis

Aba Barramentos de Controle

O plugin Modulação de Áudio permite ao usuário criar Barramentos de Controle que podem modificar tom, volume, filtro e outros valores para fontes de áudio e submixes. Esta aba exibe o valor atual de cada barramento ativo em formato numérico, formatado como um valor de float entre 0,0 e 1,0. Os valores de tom, volume e filtro vistos nas páginas Fontes e Sons refletem a influência dos Barramentos de Controle exibidos aqui.

Não há opções adicionais de exibição ou controle nesta aba.

Matriz de Modulação

Os barramentos de controle no plugin Modulação de Áudio podem ser somados para criar efeitos cumulativos. A aba Matriz de Modulação fornece informações sobre os diferentes barramentos atualmente ativos e como eles estão colaborando para afetar as fontes de áudio.

  Não há opções adicionais de exibição ou controle nesta aba.