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

يمتلك كل مشروع إعدادات نشطة — القص (trim)، الخلفية، نمط الترجمة (subtitle style)، التخطيط (layout) — تتحكم في كيفية توليد المخرجات. استخدم إعدادات المشروع عندما تريد تجاوزات محلية على مستوى المشروع لا تستحق تجميعها ضمن إعداد مسبق (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) إعدادات المشروع النشطة. يمكنك تطبيق إعداد مسبق (preset)، أو تمرير إعدادات خام، أو كلاهما (يُطبَّق الإعداد المسبق أولًا، ثم تُدمَج تجاوزات الإعدادات فوقه).

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

الحقول

string

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

object

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

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

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

import { RestUpdateProjectSettingsRequestSchema } from "@youka/ar/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",
});