Impostazioni del progetto

Ogni progetto ha impostazioni attive — trim, background, stile dei sottotitoli, layout — che controllano come vengono renderizzate le esportazioni. Usa le impostazioni del progetto quando vuoi override locali al progetto che non vale la pena raggruppare in un preset condiviso. Vedi Render settings reference per la mappa dei campi condivisi preset, settings.style e settingsOverride.

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

Recupera le impostazioni attive di un progetto.

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?)`

Applica una patch alle impostazioni attive del progetto. Puoi applicare un preset, passare impostazioni grezze o entrambi (prima viene applicato il preset, poi gli override delle impostazioni vengono uniti sopra).

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

Campi

presetId

string

Applica un preset riutilizzabile. Omettilo per lasciare invariato il preset corrente.

settings

object

Patch applicata sopra il preset. Usa style per override con la stessa forma del preset, oltre a campi locali del progetto come displayLanguages, chordSettings e duetSingerFilter.

Scoprire i campi validi

Converti lo schema di update in JSON Schema a runtime per scoprire ogni campo valido:

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

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

Gli agenti dovrebbero chiamare questo prima di modificare le impostazioni del progetto, così da conoscere sempre la forma corrente.

Pattern comuni

Trim
Colore di sfondo
Lingue di visualizzazione
Applica 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",
});