跳转到内容

签名关联类型:Woohaa3CanvasJsonPrimitive – WorldAuthoringHistoryOutcome

本页由当前 SDK 声明自动生成。

返回接口索引

Woohaa3CanvasJsonPrimitive · Woohaa3CanvasJsonValue · Woohaa3CanvasMention · Woohaa3CanvasMentionType · Woohaa3CanvasNode · Woohaa3CanvasNodeData · Woohaa3CanvasNodeDataMap · Woohaa3CanvasNodeType · Woohaa3CanvasPosition · Woohaa3CanvasSchemaVersion · Woohaa3CanvasSerializedNode · Woohaa3CanvasViewport · WorkDiagnosticResult · WorldAnimationSamplingContext · WorldAnimationScript · WorldAnimationState · WorldAuthoringConflict · WorldAuthoringEdgeSnapshot · WorldAuthoringExecuteInput · WorldAuthoringExecuteOutcome · WorldAuthoringFailure · WorldAuthoringFailureCode · WorldAuthoringHistoryInput · WorldAuthoringHistoryOutcome

Woohaa3CanvasJsonPrimitive

export type Woohaa3CanvasJsonPrimitive = string | number | boolean | null;

Woohaa3CanvasJsonValue

export type Woohaa3CanvasJsonValue = Woohaa3CanvasJsonPrimitive | Woohaa3CanvasJsonValue[] | Woohaa3CanvasJsonObject;

关联类型:Woohaa3CanvasJsonPrimitive · Woohaa3CanvasJsonObject

Woohaa3CanvasMention

解析出的规范 mention。

export type Woohaa3CanvasMention = {
type: Woohaa3CanvasMentionType;
slotId: string;
label: string;
};

关联类型:Woohaa3CanvasMentionType

Woohaa3CanvasMentionType

首版支持的 mention 类型。

export type Woohaa3CanvasMentionType = "input_image" | "input_video" | "input_audio" | "input_text";

Woohaa3CanvasNode

export type Woohaa3CanvasNode = {
id: string;
type: string;
position?: Woohaa3CanvasPosition;
width?: number;
height?: number;
parentId?: string;
zIndex?: number;
data: Woohaa3CanvasNodeData;
};

关联类型:Woohaa3CanvasPosition · Woohaa3CanvasNodeData

成员说明:

  • position:2D 卡片布局;导演区与共享世界模型没有卡片,省略。
  • zIndex:Explicit stacking order. Missing values retain legacy array-order behavior.

Woohaa3CanvasNodeData

渲染器中立的运行时节点。XYFlow 的 selected、dragging、measured、style 等瞬态字段 只允许存在于 renderer adapter 的投影节点中。data 仅为渲染器适配保留的空对象: core、图能力和插件不得在此读取或写入业务字段;业务数据必须经宿主 node-data context 按 node id 显式提供。

export type Woohaa3CanvasNodeData = Record<string, never>;

Woohaa3CanvasNodeDataMap

由宿主保存、节点实现自行解释的业务数据。

export type Woohaa3CanvasNodeDataMap<TNodeData extends Woohaa3CanvasJsonObject = Woohaa3CanvasJsonObject> = Record<string, TNodeData>;

关联类型:Woohaa3CanvasJsonObject

Woohaa3CanvasNodeType

export type Woohaa3CanvasNodeType = string;

Woohaa3CanvasPosition

export type Woohaa3CanvasPosition = {
x: number;
y: number;
};

Woohaa3CanvasSchemaVersion

export type Woohaa3CanvasSchemaVersion = typeof woohaa3CanvasSchemaVersion;

Woohaa3CanvasSerializedNode

持久化的结构节点。节点业务数据由宿主单独存储在 Woohaa3CanvasNodeDataMap; core document 不承载、解释或迁移任何 node.data 业务语义。

export type Woohaa3CanvasSerializedNode = {
id: string;
type: Woohaa3CanvasNodeType;
position?: Woohaa3CanvasPosition;
width?: number;
height?: number;
parentId?: string;
zIndex?: number;
};

关联类型:Woohaa3CanvasNodeType · Woohaa3CanvasPosition

成员说明:

  • position:2D 卡片布局;导演区与共享世界模型没有卡片,序列化时省略。

Woohaa3CanvasViewport

视口是各浏览器本地状态,不属于规范画布(不同步、不持久化)。 这里只保留其形状与缩放钳制,供前端本地视口与命中测试使用。

export type Woohaa3CanvasViewport = Woohaa3CanvasPosition & {
zoom: number;
};

