NAF for iOS v0.1.28
Updated: November 2, 2026
The first release since July, and by far the largest: 163 commits. NAF on iOS now loads avatars from CAMP, renders through the shared engine that the web SDK uses, and carries chat. The NAF API reference describes the full surface.
What's New
CAMP loading. Avatars, wearables, and animations now resolve from CAMP rather than from URLs you assemble yourself.
loadCampAvatar,loadCampSmartAvatar,loadCampUserAvatar, andloadCampUserSmartAvataronNAFViewandNAFAvatarSession. The user variants render the signed-in user's customization layer.equipCampWearable(_:lods:colors:…),equipWearableDocument(_:assetId:…), andequipAssets(_:)for a whole outfit in one serialized update.NAFCampResolverdoes catalog lookup and resolution; documents resolve against the device's texture formats and channel count rather than a fixed set.loadCampAnimation(_:)with clip metadata.- An avatar and its behavior resolve concurrently.
Toon presets travel with the asset. CAMP avatars and wearables carry their authored toon preset and it applies automatically, per material and in authored order, preserving any runtime override you've set. RGBK presets persist across LODs and wearables.
The managed renderer. Metal orchestration moved onto the shared engine, so iOS output now matches web.
- HDR environment lighting and backdrops, directional shadows with on-demand and timed updates, shadow camera fitting.
- Post-processing: SSAO, bloom, FXAA, SMAA, SSAA, vignette, dithering.
NAFRendererToneMappingaddsagxToneMappingandcineonToneMappingalongside ACES and Reinhard, with color grading through shared LUT decoding (NAFCubeLUT).- Scene-lit PBR materials when toon shading is off; per-instance shaders and picking; rig collider overlays.
- Bring your own Metal pipeline with
NAFAvatarSession+NAFAvatarRenderer;onMeshesRebuiltrepublishes the submesh set after every composition change.
Animation and behavior. Gestures, emotions, idle, talking, breathing, and voice playback are all drivable, with availableAnimationTags reporting what an avatar actually supports. Also new: postures, attention modes, eye gaze, blinkEnabled, auto-fidget and boredom, full-body and per-leg foot IK, retargeting control, body motion configuration, pause and resume, a post-animation frame callback, and direct playback control for apps that drive animation themselves.
Chat. NAFChatStream carries text and voice turns over SSE, with session management and history. Voice arrives either through the host RTC transport or through the new NAFKitLiveKit product, which adds NAFLiveKitConversation, audio anchors, and receive clocks that keep lip sync aligned to the playout clock.
Content Tools. Decode and encode asset packages and revisions, inspect materials, shader flavors, textures and masks, compose sources, and store local content revisions atomically.
Layering and dynamics. Combination order layers with overrides, anchoring and per-mesh stiffness, anchored mesh IDs, CAMP layering presets, automatic dynamics config (NAFDynamicsConfig), and effective rig recipe inspection.
Assets. Batch and multi-LOD prefetch (NAFAssetPrefetchRequest, preloadAssets), NAFContainerApi.clearLoadedLods, LZ4 bundle extraction from data or disk, and color overrides on both load and equip (NAFColorOverrides).
Export. exportGLB(format:includeTextures:includeUtilityMeshes:) writes the combined, refitted bind pose as GLB or as glTF JSON.
Service configuration. NAFServiceConfiguration.setHeader applies custom headers to service and chat requests.
What's Changed
- New product
NAFKitLiveKit. At this release it depended on the Geniesclient-sdk-swiftfork at2.17.0-genies.1; v0.1.31 moves it to2.17.0-genies.2. NAFKitUIandNAFKitUIToolsnow bundle the targets beneath them. AddingNAFKitUIpullsNAFKitUIToolsandNAFKitwith it; previously you added each product yourself.- Avatar rendering and interaction use native Y-up coordinates, aligned with the shared engine.