@vvfx/sdk 0.1.14-alpha.3 → 0.1.14-alpha.5

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _galacean_effects from '@galacean/effects';
-import { spec, VFXItem, math, Player } from '@galacean/effects';
+import { spec, math, Player } from '@galacean/effects';
 export { generateGUID, spec } from '@galacean/effects';
 import { Point } from '@pixi/constants';
 
@@ -32,6 +32,10 @@ type SDKItemOptions = {
      * @description 元素生命周期延时
      */
     delay?: number;
+    /**
+     * @description 可视状态
+     */
+    visible?: boolean;
     /**
      * @description 元素结束行为
      */
@@ -56,7 +60,7 @@ type SpriteItemOptions = SDKItemOptions & {
     /**
      * @description 元素属性
      */
-    property?: Partial<SpriteFormProperty>;
+    property?: Partial<SpriteItemProperty>;
 };
 /**
  * @description Text SDKItem 选项
@@ -65,7 +69,7 @@ type TextItemOptions = SDKItemOptions & {
     /**
      * @description 元素属性
      */
-    property?: Partial<TextFormProperty>;
+    property?: Partial<TextItemProperty>;
 };
 /**
  * @description Video SDKItem 选项
@@ -74,40 +78,44 @@ type VideoItemOptions = SDKItemOptions & {
     /**
      * @description 元素属性
      */
-    property?: Partial<VideoFormProperty>;
+    property?: Partial<VideoItemProperty>;
 };
 /**
- * @description Null SDKItem 选项（空节点/组）
+ * @description Group SDKItem 选项（空节点/组）
  */
