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

يمتلك كل مشروع إعدادات نشطة — القصّ (trim)، الخلفية، نمط الترجمة، التخطيط — تتحكم في كيفية إخراج عمليات التصدير. استخدم إعدادات المشروع عندما تريد تجاوزات محلية على مستوى المشروع لا تستحق تجميعها ضمن إعداد مسبق (preset) مشترك. راجع مرجع إعدادات العرض لخريطة الحقول المشتركة 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 },
  },
});

الحقول

presetId

string

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

settings

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