Skip to main content

NAF for iOS v0.1.14

Updated: May 7, 2026

What's New​

  • Public surface tightened.
    • NAFAvatarLoader and NAFAvatarBuilderBridge are now NS_REFINED_FOR_SWIFT — they appear to Swift consumers as __NAFAvatarLoader / __NAFAvatarBuilderBridge. Use NAFView / NAFAvatarSession instead.
    • NAFKitConfig.defaultShaderPresetURL and NAFKitConfig.textureSettingsURL are now internal (no public callers). Override via shaderPresetsDirectoryOverride / textureSettingsURLOverride.
  • NAFAvatarController.isBlinkEnabled. New Obj-C property controlling whether the avatar blinks. Default YES. .staticPose loads now disable it automatically so a static avatar holds its eyes open instead of blinking.
  • Load API consolidated. loadAvatar, loadAvatarProgressive, and attachAnimation collapse into one loadAvatar(_:mode:lods:) method on both NAFView and NAFAvatarSession. The new NAFLoadMode enum picks how alive the avatar arrives:
    • .staticPose — T-pose, holding still, no silhouette. Caller manages visibility.
    • .animated(silhouette:) — Idling, using the default clip from NAFDefaultAssets.idle. The first frame waits until the idle is ready. Avatar slug ignored.
    • .behavior(silhouette:) — Fully alive: default idle, talking, and breathing, plus the behavior keyed on avatar.slug. Default mode when mode: is omitted.
  • Custom idle / talking / breathing clips are configured once via NAFDefaultAssets.* static properties — no longer threaded through every load call.
  • NAFAvatarDefinition → NAFAvatar. Renamed throughout. JSON parser is now NAFAvatar.avatarFromJSON: (was NAFAvatarDefinition.definitionFromJSON:).
  • LOD removed from per-asset entries. NAFAssetEntry.lod and the "lod" field in each asset JSON are gone — LOD is supplied at the loader call (lods: [Int]). Strip "lod": "..." from existing definition JSONs.
  • Renamed every correlationID parameter / userInfo key to trackingID. Affects the optional trackingID: arg on loadAvatar / equip, plus the exported NAFErrorTrackingIDKey (was NAFErrorCorrelationIDKey).