-type NullItemOptions = SDKItemOptions & {
+type GroupItemOptions = SDKItemOptions & {
     /**
      * @description 元素属性
      */
-    property?: Partial<BaseFormProperty>;
+    property?: Partial<GroupItemProperty>;
 };
 /**
  * @description Generator SDKItem 选项（资源生成器）
  * @description 支持 image 和 video 两种生成器类型
- * @description 复用 SpriteFormProperty 作为底层渲染
+ * @description 使用 GeneratorItemProperty 包含 generatorType
  */
 type GeneratorItemOptions = SDKItemOptions & {
     /**
-     * @description 生成器类型
-     */
-    generatorType: GeneratorType;
-    /**
-     * @description 元素属性
+     * @description 元素属性（包含 generatorType）
      */
-    property?: Partial<SpriteFormProperty>;
+    property?: Partial<GeneratorItemProperty>;
 };
 type EffectsItemOptions = SDKItemOptions & {
-    property?: Partial<EffectsFormProperty>;
+    property?: Partial<EffectsItemProperty>;
 };
 /**
  * @description SDKItem 类型（独立于 spec.ItemType）
  * @description 包含所有 SDK 层级的元素类型，包括虚拟类型如 generator
  */
-type SDKItemType = 'sprite' | 'text' | 'video' | 'null' | 'generator' | 'effects' | 'frame';
+declare enum SDKItemType {
+    Sprite = "sprite",
+    Text = "text",
+    Video = "video",
+    Group = "group",
+    Generator = "generator",
+    Effects = "effects",
+    Frame = "frame"
+}
 
 /**
  * @description SDKItem 抽象基类
@@ -126,10 +134,6 @@ declare abstract class BaseItem {
      * @description 父节点ID
      */
     parentId?: string;
-    /**
-     * @description 子元素ID列表
-     */
-    children: string[];
     /**
      * @description 元素生命周期
      */
@@ -142,23 +146,27 @@ declare abstract class BaseItem {
      * @description 元素结束行为
      */
     endBehavior: spec.EndBehavior;
+    /**
+     * @description 是否可见
+     */
+    visible: boolean;
     /**
      * @description 是否处于锁定状态
      */
     isLocked: boolean;
     /**
-     * @description 扩展属性存储（私有）
+     * @description 扩展属性存储（与 property 同级）
      */
     private _extensions;
     /**
      * @description 元素类型（由子类实现）
-     * @description 支持 spec.ItemType 或扩展的 SDKItemType（如 'video-generator'）
+     * @description 支持 spec.ItemType 或扩展的 SDKItemType
      */
-    abstract readonly type: spec.ItemType | SDKItemType;
+    abstract readonly type: SDKItemType;
     /**
      * @description 元素属性（由子类实现）
      */
-    abstract readonly property: BaseFormProperty;
+    abstract readonly property: BaseItemProperty;
     constructor(options: SDKItemOptions);
     /**
      * @description 设置扩展属性
@@ -193,7 +201,7 @@ declare abstract class BaseItem {
      * @description 获取所有扩展属性
      * @returns 扩展属性对象
      */
-    getAllExtensions(): Record<string, any>;
+    getExtensions(): Record<string, any>;
     /**
      * @description 批量设置扩展属性
      * @param extensions 扩展属性对象
@@ -235,11 +243,11 @@ declare class SpriteItem extends BaseItem {
     /**
      * @description 元素类型
      */
-    readonly type = spec.ItemType.sprite;
+    readonly type = SDKItemType.Sprite;
     /**
      * @description 元素属性
      */
-    property: SpriteFormProperty;
+    property: SpriteItemProperty;
     constructor(options: SpriteItemOptions);
     /**
      * @description 图片地址
@@ -266,11 +274,6 @@ declare class SpriteItem extends BaseItem {
      */
     get fullRotation(): [number, number, number];
     set fullRotation(value: [number, number, number]);
-    /**
-     * @description 可见性
-     */
-    get visible(): boolean;
-    set visible(value: boolean);
     /**
      * @description 是否正在编辑关键属性
      */
@@ -305,11 +308,11 @@ declare class TextItem extends BaseItem {
     /**
      * @description 元素类型
      */
-    readonly type = spec.ItemType.text;
+    readonly type = SDKItemType.Text;
     /**
      * @description 元素属性
      */
-    property: TextFormProperty;
+    property: TextItemProperty;
     constructor(options: TextItemOptions);
     /**
      * @description 文本内容
@@ -344,8 +347,8 @@ declare class TextItem extends BaseItem {
     /**
      * @description 文本颜色 [r, g, b, a]
      */
-    get textColor(): [number, number, number, number];
-    set textColor(value: [number, number, number, number]);
+    get color(): [number, number, number, number];
+    set color(value: [number, number, number, number]);
     /**
      * @description 文本宽度
      */
@@ -386,11 +389,6 @@ declare class TextItem extends BaseItem {
      */
     get rotation(): number;
     set rotation(value: number);
-    /**
-     * @description 可见性
-     */
-    get visible(): boolean;
-    set visible(value: boolean);
     /**
      * @description 转换为 CreateInfo
      * @param withParent 是否包含父节点ID
@@ -414,11 +412,11 @@ declare class VideoItem extends BaseItem {
     /**
      * @description 元素类型
      */
-    readonly type = spec.ItemType.video;
+    readonly type = SDKItemType.Video;
     /**
      * @description 元素属性
      */
-    property: VideoFormProperty;
+    property: VideoItemProperty;
     constructor(options: VideoItemOptions);
     /**
      * @description 视频地址
@@ -445,16 +443,31 @@ declare class VideoItem extends BaseItem {
      */
     get fullRotation(): [number, number, number];
     set fullRotation(value: [number, number, number]);
-    /**
-     * @description 可见性
-     */
-    get visible(): boolean;
-    set visible(value: boolean);
     /**
      * @description 是否正在编辑关键属性
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
+    /**
+     * @description 是否静音
+     */
+    get muted(): boolean;
+    set muted(state: boolean);
+    /**
+     * @description 是否为透明视频
+     */
+    get transparent(): boolean;
+    set transparent(state: boolean);
+    /**
+     * @description 播放音量
+     */
+    get volume(): number;
+    set volume(value: number);
+    /**
+     * @description 播放速率
+     */
+    get playbackRate(): number;
+    set playbackRate(value: number);
     /**
      * @description 转换为 CreateInfo
      * @param withParent 是否包含父节点ID
@@ -474,16 +487,16 @@ declare function isVideoItem(obj: any): obj is VideoItem;
  * @description 空节点/组 SDKItem 类
  * @description 支持属性扩展
  */
-declare class NullItem extends BaseItem {
+declare class GroupItem extends BaseItem {
     /**
      * @description 元素类型
      */
-    readonly type = spec.ItemType.null;
+    readonly type = SDKItemType.Group;
     /**
      * @description 元素属性
      */
-    property: BaseFormProperty;
-    constructor(options: NullItemOptions);
+    property: GroupItemProperty;
+    constructor(options: GroupItemOptions);
     /**
      * @description 位置
      */
@@ -494,6 +507,11 @@ declare class NullItem extends BaseItem {
      */
     get size(): [number, number];
     set size(value: [number, number]);
+    /**
+     * @description 大小
+     */
+    get scale(): [number, number];
+    set scale(value: [number, number]);
     /**
      * @description 旋转（二维旋转角度）
      */
@@ -504,38 +522,25 @@ declare class NullItem extends BaseItem {
      */
     get fullRotation(): [number, number, number];
     set fullRotation(value: [number, number, number]);
-    /**
-     * @description 可见性
-     */
-    get visible(): boolean;
-    set visible(value: boolean);
     /**
      * @description 是否正在编辑关键属性
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
-    /**
-     * @description 计算缩放（基于子元素）
-     */
-    get scaleForCreateInfo(): [number, number];
-    /**
-     * @description 设置缩放（存储在扩展属性中）
-     */
-    set scaleForCreateInfo(value: [number, number]);
     /**
      * @description 转换为 CreateInfo
      * @param withParent 是否包含父节点ID
      */
-    toCreateInfo(withParent?: boolean): NullCreateInfo;
+    toCreateInfo(withParent?: boolean): GroupCreateInfo;
     /**
      * @description 克隆 SDKItem
      */
-    clone(): NullItem;
+    clone(): GroupItem;
 }
 /**
- * @description 类型守卫：检查是否是 NullItem
+ * @description 类型守卫：检查是否是 GroupItem
  */
-declare function isNullItem(obj: any): obj is NullItem;
+declare function isGroupItem(obj: any): obj is GroupItem;
 
 /**
  * @description 资源生成器元素 SDKItem 类
@@ -547,16 +552,17 @@ declare class GeneratorItem extends BaseItem {
     /**
      * @description 元素类型（独立类型，不属于 spec.ItemType）
      */
-    readonly type: SDKItemType;
+    readonly type = SDKItemType.Generator;
     /**
-     * @description 生成器类型
+     * @description 元素属性（包含 generatorType）
      */
-    generatorType: GeneratorType;
+    property: GeneratorItemProperty;
+    constructor(options: GeneratorItemOptions);
     /**
-     * @description 元素属性
+     * @description 生成器类型
      */
-    property: SpriteFormProperty;
-    constructor(options: GeneratorItemOptions);
+    get generatorType(): 'image' | 'video';
+    set generatorType(value: 'image' | 'video');
     /**
      * @description 图片地址（生成器返回空）
      */
@@ -582,11 +588,6 @@ declare class GeneratorItem extends BaseItem {
      */
     get fullRotation(): [number, number, number];
     set fullRotation(value: [number, number, number]);
-    /**
-     * @description 可见性
-     */
-    get visible(): boolean;
-    set visible(value: boolean);
     /**
      * @description 是否正在编辑关键属性
      */
@@ -626,11 +627,11 @@ declare class EffectsItem extends BaseItem {
     /**
      * @description 元素类型（独立类型，不属于 spec.ItemType）
      */
-    readonly type: SDKItemType;
+    readonly type = SDKItemType.Effects;
     /**
      * @description 元素属性
      */
-    property: EffectsFormProperty;
+    property: EffectsItemProperty;
     constructor(options: EffectsItemOptions);
     /**
      * @description 特效资源地址
@@ -657,11 +658,6 @@ declare class EffectsItem extends BaseItem {
      */
     get fullRotation(): [number, number, number];
     set fullRotation(value: [number, number, number]);
-    /**
-     * @description 可见性
-     */
-    get visible(): boolean;
-    set visible(value: boolean);
     /**
      * @description 是否正在编辑关键属性
      */
@@ -689,20 +685,11 @@ declare function isEffectsItem(obj: any): obj is EffectsItem;
  * @returns SDKItem 实例
  */
 declare function createSDKItem(type: spec.ItemType, options: SDKItemOptions): BaseItem;
-/**
- * @description 从 Player Item 创建 SDKItem
- * @param playerItem VFXItem
- * @param parentId 父节点ID
- * @param property 属性对象
- * @param generatorType 生成器类型（如果是生成器元素）
- * @returns SDKItem 实例
- */
-declare function createSDKItemFromPlayerItem(playerItem: VFXItem, parentId: string | undefined, property: Record<string, any>, generatorType?: GeneratorType): BaseItem;
 /**
  * @description SDKItem 类型联合
  * @description 用于替换原来的 SDKItem type
  */
-type SDKItem$1 = SpriteItem | TextItem | VideoItem | NullItem | GeneratorItem;
+type SDKItem$1 = SpriteItem | TextItem | VideoItem | GroupItem | GeneratorItem;
 
 type ViewItemTypedProperty = {
     [K in keyof PageFormTypeAndPropertyReference]: {
@@ -748,7 +735,7 @@ type SetItemPropertyValueParam = {
     }[keyof PageFormTypeAndPropertyReference[T]];
 }[keyof PageFormTypeAndPropertyReference] | {
     itemId: string;
-    type: spec.ItemType;
+    type: SDKItemType | spec.ItemType;
     propertyName: 'position' | 'size';
     propertyValue: spec.vec2 | spec.vec3;
 };
@@ -1510,7 +1497,7 @@ type TransformGizmoConfig = {
     /**
      * @description 空节点Logo地址
      */
-    nullLogoUrl: string;
+    groupLogoUrl: string;
     /**
      * @description 文本Logo地址
      */
@@ -2247,11 +2234,12 @@ declare class SDK {
      * @description 元素打组
      * @param children 子元素ID
      */
-    groupItems(nullInfo: NullCreateInfo, scene?: spec.JSONScene): string | undefined;
+    groupItems(groupInfo: GroupCreateInfo, scene?: spec.JSONScene): string | undefined;
     addTextItem(textInfo: TextCreateInfo, scene?: spec.JSONScene): Promise<string | undefined>;
     addItemByCreateInfos(createInfos: ItemCreateInfo[], asyncMode?: boolean): Promise<(string | undefined)[]>;
     deleteItems(idInfo: string | string[]): void;
-    getItemCreateInfo(idInfo: string | string[]): ItemCreateInfo[];
+    getItemCreateInfo(idInfo: string): ItemCreateInfo | undefined;
+    getItemCreateInfo(idInfo: string[]): ItemCreateInfo[];
     createScreenShotSceneByIds(idInfo: string | string[], time?: number): Promise<string | undefined>;
     getChildrenIds(id: string): string[];
     /**
@@ -2401,21 +2389,23 @@ declare class SDK {
 
 type SizeAdaptDirection = 'x' | 'y';
 
-type BaseFormProperty = {
+type BaseItemProperty = {
     position: [number, number];
     rotation: [number, number, number];
     size: [number, number];
     scale: [number, number];
-    visible: boolean;
-    isLocked?: boolean;
+    visible?: boolean;
     keyPropertyEditing: boolean;
 };
-type SpriteFormProperty = BaseFormProperty & {
+type SpriteItemProperty = BaseItemProperty & {
     image: string;
 };
-type TextFormProperty = BaseFormProperty & {
+type GroupItemProperty = BaseItemProperty & {
+    children: string[];
+};
+type TextItemProperty = BaseItemProperty & {
     fontFamily: string;
-    textColor: [number, number, number, number];
+    color: [number, number, number, number];
     fontWeight: spec.TextWeight;
     text: string;
     textAlign: spec.TextAlignment;
@@ -2430,38 +2420,70 @@ type TextFormProperty = BaseFormProperty & {
      * @description 描边开关
      */
     outlineEnabled?: boolean;
+    fontUrl?: string;
 };
-type VideoFormProperty = BaseFormProperty & {
+type VideoItemProperty = BaseItemProperty & {
     video: string;
+    /**
+   * @description 是否静音
+   */
+    muted?: boolean;
+    /**
+     * @description 是否为透明视频
+     */
+    transparent?: boolean;
+    /**
+     * @description 播放速率
+     */
+    playbackRate?: number;
+    /**
+     * @description 音量
+     */
+    volume?: number;
+};
+/**
+ * @description Generator 表单属性
+ */
+type GeneratorItemProperty = BaseItemProperty & {
+    /**
+     * @description 生成器类型
+     */
+    generatorType: 'image' | 'video';
 };
-type EffectsFormProperty = BaseFormProperty & {
+type EffectsItemProperty = BaseItemProperty & {
     effects: string;
 };
 /**
  * @description 页面表单类型和属性引用
  */
 type PageFormTypeAndPropertyReference = {
-    [spec.ItemType.base]: BaseFormProperty;
-    [spec.ItemType.sprite]: SpriteFormProperty;
-    [spec.ItemType.particle]: BaseFormProperty;
-    [spec.ItemType.null]: BaseFormProperty;
-    [spec.ItemType.interact]: BaseFormProperty;
-    [spec.ItemType.plugin]: BaseFormProperty;
-    [spec.ItemType.camera]: BaseFormProperty;
-    [spec.ItemType.composition]: BaseFormProperty;
-    [spec.ItemType.spine]: BaseFormProperty;
-    [spec.ItemType.mesh]: BaseFormProperty;
-    [spec.ItemType.tree]: BaseFormProperty;
-    [spec.ItemType.text]: TextFormProperty;
-    [spec.ItemType.light]: BaseFormProperty;
-    [spec.ItemType.skybox]: BaseFormProperty;
-    [spec.ItemType.effect]: BaseFormProperty;
-    [spec.ItemType.shape]: BaseFormProperty;
-    [spec.ItemType.postProcessVolume]: BaseFormProperty;
-    [spec.ItemType.node]: BaseFormProperty;
-    [spec.ItemType.video]: VideoFormProperty;
-    [spec.ItemType.audio]: BaseFormProperty;
-    [spec.ItemType.richtext]: TextFormProperty;
+    [spec.ItemType.base]: BaseItemProperty;
+    [spec.ItemType.sprite]: SpriteItemProperty;
+    [spec.ItemType.null]: BaseItemProperty;
+    [SDKItemType.Sprite]: SpriteItemProperty;
+    [SDKItemType.Text]: TextItemProperty;
+    [SDKItemType.Video]: VideoItemProperty;
+    [SDKItemType.Group]: GroupItemProperty;
+    [SDKItemType.Generator]: GeneratorItemProperty;
+    [SDKItemType.Effects]: EffectsItemProperty;
+    [SDKItemType.Frame]: BaseItemProperty;
+    [spec.ItemType.interact]: BaseItemProperty;
+    [spec.ItemType.plugin]: BaseItemProperty;
+    [spec.ItemType.camera]: BaseItemProperty;
+    [spec.ItemType.composition]: BaseItemProperty;
+    [spec.ItemType.spine]: BaseItemProperty;
+    [spec.ItemType.mesh]: BaseItemProperty;
+    [spec.ItemType.tree]: BaseItemProperty;
+    [spec.ItemType.text]: TextItemProperty;
+    [spec.ItemType.light]: BaseItemProperty;
+    [spec.ItemType.skybox]: BaseItemProperty;
+    [spec.ItemType.effect]: BaseItemProperty;
+    [spec.ItemType.shape]: BaseItemProperty;
+    [spec.ItemType.postProcessVolume]: BaseItemProperty;
+    [spec.ItemType.node]: BaseItemProperty;
+    [spec.ItemType.video]: VideoItemProperty;
+    [spec.ItemType.audio]: BaseItemProperty;
+    [spec.ItemType.richtext]: TextItemProperty;
 };
 type SpecificPageFormProps<T extends keyof PageFormTypeAndPropertyReference> = {
     type: T;
@@ -2721,7 +2743,7 @@ type SDKBackgroundType = 'color' | 'image' | 'chess-board' | 'dot-board';
  * @description 图层创建信息
  */
 type SpriteCreateInfo = {
-    type: 'sprite';
+    type: SDKItemType.Sprite;
     /**
      * @description 图层名称
      */
@@ -2734,36 +2756,41 @@ type SpriteCreateInfo = {
      * @description 父节点id
      */
     parentId?: string;
-    /**
-     * @description 图片资源地址
-     */
-    url: string;
-    /**
-     * @description 图层元素像素大小
-     */
-    size: spec.vec2;
-    /**
-     * @description 图层元素缩放
-     */
-    scale?: spec.vec2;
-    /**
-     * @description 图层元素旋转
-     */
-    rotation?: number;
-    /**
-     * @description 图层元素二维位置
-     */
-    position: spec.vec2;
     /**
      * @description 扩展属性
      */
     extensions?: Record<string, any>;
+    /**
+     * @description 元素属性
+     */
+    property: {
+        /**
+         * @description 图片资源地址 | 数据
+         */
+        image: string;
+        /**
+         * @description 元素像素大小
+         */
+        size: [number, number];
+        /**
+         * @description 元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 元素缩放
+         */
+        scale?: [number, number];
+    };
 };
 /**
  * @description 空节点创建信息
  */
-type NullCreateInfo = {
-    type: 'null';
+type GroupCreateInfo = {
+    type: SDKItemType.Group;
     /**
      * @description 元素id
      */
@@ -2776,32 +2803,37 @@ type NullCreateInfo = {
      * @description 元素名称
      */
     name?: string;
-    /**
-     * @description 空节点缩放
-     */
-    scale?: spec.vec2;
-    /**
-     * @description 子元素id
-     */
-    children: string[];
-    /**
-     * @description 空节点旋转
-     */
-    rotation?: number;
-    /**
-     * @description 空节点位移
-     */
-    position?: spec.vec2;
     /**
      * @description 扩展属性
      */
     extensions?: Record<string, any>;
+    /**
+     * @description 元素属性
+     */
+    property: {
+        /**
+         * @description 元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 元素缩放
+         */
+        scale?: [number, number];
+        /**
+         * @description 子元素id
+         */
+        children: string[];
+    };
 };
 /**
  * @description 文本创建信息
  */
 type TextCreateInfo = {
-    type: 'text';
+    type: SDKItemType.Text;
     /**
      * @description 元素id
      */
@@ -2815,79 +2847,84 @@ type TextCreateInfo = {
      */
     name?: string;
     /**
-     * @description 单行高度
-     */
-    lineHeight: number;
-    /**
-     * @description 文本高度
-     */
-    textHeight?: number;
-    /**
-     * @description 宽度
-     */
-    textWidth: number;
-    /**
-     * @description 字体名称
-     */
-    fontFamily: string;
-    /**
-     * @description 文本位置
-     */
-    position?: spec.vec2;
-    /**
-     * @description 文本旋转
-     */
-    rotation?: number;
-    /**
-     * @description 文字大小
-     */
-    fontSize: number;
-    /**
-     * @description 字重
-     */
-    fontWeight?: spec.TextWeight;
-    /**
-     * @description 字体格式
-     */
-    fontStyle?: spec.FontStyle;
-    /**
-     * @description 对齐方式
-     */
-    textAlign?: spec.TextAlignment;
-    /**
-     * @description 文本信息
-     */
-    text: string;
-    /**
-     * @description 填充色
-     */
-    textColor: spec.vec4;
-    /**
-     * @description 描边色
-     */
-    outlineColor?: spec.vec4;
-    /**
-     * @description 描边宽度
-     */
-    outlineWidth?: number;
-    /**
-     * @description 描边开关
+     * @description 扩展属性
      */
-    outlineEnabled?: boolean;
+    extensions?: Record<string, any>;
     /**
-     * @description 字体文件地址
+     * @description 元素属性
      */
-    url?: string;
-    /**
-     * @description 扩展属性
+    property: {
+        /**
+     * @description 文本宽高
      */
-    extensions?: Record<string, any>;
+        size: [number, number];
+        /**
+         * @description 元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 元素缩放
+         */
+        scale?: [number, number];
+        /**
+         * @description 单行高度
+         */
+        lineHeight: number;
+        /**
+         * @description 字体名称
+         */
+        fontFamily: string;
+        /**
+         * @description 文字大小
+         */
+        fontSize: number;
+        /**
+         * @description 字重
+         */
+        fontWeight?: spec.TextWeight;
+        /**
+         * @description 字体格式
+         */
+        fontStyle?: spec.FontStyle;
+        /**
+         * @description 对齐方式
+         */
+        textAlign?: spec.TextAlignment;
+        /**
+         * @description 文本信息
+         */
+        text: string;
+        /**
+         * @description 填充色
+         */
+        color: spec.vec4;
+        /**
+         * @description 描边色
+         */
+        outlineColor?: spec.vec4;
+        /**
+         * @description 描边宽度
+         */
+        outlineWidth?: number;
+        /**
+         * @description 描边开关
+         */
+        outlineEnabled?: boolean;
+        /**
+         * @description 字体文件地址
+         */
+        fontUrl?: string;
+    };
 };
 /**
  * @description 视频创建信息
  */
 type VideoCreateInfo = {
-    type: 'video';
+    type: SDKItemType.Video;
     /**
      * @description 视频名称
      */
@@ -2900,46 +2937,51 @@ type VideoCreateInfo = {
      * @description 父节点id
      */
     parentId?: string;
-    /**
-     * @description 视频资源地址
-     */
-    url: string;
-    /**
-     * @description 视频元素像素大小
-     */
-    size: spec.vec2;
-    /**
-     * @description 视频元素缩放
-     */
-    scale?: spec.vec2;
-    /**
-     * @description 视频元素旋转
-     */
-    rotation?: number;
-    /**
-     * @description 视频元素二维位置
-     */
-    position: spec.vec2;
-    /**
-     * @description 是否静音
-     */
-    muted?: boolean;
-    /**
-     * @description 是否为透明视频
-     */
-    transparent?: boolean;
-    /**
-     * @description 播放速率
-     */
-    playbackRate?: number;
-    /**
-     * @description 音量
-     */
-    volume?: number;
     /**
      * @description 扩展属性
      */
     extensions?: Record<string, any>;
+    /**
+     * @description 元素属性
+     */
+    property: {
+        /**
+         * @description 视频资源地址 | 数据
+         */
+        video: string;
+        /**
+         * @description 视频元素像素大小
+         */
+        size: [number, number];
+        /**
+         * @description 视频元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 视频元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 视频元素缩放
+         */
+        scale?: [number, number];
+        /**
+         * @description 是否静音
+         */
+        muted?: boolean;
+        /**
+         * @description 是否为透明视频
+         */
+        transparent?: boolean;
+        /**
+         * @description 播放速率
+         */
+        playbackRate?: number;
+        /**
+         * @description 音量
+         */
+        volume?: number;
+    };
 };
 /**
  * @description 生成器类型
@@ -2952,11 +2994,7 @@ type GeneratorCreateInfo = {
     /**
      * @description 元素类型 - 生成器
      */
-    type: 'generator';
-    /**
-     * @description 生成器类型
-     */
-    generatorType: GeneratorType;
+    type: SDKItemType.Generator;
     /**
      * @description 元素名称
      */
@@ -2969,29 +3007,38 @@ type GeneratorCreateInfo = {
      * @description 父元素id
      */
     parentId?: string;
-    /**
-     * @description 生成器大小
-     */
-    size: spec.vec2;
-    /**
-     * @description 生成器位置
-     */
-    position: spec.vec2;
-    /**
-     * @description 旋转角度
-     */
-    rotation?: number;
-    /**
-     * @description 缩放
-     */
-    scale?: spec.vec2;
     /**
      * @description 扩展属性
      */
     extensions?: Record<string, any>;
+    /**
+     * @description 元素属性
+     */
+    property: {
+        /**
+         * @description 生成器类型
+         */
+        generatorType: GeneratorType;
+        /**
+         * @description 生成器元素像素大小
+         */
+        size: [number, number];
+        /**
+         * @description 生成器元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 生成器元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 生成器元素缩放
+         */
+        scale?: [number, number];
+    };
 };
 /**
- * @description 生成器资源信息
+ * @description 图片生成器资源信息
  */
 type SpriteGeneratorResource = {
     /**
@@ -3011,10 +3058,13 @@ type SpriteGeneratorResource = {
      */
     extensions?: Record<string, any>;
 };
+/**
+ * @description 视频生成器资源信息
+ */
 type VideoGeneratorResource = {
     /**
-   * @description 资源地址
-   */
+     * @description 资源地址
+     */
     url: string;
     /**
      * @description 资源尺寸
@@ -3050,7 +3100,7 @@ type EffectsCreateInfo = {
     /**
      * @description 元素类型 - 特效
      */
-    type: 'effects';
+    type: SDKItemType.Effects;
     /**
      * @description 元素名称
      */
@@ -3063,32 +3113,34 @@ type EffectsCreateInfo = {
      * @description 父元素id
      */
     parentId?: string;
-    /**
-     * @description 生成器大小
-     */
-    size?: spec.vec2;
-    /**
-     * @description 生成器位置
-     */
-    position: spec.vec2;
-    /**
-     * @description 旋转角度
-     */
-    rotation?: number;
-    /**
-     * @description 缩放
-     */
-    scale?: spec.vec2;
-    /**
-     * @description 动效资源地址
-     */
-    url: string;
+    property: {
+        /**
+         * @description 生成器大小
+         */
+        size?: spec.vec2;
+        /**
+         * @description 生成器位置
+         */
+        position: spec.vec2;
+        /**
+         * @description 旋转角度
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 缩放
+         */
+        scale?: spec.vec2;
+        /**
+         * @description 动效资源地址
+         */
+        effects: string | spec.JSONScene;
+    };
     /**
      * @description 扩展属性
      */
     extensions?: Record<string, any>;
 };
-type ItemCreateInfo = NullCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo;
+type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo;
 /**
  * @description 场景创建信息
  */
@@ -3130,4 +3182,4 @@ type ViewportFitShiftParam = {
     bottom?: number;
 };
 
-export { type ActiveData, type BaseFormProperty, BaseItem, Box2, type CreateOperation, type DeleteOperation, type EffectsCreateInfo, EffectsItem, type EffectsItemOptions, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GizmoType, type ItemCreateInfo, ItemOrderAction, type NullCreateInfo, NullItem, type NullItemOptions, type Operation, type PageData, type PageFormTypedProperty, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem$1 as SDKItem, type SDKItemOptions, type SDKOptions, type SetItemPropertyValueParam, type SpecificPageFormProps, type SpriteCreateInfo, type SpriteFormProperty, SpriteItem, type SpriteItemOptions, type TextCreateInfo, type TextFormProperty, TextItem, type TextItemOptions, type UpdateOperation, Vector2, type VideoCreateInfo, type VideoFormProperty, VideoItem, type VideoItemOptions, type ViewItemTypedProperty, type ViewParam, type ViewProperty, createSDKItem, createSDKItemFromPlayerItem, isBaseItem, isEffectsItem, isGeneratorItem, isNullItem, isSpriteItem, isTextItem, isVideoItem };
+export { type ActiveData, BaseItem, type BaseItemProperty, Box2, type CreateOperation, type DeleteOperation, type EffectsCreateInfo, EffectsItem, type EffectsItemOptions, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GeneratorItemProperty, type GizmoType, type GroupCreateInfo, GroupItem, type GroupItemOptions, type ItemCreateInfo, ItemOrderAction, type Operation, type PageData, type PageFormTypedProperty, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem$1 as SDKItem, type SDKItemOptions, type SDKOptions, type SetItemPropertyValueParam, type SpecificPageFormProps, type SpriteCreateInfo, SpriteItem, type SpriteItemOptions, type SpriteItemProperty, type TextCreateInfo, TextItem, type TextItemOptions, type TextItemProperty, type UpdateOperation, Vector2, type VideoCreateInfo, VideoItem, type VideoItemOptions, type VideoItemProperty, type ViewItemTypedProperty, type ViewParam, type ViewProperty, createSDKItem, isBaseItem, isEffectsItem, isGeneratorItem, isGroupItem, isSpriteItem, isTextItem, isVideoItem };