JianYing Pro (剪映) 네이티브 드래프트 내보내기 스킬
이 스킬은 비디오 파일, 오디오 트랙 및 자막 스크립트에서 직접 프로덕션 등급의 JianYing Pro macOS (11.4+) 프로젝트 드래프트를 생성하고 배포하는 자동화된 하드웨어 네이티브 브릿지를 제공합니다.
"미디어 누락 / 접근 권한 없음" 샌드박스 프롬프트를 완전히 해결하여 자체 포함 드래프트 아키텍처 아래에 프로젝트를 패키징합니다.
빠른 참조
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. 듀얼 컬러 하이라이트로 프로그래매틱하게 자막 추가
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 앱 샌드박스는 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