签名关联类型:WorldCameraShotState – WorldPoint
本页由当前 SDK 声明自动生成。
WorldCameraShotState · WorldCameraView · WorldCaptureAnimationVersion · WorldCaptureDynamicVersionKey · WorldCaptureFrame · WorldCaptureFramingPhase · WorldCaptureFramingStatus · WorldCaptureGenerationBinding · WorldCaptureInput · WorldCaptureMediaMetadata · WorldCapturePageProgress · WorldCaptureStatusResult · WorldCaptureTimeRange · WorldCaptureVersionKey · WorldCaptureVideoMediaMetadata · WorldCompletion · WorldId · WorldInstanceData · WorldModelAnimationRig · WorldObjectAuthorityEntry · WorldObjectContainment · WorldObjectIdentity · WorldObjectVersion · WorldPoint
WorldCameraShotState
export type WorldCameraShotState = { readonly kind: WorldCameraShotKind; readonly phase: WorldCameraShotPhase; readonly durationSeconds: number | null; readonly downloadable: boolean; readonly playable: boolean; readonly label: string;};关联类型:WorldCameraShotKind · WorldCameraShotPhase
成员说明:
downloadable:实时取景画面只是预览;只有 ready 的冻结视频可以作为媒体下载/提交。
WorldCameraView
Where a camera actually looks, derived from its pose (world meters).
Agent tools hand this back after a camera write so the caller can check the
framing instead of assuming “the write succeeded” means “it points at the
subject”: forward is the unit view direction and groundIntersection is
where that axis meets h = 0 (null when level or looking upward).
export type WorldCameraView = { forward: WorldPoint; groundIntersection: GroundPoint | null;};关联类型:WorldPoint · GroundPoint
WorldCaptureAnimationVersion
export type WorldCaptureAnimationVersion = { readonly areaId: WorldId; readonly scriptRevision: number; readonly sourceHash: string; readonly durationSeconds: number;};关联类型:WorldId
成员说明:
durationSeconds:脚本时长(秒);时间区间必须落在其中。
WorldCaptureDynamicVersionKey
完整冻结键。outputVersion 由容器、尺寸、fps、时间区间与动画版本共同派生,
因此基础六字段键相等就足以证明动态版本相等。
export type WorldCaptureDynamicVersionKey = { readonly canvasId: WorldId; readonly cameraId: WorldId; readonly worldContentVersion: WorldVersion; readonly cameraSettingsVersion: WorldVersion; readonly bindingVersion: WorldVersion; readonly outputVersion: WorldVersion; readonly animation: WorldCaptureAnimationVersion; readonly timeRange: WorldCaptureTimeRange; readonly fps: number;};关联类型:WorldId · WorldVersion · WorldCaptureAnimationVersion · WorldCaptureTimeRange
WorldCaptureFrame
export type WorldCaptureFrame = { ok: true; rgba: Uint8Array; width: number; height: number;} | { ok: false; code: string;};WorldCaptureFramingPhase
export type WorldCaptureFramingPhase = "empty" | "capturing" | "waiting" | "ready" | "failed" | "unavailable" | "cancelled";WorldCaptureFramingStatus
Public framing status. input is the last verified framing and may still be
displayed for viewing, but stale: true means it is not the current valid input
and generation must not consume it.
export interface WorldCaptureFramingStatus { readonly canvasId: WorldId; readonly cameraId: WorldId; readonly key: WorldCaptureVersionKey | null; readonly dynamicKey?: WorldCaptureDynamicVersionKey; readonly phase: WorldCaptureFramingPhase; readonly stale: boolean; readonly requestId?: WorldId; readonly contentFingerprint?: string; readonly input?: WorldCaptureInput; readonly shotKind?: "static" | "dynamic"; readonly durationSeconds?: number; readonly video?: WorldCaptureVideoMediaMetadata; readonly width?: number; readonly height?: number; readonly reason?: string;}关联类型:WorldId · WorldCaptureVersionKey · WorldCaptureDynamicVersionKey · WorldCaptureFramingPhase · WorldCaptureInput · WorldCaptureVideoMediaMetadata
成员说明:
dynamicKey:Full frozen animation/range/profile identity for explicit video frame derivation.shotKind:卡片语义:dynamic表示该镜头代表视频,不只是图片。durationSeconds:动态镜头关联的动画时长(秒);静止镜头缺省。video:当前键已冻结的视频媒体(仅动态镜头且 ready 时存在)。width:Current output pixels of the last captured key (not byte size).
WorldCaptureGenerationBinding
Stable association produced only after trusted media verification. Generation acceptance stores this binding so later canvas changes cannot rewrite the input.
export interface WorldCaptureGenerationBinding { readonly version: typeof WORLD_CAPTURE_GENERATION_BINDING_VERSION; readonly requestId: WorldId; readonly key: WorldCaptureVersionKey; readonly contentFingerprint: string; readonly input: WorldCaptureInput; readonly media?: WorldCaptureMediaMetadata; readonly video?: WorldCaptureVideoMediaMetadata;}关联类型:WorldId · WorldCaptureVersionKey · WorldCaptureInput · WorldCaptureMediaMetadata · WorldCaptureVideoMediaMetadata
成员说明:
media:Exact verified v2 media metadata. New claims always carry it so generation can materialize the same bytes as a reference input without reading the current camera or storage head. It stays optional for previously persisted bindings; consumers that need a reference must fail closed when it is absent.video:Exact verified video envelope for a dynamic camera shot. Absent for static (image) framings; never combined withmedia.
WorldCaptureInput
export interface WorldCaptureInput { key: WorldCaptureVersionKey; mediaId: WorldId; checksum: string;}关联类型:WorldCaptureVersionKey · WorldId
WorldCaptureMediaMetadata
Static media metadata for one captured framing. Bytes live in Media Service.
export interface WorldCaptureMediaMetadata { version: typeof WORLD_CAPTURE_MEDIA_VERSION; mediaId: WorldId; storageKey: string; checksum: string; contentType: string; size: number; width: number; height: number;}关联类型:WorldId
成员说明:
storageKey:Content-addressed stable reference; never a URL, data URI or blob URL.checksum:Lowercase SHA-256 hex of the stored bytes.size:Byte size: a finite, positive safe integer, independent of the pixel size.width:Exact pixel width of the captured image: a finite, positive safe integer.height:Exact pixel height of the captured image: a finite, positive safe integer.
WorldCapturePageProgress
A page reports progress for one host-issued attempt; it cannot publish ready.
export type WorldCapturePageProgress = { cameraId: string; attemptId: string; stage: "rendering" | "encoding" | "uploading" | "failed"; completedFrames?: number; totalFrames?: number; reason?: string;};WorldCaptureStatusResult
镜头卡片状态列表(静态图片 / 动态视频共用)。
export type WorldCaptureStatusResult = { ok: true; statuses: import("@woohaa3/contracts").WorldCaptureFramingStatus[];} | { ok: false; code: string; error: string;};关联类型:WorldCaptureFramingStatus
WorldCaptureTimeRange
export type WorldCaptureTimeRange = { readonly startSeconds: number; readonly endSeconds: number;};WorldCaptureVersionKey
export interface WorldCaptureVersionKey { canvasId: WorldId; cameraId: WorldId; worldContentVersion: WorldVersion; cameraSettingsVersion: WorldVersion; bindingVersion: WorldVersion; outputVersion: WorldVersion;}关联类型:WorldId · WorldVersion
WorldCaptureVideoMediaMetadata
export type WorldCaptureVideoMediaMetadata = { readonly version: typeof WORLD_CAPTURE_VIDEO_MEDIA_VERSION; readonly mediaId: WorldId; readonly storageKey: string; readonly checksum: string; readonly size: number; readonly contentType: string; readonly width: number; readonly height: number; readonly container: typeof WORLD_CAPTURE_DYNAMIC_CONTAINER; readonly durationSeconds: number; readonly fps: number;};关联类型:WorldId
WorldCompletion
export interface WorldCompletion { canvasId: WorldId; runId: WorldId; completionId: WorldId; cameraId: WorldId; settingsVersion: WorldVersion;}关联类型:WorldId · WorldVersion
WorldId
Stable IDs are nonempty strings; versions are opaque nonempty strings, not counters.
export type WorldId = string;WorldInstanceData
New nodeData fields; keys here are the complete v1 allowlist for each payload. Structural node layout remains separate. Never infer these from legacy group/shot.
export interface WorldInstanceData { kind: "world-instance"; version: typeof SHARED_WORLD_VERSION; instanceId: WorldId; transform: WorldTransform;}关联类型:WorldId · WorldTransform
WorldModelAnimationRig
export type WorldModelAnimationRig = { staticPose?: ModelStaticPoseSummary; walkProfile?: HumanoidWalkProfile | null; motionReference?: HumanoidMotionReference; shapes?: Array<{ id: string; parent: string | null; position: [ number, number, number ]; rotation: [ number, number, number ]; scale: [ number, number, number ]; localBounds: Aabb; localTransform?: Transform; }>; spatial?: { forwardLocal: [ number, number, number ] | null; forwardSource: "humanoid-v1" | "unknown"; groundAnchorLocal: [ number, number, number ] | null; rootToGroundHeightMeters: number | null; anchorSource: "foot-geometry-bounds" | "geometry-bounds" | "unknown"; }; groups: Array<Pick<SceneV2GroupOp, "id" | "parent" | "position" | "rotation" | "scale" | "pose">>; rig: StoredHumanoidRig | null;};关联类型:ModelStaticPoseSummary · HumanoidWalkProfile · HumanoidMotionReference · Aabb · Transform · SceneV2GroupOp · StoredHumanoidRig
WorldObjectAuthorityEntry
export interface WorldObjectAuthorityEntry { identity: WorldObjectIdentity; nodeId: string | null; version: string; containment: WorldObjectContainment; contentVersion?: string; transformVersion?: string;}关联类型:WorldObjectIdentity · WorldObjectContainment
成员说明:
nodeId:Canonical node that owns this world object; absent forunknowninputs.version:Current object version (content + pose for instances, settings for cameras).
WorldObjectContainment
One canonical object as seen by the authority. Unknown is never writable.
export type WorldObjectContainment = "writable" | "read-only" | "outside" | "unknown";WorldObjectIdentity
Lock keys are (canvasId, kind, id): camera and instance IDs have separate namespaces.
export type WorldObjectIdentity = { kind: "instance"; instanceId: WorldId;} | { kind: "camera"; cameraId: WorldId;};关联类型:WorldId
WorldObjectVersion
export type WorldObjectVersion = WorldObjectIdentity & { version: WorldVersion;};关联类型:WorldObjectIdentity · WorldVersion
WorldPoint
export type WorldPoint = { u: number; v: number; h: number;};