Skip to main content
मीडिया पुन: उपयोग योग्य फाइलें हैं — वीडियो बैकग्राउंड, स्थिर इमेज, लोगो, और इंट्रो/आउट्रो क्लिप्स — जिन्हें आप प्रीसेट्स या प्रोजेक्ट सेटिंग्स से संदर्भित कर सकते हैं। एक बार अपलोड करें और प्रोजेक्ट्स में बार-बार उपयोग करें।

मीडिया प्रकार

प्रकारविवरण
videoलूप होने वाला बैकग्राउंड वीडियो।
imageस्थिर बैकग्राउंड इमेज।
logoलोगो ओवरले।
intro-videoकराओके शुरू होने से पहले चलता है।
outro-videoकराओके समाप्त होने के बाद चलता है।

client.media.list(options?)

प्रमाणीकृत खाते के स्वामित्व वाले हर पुन: उपयोग योग्य मीडिया आइटम की सूची बनाएं।
const media = await client.media.list();

client.media.get(mediaId, options?)

एकल मीडिया आइटम प्राप्त करें।
const media = await client.media.get("bg_abc123");

client.media.create(body, options?)

लोकल पाथ, बाइट्स, या पहले से अपलोड किए गए inputFileId से नया मीडिया आइटम बनाएं। लोकल पाथ और बाइट्स के लिए, SDK अपलोड तैयार करता है, फाइल बाइट्स को अपलोड URL पर भेजता है, और अपलोड की गई फाइल को पुन: उपयोग योग्य मीडिया के रूप में रजिस्टर करता है।
const media = await client.media.create({
  type: "video",
  source: {
    type: "path",
    path: "./background.mp4",
    contentType: "video/mp4",
  },
});
type
'video' | 'image' | 'logo' | 'intro-video' | 'outro-video'
required
यह मीडिया आइटम रेंडर में किस भूमिका को पूरा करता है।
source
object
फाइल स्रोत। लोकल फाइलों के लिए { type: "path", path }, Blob, File, ArrayBuffer, या टाइप्ड ऐरे डेटा के लिए { type: "bytes", data, filename }, या जब आपके पास पहले से अपलोड ID हो तो { type: "inputFile", inputFileId } का उपयोग करें।
inputFileId
string
उन्नत लो-लेवल विकल्प: source की जगह client.uploads.create(...) द्वारा लौटाया गया ID पास करें।

client.media.delete(mediaId, options?)

एक मीडिया आइटम हटाएं।
await client.media.delete("bg_abc123", {
  idempotencyKey: "delete-bg_abc123",
});
मीडिया हटाने से उन प्रोजेक्ट्स या एक्सपोर्ट्स पर कोई असर नहीं पड़ता जिन्हें पहले इसके साथ रेंडर किया जा चुका है। हटाए गए मीडिया को संदर्भित करने वाले भविष्य के रेंडर्स डिफ़ॉल्ट बैकग्राउंड पर वापस चले जाएंगे।

एंड-टू-एंड उदाहरण

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

const client = new YoukaClient({ apiKey: process.env.YOUKA_API_KEY! });

async function uploadBackground(path: string, contentType: string) {
  return client.media.create({
    type: "video",
    source: {
      type: "path",
      path,
      contentType,
    },
  });
}

const media = await uploadBackground("./loop.mp4", "video/mp4");
console.log("Media ID:", media.id);

बैकग्राउंड लागू करना

प्रीसेट से या सीधे प्रोजेक्ट सेटिंग्स से अपलोड किए गए मीडिया को संदर्भित करें:
const media = await uploadBackground("./loop.mp4", "video/mp4");

await client.projects.updateSettings("prj_abc123", {
  settings: {
    style: {
      background: {
        type: "video",
        url: media.url,
        objectFit: "cover",
      },
    },
  },
});
background के अंतर्गत स्वीकार किए जाने वाले फील्ड्स के पूर्ण सेट के लिए, प्रोजेक्ट सेटिंग्स स्कीमा को JSON में कन्वर्ट करें:
import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

आगे क्या

  • Render settings reference — सभी साझा फील्ड पाथ्स और enum मान
  • Projects — प्रोजेक्ट निर्माण और अपलोड्स
  • Presets — अन्य रेंडर सेटिंग्स के साथ मीडिया को बंडल करें
  • Project settings — किसी प्रोजेक्ट पर बैकग्राउंड लागू करें