关联类型:Woohaa3CanvasPosition

WorkDiagnosticResult

export type WorkDiagnosticResult = {
value: Record<string, unknown> | null;
reason: string | null;
};

WorldAnimationSamplingContext

在 time 秒采样动画 IR;未命中的部件不产生覆盖。 Position 值是脚本里的相对 u/v 偏移(h 为绝对高度),需要世界位置时用 sampleWorldAnimationInArea 加上导演区 origin。

export type WorldAnimationSamplingContext = {
resolveSomaMotion: (track: WorldSomaClipTrack) => PreparedSomaMotion | undefined;
};

关联类型:WorldSomaClipTrack · PreparedSomaMotion

WorldAnimationScript

export type WorldAnimationScript = {
script: string;
scriptLanguage: typeof WORLD_ANIMATION_SCRIPT_LANGUAGE;
scriptVersion: typeof WORLD_ANIMATION_SCRIPT_VERSION;
revision: number;
sourceHash: string;
duration: number;
loop: boolean;
};

WorldAnimationState

export type WorldAnimationState = {
nodeId: string | null;
time: number;
duration: number;
playing: boolean;
loop: boolean;
};

WorldAuthoringConflict

Occupying run reported by a lease conflict; the target and run identity stay visible.

export interface WorldAuthoringConflict {
target: WorldObjectIdentity;
version: string | null;
runId: string;
epoch: number;
}

关联类型:WorldObjectIdentity

成员说明:

  • version:Current target version when the rejecting authority could read it; null if unknown.

WorldAuthoringEdgeSnapshot

One frozen edge removed together with a node; re-added by undo after its endpoints.

export interface WorldAuthoringEdgeSnapshot {
id: string;
source: string;
target: string;
sourceHandle: string | null;
targetHandle: string | null;
data: Woohaa3CanvasJsonObject;
}

关联类型:Woohaa3CanvasJsonObject

WorldAuthoringExecuteInput

export interface WorldAuthoringExecuteInput {
canvasId: string;
request: SceneAreaPlanRequest;
contextId?: string;
actorId?: string;
operationId?: string;
}

关联类型:SceneAreaPlanRequest

成员说明:

  • request:Pure OC04 request frozen by the caller from a prepared snapshot.
  • contextId:Omit for an ordinary user write; then occupancy is checked without a grant.

WorldAuthoringExecuteOutcome

export type WorldAuthoringExecuteOutcome = {
ok: true;
canvasId: string;
operationId: string;
commandId: string;
revision: number;
duplicate: boolean;
plan: SceneAreaPlan;
receipt: WorldAuthoringReceipt;
} | WorldAuthoringFailure;

关联类型:SceneAreaPlan · WorldAuthoringReceipt · WorldAuthoringFailure

WorldAuthoringFailure

export interface WorldAuthoringFailure {
ok: false;
code: WorldAuthoringFailureCode;
message: string;
conflicts?: WorldAuthoringConflict[];
spatialReason?: string;
spatialDiagnostic?: {
areaId?: string;
actual?: GroundAabb;
bounds?: GroundAabb;
anchor?: {
u: number;
v: number;
};
outsideAxes?: Array<"u" | "v">;
};
}

关联类型:WorldAuthoringFailureCode · WorldAuthoringConflict · GroundAabb

成员说明:

  • spatialDiagnostic:Actionable out-of-scope geometry the authority actually read: the classified footprint/anchor, the authorized bounds and the axes that overflowed. Only present when the authority could read the offending geometry.

WorldAuthoringFailureCode

export type WorldAuthoringFailureCode = "invalid-data" | "not-ready" | "outside-scope" | "version-conflict" | "operation-conflict" | "lease-conflict" | "stale-epoch" | "cancelled" | "not-found" | "unsupported-version" | "spatial-rejected" | "write-forbidden";

WorldAuthoringHistoryInput

export interface WorldAuthoringHistoryInput {
canvasId: string;
operationId: string;
contextId?: string;
actorId?: string;
}

WorldAuthoringHistoryOutcome

export type WorldAuthoringHistoryOutcome = {
ok: true;
canvasId: string;
operationId: string;
commandId: string;
revision: number;
duplicate: boolean;
direction: "undo" | "redo";
plan: SceneAreaPlan;
receipt: WorldAuthoringReceipt;
} | WorldAuthoringFailure;

关联类型:SceneAreaPlan · WorldAuthoringReceipt · WorldAuthoringFailure