预设 - Youka Docs

预设是一种可复用的渲染配置——背景、字幕样式、布局以及其他视觉设置——你可以将它应用到任何项目或导出中。当你希望在许多轨道中保持一致的视觉风格时，预设非常适合。查看 Render settings reference 以获取完整的 preset 结构以及每个由枚举支持的选项。

`preset schema`

返回预设设置的 JSON Schema。在创建或更新预设之前，用它来发现有效字段。

youka preset schema --json

Agent 在修改预设之前应先调用 preset schema，以便了解准确的字段名称和值类型。

`preset list`

列出经过身份验证的账户所拥有的所有预设。

youka preset list --json

`preset show`

通过 ID 获取单个预设。

youka preset show <presetId> --json

`preset create`

创建一个新预设。

youka preset create [options]

Options

选项	说明
`--name <name>`	预设名称
`--default`	将新预设标记为默认预设
`--body <file\|->`	从文件或 stdin 读取完整的请求体

请求体应包含完整的 preset 对象。对于较大的载荷，建议使用 --body 而不是内联 JSON。

Examples

youka preset create \
  --name "Neon Night" \
  --body ./neon-preset.json \
  --json

youka preset create \
  --name "Red Cinema" \
  --body ./red-cinema.json \
  --default \
  --json

cat ./preset.json | youka preset create --name "From stdin" --body - --json

CLI 标志会覆盖 --body 中对应的字段。

`preset update`

更新一个现有预设。

youka preset update <presetId> [options]

选项	说明
`--name <name>`	新名称
`--body <file\|->`	从文件或 stdin 读取完整的请求体

示例：

youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json

`preset delete`

通过 ID 删除一个预设。

youka preset delete <presetId> --json

删除预设不会删除此前使用该预设渲染的项目或导出。未来引用已删除预设的导出将失败。

`preset default`

获取或设置默认预设。

youka preset default --json
youka preset default <presetId> --json

不带参数时，该命令会返回当前默认预设或 null。提供预设 ID 时，会将该预设标记为默认预设。

应用预设

使用 --preset 将预设应用到项目或导出：

youka project create ./song.mp3 --preset $PRESET_ID --wait

youka project settings $PROJECT_ID --preset $PRESET_ID

youka export create $PROJECT_ID --preset $PRESET_ID --wait

下一步

Render settings reference - 所有共享的预设字段
Projects - 将预设应用到项目设置
Exports - 在渲染时应用预设
Media - 预设引用的可复用媒体

Overview

How To

Customization

Audio

Settings

Exporting

Account

预设

`preset schema`

`preset list`

`preset show`

`preset create`

Options

Examples

`preset update`

`preset delete`

`preset default`

应用预设

下一步

​preset schema

​preset list

​preset show

​preset create

​Options

​Examples

​preset update

​preset delete

​preset default

​应用预设

​下一步

`preset schema`

`preset list`

`preset show`

`preset create`

Options

Examples

`preset update`

`preset delete`

`preset default`

应用预设

下一步