跳转到内容

签名关联类型:ModelStaticPoseSummary – NativeImageResource

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

返回接口索引

ModelStaticPoseSummary · ModelTrack · ModelTrackProperty · MotionEasing · MotionIr · MotionIrVersion · NativeEditorCapabilities · NativeEditorCreate · NativeEditorDocument · NativeEditorError · NativeEditorErrorCode · NativeEditorInput · NativeEditorInputEvent · NativeEditorLayout · NativeEditorModifiers · NativeEditorOperation · NativeEditorPointerSample · NativeEditorProvider · NativeEditorReceipt · NativeEditorRequest · NativeEditorResult · NativeEditorSnapshot · NativeEditorState · NativeImageResource

ModelStaticPoseSummary

一份模型脚本声明的静态姿势摘要(供 world_model_pose 只读资源)。

export type ModelStaticPoseSummary = {
capability: typeof MODEL_STATIC_POSE_CAPABILITY;
poses: Array<{
groupId: string;
rotation?: Vec3;
position?: Vec3;
}>;
affectedJoints: string[];
geometry: ModelPoseGeometry;
verification: "sampled-data-only";
limitations: string[];
};

关联类型:Vec3 · ModelPoseGeometry

成员说明:

  • poses:已声明姿势的 group,按脚本声明顺序。
  • affectedJoints:受影响关节 id(与 group 同集合,便于助手核对真实关节名)。

ModelTrack

模型轨道:在 [startTime,endTime] 内作用于稳定 targetId。

export type ModelTrack = {
id: string;
targetId: string;
startTime: number;
endTime: number;
motion: ModelMotion;
};

关联类型:ModelMotion

ModelTrackProperty

模型轨道属性。

opacity 为透明度乘数: 只有 keyframes/tween 可以使用,值是 0..=1 的标量而不是三维向量。

export type ModelTrackProperty = "position" | "rotation" | "scale" | "opacity";

MotionEasing

export type MotionEasing = "linear" | "smoothstep" | "easeIn" | "easeOut" | "easeInOut";

MotionIr

export type MotionIr = {
version: MotionIrVersion;
cameraMotion: CameraTrack[];
modelMotion: ModelTrack[];
};

关联类型:MotionIrVersion · CameraTrack · ModelTrack

MotionIrVersion

export type MotionIrVersion = typeof MOTION_IR_VERSION;

NativeEditorCapabilities

export type NativeEditorCapabilities = {
providers: NativeEditorProvider[];
gpu_ready: boolean;
workspace_open: boolean;
};

关联类型:NativeEditorProvider

NativeEditorCreate

export type NativeEditorCreate = {
provider_id: string;
session_id: string;
generation: number;
project_protocol: number;
browser_protocol: number;
capabilities: string[];
physical_size: [
number,
number
];
scale_factor: number;
};

NativeEditorDocument

export type NativeEditorDocument = {
document_id: string;
source_id: string;
node_binding: string | null;
revision: number;
saved_revision: number;
source_size: [
number,
number
];
};

NativeEditorError

export type NativeEditorError = {
code: NativeEditorErrorCode;
message: string;
diagnostic_id?: string | null;
};

关联类型:NativeEditorErrorCode

NativeEditorErrorCode

Optional local desktop editor protocol. No native capability is implied by installation.

export type NativeEditorErrorCode = "unavailable" | "incompatible" | "unsupported" | "busy" | "stale-generation" | "stale-revision" | "budget-exceeded" | "device-lost" | "cancelled" | "internal-error";

NativeEditorInput

export type NativeEditorInput = {
sequence: number;
layout_generation: number;
time_seconds: number;
event: NativeEditorInputEvent;
};

关联类型:NativeEditorInputEvent

NativeEditorInputEvent

