@xmov/avatar 2.0.0-alpha.38

package/dist/utils/fpsTracker.d.ts

@@ -0,0 +1,27 @@
+export interface FPSStats {
+    current: number;
+    average: number;
+    min: number;
+    max: number;
+    droppedFrames: number;
+    totalFrames: number;
+}
+export declare class FPSTracker {
+    private frameTimestamps;
+    private maxSamples;
+    private lastFrameTime;
+    private frameCount;
+    private lastUpdateTime;
+    private currentFPS;
+    private totalFrames;
+    private totalTime;
+    private droppedFrames;
+    private totalRenderedFrames;
+    constructor(maxSamples?: number);
+    tick(rendered?: boolean): void;
+    getStats(): FPSStats;
+    getCurrentFPS(): number;
+    getAverageFPS(): number;
+    reset(): void;
+    getDroppedFrames(): number;
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,22 @@
+export declare function isDEV(): boolean;
+export declare function isSupportMES(): boolean;
+export declare function getStyleStr(styles: Record<string, any>): string;
+export declare function updateCanvasXOffset(canvas: any, offset_PX: any): void;
+export declare function generateFingerprint(): string;
+export declare function getDeviceInfo(): {
+    device_id: string;
+    device_brand: string;
+    device_model: string;
+    os_version: string;
+    browser: string;
+    browser_version: string;
+    browser_ua: string;
+};
+/**
+ * 校验scale格式（支持小数）并返回合法值
+ * @param {unknown} scale - 待校验的scale值
+ * @param {string} tag - 日志标签
+ * @returns {number | string} 合法值，非法返回1
+ */
+export declare function validateScaleWithDecimal(scale: unknown, tag: string): number | string;
+export declare function isharmony(): boolean;

package/dist/utils/logger.d.ts

@@ -0,0 +1,9 @@
+declare function executeLog(consoleMethod: any, ...args: any[]): void;
+declare function setLoggingEnabled(enabled: any): void;
+declare let isLoggingEnabled: boolean;
+declare namespace sdkLog {
+    function log(...args: any[]): void;
+    function info(...args: any[]): void;
+    function warn(...args: any[]): void;
+    function error(...args: any[]): void;
+}

package/dist/utils/media-recorder-timestamp.d.ts

@@ -0,0 +1,15 @@
+type EpochClock = () => number;
+/** Normalizes browser-specific BlobEvent.timecode units to epoch milliseconds. */
+export declare class MediaRecorderTimestamp {
+    private readonly chunkMs;
+    private readonly startedAt;
+    private readonly now;
+    private timecodeScale;
+    private firstTimecode;
+    private lastTimecode;
+    private lastObservedAt;
+    private lastTimestamp;
+    constructor(chunkMs: number, now?: EpochClock);
+    resolve(timecode: number): number;
+}
+export {};

package/dist/utils/pcmAnalyzer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * PCM 音频参数分析工具
+ * 用于检测和分析 PCM 音频数据的基本参数
+ */
+export interface PCMAudioParams {
+    sampleRate: number;
+    channels: number;
+    bitDepth: number;
+    format: string;
+    encoding: string;
+    bytesPerSample: number;
+    sampleCount?: number;
+    duration?: number;
+}
+/**
+ * 分析 PCM 音频数据的基本参数
+ * @param pcmData PCM 音频数据（Uint8Array）
+ * @param knownSampleRate 已知的采样率（可选，如果不提供则使用默认值 24000）
+ * @returns PCM 音频参数
+ */
+export declare function analyzePCMParams(pcmData?: Uint8Array, knownSampleRate?: number): PCMAudioParams;
+/**
+ * 检测 PCM 数据的可能参数（通过分析数据特征）
+ * 注意：这种方法只能提供推测，最准确的参数应该从服务器配置中获取
+ * @param pcmData PCM 音频数据
+ * @returns 检测到的参数（可能不准确）
+ */
+export declare function detectPCMParams(pcmData: Uint8Array): Partial<PCMAudioParams>;
+/**
+ * 格式化显示 PCM 参数
+ * @param params PCM 音频参数
+ * @returns 格式化的字符串
+ */
+export declare function formatPCMParams(params: PCMAudioParams): string;
+/**
+ * 从音频渲染器获取当前 PCM 配置
+ * @param audioRenderer 音频渲染器实例
+ * @returns PCM 音频参数
+ */
+export declare function getPCMParamsFromRenderer(audioRenderer: any): PCMAudioParams;

package/dist/utils/perfermance.d.ts

@@ -0,0 +1,15 @@
+export declare const performanceConstant: {
+    load_resource: string;
+    ttsa_connect: string;
+    ttsa_ready: string;
+    first_avatar_render: string;
+    first_webgl_render: string;
+    ttsa_body_res: string;
+    start_action_res: string;
+    start_action_render: string;
+    load_video: string;
+    decode_video: string;
+    voice_response_play: string;
+    first_decode_video: string;
+    first_render: string;
+};

package/dist/utils/request.d.ts

@@ -0,0 +1,19 @@
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD';
+interface RequestOptions {
+    method?: HttpMethod;
+    data?: Record<string, any>;
+    headers?: Record<string, string>;
+}
+export default function request(url: string, options?: RequestOptions): Promise<Response>;
+/**
+ * 资源下载请求
+ * @returns {Promise<[isError: boolean, data: ArrayBuffer | string]>}
+ * */
+export declare function XMLRequest(options: {
+    url: string;
+    cache?: {
+        enable: boolean;
+    };
+    onProgress: (progress: number, e: ProgressEvent) => void;
+}): Promise<[boolean, ArrayBuffer | string]>;
+export {};

package/dist/utils/requestAnimateFrames.d.ts

@@ -0,0 +1,31 @@
+interface FrameAnimationControllerOptions {
+    defaultSpeed?: number;
+    frameRate?: number;
+    frameCallback?: (frame: number, timeJson: any) => void;
+}
+export default class FrameAnimationController {
+    private startTime;
+    private currentFrame;
+    private speed;
+    private frameCallback;
+    private isPlaying;
+    private animationId;
+    private frameRate;
+    private startTimeFromDate;
+    private currentFrameFromDate;
+    constructor({ defaultSpeed, frameRate, frameCallback, }?: FrameAnimationControllerOptions);
+    get playing(): boolean;
+    play(): void;
+    pause(): void;
+    reset(): void;
+    setSpeed(speed: number): void;
+    gotoFrame(frameNumber: number): void;
+    nextFrame(): void;
+    prevFrame(): void;
+    destroy(): void;
+    private _animate;
+    private _updateFrame;
+    getCurrentFrame(): number;
+    updateStartTime(frame: number): void;
+}
+export {};

package/dist/utils/time.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file 时间处理工具函数
+ */
+/**
+ * 格式化时间戳字符串为 'YYYY-MM-DD HH:mm:ss' 格式
+ * @param timestamp - ISO 格式的时间字符串, e.g., "2025-07-02T15:02:36.391615"
+ * @returns 格式化后的时间字符串，如果输入无效则返回 'N/A'
+ */
+export declare function formatTimestamp(timestamp: string): string;

package/dist/view/DebugOverlay.d.ts

@@ -0,0 +1,54 @@
+import { type SDKError } from "../types/error";
+import { type ISessionResponse } from "../modules/ResourceManager";
+/**
+ * 调试信息浮层（支持复制会话ID + 禁止疯狂刷新DOM）
+ */
+export declare class DebugOverlay {
+    private container;
+    private sdkContainer;
+    private sdk;
+    private sessionInfo;
+    private startTime;
+    private updateInterval;
+    private errors;
+    private fps;
+    private frameCount;
+    private lastFpsUpdate;
+    private videoInfo;
+    private audioInfo;
+    private eventInfo;
+    private memoryInfo;
+    private perfMetrics;
+    private currentFrameIndex;
+    private domRefs;
+    constructor(sdk: any, sessionInfo: ISessionResponse);
+    setAudioInfo(info: {
+        sf: number;
+        ef: number;
+        ad: Uint8Array;
+    }): void;
+    setEventData(info: {
+        sf: number;
+        ef: number;
+        event: any[];
+    }): void;
+    addError(error: SDKError): void;
+    show(): void;
+    hide(): void;
+    destroy(): void;
+    setVideoInfo(info: any): void;
+    private updateTextOnly;
+    private setText;
+    private copySessionId;
+    private createOverlay;
+    private formatErrors;
+    private updatePerfMetrics;
+    private formatPerfMetrics;
+    private formatMemory;
+    private trackFPS;
+    private updateMemory;
+    private trackMemory;
+    private getNetworkInfo;
+    private applyStyles;
+    private enableDrag;
+}

package/dist/worker/streaming-video.d.ts

@@ -0,0 +1 @@
+export declare const workerURL: string;

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@xmov/avatar",
+  "version": "2.0.0-alpha.38",
+  "description": "魔珐数字人 JS-SDK",
+  "type": "module",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.modern.js"
+    },
+    "./agent": {
+      "types": "./src/agent/index.ts",
+      "require": "./dist/agent/index.cjs",
+      "default": "./dist/agent/avatar.modern.js"
+    },
+    "./agent/umd": "./dist/agent/index.umd.js"
+  },
+  "amdName": "XmovAvatar",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.module.js",
+  "unpkg": "./dist/index.umd.js",
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "scripts": {
+    "build": "microbundle --workers --define ENV=production,VERSION=$npm_package_version --external none --tsconfig tsconfig.json && pnpm run build:agent && node upload-sdk.js build",
+    "build:agent": "microbundle --entry src/agent/index.ts --output dist/agent --format modern,esm,cjs,umd --external @xmov/avatar --alias ../index=@xmov/avatar --globals @xmov/avatar=XmovAvatar --name XingyunAvatarAgentModule --tsconfig tsconfig.agent.json && node scripts/build-agent-entry.mjs",
+    "sdk": "microbundle watch --workers --define ENV=development,VERSION=$npm_package_version --external none --tsconfig tsconfig.json",
+    "app": "cd app/ && npm run dev",
+    "app:lan": "pnpm --dir app dev:lan",
+    "test:agent": "node scripts/run-agent-tests.mjs",
+    "test:agent:exports": "pnpm run build:agent && node scripts/test-agent-package-exports.mjs",
+    "test:agent:browser": "playwright test",
+    "lite": "node replaceString.js && npm run build && node upload-sdk.js lite",
+    "proto": "pbjs -t static-module -w closure -o src/proto/face_data_pb.js src/proto/face_data.proto",
+    "commitlint": "commitlint --edit",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "avatar",
+    "digital-human",
+    "webgl",
+    "offline",
+    "xmov"
+  ],
+  "author": "fangchao",
+  "license": "ISC",
+  "packageManager": "pnpm@10.8.0",
+  "devDependencies": {
+    "@babel/core": "^7.29.7",
+    "@babel/preset-env": "^7.29.7",
+    "@babel/preset-typescript": "^7.29.7",
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "@msgpack/msgpack": "^1.0.3",
+    "@playwright/test": "^1.61.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/gitlab": "^13.3.2",
+    "@types/pako": "^2.0.3",
+    "ali-oss": "^6.23.0",
+    "conventional-changelog-conventionalcommits": "^10.2.0",
+    "husky": "^9.0.0",
+    "microbundle": "^0.15.1",
+    "pako": "^2.1.0",
+    "protobufjs-cli": "^1.1.3",
+    "semantic-release": "^23.0.0",
+    "socket.io-client": "^4.8.1",
+    "typescript": "^4.9.5",
+    "ws": "^8.21.1"
+  },
+  "dependencies": {
+    "blueimp-md5": "^2.19.0",
+    "protobufjs": "^7.5.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}