Projekteinstellungen

Jedes Projekt hat aktive Einstellungen — Trim, Hintergrund, Untertitelstil, Layout — die steuern, wie Exporte gerendert werden. Verwende Projekteinstellungen, wenn du projektlokale Overrides möchtest, die sich nicht lohnen, in ein gemeinsames Preset zu packen. Siehe Render settings reference für die gemeinsame Feldzuordnung von preset, settings.style und settingsOverride.

`client.projects.getSettings(projectId, options?)`

Rufe die aktiven Einstellungen eines Projekts ab.

const config = await client.projects.getSettings("prj_abc123");
console.log(
  config.settings.trim,
  config.settings.style?.background,
  config.settings.displayLanguages,
);

`client.projects.updateSettings(projectId, body, options?)`

Patche die aktiven Projekteinstellungen. Du kannst ein Preset anwenden, rohe Einstellungen übergeben oder beides (das Preset wird zuerst angewendet, danach werden Einstellungen-Overrides darüber zusammengeführt).

const updated = await client.projects.updateSettings("prj_abc123", {
  presetId: "preset_abc123",
  settings: {
    trim: { startSeconds: 5, endSeconds: 180 },
  },
});

Felder

presetId

string

Ein wiederverwendbares Preset anwenden. Weglassen, um das aktuelle Preset unverändert zu lassen.

settings

object

Patch, der oben auf das Preset angewendet wird. Verwende style für Preset-förmige Overrides, plus projektlokale Felder wie displayLanguages, chordSettings und duetSingerFilter.

Gültige Felder ermitteln

Konvertiere das Update-Schema zur Laufzeit in JSON Schema, um jedes gültige Feld zu entdecken:

import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();
console.log(JSON.stringify(schema, null, 2));

Agents sollten dies aufrufen, bevor sie Projekteinstellungen mutieren, damit sie immer die aktuelle Struktur kennen.

Häufige Muster

Trim
Background color
Display languages
Apply preset

await client.projects.updateSettings("prj_abc123", {
  settings: {
    trim: { startSeconds: 5.0, endSeconds: 180.0 },
  },
});

await client.projects.updateSettings("prj_abc123", {
  settings: {
    style: {
      background: { type: "color", color: "#101010" },
    },
  },
});

await client.projects.updateSettings("prj_abc123", {
  settings: {
    displayLanguages: ["en", "es"],
  },
});

await client.projects.updateSettings("prj_abc123", {
  presetId: "preset_abc123",
});