إعدادات المشروع

يمتلك كل مشروع إعدادات نشطة — القص، والخلفية، ونمط الترجمة، والتخطيط — تتحكم في كيفية إخراج النتائج عند التصدير. استخدم إعدادات المشروع عندما تريد تجاوزات محلية على مستوى المشروع لا تستحق تضمينها ضمن إعداد مسبق مشترك. راجع مرجع إعدادات الإخراج لخرائط الحقول المشتركة: preset وsettings.style وsettingsOverride.

`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) على إعدادات المشروع النشطة. يمكنك تطبيق إعداد مسبق، أو تمرير إعدادات خام، أو كليهما (يتم تطبيق الإعداد المسبق أولًا، ثم تُدمَج تجاوزات الإعدادات فوقه).

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

الحقول

string

طبّق إعدادًا مسبقًا قابلًا لإعادة الاستخدام. احذفه لترك الإعداد المسبق الحالي دون تغيير.

object

تصحيح يُطبَّق فوق الإعداد المسبق. استخدم style للتجاوزات التي تأخذ شكل الإعدادات المسبقة، بالإضافة إلى الحقول المحلية للمشروع مثل displayLanguages وchordSettings و duetSingerFilter.

اكتشاف الحقول الصالحة

حوّل مخطط التحديث إلى JSON Schema أثناء التشغيل لاكتشاف كل حقل صالح:

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

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

ينبغي على الوكلاء استدعاء هذا قبل تعديل إعدادات المشروع لكي يعرفوا دائمًا البنية الحالية.

أنماط شائعة

قص
لون الخلفية
لغات العرض
تطبيق إعداد مسبق

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