Configuración del proyecto

Cada proyecto tiene una configuración activa — recorte, fondo, estilo de subtítulos, diseño — que controla cómo se renderizan las exportaciones. Usa la configuración del proyecto cuando quieras sobrescrituras locales del proyecto que no valga la pena agrupar en un preset compartido. Consulta Render settings reference para el mapa de campos compartidos de preset, settings.style y settingsOverride.

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

Obtén la configuración activa de un proyecto.

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

Aplica un patch a la configuración activa del proyecto. Puedes aplicar un preset, pasar configuración sin procesar, o ambas (primero se aplica el preset y luego se fusionan las sobrescrituras de configuración por encima).

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

Campos

string

Aplica un preset reutilizable. Omítelo para dejar el preset actual sin cambios.

object

Patch aplicado por encima del preset. Usa style para sobrescrituras con forma de preset, además de campos locales del proyecto como displayLanguages, chordSettings y duetSingerFilter.

Descubrir campos válidos

Convierte el esquema de actualización a JSON Schema en tiempo de ejecución para descubrir todos los campos válidos:

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

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

Los agentes deberían llamar a esto antes de modificar la configuración del proyecto para que siempre conozcan la forma actual.

Patrones comunes

Recorte
Color de fondo
Idiomas de visualización
Aplicar 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",
});