NAF for iOS v0.1.31
Updated: November 4, 2026
What's New
Authored gesture playback —
playGestureClip(_:options:completion:)onNAFViewandNAFAvatarSession. 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 newNAFGestureClipOptionscarriesblendInTime,blendOutTime,holdTime,isSpecialGesture,mirrorMode(NAFGestureMirrorMode.right/.left/.random),defaultBlendShapeWeight, and ablendShapeWeightsdictionary keyed by exact target name after mirroring.The
Boolsays whether NAF took the request, not whether the gesture finished: onfalsenothing happened at all — whatever was playing keeps playing, andcompletionis 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 unrecognizedmirrorMode. Its blend defaults are tighter thanNAFGestureOptions—0.1/0.1/0against0.9/0.9/1.0.Authored animation track names —
NAFAnimationClip.skeletonNamesand.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(from2.17.0-genies.1).NAFKitLiveKitdepends on it exactly, so an app that also pinsclient-sdk-swiftitself must move to the same version or package resolution will fail.
See Gestures in the NAF API reference.