Docs: Add tutorial for stickers and inspect_material

This commit is contained in:
gary318 2024-11-21 20:31:43 +08:00
parent 453eb7d43d
commit 125ebba710
No known key found for this signature in database
GPG Key ID: C13F9DB85F47961A

View File

@ -18,7 +18,7 @@
- ☑️ [加载](#加载模板)(未加密的)`draft_content.json`文件作为模板
- ☑️ [替换音视频片段的素材](#根据名称替换素材)
- ☑️ [修改文本片段的文本内容](#替换文本片段的内容)
- ⬜ 提取模板中出现的贴纸元信息
- ☑️ [提取模板中出现的贴纸元信息](#提取素材元数据)
### 批量导出
- ☑️ 控制剪映打开指定草稿
@ -39,7 +39,7 @@
- ☑️ 添加[片段特效](#添加片段特效),并设置参数
- ☑️ 添加[片段滤镜](#添加片段滤镜),并设置强度
### 贴纸
- ⬜ 根据元信息添加贴纸
- ☑️ 根据元信息[添加贴纸](#提取素材元数据)
### 音频
- ☑️ 添加本地音频素材
- ☑️ 将音频素材添加至轨道
@ -136,6 +136,8 @@ script.dump("<你的草稿文件夹>/draft_content.json")
- [根据片段替换素材](#根据片段替换素材):替换某个特定片段的素材,同时重新选取其引用的素材范围
- [替换文本片段的内容](#替换文本片段的内容):保留所有文本格式,但替换其内容
除此之外,对于某些没有特定名称的特性(贴纸等),提供了[提取素材元数据](#提取素材元数据)的功能以提取其`resource_id`
> ⚠️ 由于剪映6+版本对草稿文件进行了加密,故**暂不支持加载来自6+版本的草稿文件**作为模板
> 若出现模板内容丢失的情况,欢迎反馈
@ -149,7 +151,7 @@ import pyJianYingDraft as draft
draft_folder = draft.Draft_folder("<剪映草稿文件夹>") # 一般形如 ".../JianyingPro Drafts"
script = draft_folder.duplicate_as_template("模板草稿", "新草稿") # 复制"模板草稿",并命名为"新草稿",同时打开新草稿供编辑
# 编辑新草稿,如替换素材、添加轨道、片段等
# 对返回的Script_file对象进行编辑,如替换素材、添加轨道、片段等
script.save() # 保存你的"新草稿"
```
@ -161,6 +163,35 @@ script.save() # 保存你的"新草稿"
> 导入轨道的限制也许会在后续版本中逐渐取消
#### 提取素材元数据
对导入的`Script_file`对象,可以调用`inspect_material`方法提取部分素材的`resource_id`。
`Draft_folder`也有相应的方法来提取指定草稿的素材元数据。
> 目前仅支持贴纸素材
```python
import pyJianYingDraft as draft
draft_folder = draft.Draft_folder("<剪映草稿文件夹>")
draft_folder.inspect_material("草稿名称")
# 或者
script = draft_folder.load_template("草稿名称")
script.inspect_material()
```
上述代码的输出可能类似于
```
贴纸素材:
Resource id: 7405878923323641129 '秋日手绘-枫叶'
Resource id: 7429353555447893260 '电商购物促销/哇哦'
Resource id: 7437707455267671315 '冬日涂鸦winter雪花冬天vlog装饰文字'
Resource id: 7343931192204463401 '爱心'
```
其中的`Resource id`可用于添加相应素材(例如通过`Sticker_segment`的`resource_id`参数)
#### 根据名称替换素材
这种方法将替换素材本身,而不对片段进行直接修改。