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
USoundWaveProceduralno códigoOnda 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
UAssetdo som, não o nome da instância de tempo de execuçãoPrioridade: 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
Uassetdo som, não o nome da instância de tempo de execuçãoAmp (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
Uassetpara a fonte do mixador virtualizadoTempo (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.