प्रीसेट एक पुन: उपयोग योग्य रेंडर कॉन्फ़िगरेशन है — बैकग्राउंड, सबटाइटल स्टाइल, लेआउट — जिसे आप किसी भी प्रोजेक्ट या एक्सपोर्ट पर लागू कर सकते हैं। जब आपके पास कई ट्रैक्स में एक जैसा लुक चाहिए, तब प्रीसेट्स का उपयोग करें।
preset का पूरा shape और हर enum-backed विकल्प देखने के लिए Render settings reference देखें।
client.presets.list(options?)
Authenticated अकाउंट के स्वामित्व वाले सभी प्रीसेट्स की सूची दें।
const presets = await client.presets.list();
presets.forEach((p) => console.log(p.id, p.name, p.isDefault));
client.presets.get(presetId, options?)
एक single प्रीसेट फ़ेच करें।
const preset = await client.presets.get("preset_abc123");
client.presets.create(body, options?)
एक नया प्रीसेट बनाएं।
const preset = await client.presets.create({
name: "Neon Night",
preset: {
background: {
type: "gradient",
colors: ["#12001f", "#2f0a57"],
angle: 90,
},
singerTextStyles: {
0: {
fontFamily: "Inter",
textColor: "#00f5ff",
effectColor: "#ff4fd8",
},
},
},
isDefault: false,
});
Youka UI में दिखाया जाने वाला डिस्प्ले नाम।
पूरा प्रीसेट बॉडी। human-readable फ़ील्ड मैप के लिए Render settings reference का उपयोग करें, या machine-readable schema के लिए KaraokePresetSchema.toJSONSchema() का। नए प्रीसेट को अकाउंट डिफ़ॉल्ट के रूप में मार्क करें। एक समय में केवल एक प्रीसेट
डिफ़ॉल्ट हो सकता है।
const preset = await client.presets.create(body, {
idempotencyKey: "create-neon-night-v1",
});
client.presets.update(presetId, body, options?)
मौजूदा प्रीसेट को patch करें। name, preset, और isDefault में से कोई भी subset पास करें।
const updated = await client.presets.update("preset_abc123", {
name: "Neon Night v2",
preset: {
singerTextStyles: {
0: { textColor: "#ff2a2a" },
},
},
});
client.presets.delete(presetId, options?)
एक प्रीसेट डिलीट करें।
await client.presets.delete("preset_abc123", {
idempotencyKey: "delete-preset_abc123",
});
किसी प्रीसेट को डिलीट करने से वे प्रोजेक्ट्स या एक्सपोर्ट्स डिलीट नहीं होते जो पहले
उसके साथ रेंडर किए गए थे। डिलीट किए गए प्रीसेट को reference करने वाले भविष्य के एक्सपोर्ट्स फेल हो जाएंगे।
client.presets.setDefault(presetId, options?)
नए प्रोजेक्ट्स के लिए किसी प्रीसेट को डिफ़ॉल्ट के रूप में मार्क करें। यह client.presets.update(presetId, { isDefault: true }) के आसपास एक convenience wrapper है।
await client.presets.setDefault("preset_abc123");
वैध फ़ील्ड्स ढूंढना
SDK Zod schema एक्सपोर्ट करता है जो प्रीसेट बॉडीज़ को validate करता है। Agents और form builders के लिए runtime पर इसे JSON Schema में कन्वर्ट करें:
import { KaraokePresetSchema } from "@youka/sdk";
const jsonSchema = KaraokePresetSchema.toJSONSchema();
console.log(jsonSchema);
Agent authors: प्रीसेट्स को mutate करने से पहले इस schema को कॉल करें ताकि मॉडल को
exact फ़ील्ड नाम और वैल्यू टाइप्स पता हों।
प्रीसेट लागू करना
तीन जगहों पर प्रीसेट्स लागू करें:
प्रोजेक्ट बनाते समय
प्रोजेक्ट सेटिंग्स पर
एक्सपोर्ट पर
await client.projects.create({
source: { type: "path", path: "./song.mp3" },
presetId: "preset_abc123",
});
await client.projects.updateSettings("prj_abc123", {
presetId: "preset_abc123",
});
await client.exports.create("prj_abc123", {
presetId: "preset_abc123",
resolution: "1080p",
});
आगे क्या
