執行時 API
Runtime（scratch-vm/src/engine/runtime.js）是實際執行專案的引擎。VirtualMachine 擁有一個並將其暴露為 vm.runtime；擴充功能以 Scratch.vm.runtime 獲得它。它持有每個目標、步進執行緒、透過 IO 裝置路由輸入，併發出編輯器監聽的事件。
Runtime 擴充功能 Node 的 EventEmitter，因此 runtime.on(name, handler) 和 runtime.emit(...) 直接工作。VM 以相同名稱重新發出大多數執行時事件，因此 UI 程式碼通常監聽 vm；想要原始流的擴充功能和內部程式碼監聽 runtime。
本頁涵蓋擴充功能或 window.vm 控制台可以安全觸及的執行時表面。任何以 _ 字首的內容都是內部的，不在此涵蓋。
目標
"目標"是一個角色或舞臺（一個 RenderedTarget）。執行時按執行順序保留它們。
runtime.targets：所有目標的陣列，包括克隆，按圖層/執行順序。runtime.getTargetForStage()：舞臺目標，如果沒有則為undefined。runtime.getSpriteTargetByName(name)：具有該名稱的第一個原始（非克隆）角色。runtime.getTargetById(id)：按 ID 的目標（使用內部快取）。runtime.getTargetByDrawableId(drawableID)：擁有給定渲染器可繪製物件的目標。runtime.getEditingTarget()：編輯器中當前選中的目標，或undefined。
// 在編輯器控制台中：
window.vm.runtime.getTargetForStage();
window.vm.runtime.getSpriteTargetByName('Sprite1');
克隆
runtime.clonesAvailable()：是否還可以建立另一個克隆（計數達到runtimeOptions.maxClones後為false）。runtime.changeCloneCounter(delta)：調整即時克隆計數。克隆/刪除積木會呼叫這個；您很少需要直接使用。
克隆是 runtime.targets 中的普通目標；stopAll() 處理掉每個非原始克隆。
IO 裝置
runtime.ioDevices 分組虛擬輸入裝置。積木讀取它們；宿主透過 vm.postIOData(device, data) 供給它們。
| 裝置 | 原始碼 | 值得注意的讀取 |
|---|---|---|
keyboard | io/keyboard.js | getKeyIsDown(key) |
mouse | io/mouse.js | getScratchX()、getScratchY()、getIsDown()、getButtonIsDown(button) |
mouseWheel | io/mouse-wheel.js | 滾動增量 |
clock | io/clock.js | projectTimer()、resetProjectTimer() |
cloud | io/cloud.js | 雲端變數請求 |
userData | io/user_data.js | getUsername() |
video | io/video.js | 用於影片偵測擴充功能的攝影機幀 |
專案計時器
Scratch 的 計時器 積木讀取 runtime.ioDevices.clock：
runtime.ioDevices.clock.projectTimer()：計時器上次重置以來的秒數。runtime.ioDevices.clock.resetProjectTimer()：將其重置為零。greenFlag()和dispose()會自動執行此操作。
綠旗與停止
runtime.greenFlag()：停止一切，重置專案計時器，觸發event_whenflagclicked帽子。發出PROJECT_START。這就是vm.greenFlag()呼叫的內容。runtime.stopAll()：停止每個執行緒，處理掉所有克隆，並清空執行緒列表。發出PROJECT_STOP_ALL。
啟動執行緒（帽子）
runtime.startHats(requestedHatOpcode, optMatchFields, optTarget)：為每個頂部積木是requestedHatOpcode帽子的指令碼啟動一個執行緒。optMatchFields按欄位值篩選（比較前大寫，因此廣播和按鍵只觸發正確的指令碼）；optTarget將其限制為一個 目標。返回新執行緒陣列。它尊重帽子的restartExistingThreads後設資料：true重啟匹配的執行中執行緒，false在已有執行執行緒時跳過啟動。這就是帶HAT/EVENT積木的擴充功能讓帽子觸發的方式。請參閱積木註冊。runtime.allScriptsDo(fn, optTarget)/runtime.allScriptsByOpcodeDo(opcode, fn, optTarget)：迭代每個頂層指令碼（可選按頂部積木操作碼篩選）。startHats建構在第二個之上。runtime.toggleScript(topBlockId, opts)：從其頂部積木啟動（或對於已在執行的點選，停止）一個指令碼，就像在編輯器中點選它一樣。
這個引擎沒有 startHatsWithParams 方法；請透過 startHats 的 optMatchFields 傳遞欄位匹配器。
事件
Runtime 發出大量事件；擴充功能和宿主最常用的：
| 事件 | 觸發時 |
|---|---|
PROJECT_START | 綠旗被按下。 |
PROJECT_STOP_ALL | 停止按鈕被點選（或 stopAll() 執行）。 |
PROJECT_RUN_START | 本 tick 執行緒從空閒變為活動。 |
PROJECT_RUN_STOP | 本 tick 最後一個非監視器執行緒完成。 |
PROJECT_LOADED | 專案完成載入。 |
PROJECT_CHANGED | 專案以影響序列化的方式被編輯。 |
TURBO_MODE_ON / TURBO_MODE_OFF | 渦輪模式切換。 |
PROJECT_RUN_START / PROJECT_RUN_STOP 是圍繞非監視器執行緒計數的邊緣觸發事件，因此它們在每次空閒/活動轉變時觸發一次，而不是每個執行緒一次。完整列表請參閱事件。
監視器
監視器是顯示在舞臺上的值觀察器。執行時持有它們的狀態，編輯器從 MONITORS_UPDATE 事件渲染它。
runtime.requestAddMonitor(monitorRecord)：新增監視器（如果 ID 存在則就地更新）。runtime.requestUpdateMonitor(delta)：按 ID 修補現有監視器；返回它是否存在。runtime.requestRemoveMonitor(id)：移除一個。runtime.requestShowMonitor(id)/runtime.requestHideMonitor(id)：切換可見性；各自返回監視器是否存在。runtime.getMonitorState()：當前的監視器狀態對映。
視覺報告
runtime.visualReport(target, blockId, value)：在點選的報告積木旁邊顯示值氣泡。只在target是編輯目標時報告；發出VISUAL_REPORT。當報告積木在工作區中被點選時，會為您呼叫。
重繪
runtime.requestRedraw()：標記螢幕必須在序列器在本幀執行更多工作之前重繪。更改可見內容的積木會呼叫這個；一旦請求重繪，序列器就會在本幀停止步進（除非渦輪模式開啟）。請參閱執行緒：序列器。
渦輪和編譯器標誌
這些由引擎讀取，並透過 VM 的設定器設定（它們也發出更改事件）：
runtime.turboMode：迴圈執行時不對重繪讓出時為true。透過vm.setTurboMode設定。runtime.runtimeOptions：{maxClones, miscLimits, fencing, caseSensitiveLists, unsafeOptimisations}。透過vm.setRuntimeOptions設定。runtime.compilerOptions：{enabled, warpTimer}。透過vm.setCompilerOptions設定。enabled是 JavaScript 編譯器的開關；warpTimer讓 warp 迴圈即使在 warp 模式之外也尊重 warp 超時。