يمكن للفيديو أن يكون لديه أغطية أوتوماتيكية إنجليزية، وتتبع إسباني مقدم من المحملين، سواء أو لا. طلب لغة لا يخلق مساراً لا يملكه الفيديو. ويوضح هذا الدليل الخيار الصريح ويبيّن كيفية إنقاذ المسار المختار دون الاستعاضة بصمت عن لغة أخرى أو مصدر آخر للاختفاء.
المقتطفات الآلية والاختفاءات المقدمة من المحمل
وتكشف شركة FlashData عن مصدرين مناسبين: youtube_transcript التخلف عن السداد التلقائي، في حين youtube_captions التخلف عن الدفعات المزودة بأجهزة تحميل كلاهما يؤيدان صراحة params.auto القيمة: true اختيار الاسطوانات التلقائية false يَختارُ أغطيةَ مُقدّمةَ مُحمّلةَ. واسترجع كلاهما الأصفاد الحالية من طراز YouTube وفترات العودة المأخوذة.
المجموعة params.language إلى المسار الذي تحتاجه، على سبيل المثال en, es أو en-US. لا يعني رمز المنطقة ورمز اللغة وحدها الدعم نفسه. إذا لم تتوفر اللغة ومصدر الترجمة المطلوبان، فقد يفشل الطلب أو لا يعيد نصًا صالحًا للاستخدام. لا تترجم API النص تلقائيًا ولا تحوّل الكلام إلى نص ولا تنتقل تلقائيًا بين مصادر الترجمة.
اختر مسارا واحدا قبل إرسال الطلب
Use Node.js 22 or later and an مفتاح API مع الائتمانات المتاحة ضع شريط فيديو رقم ID يسمح لك بالعملية. وللاطلاع على النص الأساسي لتدفق الأعمال التصديرية، انظر ! YouTube ترجمة: JavaScript.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_VIDEO_ID='your-video-id'
export CAPTION_LANGUAGE='en'
export CAPTION_AUTO='true'
الاستخدام CAPTION_AUTO=false أن نطلب مساراً مقدماً من المحمل النص يرسل بالضبط طلب واحد. وهي لا تحاول كل لغة أو تصدر طلباً ثانياً مدفوعة الأجر تلقائياً عندما تفشل اللغة الأولى.
إلتقط المسار المختار واحتفظ بالمصابيح
وفّر الرمز التالي caption-track.mjs. وهو يصادق على اختيار المدخلات، ويتحقق من الأخطاء على مستوى الأدوات، فضلاً عن إخفاقات شركة HTTP، ويحفظ المعلومات اللغوية والمصدرية المبلغ عنها في الرد.
import { writeFile } from "node:fs/promises";
const key = process.env.FLASHDATA_API_KEY;
const videoId = process.env.YOUTUBE_VIDEO_ID;
const language = process.env.CAPTION_LANGUAGE ?? "en";
const autoSetting = process.env.CAPTION_AUTO ?? "true";
if (!key || !/^[A-Za-z0-9_-]{11}$/.test(videoId ?? "")) {
throw new Error("Set FLASHDATA_API_KEY and an 11-character YOUTUBE_VIDEO_ID.");
}
if (!["true", "false"].includes(autoSetting)) {
throw new Error("CAPTION_AUTO must be true or false.");
}
if (!/^[A-Za-z0-9-]{1,35}$/.test(language)) {
throw new Error("Use a caption language code such as en or en-US.");
}
const auto = autoSetting === "true";
const source = auto ? "youtube_transcript" : "youtube_captions";
const response = await fetch("https://data.flashdata.dev/v1/queries/realtime", {
method: "POST",
headers: { "Content-Type": "application/json", "X-API-Key": key },
body: JSON.stringify({ source, video_id: videoId, params: { language, auto } }),
signal: AbortSignal.timeout(60000),
});
const payload = await response.json();
if (!response.ok || payload.error || payload.status !== "done") {
console.error(JSON.stringify({ httpStatus: response.status,
requestId: response.headers.get("x-request-id"),
detail: payload.detail ?? payload.message ?? payload.error }, null, 2));
throw new Error("Caption request failed. Inspect the error before trying another track.");
}
const track = payload.results?.[0];
if (!Array.isArray(track?.segments) || !track.segments.some(s => s.text?.trim())) {
throw new Error("No usable caption segments were returned for this selection.");
}
const saved = {
requested: { videoId, language, auto },
returned: { videoId: track.videoId, languageCode: track.languageCode,
isAutoGenerated: track.isAutoGenerated, segments: track.segments },
};
await writeFile("caption-track.json", JSON.stringify(saved, null, 2));
await writeFile("caption-track.txt", track.fullText || track.segments.map(s => s.text).join("\n"));
console.log(`Saved ${track.segments.length} segments from ${track.languageCode}`);
node caption-track.mjs
ماذا تفعل عندما يختفي المسار المطلوب
تحقق من الخطأ قبل تغيير أماكن الاختباء. مفتاح غير صحيح، أو عدم كفاية الائتمانات أو التفرغ ليس دليلاً على أن الفيديو يفتقر إلى الاختباءات.
إذا كنت قد حصلت بالفعل على البيانات الفيديو، وفحص
hasTranscriptsوtranscriptLanguagesكإشارة مفيدة. ولا تضمن اللغة المبلغ عنها وجود المسارات الآلية والمزودة بالأجهزة المحمولة على حد سواء بهذه اللغة.إذا كان المسار البديل مقبولاً لقضيّة استخدامك، إختاره عمداً، وأطلبه بشكل منفصل. تسجيل اللغة المطلوبة واللغة المعادة
isAutoGeneratedقيمة النص.إذا كان تدفق عملك يتطلب المسار الدقيق، علامة على البند غير متاح، والاستمرار في الفيديو الأخرى. تكرار إرسال نفس الطلب لن يخلق حالات اختفاء.
حافظ على اللغة والأوقات المثبتة في رسالتك
الأجزاء تحتوي على start, end و text; تقاس الزمان في ثواني أبق الفيديو ID واللغة عند تقسيم نسخة مستنسخة إلى أشرطة بحث. يمكن لشبكة فيديو موقوفة الزمن أن تساعد قارئ على التحقق من السياق الأصلي. تجنب معالجة جزء من الإخفاء كوصف جديد أن تطبيقك أنتج.
يمكن أن تحتوي الأصفاد الآلية على أخطاء في الاعتراف. إذا استخدمتم النص للموجزات أو المقذوفات، فوفروا وسيلة لتفتيش الجزء الأصلي والفيديو. فالإمكانية والدقة هما سؤالان منفصلان: فالاسترجاع الناجح لمسار لا يضمن صحة صياغته.
مقارنة Transcript API و Captions API, أو يستكشف YouTube Data APIs.