प्रोजेक्ट सेटिंग्स

हर प्रोजेक्ट में सक्रिय सेटिंग्स होती हैं — trim, background, subtitle style, layout — जो यह नियंत्रित करती हैं कि exports कैसे रेंडर होते हैं। जब आपको प्रोजेक्ट-लोकल overrides चाहिए हों जो किसी shared preset में बंडल करने लायक न हों, तब project settings का उपयोग करें। shared preset, settings.style, और settingsOverride फ़ील्ड मैप के लिए Render settings reference देखें।

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

किसी प्रोजेक्ट की सक्रिय सेटिंग्स फ़ेच करें।

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

सक्रिय प्रोजेक्ट सेटिंग्स को patch करें। आप एक preset लागू कर सकते हैं, raw settings पास कर सकते हैं, या दोनों (पहले preset लागू होता है, फिर settings overrides ऊपर merge होते हैं)।

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

फ़ील्ड्स

presetId

string

एक पुन: उपयोग योग्य preset लागू करें। मौजूदा preset को अपरिवर्तित रखने के लिए इसे छोड़ दें।

settings

object

preset के ऊपर लागू होने वाला patch। preset-जैसे overrides के लिए style का उपयोग करें, साथ ही प्रोजेक्ट-लोकल फ़ील्ड्स जैसे displayLanguages, chordSettings, और duetSingerFilter।

वैध फ़ील्ड्स ढूँढना

हर वैध फ़ील्ड खोजने के लिए runtime पर update schema को JSON Schema में कन्वर्ट करें:

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

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

Agents को project settings mutate करने से पहले यह कॉल करना चाहिए, ताकि उन्हें हमेशा वर्तमान shape पता रहे।

सामान्य पैटर्न

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