export type NativeEditorInputEvent = {
kind: "pointer";
phase: "down" | "move" | "up" | "cancel";
pointer_id: number;
pointer_type?: "mouse" | "pen" | "touch";
position_css: [
number,
number
];
pressure: number;
button: number;
buttons: number;
modifiers: NativeEditorModifiers;
samples: NativeEditorPointerSample[];
} | {
kind: "zoom";
position_css: [
number,
number
];
factor: number;
} | {
kind: "wheel";
position_css: [
number,
number
];
delta_css: [
number,
number
];
modifiers: NativeEditorModifiers;
} | {
kind: "key";
key: string;
code: string;
pressed: boolean;
repeat: boolean;
modifiers: NativeEditorModifiers;
} | {
kind: "ime-preedit";
text: string;
selection: [
number,
number
] | null;
} | {
kind: "ime-commit";
text: string;
} | {
kind: "blur";
};

关联类型:NativeEditorModifiers · NativeEditorPointerSample

NativeEditorLayout

export type NativeEditorLayout = {
physical_size: [
number,
number
];
scale_factor: number;
layout_generation: number;
viewport_origin_css: [
number,
number
];
};

NativeEditorModifiers

export type NativeEditorModifiers = {
alt: boolean;
control: boolean;
shift: boolean;
meta: boolean;
};

NativeEditorOperation

export type NativeEditorOperation = {
kind: "input";
input: NativeEditorInput;
} | {
kind: "layout";
layout: NativeEditorLayout;
} | ({
kind: "open";
source_id: string;
node_binding: string | null;
format: string;
} & ({
bytes: number[];
bytes_blob_id?: never;
} | {
bytes_blob_id: string;
bytes?: never;
})) | {
kind: "activate";
document_id: string;
} | {
kind: "show" | "hide";
} | {
kind: "close";
document_id: string;
expected_revision: number;
discard: boolean;
} | {
kind: "command";
document_id: string;
expected_revision: number;
command: string;
parameters: number[];
} | {
kind: "export";
document_id: string;
expected_revision: number;
format: string;
} | {
kind: "cancel-job";
job_id: number;
} | {
kind: "mark-saved";
document_id: string;
expected_revision: number;
};

关联类型:NativeEditorInput · NativeEditorLayout

NativeEditorPointerSample

export type NativeEditorPointerSample = {
position_css: [
number,
number
];
pressure: number;
time_seconds: number;
};

NativeEditorProvider

export type NativeEditorProvider = {
provider_id: string;
api_major: number;
api_minor: number;
project_protocol: number;
browser_protocol: number;
formats: string[];
capabilities: string[];
build_identity: string;
};

NativeEditorReceipt

export type NativeEditorReceipt = {
request_id: number;
generation: number;
result: {
Ok: NativeEditorResult;
} | {
Err: NativeEditorError;
};
};

关联类型:NativeEditorResult · NativeEditorError

NativeEditorRequest

export type NativeEditorRequest = {
session_id: string;
request_id: number;
generation: number;
operation: NativeEditorOperation;
};

关联类型:NativeEditorOperation

NativeEditorResult

export type NativeEditorResult = {
kind: "opened";
document_id: string;
revision: number;
source_size: [
number,
number
];
} | {
kind: "changed";
revision: number;
} | {
kind: "exported";
bytes?: number[];
bytes_blob_id?: string;
revision: number;
} | {
kind: "needs-settlement";
document_id: string;
} | {
kind: "done";
};

NativeEditorSnapshot

export type NativeEditorSnapshot = {
frame?: unknown;
receipts: NativeEditorReceipt[];
state: NativeEditorState[];
documents: Record<string, NativeEditorDocument>;
visible: boolean;
};

关联类型:NativeEditorReceipt · NativeEditorState · NativeEditorDocument

NativeEditorState

export type NativeEditorState = {
key: string;
generation: number;
document_id: string | null;
revision: number | null;
progress: number | null;
};

NativeImageResource

Opaque native pixels; bytes remain in the native process until upload or release.

export type NativeImageResource = {
kind: 'native-image';
handle: string;
generation: number;
width: number;
height: number;
};