PAUTINKAAudio Motion System 1.0
Movimiento runtime controlado por audio, Choreography determinista, recursos Dialogue Curve reutilizables y mezcla de Animation Sequence para Unreal Engine.
Descripción general
AMS convierte el análisis de audio en datos reutilizables y control runtime. El editor ofrece cuatro espacios de trabajo especializados, mientras los módulos runtime exponen componentes, recursos, helpers Blueprint e interfaces C++.
Preview está pensado para iterar; los recursos reutilizables y los componentes runtime llevan después el resultado a producción.
Información técnica
Instalación
AudioMotionSystem en [Project]/Plugins/.Intermediate o Saved carpetas entre equipos.
Inicio rápido
Connect Audio Motion o con un Audio Motion Clip.Control mediante voz
Motion impulsado por música
Suprime el desplazamiento global.
Úsalo para reproducción estacionaria.Usa la trayectoria planificada.
Úsalo cuando la secuencia deba desplazarse.Usa la trayectoria global estabilizada.
Úsalo cuando el desplazamiento planificado necesite estabilización.
Salida escalar
Crear un Audio Motion Dialogue Curve cuando necesites un único valor escalar baked para Blueprint o para un parámetro de material.
La evaluación runtime lee la curva baked y no necesita repetir el análisis del editor.
Connect Dialogue Curve Asset crea o reutiliza un componente Audio Motion Dialogue Curve en el Actor de destino y lo inicia con la configuración del recurso.
El valor escalar actual está disponible mediante Get Dialogue Curve Value. Si la salida de material está activada, el mismo valor se escribe en el parámetro escalar seleccionado.
Animation Sequence + Dialogue
Construye un mapping Source-to-Target a partir de la jerarquía de referencia y la geometría.
Las animaciones nativas del Rig de destino omiten el retargeting.Parte de Auto y permite sustituir o borrar los mappings que necesitan corrección.
Úsalo en casos poco habituales o de baja confianza.Reutiliza un Retarget Profile guardado para un par Source / Target conocido.
Ideal para trabajo repetido de producción.
Arquitectura
AudioMotionRuntimeRuntimeEvaluación de audio, componentes, helpers Blueprint, recursos, mapping y datos Choreography.Juego + EditorAudioMotionAnimationRuntimeNodo de control AnimGraph runtime.Sistemas de animaciónAudioMotionEditorEditorVentana Tools, fábricas de recursos, Preview, autoría, Bake y Animation Mixer.Solo EditorAudioMotionRuntime y, cuando sea necesario, AudioMotionAnimation. No añadas una AudioMotionEditor dependencia al código runtime de shipping.El módulo runtime prepara los archivos compactos AMS Vocabulary y view desde Content/AMSData como dependencias runtime NonUFS.
*.amsvocab.json
*.amsvocabz
*.amsview.jsonLas carpetas Vocabulary del proyecto compatibles con las reglas de build runtime también pueden incluirse cuando existan.
Nodos principales de integración
Los helpers Blueprint crean o reutilizan componentes AMS en el Actor de destino. Las entradas obligatorias se validan; una configuración fallida devuelve None / nullptr.
UAudioMotionComponent*Crea o reutiliza el componente Audio Motion principal, prepara la ruta Voice Sound, reconstruye los bindings Dialogue, conecta el componente Rig de destino e inicia el procesamiento.
UAudioMotionComponent*Conecta un Audio Motion Clip baked al Actor de destino. Esta ruta no requiere reproducir audio de origen.
UAudioMotionComponent*Configura el componente principal para procesamiento mediante música usando la SoundWave seleccionada como Background Music. El procesamiento puede continuar independientemente de la fuente Voice.
UAudioMotionComponent*Conecta Voice Sound y Background Music independiente al mismo Audio Motion Component. El componente sigue procesando cuando termina la reproducción Voice para que continúe la ruta musical.
UAudioMotionComponent*Busca el primer Audio Motion Component conectado al Actor de destino. Devuelve None si el Actor no tiene uno.
UAudioMotionDialogueCurveComponent*Crea o reutiliza un componente Dialogue Curve y conecta su salida escalar a Blueprint y, por defecto, a un parámetro escalar de material.
UAudioMotionDialogueCurveComponent*Crea o reutiliza un componente Dialogue Curve y aplica el recurso completo generado: sonido fuente, curva baked, ajustes de respuesta, loop, objetivo de material, slot de material y nombre de parámetro.
UAudioMotionPulseComponent*Crea o reutiliza un componente escalar compacto Audio Pulse. La fuente puede ser Voice, energía musical general, bandas de frecuencia, onset, beat o un canal Audio Motion personalizado.
Control en tiempo de ejecución
Cabecera: AudioMotionComponent.h · Módulo: AudioMotionRuntime
SetAudioSource(UAudioComponent*)Establece la entrada Audio Component y actualiza el estado de la fuente.SetSourceSound(USoundWave*)Establece la fuente SoundWave.SetSourceClip(UAudioMotionClip*)Establece la fuente Audio Motion Clip baked.StartProcessing(bool)Inicia la evaluación; opcionalmente reinicia el tiempo de reproducción.StopProcessing(bool)Detiene la evaluación; opcionalmente detiene el audio fuente.ResetProcessing(float)Reinicia el estado del procesador al tiempo indicado.PushEnvelopeValue(float)Proporciona un valor envelope manual para el modo de entrada Manual Envelope.EvaluateAtTime(float,float)Evalúa un tiempo explícito y un valor envelope.EvaluateSourceAtTime(float)Evalúa la fuente configurada en el tiempo solicitado.ApplyExternalFrame(FAudioMotionFrame,bool)Aplica un frame ya construido y, opcionalmente, bindings automáticos.RefreshAutomaticConnection()Vuelve a resolver la conexión automática del objetivo runtime.ResetAutomaticBindings()Borra el estado en caché de los bindings automáticos.SetTargetSkeletalMesh(...)Establece un componente Rig de destino explícito para runtime.GetChannelValue(EAudioMotionChannel)Lee un valor del frame actual.GetPlaybackTimeSeconds()Devuelve el reloj principal de reproducción actual.GetSourceDurationSeconds()Devuelve la duración de la fuente configurada cuando está disponible.IsProcessing()Devuelve el estado de procesamiento.SetBackgroundMusic(...)Establece la SoundWave independiente de Background Music.PlayBackgroundMusic(float)Inicia Background Music en el tiempo local solicitado.StopBackgroundMusic()Detiene la reproducción de Background Music.SetBackgroundMusicVolume(float)Actualiza el volumen de Background Music.IsBackgroundMusicPlaying()Devuelve el estado de reproducción de Background Music.On Frame UpdatedOn Speech Value UpdatedOn Speech StartedOn Speech StoppedCabecera: AudioMotionPulseComponent.h · Módulo: AudioMotionRuntime
Lee un canal AMS seleccionado o un sonido independiente, lo mapea mediante rangos Input/Output con suavizado attack/release, puede escribir el valor en un escalar de material dinámico y expone un evento de umbral.
StartPulse()Inicia ticking y evaluación de la fuente.StopPulse(bool)Detiene la evaluación; opcionalmente detiene el audio independiente.SetStandaloneSound(USoundWave*,bool)Cambia la fuente independiente y opcionalmente reproduce de inmediato.GetPulseValue()Devuelve la salida escalar actual.On Pulse Value UpdatedOn PulseCabecera: AudioMotionDialogueCurveComponent.h · Módulo: AudioMotionRuntime
Derivado de Audio Motion Pulse Component. Al asignar un Curve Asset, su curva baked se convierte en la fuente escalar y los ajustes de reproducción/material se copian al componente.
SetCurveAsset(UAudioMotionDialogueCurveAsset*,bool)Asigna el recurso y opcionalmente inicia su sonido fuente.GetDialogueCurveValue()Devuelve el escalar actual de la curva baked.Cabeceras públicas
Añade solo el módulo que realmente utilice tu código.
PublicDependencyModuleNames.AddRange(new[]
{
"AudioMotionRuntime",
"AudioMotionAnimation" // only when your runtime animation module needs FAnimNode_AudioMotion
});AudioMotionEditor solo desde un módulo Editor. Nunca hagas que un módulo runtime de shipping dependa del módulo AMS Editor.UAudioMotionComponentAudioMotionComponent.hEvaluador runtime principal. Selección de fuente, reloj de procesamiento, evaluación de frames, conexión automática, música de fondo y lectura de canales.UAudioMotionBlueprintLibraryAudioMotionBlueprintLibrary.hCapa estática de utilidad usada por los nodos Blueprint Connect; también se puede llamar directamente desde C++.UAudioMotionProfileAudioMotionProfile.hPrimary Data Asset con ajustes de envelope, Dialogue, música y evaluación.UAudioMotionBindingProfileAudioMotionBindingProfile.hPrimary Data Asset para target mapping. Helpers públicos: FindDialogueRole, EnsureDialogueRoles, RebuildDialogueBindings.UAudioMotionClipAudioMotionClip.hCurvas Dialogue baked. EvaluateChannel, EvaluateFrame, BuildFromFrames, ClearClip, IsEmpty.UAudioMotionDialogueCurveAssetAudioMotionDialogueCurveAsset.hRecurso portátil de curva escalar. EvaluateCurve y GetSourceSound.UAudioMotionPulseComponentAudioMotionPulseComponent.hComponente de reacción de audio escalar con salida a material y eventos trigger.UAudioMotionDialogueCurveComponentAudioMotionDialogueCurveComponent.hComponente derivado de Pulse que evalúa un recurso Dialogue Curve baked.FAudioMotionDialogueProcessorAudioMotionDialogueProcessor.hProcesador Dialogue determinista. Reset(seed), Evaluate(...).FAudioMotionMusicAnalyzerAudioMotionMusicAnalyzer.hHelper de análisis musical para evaluar SoundWave o Audio Component.FAudioMotionFrameAudioMotionTypes.hContenedor de frame compartido. GetChannel / SetChannel más valores de canales Dialogue y música.UAMSMotionDataSubsystemAMSMotionDataSubsystem.hSubsystem del motor que carga datos Vocabulary compactos. ReloadData, GetVocabulary, GetDefaultVocabulary, GetVocabularyIds.UAMSMotionVocabularyAMSMotionVocabulary.hMetadatos Vocabulary y referencias Motion. FindMotion, GetMotionCount, ValidateVocabulary.UAMSMotionClipAMSMotionClip.hDatos Motion Unit medidos. Evaluación de tracks, aplicación de pose, validación de autoría y metadatos de transición.UAMSMotionLibraryAMSMotionLibrary.hBiblioteca de candidatos para el Planner creada con datos Vocabulary y Book.UAMSPerformanceBookAMSPerformanceBook.hData Asset de política / gramática Choreography. Helpers Book integrados, validación y reglas de familia.FAMSPerformancePlannerAMSPerformancePlanner.hInterfaz estática determinista BuildPlan desde Book/Library + Analysis + Planner Settings hacia una Motion Sequence.UAMSMotionSequenceAMSMotionSequence.hSecuencia Choreography programada. Normalización de duración/tiempo, evaluación de pose, build y validación del track compilado.UAMSRigProfileAMSRigProfile.hPerfil Rig Mapping. Resolución de mapping, creación desde jerarquía de referencia, overrides manuales, validación y escala de referencia.FAnimNode_AudioMotionAnimNode_AudioMotion.hNodo de control AnimGraph runtime. Por defecto lee el frame del Audio Motion Component propietario.#include "AudioMotionBlueprintLibrary.h"
#include "AudioMotionComponent.h"
UAudioMotionComponent* ConnectAMS(
AActor* TargetActor,
UAudioMotionProfile* Profile,
UAudioMotionBindingProfile* BindingProfile,
USoundWave* VoiceSound)
{
return UAudioMotionBlueprintLibrary::ConnectAudioMotion(
TargetActor,
Profile,
BindingProfile,
VoiceSound,
nullptr,
true,
false);
}#include "AudioMotionDialogueCurveAsset.h"
float ReadDialogueCurve(
const UAudioMotionDialogueCurveAsset* CurveAsset,
float TimeSeconds)
{
return CurveAsset
? CurveAsset->EvaluateCurve(TimeSeconds, false)
: 0.0f;
}Recursos y tipos de datos
Ajustes de envelope, Dialogue, análisis musical y frecuencia de evaluación.
Mappings de destino y bindings Dialogue generados.
Curvas frame-channel baked y reutilizables.
SoundWave fuente más una curva escalar baked y ajustes de material.
Rig Mapping, overrides manuales, datos de topología y escala de referencia.
Metadatos Vocabulary y referencias a Motion Units.
Biblioteca de candidatos del Planner creada con datos Vocabulary y Book.
Política/gramática de selección utilizada por el Planner.
Entradas Choreography programadas y pista compilada opcional.
Recurso de Editor que guarda un Mapping Source/Target reutilizable y ajustes de traslación.
EAudioMotionModeEAudioMotionInputModeEAudioMotionChannelEAudioMotionPulseSourceEAudioMotionTransformChannelEAudioMotionTargetTypeEAudioMotionDialogueRoleEAudioMotionDialogueTargetTypeEAMSRigProfileKindEAMSMotionSequenceModeEAMSTrajectoryModeEAMSMotionCurveModeEAMSMotionActionKindEAMSMotionPathKindEAMSMotionDirectionEAMSMotionLevelEAMSMotionTimeQualityEAMSMotionForceQualityEAMSMotionFlowQualityEAMSSupportState
Los identificadores C++ exactos se muestran para mantener la precisión de la API. El editor usa etiquetas neutras para los principales roles Dialogue de producción.
FAudioMotionFrameFAudioMotionMusicSettingsFAudioMotionEnvelopeSettingsFAudioMotionDialogueSettingsFAudioMotionValueMappingFAudioMotionDialogueTargetConfigFAudioMotionDialogueRoleTargetFAudioMotionMorphBindingFAudioMotionMaterialScalarBindingFAudioMotionSceneBindingFAMSPerformanceAnalysisFAMSPerformancePlannerSettingsFAMSRigSlotMappingFAMSRigManualOverrideFAMSMotionKeyFAMSMotionTrack
Seguridad de assets
AMS usa el Output Folder configurado como raíz. Los recursos dependientes del Mesh se guardan en una carpeta con el nombre del Rig Mesh seleccionado.
/Game/AudioMotion/
SK_MyRig/
Profiles/
Clips/
Animations/
Retarget/
Choreography/
RigProfiles/
Generated/
DialogueCurves/Los recursos finales generados usan el sistema de nombres únicos de Unreal en lugar de sustituir silenciosamente un recurso existente.
Los recursos Dialogue Curve son compartidos y no están ligados a un Rig Mesh.
Compatibilidad
Solución de problemas
Confirma que el plugin esté activado para el proyecto y que el Editor se haya reiniciado tras la activación. Confirma también que el paquete corresponda a la versión de Unreal Engine del proyecto.
Verifica los datos de análisis Voice Sound, la selección Profile/Binding Profile, el Rig Mesh de destino y las asignaciones automáticas. Revisa mappings ausentes o sospechosos antes de rebuild o Bake.
Valida el Rig Profile. Cambia a Custom Mapping, parte de la base automática, corrige solo las filas incorrectas, usa Validate y Apply y reconstruye la pista Choreography compilada.
Sigue el mensaje de estado del editor. Cuando AMS active los ajustes de análisis necesarios, guarda la SoundWave y deja que Unreal reconstruya sus datos de análisis antes de volver a ejecutar Analyze + Build + Compile.
Confirma que la salida de material esté activada, que exista el parámetro escalar, que Material Slot sea correcto y que Target Component Name coincida con el componente mesh deseado o quede vacío para que AMS use el primer componente adecuado.
Usa el modo Custom, parte de Auto Mapping, sustituye o borra solo las filas incorrectas y guarda un Retarget Profile reutilizable si volverás a usar el par Source/Target.
Instala/usa el paquete fuente AMS para esa versión exacta del motor y recompila con el compilador/toolchain compatible. No reutilices Binaries ni Intermediate de otra versión.
Pautinka
Incluye la versión de Unreal Engine, versión de AMS, si el problema aparece en Editor Preview / Runtime / Bake, pasos exactos para reproducirlo y el fragmento relevante del log de Unreal.
Para problemas de Mapping o Animation Mixer, incluye también el tipo de Rig Source/Target y si usaste modo Auto, Custom o Profile.
Autoría en el Editor, recursos reutilizables, integración Blueprint y APIs runtime C++ públicas en un solo flujo de producción.
