JianYing Pro (剪映) ネイティブ書き出しスキル は何をしますか？
このスキルは、動画ファイル、オーディオトラック、字幕スクリプトから、プロ仕様の JianYing Pro macOS (11.4+) プロジェクト草稿 (draft) を自動生成し、ハードウェアネイティブなブリッジを提供します。
macOS サンドボックスによって発生する 「媒体丢失 / 暂无访问权限」 （メディアが見つかりません / アクセス権がありません）というプロンプトを、自己完結型草稿アーキテクチャ（自包含草稿架构） によって完全に解決します。
クイックリファレンス
1. ワンライナー CLI 書き出し＆即時起動
python3 scripts/export_draft.py \
--video "/path/to/my_video.mp4" \
--name "临沂森兴科技_GEO三角咬合被动获客" \
--cover "/path/to/cover.jpg" \
--subtitles "/path/to/subtitles.json" \
--open
| パラメータ | 短縮 | 必須 | 説明 |
|---|---|---|---|
--video | -v | はい | ソース動画ファイルの絶対パス |
--name | -n | いいえ | JianYing でのプロジェクト名（デフォルトは動画ファイル名） |
--cover | -c | いいえ | カバーサムネイル画像（.jpg / .png） |
--subtitles | -s | いいえ | 字幕ファイル（.json または .srt） |
--duration | -d | いいえ | 動画の長さ（秒）。省略時は自動検出 |
--open | -o | いいえ | JianYing Pro を再起動/起動して草稿を開く |
2. Python API の使い方
from pathlib import Path
import sys
# スキルスクリプトディレクトリを追加
sys.path.insert(0, "/path/to/jianying-draft-export/scripts")
from draft_builder import JianyingDraft
# 1. 草稿を初期化
draft = JianyingDraft(name="私の高次元IPショート動画", width=1920, height=1080)
# 2. 動画ソースを設定（長さは自動検出）
draft.set_video("/path/to/rendered_video.mp4")
# 3. カバー画像を設定
draft.set_cover("/path/to/cover.jpg")
# 4. 字幕をプログラムで追加（2色強調表示対応）
draft.add_subtitle(
text="大規模言語モデルの基盤には厳格な不正防止メカニズムがあります。単一の次元での自己主張は、アルゴリズムから見ればすべて「孤証」に過ぎません。",
start_sec=8.13,
end_sec=16.46,
highlight="孤証" # 強調ワードは金色 [1.0, 0.84, 0.0] で黒い枠線付きで描画
)
# または外部 JSON / SRT ファイルから読み込む:
# draft.load_subtitles("/path/to/subtitles.json")
# 5. コンパイル、自己完結型草稿に自動コピー、アプリを起動
draft.save_and_inject(open_app=True)
3. 字幕 JSON フォーマット
字幕パーサーは、標準の .srt ファイルまたは以下の JSON リストを受け付けます:
[
{
"start": 0.0,
"end": 7.68,
"text": "2026年、実店舗の最も厳しい現実。それは隣の店が値下げをしていることではなく、顧客が AI に「近くでどこが良い？」と尋ねたときに、あなたの店がそもそも存在しないことです。",
"hl": "存在しない"
},
{
"start": 8.13,
"end": 16.46,
"text": "大規模言語モデルの基盤には厳格な不正防止メカニズムがあります。単一の次元での自己主張は、アルゴリズムから見ればすべて「孤証」に過ぎません。孤証は立たず、直接除外されます。",
"hl": "孤証は立たず"
}
]
hl: オプション。指定された部分文字列は、太い黒枠付きの金色ハイライトスタイルで表示されます。
4. アーキテクチャ: macOS サンドボックスに「自己完結型草稿」が必要な理由
macOS の App Sandbox は、VideoFusion-macOS.app が ~/Desktop/ や ~/.gemini/ などの任意のディレクトリ内のファイルにアクセスすることを制限します。
❌ 外部パスモード（問題あり）:
~/Desktop/IP/video.mp4 -----> JianYing Pro [サンドボックス EACCES] -----> 「媒体丢失/暂无访问权限」 ダイアログ
✅ 自己完結型草稿モード（このスキル）:
~/Movies/JianyingPro/User Data/Projects/com.lveditor.draft/<Project>/video.mp4
└─> JianYing Pro [完全なネイティブ読み書き] ──> プロンプト無し、即時再生!
詳細な技術分析については macos_sandbox_bypass.md を参照してください。
5. 検証とトラブルシューティング
草稿が正しく作成され、復号化されたかどうかを確認するには:
python3 scripts/verify_draft.py "プロジェクト名"
libjycodec.dylib の再コンパイルが必要な場合（例: 新しいアーキテクチャ上）:
bash scripts/compile_dylib.sh