Runtime API / Method

NodeScriptContext.setTransformsBatch

在 owning SceneRuntime 的 fast channel 中合并一帧的位置写入,并返回 accepted/missing refs。

使用说明

用于 Scroll、Slider、拖拽面板等连续交互,把 content 与 thumb 的位置放在同一批中提交。每个 animation frame 最多调用一次;Runtime flush 后只发布一次 scene mutation revision,使 renderer 与 picker 观察同一几何状态。

const receipt = ctx.setTransformsBatch([
{ ref: content.entity, x: contentX, y: contentY },
{ ref: 'vertical-thumb', x: thumbX, y: thumbY },
]);
if (receipt.missing.length > 0) {
ctx.trace('scroll.targets.missing', receipt.missing);
}

accepted 表示已经进入 fast channel,不表示已经渲染;需要读取提交后的状态时等待下一帧并重新 probe。

参数

updatesreadonly NodeScriptTransformBatchUpdate[]