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 anulaciones locales del proyecto que no merecen 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 parche a la configuración activa del proyecto. Puedes aplicar un preset, pasar configuración en bruto o ambas (primero se aplica el preset y luego se fusionan las anulaciones 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

Parche aplicado por encima del preset. Usa style para anulaciones con la misma forma que el 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 mutar 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",
});