PAUTINKAAudio Motion System 1.0
Mouvement runtime piloté par l’audio, Choreography déterministe, ressources Dialogue Curve réutilisables et mixage d’Animation Sequences pour Unreal Engine.
Vue d’ensemble
AMS transforme l’analyse audio en données réutilisables et en contrôle runtime. L’éditeur propose quatre espaces de travail ciblés, tandis que les modules runtime exposent composants, ressources, helpers Blueprint et interfaces C++.
Preview sert aux itérations ; les ressources réutilisables et les composants runtime transportent ensuite le résultat en production.
Informations techniques
Installation
AudioMotionSystem dans [Project]/Plugins/.Intermediate ou Saved entre différentes machines.
Démarrage rapide
Connect Audio Motion ou un Audio Motion Clip.Contrôle piloté par la voix
Motion piloté par la musique
Supprime le déplacement global.
À utiliser pour une lecture sur place.Utilise la trajectoire planifiée.
À utiliser lorsque la séquence doit se déplacer.Utilise la trajectoire globale stabilisée.
À utiliser lorsque le déplacement planifié doit être stabilisé.
Sortie scalaire
Créer un Audio Motion Dialogue Curve lorsque vous avez besoin d’une seule valeur scalaire baked pour Blueprint ou pour un paramètre de matériau.
L’évaluation runtime lit directement la courbe baked. Elle n’a pas besoin de répéter l’analyse de l’éditeur.
Connect Dialogue Curve Asset crée ou réutilise un composant Audio Motion Dialogue Curve sur l’Actor cible et le démarre avec les réglages de l’asset.
La valeur scalaire actuelle est disponible via Get Dialogue Curve Value. Si la sortie matériau est activée, la même valeur est écrite dans le paramètre scalaire sélectionné.
Animation Sequence + Dialogue
Construit un mapping Source-to-Target à partir de la hiérarchie de référence et de la géométrie.
Les animations natives du Rig cible ignorent le retargeting.Part de Auto et permet de remplacer ou d’effacer les mappings à corriger.
À utiliser pour les cas atypiques ou à faible confiance.Réutilise un Retarget Profile enregistré pour une paire Source / Target connue.
Idéal pour les usages répétés en production.
Architecture
AudioMotionRuntimeRuntimeÉvaluation audio, composants, helpers Blueprint, assets, mapping et données Choreography.Jeu + ÉditeurAudioMotionAnimationRuntimeNœud de contrôle AnimGraph runtime.Systèmes d’animationAudioMotionEditorÉditeurFenêtre Tools, factories d’assets, Preview, authoring, Bake et Animation Mixer.Éditeur uniquementAudioMotionRuntime et, si nécessaire, AudioMotionAnimation. N’ajoutez pas de AudioMotionEditor dépendance au code runtime de shipping.Le module runtime inclut les fichiers compacts AMS Vocabulary et view depuis Content/AMSData comme dépendances runtime NonUFS.
*.amsvocab.json
*.amsvocabz
*.amsview.jsonLes dossiers Vocabulary du projet pris en charge par les règles de build runtime peuvent également être inclus s’ils existent.
Nœuds d’intégration principaux
Les helpers Blueprint créent ou réutilisent les composants AMS sur l’Actor cible. Les entrées requises sont validées ; un setup invalide renvoie None / nullptr.
UAudioMotionComponent*Crée ou réutilise le composant Audio Motion principal, prépare la voie Voice Sound, reconstruit les bindings Dialogue, connecte le composant Rig cible et démarre le traitement.
UAudioMotionComponent*Connecte un Audio Motion Clip baked à l’Actor cible. Cette voie ne nécessite aucune lecture audio source.
UAudioMotionComponent*Configure le composant principal pour un traitement piloté par la musique en utilisant le SoundWave sélectionné comme Background Music. Le traitement peut continuer indépendamment de la source Voice.
UAudioMotionComponent*Connecte un Voice Sound et une Background Music indépendante au même Audio Motion Component. Le composant continue à traiter les données lorsque la lecture Voice s’arrête afin que la voie musicale puisse continuer.
UAudioMotionComponent*Recherche le premier Audio Motion Component attaché à l’Actor cible. Renvoie None si l’Actor n’en possède pas.
UAudioMotionDialogueCurveComponent*Crée ou réutilise un composant Dialogue Curve et connecte sa sortie scalaire à Blueprint et, par défaut, à un paramètre scalaire de matériau.
UAudioMotionDialogueCurveComponent*Crée ou réutilise un composant Dialogue Curve et applique l’asset Dialogue Curve généré complet : son source, courbe baked, réglages de réponse, état de boucle, cible matériau, slot matériau et nom du paramètre.
UAudioMotionPulseComponent*Crée ou réutilise un composant scalaire compact Audio Pulse. La source peut être Voice, l’énergie musicale globale, les bandes de fréquences, onset, beat ou un canal Audio Motion personnalisé.
Contrôle à l’exécution
En-tête : AudioMotionComponent.h · Module : AudioMotionRuntime
SetAudioSource(UAudioComponent*)Définit l’entrée Audio Component et met à jour l’état de la source.SetSourceSound(USoundWave*)Définit la source SoundWave.SetSourceClip(UAudioMotionClip*)Définit la source Audio Motion Clip baked.StartProcessing(bool)Démarre l’évaluation ; peut réinitialiser le temps de lecture.StopProcessing(bool)Arrête l’évaluation ; peut aussi arrêter l’audio source.ResetProcessing(float)Réinitialise l’état du processeur au temps demandé.PushEnvelopeValue(float)Fournit une valeur d’enveloppe manuelle pour le mode d’entrée Manual Envelope.EvaluateAtTime(float,float)Évalue un temps et une valeur d’enveloppe explicites.EvaluateSourceAtTime(float)Évalue la source actuellement configurée au temps demandé.ApplyExternalFrame(FAudioMotionFrame,bool)Applique une frame déjà construite et, si demandé, les bindings automatiques.RefreshAutomaticConnection()Résout à nouveau la connexion automatique de la cible runtime.ResetAutomaticBindings()Efface l’état mis en cache des bindings automatiques.SetTargetSkeletalMesh(...)Définit explicitement le composant Rig cible pour l’application runtime.GetChannelValue(EAudioMotionChannel)Lit une valeur de la frame actuelle.GetPlaybackTimeSeconds()Renvoie l’horloge principale de lecture actuelle.GetSourceDurationSeconds()Renvoie la durée de la source configurée lorsqu’elle est disponible.IsProcessing()Renvoie l’état du traitement.SetBackgroundMusic(...)Définit la SoundWave indépendante de Background Music.PlayBackgroundMusic(float)Démarre Background Music au temps local demandé.StopBackgroundMusic()Arrête la lecture de Background Music.SetBackgroundMusicVolume(float)Met à jour le volume de Background Music.IsBackgroundMusicPlaying()Renvoie l’état de lecture de Background Music.On Frame UpdatedOn Speech Value UpdatedOn Speech StartedOn Speech StoppedEn-tête : AudioMotionPulseComponent.h · Module : AudioMotionRuntime
Lit un canal AMS sélectionné ou un son autonome, le mappe via les plages Input/Output avec lissage attack/release, peut écrire la valeur dans un scalaire de matériau dynamique et expose un événement de seuil.
StartPulse()Démarre le tick et l’évaluation de la source.StopPulse(bool)Arrête l’évaluation ; peut aussi arrêter l’audio autonome.SetStandaloneSound(USoundWave*,bool)Change la source autonome et peut lancer la lecture immédiatement.GetPulseValue()Renvoie la sortie scalaire actuelle.On Pulse Value UpdatedOn PulseEn-tête : AudioMotionDialogueCurveComponent.h · Module : AudioMotionRuntime
Dérivé d’Audio Motion Pulse Component. Lorsqu’un Curve Asset est assigné, sa courbe baked devient la source scalaire et ses réglages de lecture/matériau sont copiés dans le composant.
SetCurveAsset(UAudioMotionDialogueCurveAsset*,bool)Assigne l’asset et peut démarrer son son source.GetDialogueCurveValue()Renvoie la valeur scalaire actuelle de la courbe baked.En-têtes publics
N’ajoutez que le module réellement utilisé par votre code.
PublicDependencyModuleNames.AddRange(new[]
{
"AudioMotionRuntime",
"AudioMotionAnimation" // only when your runtime animation module needs FAnimNode_AudioMotion
});AudioMotionEditor uniquement depuis un module Editor. Ne faites jamais dépendre un module runtime destiné au shipping du module AMS Editor.UAudioMotionComponentAudioMotionComponent.hÉvaluateur runtime principal. Sélection de source, horloge de traitement, évaluation des frames, connexion automatique, musique de fond et lecture des canaux.UAudioMotionBlueprintLibraryAudioMotionBlueprintLibrary.hCouche utilitaire statique utilisée par les nœuds Blueprint Connect, également appelable directement depuis C++.UAudioMotionProfileAudioMotionProfile.hPrimary Data Asset contenant les réglages envelope, Dialogue, musique et évaluation.UAudioMotionBindingProfileAudioMotionBindingProfile.hPrimary Data Asset pour le mapping cible. Helpers publics : FindDialogueRole, EnsureDialogueRoles, RebuildDialogueBindings.UAudioMotionClipAudioMotionClip.hCourbes Dialogue baked. EvaluateChannel, EvaluateFrame, BuildFromFrames, ClearClip, IsEmpty.UAudioMotionDialogueCurveAssetAudioMotionDialogueCurveAsset.hAsset de courbe scalaire portable. EvaluateCurve et GetSourceSound.UAudioMotionPulseComponentAudioMotionPulseComponent.hComposant de réaction audio scalaire avec sortie matériau et événements trigger.UAudioMotionDialogueCurveComponentAudioMotionDialogueCurveComponent.hComposant dérivé de Pulse qui évalue un asset Dialogue Curve baked.FAudioMotionDialogueProcessorAudioMotionDialogueProcessor.hProcesseur Dialogue déterministe. Reset(seed), Evaluate(...).FAudioMotionMusicAnalyzerAudioMotionMusicAnalyzer.hHelper d’analyse musicale pour l’évaluation SoundWave ou Audio Component.FAudioMotionFrameAudioMotionTypes.hConteneur de frame partagé. GetChannel / SetChannel ainsi que les valeurs des canaux Dialogue et musique.UAMSMotionDataSubsystemAMSMotionDataSubsystem.hSubsystem du moteur qui charge les données Vocabulary compactes. ReloadData, GetVocabulary, GetDefaultVocabulary, GetVocabularyIds.UAMSMotionVocabularyAMSMotionVocabulary.hMétadonnées Vocabulary et références Motion. FindMotion, GetMotionCount, ValidateVocabulary.UAMSMotionClipAMSMotionClip.hDonnées Motion Unit mesurées. Évaluation des tracks, application de pose, validation d’authoring et métadonnées de transition.UAMSMotionLibraryAMSMotionLibrary.hBibliothèque de candidats destinée au Planner, construite à partir des données Vocabulary et Book.UAMSPerformanceBookAMSPerformanceBook.hData Asset de politique / grammaire Choreography. Helpers de Book intégrés, validation et règles de famille.FAMSPerformancePlannerAMSPerformancePlanner.hInterface statique déterministe BuildPlan qui transforme Book/Library + Analysis + Planner Settings en Motion Sequence.UAMSMotionSequenceAMSMotionSequence.hSéquence Choreography planifiée. Normalisation durée/temps, évaluation de pose, construction et validation du track compilé.UAMSRigProfileAMSRigProfile.hProfil Rig Mapping. Résolution du mapping, construction depuis la hiérarchie de référence, overrides manuels, validation et échelle de référence.FAnimNode_AudioMotionAnimNode_AudioMotion.hNœud de contrôle AnimGraph runtime. Lit par défaut la frame depuis l’Audio Motion Component propriétaire.#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;
}Assets et types de données
Réglages d’enveloppe, Dialogue, analyse musicale et fréquence d’évaluation.
Mappings de cible et bindings Dialogue générés.
Courbes de canaux par frame baked et réutilisables.
SoundWave source, une courbe scalaire baked et réglages matériau.
Rig Mapping, overrides manuels, données de topologie et échelle de référence.
Métadonnées Vocabulary et références aux Motion Units.
Bibliothèque de candidats du Planner construite à partir des données Vocabulary et Book.
Politique / grammaire de sélection utilisée par le Planner.
Entrées Choreography planifiées et piste compilée facultative.
Asset Editor stockant un Mapping Source/Target réutilisable et les réglages de translation.
EAudioMotionModeEAudioMotionInputModeEAudioMotionChannelEAudioMotionPulseSourceEAudioMotionTransformChannelEAudioMotionTargetTypeEAudioMotionDialogueRoleEAudioMotionDialogueTargetTypeEAMSRigProfileKindEAMSMotionSequenceModeEAMSTrajectoryModeEAMSMotionCurveModeEAMSMotionActionKindEAMSMotionPathKindEAMSMotionDirectionEAMSMotionLevelEAMSMotionTimeQualityEAMSMotionForceQualityEAMSMotionFlowQualityEAMSSupportState
Les identifiants C++ exacts sont conservés pour la précision de l’API. L’éditeur affiche des libellés neutres pour les principaux rôles Dialogue orientés production.
FAudioMotionFrameFAudioMotionMusicSettingsFAudioMotionEnvelopeSettingsFAudioMotionDialogueSettingsFAudioMotionValueMappingFAudioMotionDialogueTargetConfigFAudioMotionDialogueRoleTargetFAudioMotionMorphBindingFAudioMotionMaterialScalarBindingFAudioMotionSceneBindingFAMSPerformanceAnalysisFAMSPerformancePlannerSettingsFAMSRigSlotMappingFAMSRigManualOverrideFAMSMotionKeyFAMSMotionTrack
Sécurité des ressources
AMS utilise l’Output Folder configuré comme racine. Les assets dépendants du Mesh sont stockés dans un dossier portant le nom du Rig Mesh sélectionné.
/Game/AudioMotion/
SK_MyRig/
Profiles/
Clips/
Animations/
Retarget/
Choreography/
RigProfiles/
Generated/
DialogueCurves/Les assets finaux générés utilisent le nommage unique d’Unreal au lieu de remplacer silencieusement un asset existant.
Les assets Dialogue Curve sont partagés et ne sont pas liés à un Rig Mesh.
Compatibilité
Dépannage
Vérifiez que le plugin est activé pour le projet et que l’éditeur a été redémarré après activation. Vérifiez aussi que le package correspond à la version d’Unreal Engine du projet.
Vérifiez les données d’analyse Voice Sound, le choix Profile/Binding Profile, le Rig Mesh cible et les affectations automatiques. Contrôlez les mappings manquants ou suspects avant de reconstruire ou de Bake.
Validez le Rig Profile. Passez à Custom Mapping, partez de la base automatique, corrigez uniquement les lignes incorrectes, utilisez Validate puis Apply et reconstruisez la piste Choreography compilée.
Suivez le message d’état de l’éditeur. Lorsque AMS active les réglages d’analyse requis, enregistrez la SoundWave et laissez Unreal reconstruire ses données d’analyse audio avant de relancer Analyze + Build + Compile.
Vérifiez que la sortie matériau est activée, que le paramètre scalaire existe, que le Material Slot est correct et que Target Component Name correspond au composant mesh souhaité ou reste vide afin qu’AMS utilise le premier composant mesh adapté.
Utilisez le mode Custom, partez d’Auto Mapping, remplacez ou effacez uniquement les lignes incorrectes et enregistrez un Retarget Profile réutilisable si la paire Source/Target sera utilisée à nouveau.
Installez/utilisez le package source AMS correspondant exactement à cette version du moteur et reconstruisez avec le compilateur/toolchain pris en charge. Ne réutilisez pas les Binaries ou Intermediate d’une autre version du moteur.
Pautinka
Indiquez la version d’Unreal Engine, la version d’AMS, si le problème apparaît dans Editor Preview / Runtime / Bake, les étapes exactes de reproduction et l’extrait pertinent du log Unreal.
Pour les problèmes de Mapping ou d’Animation Mixer, indiquez également le type de Rig Source/Target et si le mode Auto, Custom ou Profile a été utilisé.
Authoring dans l’Editor, assets réutilisables, intégration Blueprint et API runtime C++ publiques réunis dans un seul workflow de production.
