Skip to main content

NAF for iOS v0.1.31

Updated: November 4, 2026

What's New​

  • Authored gesture playback — playGestureClip(_:options:completion:) on NAFView and NAFAvatarSession. Plays a clip you loaded yourself as a gesture. The avatar treats it exactly like a tagged one — it takes over from a gesture already playing, and idle, talking, and expression carry on around it. What it adds is mirroring and per-blendshape facial control. The new NAFGestureClipOptions carries blendInTime, blendOutTime, holdTime, isSpecialGesture, mirrorMode (NAFGestureMirrorMode.right / .left / .random), defaultBlendShapeWeight, and a blendShapeWeights dictionary keyed by exact target name after mirroring.

    The Bool says whether NAF took the request, not whether the gesture finished: on false nothing happened at all — whatever was playing keeps playing, and completion is never called. Rejections come from a weight outside [0, 1], an empty or malformed name, a non-numeric weight, a non-finite time, or an unrecognized mirrorMode. Its blend defaults are tighter than NAFGestureOptions — 0.1 / 0.1 / 0 against 0.9 / 0.9 / 1.0.

  • Authored animation track names — NAFAnimationClip.skeletonNames and .floatNames. Joint and float track names in native order, before target binding, masks, and mirroring. A nonzero track count with empty names means the clip binds by index.

What's Changed​

  • The LiveKit fork moves to 2.17.0-genies.2 (from 2.17.0-genies.1). NAFKitLiveKit depends on it exactly, so an app that also pins client-sdk-swift itself must move to the same version or package resolution will fail.

See Gestures in the NAF API reference.