@spatius/avatarkit 1.2.0-beta.1 → 1.2.0-beta.2

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0-beta.2] - 2026-06-23
+
+### Removed
+- Post-processing support has been removed from the SDK. The `PostProcessingConfig` type and `AvatarController.setPostProcessingConfig()` are gone; the SDK now renders frames exactly as provided. No effect on standard playback or RTC.
+
 ## [1.2.0-beta.1] - 2026-06-19
 
 ### Added

package/dist/{StreamingAudioPlayer-Br8UrVgO.js → StreamingAudioPlayer-CqzPGdy5.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-DHCQ9wsL.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-BnubRaUR.js";
 class StreamingAudioPlayer {
   // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {

package/dist/core/AvatarController.d.ts

@@ -1,5 +1,5 @@
 import { Avatar } from './Avatar';
-import { ConnectionState, AvatarError, DrivingServiceMode, FrameStarvationMode, ConversationState, AnimationType, PostProcessingConfig } from '../types';
+import { ConnectionState, AvatarError, DrivingServiceMode, FrameStarvationMode, ConversationState, AnimationType } from '../types';
 import { FrameRateInfo } from '../performance/FrameRateMonitor';
 export declare class AvatarController {
     private networkLayer?;
@@ -37,7 +37,6 @@ export declare class AvatarController {
     set frameRateMonitorEnabled(value: boolean);
     private renderCallback?;
     private characterHandle;
-    private postProcessingConfig;
     private lastRenderedFrameIndex;
     private keyframesOffset;
     private readonly MAX_KEYFRAMES;
@@ -140,12 +139,6 @@ export declare class AvatarController {
      * The point count of current avatar, or null if avatar is not loaded.
      */
     get pointCount(): number | null;
-    /**
-     * Set post-processing configuration
-     * These parameters will be applied in real-time to animation parameters returned by the server
-     * @param config Post-processing configuration, or null to clear
-     */
-    setPostProcessingConfig(config: PostProcessingConfig | null): void;
     /**
      * Set audio playback volume
      * Note: This only controls the avatar audio player volume, not the system volume

package/dist/{index-DHCQ9wsL.js → index-BnubRaUR.js}

@@ -12631,7 +12631,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-Br8UrVgO.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CqzPGdy5.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -14691,7 +14691,7 @@ class AvatarSDK {
 __publicField(AvatarSDK, "_initializationState", "uninitialized");
 __publicField(AvatarSDK, "_initializingPromise", null);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.2.0-beta.1");
+__publicField(AvatarSDK, "_version", "1.2.0-beta.2");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_cachedDeviceScore", null);
 __publicField(AvatarSDK, "_rendererBackend", null);
@@ -15859,7 +15859,6 @@ class AvatarController {
     __publicField(this, "characterHandle", null);
     // Character handle for multi-character support
     // ========== Post-processing Configuration ==========
-    __publicField(this, "postProcessingConfig", null);
     // ========== Playback Loop ==========
     __publicField(this, "lastRenderedFrameIndex", -1);
     __publicField(this, "keyframesOffset", 0);
@@ -16663,18 +16662,7 @@ class AvatarController {
     return avatarCore.getPointCount(this.characterHandle);
   }
   /**
-   * Set post-processing configuration
-   * These parameters will be applied in real-time to animation parameters returned by the server
-   * @param config Post-processing configuration, or null to clear
-   */
-  setPostProcessingConfig(config) {
-    this.postProcessingConfig = config;
-    if (this.currentState === AvatarState.paused && this.isPlaying) {
-      this.rerenderCurrentFrame();
-    }
-  }
-  /**
-   * 重新渲染当前帧（用于暂停状态下更新后处理参数或相机配置）
+   * 重新渲染当前帧（用于暂停状态下更新相机配置）
    * @internal
    */
   async rerenderCurrentFrameIfPaused() {
@@ -16694,10 +16682,7 @@ class AvatarController {
     }
     try {
       const currentFrame = this.currentKeyframes[arrayIndex];
-      let wasmParams = convertProtoFlameToWasmParams(currentFrame);
-      if (this.postProcessingConfig) {
-        wasmParams = this.applyPostProcessingToParams(wasmParams);
-      }
+      const wasmParams = convertProtoFlameToWasmParams(currentFrame);
       const avatarCore = AvatarSDK.getAvatarCore();
       if (avatarCore) {
         const splatData = await avatarCore.computeFrameFlatFromParams(wasmParams, this.characterHandle ?? void 0);
@@ -17172,97 +17157,6 @@ class AvatarController {
       listeners.forEach((callback) => callback(data));
     }
   }
-  /**
-   * Apply post-processing parameters to a Flame (proto format)
-   * Used for transition animations
-   * @internal
-   */
-  applyPostProcessingToFlame(flame) {
-    if (!this.postProcessingConfig) {
-      return flame;
-    }
-    let wasmParams = convertProtoFlameToWasmParams(flame);
-    wasmParams = this.applyPostProcessingToParams(wasmParams);
-    return convertWasmParamsToProtoFlame(wasmParams);
-  }
-  /**
-   * Apply post-processing parameters to animation parameters
-   * @internal
-   */
-  /** @internal */
-  applyPostProcessingToParams(baseParams) {
-    if (!this.postProcessingConfig) {
-      return baseParams;
-    }
-    const result2 = {
-      shape_params: baseParams.shape_params || Array.from({ length: 300 }, () => 0),
-      expr_params: baseParams.expr_params ? [...baseParams.expr_params] : Array.from({ length: 100 }, () => 0),
-      rotation: baseParams.rotation ? [...baseParams.rotation] : [0, 0, 0],
-      translation: baseParams.translation ? [...baseParams.translation] : [0, 0, 0],
-      neck_pose: baseParams.neck_pose ? [...baseParams.neck_pose] : [0, 0, 0],
-      jaw_pose: baseParams.jaw_pose ? [...baseParams.jaw_pose] : [0, 0, 0],
-      eyes_pose: baseParams.eyes_pose ? [...baseParams.eyes_pose] : [0, 0, 0, 0, 0, 0],
-      eyelid: baseParams.eyelid ? [...baseParams.eyelid] : [0, 0],
-      has_eyelid: baseParams.has_eyelid || false
-    };
-    if (this.postProcessingConfig.rotation && result2.rotation) {
-      result2.rotation[0] += this.postProcessingConfig.rotation.x ?? 0;
-      result2.rotation[1] += this.postProcessingConfig.rotation.y ?? 0;
-      result2.rotation[2] += this.postProcessingConfig.rotation.z ?? 0;
-    }
-    if (this.postProcessingConfig.translation && result2.translation) {
-      result2.translation[0] += this.postProcessingConfig.translation.x ?? 0;
-      result2.translation[1] += this.postProcessingConfig.translation.y ?? 0;
-      result2.translation[2] += this.postProcessingConfig.translation.z ?? 0;
-    }
-    if (this.postProcessingConfig.neckPose && result2.neck_pose) {
-      const biasX = this.postProcessingConfig.neckPose.x ?? 0;
-      const biasY = this.postProcessingConfig.neckPose.y ?? 0;
-      const biasZ = this.postProcessingConfig.neckPose.z ?? 0;
-      const weightX = this.postProcessingConfig.neckPose.weightX ?? 1;
-      const weightY = this.postProcessingConfig.neckPose.weightY ?? 1;
-      const weightZ = this.postProcessingConfig.neckPose.weightZ ?? 1;
-      result2.neck_pose[0] = result2.neck_pose[0] * weightX + biasX;
-      result2.neck_pose[1] = result2.neck_pose[1] * weightY + biasY;
-      result2.neck_pose[2] = result2.neck_pose[2] * weightZ + biasZ;
-    }
-    if (this.postProcessingConfig.jawPose && result2.jaw_pose) {
-      const biasX = this.postProcessingConfig.jawPose.x ?? 0;
-      const biasY = this.postProcessingConfig.jawPose.y ?? 0;
-      const biasZ = this.postProcessingConfig.jawPose.z ?? 0;
-      const weight = this.postProcessingConfig.jawPose.weight ?? 1;
-      result2.jaw_pose[0] = result2.jaw_pose[0] * weight + biasX;
-      result2.jaw_pose[1] = result2.jaw_pose[1] * weight + biasY;
-      result2.jaw_pose[2] = result2.jaw_pose[2] * weight + biasZ;
-    }
-    if (this.postProcessingConfig.eyePose && result2.eyes_pose) {
-      const biasX = this.postProcessingConfig.eyePose.x ?? 0;
-      const biasY = this.postProcessingConfig.eyePose.y ?? 0;
-      const biasZ = this.postProcessingConfig.eyePose.z ?? 0;
-      const weightX = this.postProcessingConfig.eyePose.weightX ?? 1;
-      const weightY = this.postProcessingConfig.eyePose.weightY ?? 1;
-      const weightZ = this.postProcessingConfig.eyePose.weightZ ?? 1;
-      result2.eyes_pose[0] = result2.eyes_pose[0] * weightX + biasX;
-      result2.eyes_pose[1] = result2.eyes_pose[1] * weightY + biasY;
-      result2.eyes_pose[2] = result2.eyes_pose[2] * weightZ + biasZ;
-      result2.eyes_pose[3] = result2.eyes_pose[3] * weightX + biasX;
-      result2.eyes_pose[4] = result2.eyes_pose[4] * weightY + biasY;
-      result2.eyes_pose[5] = result2.eyes_pose[5] * weightZ + biasZ;
-    }
-    if (this.postProcessingConfig.eyeBlink !== void 0 && result2.eyelid) {
-      const blinkValue = this.postProcessingConfig.eyeBlink;
-      result2.eyelid[0] = blinkValue;
-      result2.eyelid[1] = blinkValue;
-      result2.has_eyelid = true;
-    }
-    if (this.postProcessingConfig.expressionWeight !== void 0 && result2.expr_params) {
-      const weight = this.postProcessingConfig.expressionWeight;
-      for (let i2 = 0; i2 < result2.expr_params.length; i2++) {
-        result2.expr_params[i2] *= weight;
-      }
-    }
-    return result2;
-  }
 }
 function errorToMessage(err) {
   if (err instanceof Error) {
@@ -20882,8 +20776,7 @@ class AvatarView {
               if (arrayIndex >= 0 && arrayIndex < keyframes.length) {
                 const currentFrame = keyframes[arrayIndex];
                 this.currentFrame = currentFrame;
-                let wasmParams = convertProtoFlameToWasmParams(currentFrame);
-                wasmParams = this.avatarController.applyPostProcessingToParams(wasmParams);
+                const wasmParams = convertProtoFlameToWasmParams(currentFrame);
                 computeInFlight = true;
                 avatarCore.computeFrameFlatFromParams(wasmParams, this.characterHandle ?? void 0).then((splatData) => {
                   if (splatData && !this.isPureRenderingMode) {
@@ -20910,7 +20803,7 @@ class AvatarView {
             const offset = this.avatarController.getKeyframesOffset();
             const targetArrayIdx = targetIdx - offset;
             if (targetArrayIdx >= 0 && targetArrayIdx < keyframes.length) {
-              const targetFrame = this.avatarController.applyPostProcessingToFlame(keyframes[targetArrayIdx]);
+              const targetFrame = keyframes[targetArrayIdx];
               this.transitionFrames = this.generateAndAlignTransitionFrames(
                 this.currentFrame,
                 targetFrame,
@@ -21186,10 +21079,9 @@ class AvatarView {
       const fromFrame = this.currentFrame;
       if (fromFrame) {
         const firstSpeaking = keyframes[0];
-        const firstSpeakingWithPP = this.avatarController.applyPostProcessingToFlame(firstSpeaking);
         this.transitionFrames = this.generateAndAlignTransitionFrames(
           fromFrame,
-          firstSpeakingWithPP,
+          firstSpeaking,
           START_TRANSITION_DURATION_MS,
           true
         );
@@ -21221,9 +21113,8 @@ class AvatarView {
     const fromFrame = this.currentFrame;
     if (fromFrame && this.cachedIdleFirstFrame) {
       try {
-        const fromFrameWithPP = this.avatarController.applyPostProcessingToFlame(fromFrame);
         this.transitionFrames = this.generateAndAlignTransitionFrames(
-          fromFrameWithPP,
+          fromFrame,
           this.cachedIdleFirstFrame,
           END_TRANSITION_DURATION_MS,
           false
@@ -21341,8 +21232,7 @@ class AvatarView {
     try {
       const flame = keyframeData;
       this.currentFrame = flame;
-      const processedFlame = this.avatarController.applyPostProcessingToFlame(flame);
-      const wasmParams = convertProtoFlameToWasmParams(processedFlame);
+      const wasmParams = convertProtoFlameToWasmParams(flame);
       const avatarCore = AvatarSDK.getAvatarCore();
       if (!avatarCore) {
         throw new Error("AvatarCore not available");
@@ -21384,7 +21274,7 @@ class AvatarView {
       }
       let toFrame;
       if (to2) {
-        toFrame = this.avatarController.applyPostProcessingToFlame(to2);
+        toFrame = to2;
       } else {
         const idleParams = await avatarCore.getCurrentFrameParams(this.activeAnimationState.frameIndex, this.characterId);
         toFrame = convertWasmParamsToProtoFlame(idleParams);

package/dist/index.js

@@ -1,4 +1,4 @@
-import { k, b, c, o, f, d, n, g, C, m, i, D, E, F, j, L, h, R, p, T, q } from "./index-DHCQ9wsL.js";
+import { k, b, c, o, f, d, n, g, C, m, i, D, E, F, j, L, h, R, p, T, q } from "./index-BnubRaUR.js";
 export {
   k as AnimationType,
   b as Avatar,

package/dist/types/index.d.ts

@@ -147,53 +147,6 @@ export interface CameraConfig {
     up?: [number, number, number];
     aspect?: number;
 }
-/**
- * Post-processing parameter configuration
- * Used to overlay in real-time on animation parameters returned by the server
- */
-export interface PostProcessingConfig {
-    /** Rotation (Euler angles, in radians) */
-    rotation?: {
-        x?: number;
-        y?: number;
-        z?: number;
-    };
-    /** Translation (position offset) */
-    translation?: {
-        x?: number;
-        y?: number;
-        z?: number;
-    };
-    /** Neck pose offset (in radians) */
-    neckPose?: {
-        x?: number;
-        y?: number;
-        z?: number;
-        weightX?: number;
-        weightY?: number;
-        weightZ?: number;
-    };
-    /** Jaw pose offset (in radians) */
-    jawPose?: {
-        x?: number;
-        y?: number;
-        z?: number;
-        weight?: number;
-    };
-    /** Eye pose offset (in radians) */
-    eyePose?: {
-        x?: number;
-        y?: number;
-        z?: number;
-        weightX?: number;
-        weightY?: number;
-        weightZ?: number;
-    };
-    /** Eye blink value (-1.0 to 1.0, larger value means more closed) */
-    eyeBlink?: number;
-    /** Expression weight (0.0-2.0, 0=no expression, 1=normal, >1=enhanced) */
-    expressionWeight?: number;
-}
 export interface CharacterInfo {
     pointCount: number;
     hasAnimation: boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatius/avatarkit",
   "type": "module",
-  "version": "1.2.0-beta.1",
+  "version": "1.2.0-beta.2",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",