add_attach_track
Attach one object to another in a Level Sequence via a 3D-Attach track, so it follows the target over a frame range (e.g., prop to hand socket).
Instructions
Add a Sequencer 3D-Attach track on a binding so it follows another binding (e.g. a prop attached to a character's hand socket) over the section's range. The attachee binding owns a UMovieScene3DAttachTrack; AddConstraint creates an attach section pointing at the target binding. Idempotent by (target_binding_guid, start_frame).
Returns: { sequence_name: string, binding_guid: string, target_binding_guid: string, track_added: bool, already_exists: bool, start_frame: int, duration: int, socket_name: string, component_name: string, section_count: int, track_class: string, saved: bool, save_error?: string }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duration | No | Optional duration in frames (default: the playback range size). | |
| socket_name | No | Optional socket name on the target to attach to (default: none -> target root). | |
| start_frame | No | Optional start frame of the attach section (default: the sequence playback range start). | |
| binding_guid | Yes | GUID of the binding to attach (the attachee; this binding owns the attach track). | |
| sequence_name | Yes | Name of the target Level Sequence. | |
| component_name | No | Optional component name on the target to attach to (default: none). | |
| target_binding_guid | Yes | GUID of the binding to attach TO (the parent/target). |