繁中
English繁中

「剪輯」草稿文檔自動化工具

作者: /

支持加載未加密的草稿文件、替換音頻和視頻剪輯、修改文本內容以及將音頻/視頻/文本軌道從模板草稿導入到其他草稿。您可以批量輸出草稿、調整輸出解析度和幀率、添加本地視頻/圖像資源、設置音頻漸變效果以及應用各種效果和濾鏡。

1.項目的目的和背景

  • 在視頻製作過程中，經常需要處理大量的素材拼接、文本/字幕、過渡、動畫、濾鏡、特效等，如果手工完成，非常繁瑣。
  • 該項目旨在允許用戶控制「剪輯草稿」（即，剪輯項目的工程文件/草稿文件）和腳本，以便自動生成、編輯、組合和輸出視頻。
  • 換句話說，它是一個「在文件級別自動編輯」而不是在視頻像素級別進行處理的工具（與FFmpeg不同，它直接操縱編碼、幀等）。

2.主要功能/特點

根據REAUTE中的功能列表，以下是它支持（或部分支持）的摘要：

功能類別可以做什麼/可以支持什麼限制/注意事項
模板模式加載現有的未加密 draft_content.json 作為模板，替換鏡頭、修改文本內容、將模板曲目導入到另一個草稿中Clipping 6+版本對draft_content.json進行加密，目前僅支持Clipping 5.9及以下版本的模板功能
大容量導出控制剪輯、打開指定草稿+輸出到指定路徑+調整解析度/幀率等依賴於Windows下的UI自動化工具，例如uiautomation，並且僅支持剪輯6及以下版本的輸出功能
添加剪輯、剪輯、效果、濾鏡、過渡、動畫、文本、字幕、面罩等您可以通過腳本將視頻/圖像/音頻/文本剪輯添加到草稿中，設置其持續時間、播放速度、音頻漸變、關鍵幀、旋轉/縮放/透明度/濾鏡/效果等在導入模板的曲目上，目前無法繼續添加新剪輯/效果（即模板導入的曲目有修改限制）
軌操作您可以創建多個軌道（視頻軌道、音頻軌道、效果軌道、濾鏡軌道等）並控制賽道順序操作多曲目時，注意同類型曲目的順序，添加片段時指定曲目名稱或索引
關鍵幀操縱支持向透明度、位置、縮放、旋轉、音量等屬性添加關鍵幀目前不支持關鍵幀濾鏡/效果參數（即特效中參數的變化曲線）。
字幕/文本您可以創建文本片段、控制其風格（字體、顏色、大小、對齊方式等），包裝文字、導入SRT字幕導入的字幕僅支持SRT格式;請注意，如果字幕剪輯太短，動畫可能會表現不佳
掩模支持向視頻剪輯添加線性面膜、圓形面膜、羽狀、圓角、旋轉和其他設置參數應符合剪輯內部的屏蔽機制

此外，它還提供了一些方便的方法，例如時間格式可以以字符串「1.5s」和「1h3m12s」的形式輸入，無需每次計算微秒。

3.使用環境和限制

儘管該項目功能豐富，但仍存在許多限制和注意事項 版本/平台/權限條款:

  1. 剪輯版本兼容性
    • 模板功能依賴於解密 draft_content.json，而且6+版本的劍英對該文件進行了加密，因此模板相關功能目前不支持草稿6+版本。
    • 當剪輯7+版本控制項隱藏時，輸出功能不可用，目前僅支持剪輯6及以下版本。
  2. 作業系統兼容性
    •  支持草稿生成、模板模式和自動輸出 Windows （依賴於圖形界面自動化）
    •  對 Linux/macOS ，僅支持草稿生成和模板模式，不支持自動導出（由於涉及裁剪GUI控制項操作）
    • 雖然可以生成草稿，但最終的輸出仍然需要在Windows剪輯客戶端上執行。
  3. 警告/出口限制
    • 輸出功能要求用戶具有剪輯的輸出權限（不能使用需要VIP輸出的功能，否則可能會出現問題/死循環）。
    • 通過控制裁剪窗口、滑鼠點擊等模擬輸出操作;這種方法存在漏洞（窗口被阻塞、焦點丟失、意外操作干擾等）
  4. 模板導入軌道的可修改性有限
    • 儘管可以將模板的曲目導入目標草稿，但目前無法在導入曲目上的剪輯中添加新的效果/過渡/動畫等，只能讀取/保留現有內容。

4.使用示例/快速啟動過程

提供了一個示例 demo.py 在REAUTE中演示如何：

  1. 指定剪輯的草稿文件夾路徑（通常為「Jianying Pro Drafts」）
  2. 運行腳本以生成新草稿
  3. 在剪輯客戶端中打開它，查看相應的剪輯、文本、動畫等

基本步驟大致如下：

將pyJianYingDraft導入為草稿

draft_folder = draft.DraftFolder（「你的草文件夾路徑「）
script = draft_folder.duplicate_as_template（「模板草"，「新草」）

# 在腳本（立即新草類）上做操作，例如添加視頻 / 音頻 / 文字片段、特效、轉發、關鍵片段等

script.save（）

然後（在Windows上）您可以使用：

從pyJianYing Draft導入JianyingController、ExportResolution、ExportFramerate

cð= draft.JianyingController（）
cspel. select_draft（「要引導出的草坪名稱」，「引導出道路」，
 解析度=ExportResolution.RES_1080P，
 framerate=ExportFramerate.FR_24）

控制剪輯將草稿輸出為視頻文件（例如mp4）。

5.項目應用場景優勢

該庫適合在以下場景中使用：

  • 批量/自動視頻生成
    例如，如果您有大量結構相似（模板+內容替換）的視頻，則可以使用腳本批量進行。
  • 程式/腳本視頻拼接
    例如，在後台服務中，視頻是基於數據/模板生成的，而不是在剪輯中手動逐個生成。
  • 混合/複合視頻管道
    您可以將其作為整個視頻處理管道的一部分（前期的材料選擇和結構腳本控制，然後剪切和輸出）
  • 進一步處理/定製剪輯項目文件
    如果您需要了解草圖的內部結構/格式，可以使用此庫來讀取、寫入和修改內部元素（剪輯、軌道、效果等）

與手動操作相比的優點是：

  • 自動化重複性任務並減少手動錯誤
  • 保持結構一致性和標準化
  • 輕鬆與其他系統/腳本/資料庫集成

但是，請注意上面提到的版本/平台兼容性限制。

Github：https://github.com/GuanYixuan/pyJianYingDraft

管材：

返回頂端