blender-background-jobs
Blender background jobs
Use for job.* when an approved output root exists. A submission saves a versioned source snapshot first; the child Blender process may write only inside its job directory. The foreground may continue editing, but the job remains bound to the submitted snapshot.
Route by kind: EXPORT and RENDER_STILL also use blender-render-compositing; BAKE_POINT_CACHES also uses blender-simulation. Use RENDER_ANIMATION_FRAMES for a persistent PNG or multilayer EXR sequence. Use COMPOSE_VIDEO only after its source FrameSequenceReceipt has complete frame hashes; it produces a separate H.264 receipt without rerendering Blender.
Query status until a terminal receipt and keep the job ID, snapshot hash, manifest hash, and artifact receipt together. Cancellation terminates only the child task. job.recover may mark a lost task interrupted but never restarts it. Resume only after an explicit job.resume; verified frames remain untouched while missing or hash-invalid frames are replaced. A background receipt does not approve external upload, publishing, payment, or Video Factory orchestration.
什么时候使用(When to Use)
渲染、导出或缓存烘焙会阻塞前台,或者任务要求断点恢复和逐帧校验时使用。快速且必须立即观察结果的操作继续走对应前台技能。
输入与前置条件(Prerequisites)
- 已提交的
sceneRevision + snapshotId、批准的输出根目录和不可覆盖约束。 - 明确任务类型、帧范围、格式、超时和磁盘预算,并确认子进程可读取依赖素材。