@vvfx/sdk 0.2.8 → 0.2.10

package/dist/utils/json-data-utils.js

@@ -0,0 +1,1529 @@
+import { Vector2, Vector3 } from '../math';
+import { spec, generateGUID, PlayerVersion } from '../shared';
+/**
+ * @description 创建 Frame 元素的内部合成场景
+ * @param frameId Frame 元素ID（用于标识）
+ * @param size 场景尺寸 [width, height]
+ * @param name 场景名称
+ * @returns Frame 内部的合成场景
+ */
+export function createFrameCompositionScene(frameId, size, name) {
+    const compositionId = generateGUID();
+    const timelineAssetId = generateGUID();
+    const compositionComponentId = generateGUID();
+    const timelineAsset = {
+        id: timelineAssetId,
+        dataType: spec.DataType.TimelineAsset,
+        tracks: [],
+    };
+    const compositionComponent = {
+        id: compositionComponentId,
+        item: { id: compositionId },
+        dataType: spec.DataType.CompositionComponent,
+        items: [],
+        timelineAsset: { id: timelineAssetId },
+        sceneBindings: [],
+    };
+    const [width, height] = size;
+    const composition = {
+        id: compositionId,
+        name: name + '_inner',
+        duration: 999,
+        startTime: 0,
+        endBehavior: spec.EndBehavior.forward,
+        previewSize: [...size],
+        camera: {
+            fov: 60,
+            far: 40,
+            near: 0.1,
+            clipMode: 1,
+            position: [0, 0, 8],
+            rotation: [0, 0, 0],
+            // @ts-expect-error: aspect 属性在 CameraOptions 上有定义但类型声明不完善
+            aspect: width / height,
+        },
+        components: [{ id: compositionComponentId }],
+    };
+    const scene = {
+        version: spec.JSONSceneVersion['3_6'],
+        playerVersion: {
+            web: PlayerVersion,
+            native: '10.7.6',
+        },
+        type: 'ge',
+        compositionId: compositionId,
+        compositions: [composition],
+        images: [],
+        plugins: [],
+        bins: [],
+        textures: [],
+        items: [],
+        components: [compositionComponent],
+        materials: [],
+        shaders: [],
+        geometries: [],
+        animations: [],
+        miscs: [timelineAsset],
+    };
+    return scene;
+}
+/**
+ * @description 创建基础场景信息
+ * @param viewSize 画布大小
+ * @returns 场景信息
+ */
+export function getBasicScene(viewSize = [750, 750], name = 'AI 设计师画布') {
+    const compositionId = generateGUID();
+    const timelineAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.TimelineAsset,
+        tracks: [],
+    };
+    const basicCompositionComponent = {
+        id: generateGUID(),
+        item: { id: compositionId },
+        dataType: spec.DataType.CompositionComponent,
+        items: [],
+        timelineAsset: { id: timelineAsset.id },
+        sceneBindings: [],
+    };
+    const basicComposition = {
+        id: compositionId,
+        name,
+        duration: 999,
+        startTime: 0,
+        endBehavior: spec.EndBehavior.forward,
+        previewSize: [...viewSize],
+        camera: {
+            fov: 60,
+            far: 40,
+            near: 0.1,
+            clipMode: 1,
+            position: [0, 0, 8],
+            rotation: [0, 0, 0],
+            //@ts-expect-error @赤芍 to fix4
+            aspect: viewSize[0] / viewSize[1]
+        },
+        components: [{ id: basicCompositionComponent.id }],
+    };
+    const scene = {
+        version: spec.JSONSceneVersion['3_6'],
+        playerVersion: {
+            web: PlayerVersion,
+            native: '10.7.6'
+        },
+        type: 'ge',
+        compositionId: compositionId,
+        compositions: [],
+        images: [],
+        plugins: [],
+        bins: [],
+        textures: [],
+        items: [],
+        components: [],
+        materials: [],
+        shaders: [],
+        geometries: [],
+        animations: [],
+        miscs: [],
+    };
+    scene.miscs.push(timelineAsset);
+    scene.compositions.push(basicComposition);
+    scene.components.push(basicCompositionComponent);
+    return scene;
+}
+export function createSpriteItemJSON(spriteId, position, rotation, size, scale, name, texture) {
+    const componentId = generateGUID();
+    const spriteItem = {
+        id: spriteId,
+        name,
+        dataType: spec.DataType.VFXItemData,
+        components: [{ id: componentId }],
+        delay: 0,
+        duration: 999,
+        endBehavior: spec.EndBehavior.restart,
+        renderLevel: spec.RenderLevel.BPlus,
+        type: spec.ItemType.sprite,
+        visible: true,
+        transform: {
+            position: { x: position.x, y: position.y, z: position.z },
+            eulerHint: { x: rotation.x, y: rotation.y, z: rotation.z },
+            size: { x: size.x, y: size.y },
+            scale: { x: scale.x, y: scale.y, z: scale.z },
+            anchor: { x: 0, y: 0 }
+        },
+        content: undefined,
+    };
+    const component = {
+        id: componentId,
+        item: { id: spriteId },
+        dataType: spec.DataType.SpriteComponent,
+        options: {
+            startColor: [1, 1, 1, 1],
+        },
+        renderer: {
+            renderMode: spec.RenderMode.MESH,
+        },
+    };
+    if (texture) {
+        component.renderer.texture = { id: texture };
+    }
+    const activationPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationPlayableAsset,
+    };
+    const activationTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: activationPlayableAsset.id,
+                },
+            }],
+    };
+    const spriteColorPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.SpriteColorPlayableAsset,
+        startColor: [1, 1, 1, 1],
+    };
+    const spriteColorTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.SpriteColorTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: spriteColorPlayableAsset.id,
+                },
+            }]
+    };
+    const tracks = [activationTrack, spriteColorTrack];
+    const playableAssets = [activationPlayableAsset, spriteColorPlayableAsset];
+    return {
+        item: spriteItem,
+        components: [component],
+        tracks,
+        playableAssets,
+    };
+}
+/**
+ * @description 创建视频生成器 Item JSON
+ * @description 以 SpriteItem 形式渲染，但设置透明颜色
+ * @description 在 content 中存储 isVideoGenerator 标记
+ */
+export function createVideoGeneratorItemJSON(id, position, rotation, size, scale, name) {
+    const componentId = generateGUID();
+    const vfxItem = {
+        id,
+        name,
+        dataType: spec.DataType.VFXItemData,
+        components: [{ id: componentId }],
+        delay: 0,
+        duration: 999,
+        endBehavior: spec.EndBehavior.restart,
+        renderLevel: spec.RenderLevel.BPlus,
+        type: spec.ItemType.sprite,
+        visible: true,
+        transform: {
+            position: { x: position.x, y: position.y, z: position.z },
+            eulerHint: { x: rotation.x, y: rotation.y, z: rotation.z },
+            size: { x: size.x, y: size.y },
+            scale: { x: scale.x, y: scale.y, z: scale.z },
+            anchor: { x: 0, y: 0 }
+        },
+        // 存储视频生成器标记
+        content: {
+            isVideoGenerator: true
+        },
+    };
+    // 使用透明颜色 [1, 1, 1, 0]
+    const component = {
+        id: componentId,
+        item: { id },
+        dataType: spec.DataType.SpriteComponent,
+        options: {
+            startColor: [1, 1, 1, 0], // 完全透明
+        },
+        renderer: {
+            renderMode: spec.RenderMode.MESH,
+        },
+    };
+    const activationPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationPlayableAsset,
+    };
+    const activationTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: activationPlayableAsset.id,
+                },
+            }],
+    };
+    // 透明颜色 playable asset
+    const spriteColorPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.SpriteColorPlayableAsset,
+        startColor: [1, 1, 1, 0], // 完全透明
+    };
+    const spriteColorTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.SpriteColorTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: spriteColorPlayableAsset.id,
+                },
+            }],
+    };
+    const tracks = [activationTrack, spriteColorTrack];
+    const playableAssets = [activationPlayableAsset, spriteColorPlayableAsset];
+    return {
+        item: vfxItem,
+        components: [component],
+        tracks,
+        playableAssets,
+    };
+}
+export function createNullItemJSON(nullId, name, position, scale = new Vector2(1, 1), rotation = new Vector3(), worldSize = new Vector2(1, 1)) {
+    const positionInfo = JSON.parse(JSON.stringify(position));
+    const nullItem = {
+        id: nullId,
+        name: name,
+        duration: 999,
+        type: spec.ItemType.null,
+        visible: true,
+        endBehavior: spec.EndBehavior.restart,
+        delay: 0,
+        renderLevel: spec.RenderLevel.BPlus,
+        content: {
+            options: {
+                startColor: [1, 1, 1, 1],
+            }
+        },
+        components: [],
+        transform: {
+            position: positionInfo,
+            eulerHint: { x: rotation.x, y: rotation.y, z: rotation.z },
+            size: JSON.parse(JSON.stringify(worldSize)),
+            scale: { x: scale.x, y: scale.y, z: 1 },
+        },
+        dataType: spec.DataType.VFXItemData,
+    };
+    const activationPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationPlayableAsset,
+    };
+    const activationTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: activationPlayableAsset.id,
+                },
+            }],
+    };
+    const tracks = [activationTrack];
+    const playableAssets = [activationPlayableAsset];
+    return {
+        item: nullItem,
+        components: [],
+        tracks,
+        playableAssets,
+    };
+}
+export function createTextItemJSON(textId, name, position, rotation, size, fontInfo) {
+    const componentId = generateGUID();
+    const textItem = {
+        id: textId,
+        name,
+        dataType: spec.DataType.VFXItemData,
+        components: [{ id: componentId }],
+        delay: 0,
+        duration: 999,
+        endBehavior: spec.EndBehavior.restart,
+        renderLevel: spec.RenderLevel.BPlus,
+        type: spec.ItemType.text,
+        visible: true,
+        transform: {
+            position: { x: position.x, y: position.y, z: position.z },
+            eulerHint: { x: rotation.x, y: rotation.y, z: rotation.z },
+            scale: { x: size.x, y: size.y, z: 1 },
+            anchor: { x: 0, y: 0 }
+        },
+        content: undefined,
+    };
+    const component = {
+        id: componentId,
+        item: { id: textId },
+        dataType: spec.DataType.TextComponent,
+        options: fontInfo,
+        renderer: { renderMode: 1 }
+    };
+    const activationPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationPlayableAsset,
+    };
+    const activationTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: activationPlayableAsset.id,
+                },
+            }],
+    };
+    const tracks = [activationTrack];
+    const playableAssets = [activationPlayableAsset];
+    return {
+        item: textItem,
+        components: [component],
+        tracks,
+        playableAssets,
+    };
+}
+export function createVideoItemJSON(videoId, position, rotation, size, scale, name, isMuted = false, transparent = false, volume = 1, playbackRate = 1, texture, video) {
+    const componentId = generateGUID();
+    const videoItem = {
+        id: videoId,
+        name,
+        dataType: spec.DataType.VFXItemData,
+        components: [{ id: componentId }],
+        delay: 0,
+        duration: 999,
+        endBehavior: spec.EndBehavior.restart,
+        renderLevel: spec.RenderLevel.BPlus,
+        type: spec.ItemType.video,
+        visible: true,
+        transform: {
+            position: { x: position.x, y: position.y, z: position.z },
+            eulerHint: { x: rotation.x, y: rotation.y, z: rotation.z },
+            size: { x: size.x, y: size.y },
+            scale: { x: scale.x, y: scale.y, z: scale.z },
+            anchor: { x: 0, y: 0 }
+        },
+        content: undefined,
+    };
+    const component = {
+        id: componentId,
+        item: { id: videoId },
+        dataType: spec.DataType.VideoComponent,
+        options: {
+            startColor: [1, 1, 1, 1],
+            muted: isMuted,
+            video: {
+                id: video
+            },
+            volume,
+            playbackRate,
+            transparent
+        },
+        renderer: {
+            renderMode: spec.RenderMode.MESH,
+        },
+    };
+    if (texture) {
+        component.renderer.texture = { id: texture };
+    }
+    const activationPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationPlayableAsset,
+    };
+    const activationTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: activationPlayableAsset.id,
+                },
+            }],
+    };
+    const spriteColorPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.SpriteColorPlayableAsset,
+        startColor: [1, 1, 1, 1],
+    };
+    const spriteColorTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.SpriteColorTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: spriteColorPlayableAsset.id,
+                },
+            }]
+    };
+    const tracks = [activationTrack, spriteColorTrack];
+    const playableAssets = [activationPlayableAsset, spriteColorPlayableAsset];
+    return {
+        item: videoItem,
+        components: [component],
+        tracks,
+        playableAssets,
+    };
+}
+/**
+ * @description 创建预合成元素
+ * @param effectsId 预合成元素ID
+ * @param position 位置信息
+ * @param rotation 旋转信息
+ * @param scale 缩放信息
+ * @param name 名称
+ */
+export function createCompositionItemJSON(effectsId, position, rotation, scale, name) {
+    const positionInfo = JSON.parse(JSON.stringify(position));
+    const compositionItem = {
+        id: effectsId,
+        name: name,
+        duration: 999,
+        type: spec.ItemType.null,
+        visible: true,
+        endBehavior: spec.EndBehavior.restart,
+        delay: 0,
+        renderLevel: spec.RenderLevel.BPlus,
+        content: {
+            options: {
+                startColor: [1, 1, 1, 1],
+            }
+        },
+        components: [],
+        transform: {
+            position: positionInfo,
+            eulerHint: { x: rotation.x, y: rotation.y, z: rotation.z },
+            size: { x: 1, y: 1 },
+            scale: { x: scale.x, y: scale.y, z: 1 },
+        },
+        dataType: spec.DataType.VFXItemData,
+    };
+    const activationPlayableAsset = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationPlayableAsset,
+    };
+    const activationTrack = {
+        id: generateGUID(),
+        dataType: spec.DataType.ActivationTrack,
+        children: [],
+        clips: [{
+                start: 0,
+                duration: 999,
+                endBehavior: spec.EndBehavior.restart,
+                asset: {
+                    id: activationPlayableAsset.id,
+                },
+            }],
+    };
+    const tracks = [activationTrack];
+    const playableAssets = [activationPlayableAsset];
+    return {
+        item: compositionItem,
+        components: [],
+        tracks,
+        playableAssets,
+    };
+}
+/**
+ * @description 添加元素信息到JSON
+ * @param scene 场景信息
+ * @param itemInfo 元素信息
+ */
+export function addItemInfoToScene(scene, itemInfo) {
+    scene.items.push(itemInfo.item);
+    scene.miscs.push(...itemInfo.tracks, ...itemInfo.playableAssets);
+    scene.components.push(...itemInfo.components);
+    const mainComposition = scene.compositions.find(c => c.id === scene.compositionId) ?? scene.compositions[0];
+    const mainCompositionComponent = scene.components.find(c => c.id === mainComposition.components[0]?.id);
+    if (mainCompositionComponent) {
+        mainCompositionComponent.items.push({ id: itemInfo.item.id });
+        const bindingTrackData = {
+            id: generateGUID(),
+            dataType: spec.DataType.ObjectBindingTrack,
+            children: [],
+            clips: [],
+        };
+        for (const track of itemInfo.tracks) {
+            bindingTrackData.children.push({ id: track.id });
+        }
+        const timelineAsset = scene.miscs.find(t => t.id === mainCompositionComponent.timelineAsset.id);
+        timelineAsset.tracks.push({ id: bindingTrackData.id });
+        mainCompositionComponent.sceneBindings.push({
+            key: { id: bindingTrackData.id },
+            value: { id: itemInfo.item.id },
+        });
+        scene.miscs.push(bindingTrackData);
+    }
+}
+/**
+ * @description 设置元素父节点信息
+ * @param scene 场景信息
+ * @param itemId 元素Id
+ * @param parentId 父节点Id
+ */
+export function setItemJSONParentId(scene, itemId, parentId) {
+    const targetItemIndex = scene.items.findIndex(item => item.id === itemId);
+    if (targetItemIndex < 0) {
+        return;
+    }
+    clearItemParentInfo(scene, itemId);
+    const targetParentItem = scene.items.find(item => item.id === parentId);
+    if (!targetParentItem) {
+        return;
+    }
+    scene.items[targetItemIndex].parentId = parentId;
+    const { position, eulerHint, scale } = targetParentItem.transform;
+    scene.items[targetItemIndex].transform ??= {
+        position: { x: 0, y: 0, z: 0 },
+        eulerHint: { x: 0, y: 0, z: 0 },
+        scale: { x: 1, y: 1, z: 1 },
+        size: { x: 1, y: 1 },
+    };
+    scene.items[targetItemIndex].transform.position.x -= position.x;
+    scene.items[targetItemIndex].transform.position.y -= position.y;
+    scene.items[targetItemIndex].transform.position.z -= position.z;
+    scene.items[targetItemIndex].transform.eulerHint.x -= eulerHint.x;
+    scene.items[targetItemIndex].transform.eulerHint.y -= eulerHint.y;
+    scene.items[targetItemIndex].transform.eulerHint.z -= eulerHint.z;
+    scene.items[targetItemIndex].transform.scale.x /= (scale.x === 0 ? 1 : scale.x);
+    scene.items[targetItemIndex].transform.scale.y /= (scale.y === 0 ? 1 : scale.y);
+    scene.items[targetItemIndex].transform.scale.z /= (scale.z === 0 ? 1 : scale.z);
+}
+/**
+ * @description 清理元素父节点信息
+ * @param scene 场景信息
+ * @param itemId 元素Id
+ */
+export function clearItemParentInfo(scene, itemId) {
+    const targetItemIndex = scene.items.findIndex(item => item.id === itemId);
+    if (!scene.items[targetItemIndex]?.parentId) {
+        return;
+    }
+    const targetParentItem = scene.items.find(item => item.id === scene.items[targetItemIndex].parentId);
+    if (!targetParentItem) {
+        delete scene.items[targetItemIndex].parentId;
+        return;
+    }
+    const { position, eulerHint, scale } = targetParentItem.transform;
+    scene.items[targetItemIndex].transform ??= {
+        position: { x: 0, y: 0, z: 0 },
+        eulerHint: { x: 0, y: 0, z: 0 },
+        scale: { x: 1, y: 1, z: 1 },
+        size: { x: 1, y: 1 },
+    };
+    scene.items[targetItemIndex].transform.position.x += position.x;
+    scene.items[targetItemIndex].transform.position.y += position.y;
+    scene.items[targetItemIndex].transform.position.z += position.z;
+    scene.items[targetItemIndex].transform.eulerHint.x += eulerHint.x;
+    scene.items[targetItemIndex].transform.eulerHint.y += eulerHint.y;
+    scene.items[targetItemIndex].transform.eulerHint.z += eulerHint.z;
+    scene.items[targetItemIndex].transform.scale.x *= (scale.x === 0 ? 1 : scale.x);
+    scene.items[targetItemIndex].transform.scale.y *= (scale.y === 0 ? 1 : scale.y);
+    scene.items[targetItemIndex].transform.scale.z *= (scale.z === 0 ? 1 : scale.z);
+}
+/**
+ * @description 删除元素信息
+ * @param scene 场景信息
+ * @param itemId 元素Id
+ */
+export function deleteItemInfoFromScene(scene, itemId) {
+    const item = scene.items.find(item => item.id === itemId);
+    if (!item) {
+        console.warn(`item ${itemId} is not existed.`);
+        return;
+    }
+    // 删除 元素 信息
+    scene.items = scene.items.filter(item => item.id !== itemId);
+    // 刷新 父子级 元素信息
+    scene.items.forEach(child => {
+        if (child.parentId === itemId) {
+            child.transform ??= {
+                position: { x: 0, y: 0, z: 0 },
+                eulerHint: { x: 0, y: 0, z: 0 },
+                scale: { x: 1, y: 1, z: 1 },
+                size: { x: 1, y: 1 },
+            };
+            child.transform.position.x += item.transform.position.x;
+            child.transform.position.y += item.transform.position.y;
+            child.transform.position.z += item.transform.position.z;
+            child.transform.eulerHint.x += item.transform.eulerHint.x;
+            child.transform.eulerHint.y += item.transform.eulerHint.y;
+            child.transform.eulerHint.z += item.transform.eulerHint.z;
+            child.transform.scale.x *= (item.transform.scale.x !== 0) ? item.transform.scale.x : 1;
+            child.transform.scale.y *= (item.transform.scale.y !== 0) ? item.transform.scale.y : 1;
+            child.transform.scale.z *= (item.transform.scale.z !== 0) ? item.transform.scale.z : 1;
+        }
+        delete child.parentId;
+    });
+    // 删除 Component 信息
+    const targetComponents = scene.components.filter(c => c.item.id === itemId);
+    scene.components = scene.components.filter(c => !(targetComponents.map(component => component.id).includes(c.id)));
+    targetComponents.forEach(component => {
+        switch (component.dataType) {
+            case spec.DataType.SpriteComponent: {
+                // 删除 Texture 信息
+                if (component.renderer.texture) {
+                    const textureHasOtherUsed = scene.components.find(c => c.renderer?.texture?.id === component.renderer.texture.id);
+                    if (!textureHasOtherUsed) {
+                        const targetTexture = scene.textures?.find(t => t.id === component.renderer.texture?.id);
+                        if (targetTexture) {
+                            scene.textures = scene.textures?.filter(t => t.id !== targetTexture.id);
+                            scene.images = scene.images.filter(image => image.id !== targetTexture.source.id);
+                        }
+                    }
+                }
+                break;
+            }
+            case spec.DataType.VideoComponent: {
+                if (component.renderer.texture) {
+                    const textureHasOtherUsed = scene.components.find(c => c.renderer?.texture?.id === component.renderer.texture.id);
+                    if (!textureHasOtherUsed) {
+                        const targetTexture = scene.textures?.find(t => t.id === component.renderer.texture?.id);
+                        if (targetTexture) {
+                            scene.textures = scene.textures?.filter(t => t.id !== targetTexture.id);
+                            scene.videos = scene.videos?.filter(video => video.id !== targetTexture.source.id);
+                        }
+                    }
+                }
+            }
+        }
+    });
+    // 删除 SceneBinding 信息
+    const toDeleteMiscIds = [];
+    let objectTrackId;
+    let timelineAssetId;
+    if ((+scene.version) >= 3.3) {
+        const compositionComponents = scene.components.filter(c => c.dataType === spec.DataType.CompositionComponent);
+        const compositionComponent = compositionComponents.find(c => c.items.find(item => item.id === itemId));
+        if (compositionComponent) {
+            compositionComponent.items = compositionComponent.items.filter(i => i.id !== itemId);
+            timelineAssetId = compositionComponent.timelineAsset.id;
+            objectTrackId = compositionComponent.sceneBindings.find(binding => binding.value.id === itemId)?.key.id;
+            compositionComponent.sceneBindings = compositionComponent.sceneBindings.filter(binding => binding.value.id !== itemId);
+            if (objectTrackId) {
+                toDeleteMiscIds.push(objectTrackId);
+            }
+        }
+    }
+    else {
+        const targetComposition = scene.compositions.find((c) => c.items.find((item) => item.id === itemId));
+        if (targetComposition) {
+            targetComposition.items = targetComposition.items.filter((i) => i.id !== itemId);
+            timelineAssetId = targetComposition.timelineAsset.id;
+            objectTrackId = targetComposition.sceneBindings.find((binding) => binding.value.id === itemId)?.key.id;
+            targetComposition.sceneBindings = targetComposition.sceneBindings.filter((binding) => binding.value.id !== itemId);
+            if (objectTrackId) {
+                toDeleteMiscIds.push(objectTrackId);
+            }
+        }
+    }
+    // 删除 miscs 信息
+    const timelineAssetIndex = scene.miscs.findIndex(misc => misc.id === timelineAssetId);
+    if (timelineAssetIndex >= 0) {
+        scene.miscs[timelineAssetIndex].tracks = scene.miscs[timelineAssetIndex].tracks.filter((track) => track.id !== objectTrackId);
+    }
+    const objectTrack = scene.miscs.find(misc => misc.id === objectTrackId);
+    if (objectTrack) {
+        objectTrack.children.forEach((child) => {
+            toDeleteMiscIds.push(child.id);
+            const targetTrack = scene.miscs.find(misc => misc.id === child.id);
+            if (targetTrack) {
+                toDeleteMiscIds.push(...targetTrack.clips.map((clip) => clip.asset.id));
+            }
+        });
+        toDeleteMiscIds.push(...objectTrack.children.map((c) => c.id));
+    }
+    scene.miscs = scene.miscs.filter(misc => !toDeleteMiscIds.includes(misc.id));
+    return scene;
+}
+/**
+ * @description 从场景中移除并获取元素的完整 ItemJSONInfo
+ * @param scene 场景信息
+ * @param itemId 元素ID
+ * @returns ItemJSONInfo 或 undefined（如果元素不存在）
+ */
+export function removeItemInfoFromScene(scene, itemId) {
+    const item = scene.items.find(item => item.id === itemId);
+    if (!item) {
+        return undefined;
+    }
+    // 1. 提取 item
+    const itemData = { ...item };
+    // 2. 提取 components（包括关联的 texture 等资源）
+    const components = scene.components.filter(c => c.item.id === itemId);
+    // 3. 查找 compositionComponent
+    const compositionComponents = scene.components.filter(c => c.dataType === spec.DataType.CompositionComponent);
+    const compositionComponent = compositionComponents.find(c => c.items.find((i) => i.id === itemId));
+    // 4. 提取 tracks 和 playableAssets
+    const tracks = [];
+    const playableAssets = [];
+    if (compositionComponent) {
+        // 查找 sceneBindings
+        const sceneBinding = compositionComponent.sceneBindings.find(binding => binding.value.id === itemId);
+        if (sceneBinding) {
+            const objectTrackId = sceneBinding.key.id;
+            const objectTrack = scene.miscs.find(misc => misc.id === objectTrackId);
+            if (objectTrack) {
+                // 提取子 tracks
+                const childTrackIds = (objectTrack.children || []).map((child) => child.id);
+                childTrackIds.forEach(trackId => {
+                    const track = scene.miscs.find(misc => misc.id === trackId);
+                    if (track) {
+                        tracks.push({ ...track });
+                        // 提取 track 中的 playableAssets
+                        const trackClips = track.clips;
+                        if (trackClips) {
+                            trackClips.forEach((clip) => {
+                                const asset = scene.miscs.find(misc => misc.id === clip.asset.id);
+                                if (asset) {
+                                    playableAssets.push({ ...asset });
+                                }
+                            });
+                        }
+                    }
+                });
+                // 添加 objectBindingTrack 本身到 tracks
+                tracks.push({ ...objectTrack });
+                // objectBindingTrack clips 中的 asset 也需要提取
+                const objectTrackClips = objectTrack.clips;
+                if (objectTrackClips) {
+                    objectTrackClips.forEach((clip) => {
+                        const asset = scene.miscs.find(misc => misc.id === clip.asset.id);
+                        if (asset) {
+                            playableAssets.push({ ...asset });
+                        }
+                    });
+                }
+            }
+        }
+    }
+    // 5. 从 scene 中移除数据（使用已有的 deleteItemInfoFromScene 函数）
+    deleteItemInfoFromScene(scene, itemId);
+    return {
+        item: itemData,
+        components: components.map(c => ({ ...c })),
+        tracks,
+        playableAssets,
+    };
+}
+export function getTextureUrlById(scene, itemId) {
+    let textureUrl;
+    scene.components.forEach(component => {
+        if (component.item.id === itemId) {
+            if (component.dataType === spec.DataType.SpriteComponent && component.renderer.texture) {
+                const targetTexture = scene.textures?.find(t => t.id === component.renderer.texture?.id);
+                if (targetTexture) {
+                    textureUrl = scene.images.find(image => image.id === targetTexture.source.id)?.url;
+                }
+            }
+            else if (component.dataType === spec.DataType.VideoComponent && component.renderer.texture) {
+                const targetTexture = scene.textures?.find(t => t.id === component.renderer.texture?.id);
+                if (targetTexture) {
+                    textureUrl = scene.videos?.find(video => video.id === targetTexture.source.id)?.url;
+                }
+            }
+        }
+    });
+    return textureUrl;
+}
+export function addCompositionItemByComposition(main, inputChild, compositionItemId, parentId) {
+    const child = JSON.parse(JSON.stringify(inputChild));
+    const delay = 0;
+    const duration = child.compositions?.[0]?.duration ?? 5;
+    const endBehavior = spec.EndBehavior.restart;
+    const compositionTransform = {
+        position: {
+            x: 0,
+            y: 0,
+            z: 0,
+        },
+        eulerHint: {
+            x: 0,
+            y: 0,
+            z: 0,
+        },
+        scale: {
+            x: 1,
+            y: 1,
+            z: 1,
+        },
+    };
+    const compositionOptions = {
+        refId: child.compositionId ?? child.compositions[0].id,
+        startColor: [1, 1, 1, 1],
+    };
+    const compositionContent = {
+        options: compositionOptions,
+    };
+    const specificationItem = {
+        id: compositionItemId,
+        components: [],
+        name: 'ref_' + child.compositions[0].name,
+        duration,
+        dataType: spec.DataType.VFXItemData,
+        parentId,
+        type: spec.ItemType.composition,
+        visible: true,
+        endBehavior,
+        delay,
+        renderLevel: spec.RenderLevel.BPlus,
+        content: compositionContent,
+        transform: compositionTransform,
+    };
+    main.items.push(specificationItem);
+    const activationPlayableAsset = {
+        id: generateGUID(),
+        dataType: 'ActivationPlayableAsset',
+    };
+    const activationTrack = {
+        id: generateGUID(),
+        dataType: 'ActivationTrack',
+        children: [],
+        clips: [
+            {
+                start: delay,
+                duration,
+                endBehavior,
+                asset: {
+                    id: activationPlayableAsset.id,
+                },
+            },
+        ],
+    };
+    const subCompositionPlayableAsset = {
+        id: generateGUID(),
+        dataType: 'SubCompositionPlayableAsset',
+    };
+    const subCompositionTrack = {
+        id: generateGUID(),
+        dataType: 'SubCompositionTrack',
+        children: [],
+        clips: [
+            {
+                start: 0,
+                duration,
+                endBehavior,
+                asset: {
+                    id: subCompositionPlayableAsset.id,
+                },
+            },
+        ],
+    };
+    const bindingTrackData = {
+        id: generateGUID(),
+        dataType: spec.DataType.ObjectBindingTrack,
+        children: [],
+        clips: [],
+    };
+    main.miscs.push(bindingTrackData);
+    const tracks = [];
+    const playableAssets = [];
+    tracks.push(activationTrack, subCompositionTrack);
+    playableAssets.push(activationPlayableAsset, subCompositionPlayableAsset);
+    if (Number(main.version) <= 3.3) {
+        const mainCompositionIndex = main.compositions.findIndex((c) => c.id === main.compositionId);
+        if (mainCompositionIndex >= 0) {
+            // @ts-expect-error type to fix
+            main.compositions[mainCompositionIndex].items.push({ id: specificationItem.id });
+            // @ts-expect-error type to fix
+            const timelineAsset = main.miscs.find((misc) => misc.id === main.compositions[mainCompositionIndex].timelineAsset.id);
+            timelineAsset?.tracks.push({ id: bindingTrackData.id });
+            // @ts-expect-error type to fix
+            main.compositions[mainCompositionIndex].sceneBindings.push({
+                key: { id: bindingTrackData.id },
+                value: { id: specificationItem.id },
+            });
+        }
+    }
+    else {
+        const compositionComponent = main.components.find((c) => c.id === main.compositions[0].components[0].id && c.dataType === spec.DataType.CompositionComponent);
+        compositionComponent.items.push({ id: specificationItem.id });
+        const timelineAsset = main.miscs.find((misc) => misc.id === compositionComponent.timelineAsset.id);
+        timelineAsset?.tracks.push({ id: bindingTrackData.id });
+        compositionComponent.sceneBindings.push({
+            key: { id: bindingTrackData.id },
+            value: { id: specificationItem.id },
+        });
+    }
+    tracks.forEach((track) => {
+        if (!track.path) {
+            bindingTrackData.children.push({ id: track.id });
+        }
+    });
+    main.miscs.push(...tracks);
+    main.miscs.push(...playableAssets);
+    Object.keys(main).forEach(property => {
+        if (property === 'compositionId') {
+            main.compositionId ??= main.compositions[0].id;
+            return;
+        }
+        else if (property === 'components') {
+            // 补充CompositionComponent.item.id
+            child.components.forEach(component => {
+                if (component.dataType === spec.DataType.CompositionComponent && !component.item.id) {
+                    child.compositions.forEach(composition => {
+                        if (composition.components[0]?.id === component.id) {
+                            component.item.id = composition.id;
+                        }
+                    });
+                }
+            });
+        }
+        // @ts-expect-error type to fix
+        if (child[property] && Array.isArray(child[property])) {
+            // @ts-expect-error type to fix
+            main[property] ??= [];
+            // @ts-expect-error type to fix
+            main[property].push(...child[property]);
+        }
+    });
+    return main;
+}
+/**
+ * @description 删除预合成数据
+ * @param scene 场景数据
+ * @param itemId 预合成ID
+ * @returns 场景数据
+ */
+export function deleteCompositionItemFromScene(scene, itemIds) {
+    const compositionIds = [];
+    itemIds.forEach(id => {
+        const item = scene.items.find(item => item.id === id);
+        if (!item) {
+            return;
+        }
+        deleteItemInfoFromScene(scene, id);
+        if (item.type === spec.ItemType.composition) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
+            const compositionId = item?.content.options.refId;
+            compositionIds.push(compositionId);
+        }
+    });
+    compositionIds.forEach(compositionId => {
+        deleteCompositionFromScene(scene, compositionId);
+    });
+    return scene;
+}
+/**
+ * @description 删除合成信息
+ * @param scene 场景数据
+ * @param compositionId 合成ID
+ */
+export function deleteCompositionFromScene(scene, compositionId) {
+    const compositionComponent = scene.components.find(com => com.item.id === compositionId);
+    if (compositionComponent) {
+        const timelineAssetId = compositionComponent.timelineAsset.id;
+        scene.miscs = scene.miscs.filter(value => value.id !== timelineAssetId);
+        scene.compositions = scene.compositions.filter(com => com.id !== compositionId);
+        scene.components = scene.components.filter(com => com.id !== compositionComponent.id);
+    }
+}
+/**
+ * @description 重置元素ID - 加载时会新建guid，需要保持一致
+ * @param scene 场景数据
+ * @param idMap id名称列表
+ */
+export function resetSubCompositionItemId(scene, idMap) {
+    scene.items.forEach(item => {
+        const originId = item.id;
+        const newId = idMap.get(originId);
+        if (newId) {
+            item.id = newId;
+            const components = scene.components.filter(c => c.item.id === originId);
+            components.forEach(com => {
+                com.item.id = newId;
+            });
+            const compositionComponents = scene.components.filter(comp => comp.dataType === spec.DataType.CompositionComponent);
+            compositionComponents.forEach(com => {
+                com.items.forEach(comItem => {
+                    if (comItem.id === originId) {
+                        comItem.id = newId;
+                    }
+                });
+                com.sceneBindings.forEach(bindingValue => {
+                    if (bindingValue.value.id === originId) {
+                        bindingValue.value.id = newId;
+                    }
+                });
+            });
+        }
+    });
+}
+/**
+ * @description 设置场景中元素名称
+ * @param scene 场景数据
+ * @param itemId 元素ID
+ * @param name 名称
+ */
+export function setJSONItemName(scene, itemId, name) {
+    const item = scene.items.find(item => item.id === itemId);
+    if (!item) {
+        console.warn(`item ${itemId} is not existed.`);
+        return;
+    }
+    item.name = name;
+}
+/**
+ * @description 将元素从一个合成移动到另一个合成
+ * @param scene 场景数据
+ * @param itemId 元素ID
+ * @param targetCompositionId 目标合成ID，为null时表示移动到主合成
+ * @param options 可选的位置、大小、缩放、旋转信息
+ * @returns 是否移动成功
+ */
+export function moveItemBetweenCompositions(scene, itemId, targetCompositionId, options) {
+    // 1. 查找元素
+    const item = scene.items.find(item => item.id === itemId);
+    if (!item) {
+        console.warn(`moveItemBetweenCompositions: item ${itemId} not found`);
+        return false;
+    }
+    // 2. 查找元素当前所在的合成（源合成）
+    const sourceCompositionComponent = findCompositionComponentByItemId(scene, itemId);
+    if (!sourceCompositionComponent) {
+        console.warn(`moveItemBetweenCompositions: source composition not found for item ${itemId}`);
+        return false;
+    }
+    // 3. 查找目标合成
+    const targetCompositionComponent = targetCompositionId
+        ? findCompositionComponentByCompositionId(scene, targetCompositionId)
+        : getMainCompositionComponent(scene);
+    if (!targetCompositionComponent) {
+        console.warn(`moveItemBetweenCompositions: target composition not found ${targetCompositionId ?? '(main)'}`);
+        return false;
+    }
+    // 源合成和目标合成相同，无需移动
+    if (sourceCompositionComponent.id === targetCompositionComponent.id) {
+        return true;
+    }
+    // 4. 从源合成中移除元素的绑定关系
+    const removedBindingInfo = removeItemBindingFromComposition(scene, sourceCompositionComponent, itemId);
+    if (!removedBindingInfo) {
+        console.warn(`moveItemBetweenCompositions: failed to remove item ${itemId} from source composition`);
+        return false;
+    }
+    // 5. 将元素添加到目标合成
+    addItemBindingToComposition(scene, targetCompositionComponent, itemId, removedBindingInfo.trackIds);
+    // 6. 更新元素的变换属性
+    if (options) {
+        updateItemTransform(item, options);
+    }
+    return true;
+}
+/**
+ * @description 根据元素ID查找包含该合成的CompositionComponent
+ */
+function findCompositionComponentByItemId(scene, itemId) {
+    if ((+scene.version) >= 3.3) {
+        return scene.components.find(comp => comp.dataType === spec.DataType.CompositionComponent &&
+            comp.items.some(item => item.id === itemId));
+    }
+    else {
+        // V3.3 以下版本，遍历 compositions 查找
+        const targetComposition = scene.compositions.find((c) => c.items?.some((item) => item.id === itemId));
+        if (targetComposition) {
+            return scene.components.find(comp => comp.dataType === spec.DataType.CompositionComponent &&
+                comp.item.id === targetComposition.id);
+        }
+    }
+    return undefined;
+}
+/**
+ * @description 根据合成ID查找CompositionComponent
+ */
+function findCompositionComponentByCompositionId(scene, compositionId) {
+    return scene.components.find(comp => comp.dataType === spec.DataType.CompositionComponent &&
+        comp.item.id === compositionId);
+}
+/**
+ * @description 获取主合成组件
+ */
+function getMainCompositionComponent(scene) {
+    const mainComposition = scene.compositions.find(c => c.id === scene.compositionId) ?? scene.compositions[0];
+    if (!mainComposition) {
+        return undefined;
+    }
+    return scene.components.find(comp => comp.dataType === spec.DataType.CompositionComponent &&
+        comp.item.id === mainComposition.id);
+}
+/**
+ * @description 从合成中移除元素的绑定关系
+ * @returns 移除的轨道ID列表，用于后续添加到新合成
+ */
+function removeItemBindingFromComposition(scene, compositionComponent, itemId) {
+    // 在 V3.3+ 中，从 CompositionComponent 中移除
+    // 在 V3.3- 中，从 CompositionData 中移除
+    const trackIds = [];
+    let objectBindingTrackId = null;
+    if ((+scene.version) >= 3.3) {
+        // 1. 从 items 中移除
+        compositionComponent.items = compositionComponent.items.filter(item => item.id !== itemId);
+        // 2. 从 sceneBindings 中找到并移除绑定关系
+        const bindingIndex = compositionComponent.sceneBindings.findIndex(binding => binding.value.id === itemId);
+        if (bindingIndex >= 0) {
+            const binding = compositionComponent.sceneBindings[bindingIndex];
+            objectBindingTrackId = binding.key.id;
+            compositionComponent.sceneBindings.splice(bindingIndex, 1);
+        }
+    }
+    else {
+        // V3.3 以下版本
+        const composition = scene.compositions.find((c) => {
+            const compComponent = scene.components.find(comp => comp.dataType === spec.DataType.CompositionComponent &&
+                comp.id === compositionComponent.id);
+            return compComponent && c.id === compComponent.item.id;
+        });
+        if (composition) {
+            composition.items = composition.items.filter((item) => item.id !== itemId);
+            const bindingIndex = composition.sceneBindings?.findIndex((binding) => binding.value.id === itemId);
+            if (bindingIndex >= 0) {
+                const binding = composition.sceneBindings[bindingIndex];
+                objectBindingTrackId = binding.key.id;
+                composition.sceneBindings.splice(bindingIndex, 1);
+            }
+        }
+    }
+    if (!objectBindingTrackId) {
+        return null;
+    }
+    // 3. 从 TimelineAsset 中移除 ObjectBindingTrack
+    const timelineAssetId = compositionComponent.timelineAsset.id;
+    const timelineAsset = scene.miscs.find(m => m.id === timelineAssetId);
+    if (timelineAsset?.tracks) {
+        timelineAsset.tracks = timelineAsset.tracks.filter((track) => track.id !== objectBindingTrackId);
+    }
+    // 4. 获取 ObjectBindingTrack 的子轨道ID列表
+    const objectBindingTrack = scene.miscs.find(m => m.id === objectBindingTrackId);
+    if (objectBindingTrack?.children) {
+        objectBindingTrack.children.forEach((child) => {
+            trackIds.push(child.id);
+        });
+    }
+    return { trackIds, objectBindingTrackId };
+}
+/**
+ * @description 将元素绑定添加到目标合成
+ */
+function addItemBindingToComposition(scene, compositionComponent, itemId, trackIds) {
+    // 1. 添加到 items
+    compositionComponent.items.push({ id: itemId });
+    // 2. 创建新的 ObjectBindingTrack
+    const bindingTrackData = {
+        id: generateGUID(),
+        dataType: spec.DataType.ObjectBindingTrack,
+        children: [],
+        clips: [],
+    };
+    // 添加子轨道引用
+    for (const trackId of trackIds) {
+        bindingTrackData.children.push({ id: trackId });
+    }
+    // 3. 添加到 sceneBindings
+    compositionComponent.sceneBindings.push({
+        key: { id: bindingTrackData.id },
+        value: { id: itemId },
+    });
+    // 4. 添加到 TimelineAsset 的 tracks
+    const timelineAssetId = compositionComponent.timelineAsset.id;
+    const timelineAsset = scene.miscs.find(m => m.id === timelineAssetId);
+    if (timelineAsset?.tracks) {
+        timelineAsset.tracks.push({ id: bindingTrackData.id });
+    }
+    // 5. 添加 ObjectBindingTrack 到 miscs
+    scene.miscs.push(bindingTrackData);
+}
+/**
+ * @description 更新元素的变换属性
+ */
+function updateItemTransform(item, options) {
+    item.transform ??= {
+        position: { x: 0, y: 0, z: 0 },
+        eulerHint: { x: 0, y: 0, z: 0 },
+        scale: { x: 1, y: 1, z: 1 },
+        size: { x: 1, y: 1 },
+    };
+    if (options.position) {
+        item.transform.position = { ...options.position };
+    }
+    if (options.size) {
+        item.transform.size = { ...options.size };
+    }
+    if (options.scale) {
+        item.transform.scale = { ...options.scale };
+    }
+    if (options.rotation) {
+        item.transform.eulerHint = { ...options.rotation };
+    }
+}
+export function getCompositionIdByRefCompositionItemId(scene, compositionItemId) {
+    const compositionItem = scene.items.find(item => item.id === compositionItemId);
+    if (!compositionItem) {
+        console.warn(`Target composition item ${compositionItemId} is not existed.`);
+        return undefined;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    return compositionItem.content.options.refId;
+}
+/**
+ * @description 获取预合成元素所指向的合成数据
+ * @param scene 场景数据
+ * @param compositionItemId 预合成元素ID
+ * @returns 对应的合成数据 (CompositionData)，如果未找到则返回 undefined
+ */
+export function getCompositionDataByRefCompositionItemId(scene, compositionItemId) {
+    const compositionItem = scene.items.find(item => item.id === compositionItemId);
+    if (!compositionItem) {
+        console.warn(`Target composition item ${compositionItemId} is not existed.`);
+        return undefined;
+    }
+    // 预合成元素通过 content.options.refId 存储引用的合成ID
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    const refId = compositionItem.content?.options?.refId;
+    if (!refId) {
+        console.warn(`Composition item ${compositionItemId} has no refId.`);
+        return undefined;
+    }
+    // 根据 refId 查找对应的合成数据
+    const compositionData = scene.compositions.find(composition => composition.id === refId);
+    if (!compositionData) {
+        console.warn(`Composition data with id ${refId} not found.`);
+        return undefined;
+    }
+    return compositionData;
+}
+/**
+ * @description 提取子合成元素及其所有关联资源为独立的 JSONScene
+ * @param scene 主场景数据
+ * @param compositionItemId 预合成元素ID（子合成元素ID）
+ * @returns 独立的子合成场景 JSONScene，如果未找到则返回 undefined
+ */
+export function extractSubCompositionToScene(scene, compositionItemId) {
+    // 1. 查找预合成元素
+    const compositionItem = scene.items.find(item => item.id === compositionItemId);
+    if (!compositionItem) {
+        console.warn(`Target composition item ${compositionItemId} is not existed.`);
+        return undefined;
+    }
+    // 验证元素类型是预合成类型
+    if (compositionItem.type !== spec.ItemType.composition) {
+        console.warn(`Item ${compositionItemId} is not a composition item.`);
+        return undefined;
+    }
+    // 2. 获取子合成ID (refId)
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    const refId = compositionItem.content?.options?.refId;
+    if (!refId) {
+        console.warn(`Composition item ${compositionItemId} has no refId.`);
+        return undefined;
+    }
+    // 3. 提取合成数据
+    const compositionData = scene.compositions.find(comp => comp.id === refId);
+    if (!compositionData) {
+        console.warn(`Composition data with id ${refId} not found.`);
+        return undefined;
+    }
+    // 4. 查找对应的 CompositionComponent
+    const compositionComponent = scene.components.find(comp => comp.dataType === spec.DataType.CompositionComponent && comp.item.id === refId);
+    if (!compositionComponent) {
+        console.warn(`CompositionComponent for composition ${refId} not found.`);
+        return undefined;
+    }
+    // 收集所有需要的数据集合
+    const itemIds = new Set();
+    const componentIds = new Set();
+    const miscIds = new Set();
+    const textureIds = new Set();
+    const imageIds = new Set();
+    const videoIds = new Set();
+    const materialIds = new Set();
+    const shaderIds = new Set();
+    const geometryIds = new Set();
+    const animationIds = new Set();
+    // 收集元素ID
+    compositionComponent.items.forEach(itemRef => itemIds.add(itemRef.id));
+    // 收集 CompositionComponent ID
+    componentIds.add(compositionComponent.id);
+    // 收集 TimelineAsset ID
+    miscIds.add(compositionComponent.timelineAsset.id);
+    // 5. 提取元素数据并收集关联资源
+    const extractedItems = scene.items.filter(item => itemIds.has(item.id));
+    // 6. 提取组件数据并收集资源引用
+    const extractedComponents = scene.components.filter(comp => {
+        if (comp.item.id === refId) {
+            return true;
+        }
+        if (itemIds.has(comp.item.id)) {
+            return true;
+        }
+        return false;
+    });
+    // 收集 resources 引用
+    extractedComponents.forEach(comp => {
+        componentIds.add(comp.id);
+        // 收集 SpriteComponent 的 texture 引用
+        if (comp.dataType === spec.DataType.SpriteComponent) {
+            const spriteComp = comp;
+            if (spriteComp.renderer?.texture?.id) {
+                textureIds.add(spriteComp.renderer.texture.id);
+            }
+        }
+        // 收集 VideoComponent 的 texture 引用
+        if (comp.dataType === spec.DataType.VideoComponent) {
+            const videoComp = comp;
+            if (videoComp.renderer?.texture?.id) {
+                textureIds.add(videoComp.renderer.texture.id);
+            }
+        }
+    });
+    // 7. 提取贴图和图片/视频资源
+    const extractedTextures = [];
+    if (scene.textures) {
+        scene.textures.forEach(texture => {
+            if (texture.id && textureIds.has(texture.id)) {
+                extractedTextures.push(texture);
+                // 收集图片或视频资源ID
+                const sourceId = texture.source?.id;
+                if (sourceId) {
+                    // 根据 texture 类型判断是图片还是视频
+                    const textureType = texture.sourceType;
+                    if (textureType === 1) { // Video source type
+                        videoIds.add(sourceId);
+                    }
+                    else {
+                        imageIds.add(sourceId);
+                    }
+                }
+            }
+        });
+    }
+    const extractedImages = scene.images.filter(img => imageIds.has(img.id));
+    const extractedVideos = scene.videos?.filter(video => videoIds.has(video.id)) ?? [];
+    // 8. 提取 miscs 数据 (TimelineAsset, tracks, playableAssets)
+    const extractedMiscs = [];
+    // 提取 TimelineAsset
+    const timelineAsset = scene.miscs.find(m => m.id === compositionComponent.timelineAsset.id);
+    if (timelineAsset) {
+        extractedMiscs.push({ ...timelineAsset, tracks: [] }); // 先添加空的tracks，后面再填充
+    }
+    // 收集 sceneBindings 相关的 track IDs
+    const bindingTrackIds = compositionComponent.sceneBindings.map(binding => binding.key.id);
+    bindingTrackIds.forEach(id => miscIds.add(id));
+    // 收集 item 引用的所有 tracks
+    compositionComponent.sceneBindings.forEach(binding => {
+        const objectTrackId = binding.key.id;
+        const objectTrack = scene.miscs.find(m => m.id === objectTrackId);
+        if (objectTrack) {
+            // 提取 ObjectBindingTrack 本身
+            extractedMiscs.push({ ...objectTrack });
+            // 将 track 添加到 TimelineAsset
+            if (timelineAsset) {
+                const timelineIndex = extractedMiscs.findIndex(m => m.id === timelineAsset.id);
+                if (timelineIndex >= 0) {
+                    extractedMiscs[timelineIndex].tracks = extractedMiscs[timelineIndex].tracks || [];
+                    extractedMiscs[timelineIndex].tracks.push({ id: objectTrackId });
+                }
+            }
+            // 提取子 tracks
+            const childTrackIds = (objectTrack.children || []).map((child) => child.id);
+            childTrackIds.forEach(trackId => {
+                miscIds.add(trackId);
+                const track = scene.miscs.find(m => m.id === trackId);
+                if (track) {
+                    extractedMiscs.push({ ...track });
+                    // 从子 track 中提取 playableAssets
+                    const trackClips = track.clips;
+                    if (trackClips) {
+                        trackClips.forEach(clip => {
+                            if (clip.asset?.id) {
+                                miscIds.add(clip.asset.id);
+                                const asset = scene.miscs.find(m => m.id === clip.asset.id);
+                                if (asset) {
+                                    extractedMiscs.push({ ...asset });
+                                }
+                            }
+                        });
+                    }
+                }
+            });
+            // 从 ObjectBindingTrack 中提取 playableAssets
+            const objectTrackClips = objectTrack.clips;
+            if (objectTrackClips) {
+                objectTrackClips.forEach(clip => {
+                    if (clip.asset?.id) {
+                        miscIds.add(clip.asset.id);
+                        const asset = scene.miscs.find(m => m.id === clip.asset.id);
+                        if (asset) {
+                            extractedMiscs.push({ ...asset });
+                        }
+                    }
+                });
+            }
+        }
+    });
+    // 9. 按需提取其他资源 (shaders, materials, geometries, animations)
+    // 这些需要根据实际使用情况进行收集，这里先保留空数组
+    const extractedShaders = scene.shaders?.filter(s => shaderIds.has(s.id)) || [];
+    const extractedMaterials = scene.materials?.filter(m => materialIds.has(m.id)) || [];
+    const extractedGeometries = scene.geometries?.filter(g => geometryIds.has(g.id)) || [];
+    const extractedAnimations = scene.animations?.filter(a => animationIds.has(a.id)) || [];
+    // 10. 构建新的 JSONScene
+    const newScene = {
+        version: spec.JSONSceneVersion['3_6'],
+        playerVersion: { ...scene.playerVersion },
+        type: scene.type,
+        compositionId: refId,
+        compositions: [{ ...compositionData }],
+        items: extractedItems.map(item => ({ ...item })),
+        components: extractedComponents.map(comp => ({ ...comp })),
+        miscs: extractedMiscs,
+        images: extractedImages.map(img => ({ ...img })),
+        textures: extractedTextures,
+        videos: extractedVideos,
+        shaders: extractedShaders,
+        materials: extractedMaterials,
+        geometries: extractedGeometries,
+        animations: extractedAnimations,
+        plugins: scene.plugins ? [...scene.plugins] : [],
+        bins: scene.bins ? [...scene.bins] : [],
+    };
+    return newScene;
+}
+export function fixStandardJSON(scene) {
+    const compositionComponents = scene.components.filter(component => component.dataType === spec.DataType.CompositionComponent);
+    compositionComponents.forEach(compositionComponent => {
+        if (!compositionComponent.items) {
+            compositionComponent.items ??= [];
+            const composition = scene.compositions.find(comp => comp.id === compositionComponent.item.id);
+            if (composition && 'items' in composition && composition?.items) {
+                compositionComponent.items.push(...composition.items);
+                delete composition.items;
+            }
+        }
+    });
+}