Projekteinstellungen

Jedes Projekt hat aktive Einstellungen — Trim, Hintergrund, Untertitelstil, Layout — die steuern, wie Exporte gerendert werden. Verwende Projekteinstellungen, wenn du projektlokale Überschreibungen 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, anschließend werden Settings-Überschreibungen darüber gemergt).

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

Fields

string

Wende ein wiederverwendbares Preset an. Lass es weg, um das aktuelle Preset unverändert zu lassen.

object

Patch, der oberhalb des Presets angewendet wird. Verwende style für Preset-förmige Überschreibungen, plus projektlokale Felder wie displayLanguages, chordSettings und duetSingerFilter.

Gültige Felder ermitteln

Wandle das Update-Schema zur Laufzeit in JSON Schema um, 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 vor dem Mutieren von Projekteinstellungen aufrufen, damit sie immer die aktuelle Struktur kennen.

Häufige Muster

Trim
Hintergrundfarbe
Anzeigesprachen
Preset anwenden

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",
});