Как остановить рендер через DaVinci Resolve Python API
StopRendering перед очисткой очереди или аварийным завершением автоматизации
Разбираем безопасный вызов StopRendering и проверку IsRenderingInProgress, чтобы остановить активный экспорт перед изменением Render Queue.
API
Resolve Scripting API
Язык
Python
Resolve
19–20+
Требуется
Запущенный Resolve
Синтаксис
result = api_method()Параметры
- • Параметры зависят от конкретного метода Resolve Scripting API и показаны в рабочем примере.
Возвращает
Возвращаемое значение нужно проверять перед следующим шагом автоматизации.
import os
import sys
import time
from pathlib import Path
def import_resolve_module():
try:
import DaVinciResolveScript as dvr
return dvr
except ImportError:
search_paths = [
os.environ.get("RESOLVE_SCRIPT_API", ""),
os.environ.get("RESOLVE_MODULES", ""),
r"C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting\Modules",
"/opt/resolve/Developer/Scripting/Modules",
"/opt/BlackmagicDesign/DaVinciResolve/Developer/Scripting/Modules",
"/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules",
str(Path.home() / "Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules"),
]
for path in search_paths:
if path and os.path.isdir(path) and path not in sys.path:
sys.path.append(path)
import DaVinciResolveScript as dvr
return dvr
def safe_call(obj, name, *args, **kwargs):
try:
fn = getattr(obj, name, None)
if callable(fn):
return fn(*args, **kwargs)
except Exception:
return None
return None
def get_project_and_timeline():
dvr = import_resolve_module()
resolve = dvr.scriptapp("Resolve")
if not resolve:
raise RuntimeError("DaVinci Resolve API недоступен")
project_manager = safe_call(resolve, "GetProjectManager")
project = safe_call(project_manager, "GetCurrentProject") if project_manager else None
if not project:
raise RuntimeError("Нет открытого проекта DaVinci Resolve")
timeline = safe_call(project, "GetCurrentTimeline")
if not timeline:
raise RuntimeError("Нет активного Timeline")
return resolve, project, timeline
def stop_current_render(project, wait_seconds=0.5, max_checks=10):
if not safe_call(project, "IsRenderingInProgress"):
return {"was_rendering": False, "stopped": True}
safe_call(project, "StopRendering")
for _ in range(max_checks):
if not safe_call(project, "IsRenderingInProgress"):
return {"was_rendering": True, "stopped": True}
time.sleep(wait_seconds)
return {"was_rendering": True, "stopped": False}
resolve, project, timeline = get_project_and_timeline()
result = stop_current_render(project)
print(result)
Документация
Что делает пример
Скрипт проверяет, идет ли рендер, вызывает StopRendering и несколько раз убеждается, что IsRenderingInProgress перестал возвращать True.
Когда это нужно
StopRendering полезен перед очисткой очереди, перед пересозданием render job или в интерфейсе, где пользователю нужна кнопка остановки текущего экспорта.
Почему нельзя сразу удалять очередь
Если в момент удаления job еще рендерится, поведение может быть нестабильным. Сначала лучше остановить рендер, дождаться остановки и только потом менять очередь.
Разбор примера
Подключение к Resolve
Пример начинает работу с подключения к запущенному DaVinci Resolve через официальный Python-модуль.
Проверка проекта
Перед вызовами Media Pool, Timeline или Render Queue код проверяет наличие открытого проекта.
Вызов метода API
Основной блок выполняет задачу статьи: как остановить рендер через davinci resolve python api.
Проверка результата
После вызова API результат проверяется, чтобы скрипт не продолжал работу с пустым объектом или не созданной задачей.
Особенности Resolve API
- StopRendering не удаляет Render Job из очереди.
- После остановки проверьте статус задания отдельно.
- Не вызывайте StopRendering без причины в середине нормального экспорта.
- Для UI возвращайте пользователю понятный результат stopped/failed.
Частые ошибки
Resolve API недоступен
Причина: Приложение не запущено или Python не видит DaVinciResolveScript.
Решение: Запустите Resolve и проверьте путь к Developer/Scripting/Modules.
Метод вернул None или False
Причина: В Resolve нет нужного проекта, Timeline, клипов, preset или доступа к папке.
Решение: Проверьте входные данные и добавьте явную проверку результата после каждого важного вызова API.
Скрипт работает только на одной машине
Причина: Пути к файлам или папкам Resolve зашиты под конкретную систему.
Решение: Вынесите пути в переменные и добавьте стандартные пути Windows, Linux и macOS.
Следующий шаг
Следующий шаг зависит от задачи: импорт медиа, создание Timeline или запуск рендера.
Связанные статьи API
Render
Как очистить Render Queue в DaVinci Resolve через Python API
Показываем рабочий подход к очистке очереди рендера: получить список задач, извлечь job id и удалить старые Render Jobs перед созданием новой задачи.
Render
Как удалить Render Job из очереди через DaVinci Resolve Python API
Показываем практический способ удалить конкретное задание из Render Queue, учитывая что Resolve может возвращать job id строкой, числом или словарем.
Render
Как дождаться завершения рендера через DaVinci Resolve Python API
Показываем безопасный цикл ожидания рендера: скрипт не завершается раньше времени и после окончания читает статус Render Job.

