تاريخ النشر: 24 سبتمبر 2024، تاريخ آخر تعديل: 20 مايو 2025
قبل ترجمة نص من لغة إلى أخرى، يجب أولاً تحديد اللغة المستخدمة في النص المحدّد. في السابق، كانت الترجمة تتطلب تحميل النص إلى خدمة سحابية، وإجراء الترجمة على الخادم، ثم تنزيل النتائج.
تعمل واجهة Language Detector API من جهة العميل، ما يعني أنّه يمكنك حماية خصوصية المستخدم. ومع أنّه من الممكن شحن مكتبة معيّنة تؤدي هذه المهمة، ستتطلّب هذه العملية موارد إضافية لتنزيلها.
حالات استخدام ميزة "رصد اللغة"
تكون Language Detector API مفيدة بشكل أساسي في الحالات التالية:
- تحديد لغة النص المُدخَل لترجمته
- تحديد لغة النص المُدخَل، ليتم تحميل النموذج الصحيح للمهام الخاصة باللغة، مثل رصد اللغة السامة
- تحديد لغة النص المُدخَل، ليتم تصنيفه بشكل صحيح، على سبيل المثال، في شبكات التواصل الاجتماعي على الإنترنت
- تحديد لغة النص المُدخَل، بحيث يمكن تعديل واجهة التطبيق وفقًا لذلك على سبيل المثال، في موقع إلكتروني بلجيكي، يمكنك عرض الواجهة ذات الصلة بالمستخدمين الذين يتحدثون الفرنسية فقط.
البدء
تعمل واجهتا برمجة التطبيقات Language Detector وTranslator في Chrome على الكمبيوتر المكتبي. لا تعمل واجهات برمجة التطبيقات هذه على الأجهزة الجوّالة.
شغِّل ميزة رصد الميزات لمعرفة ما إذا كان المتصفّح متوافقًا مع Language Detector API.
if ('LanguageDetector' in self) {
// The Language Detector API is available.
}
تنزيل النموذج
يعتمد رصد اللغة على نموذج تم ضبطه بدقة لمهمة رصد اللغات المحدّدة. مع أنّ واجهة برمجة التطبيقات مضمّنة في المتصفّح، يتم تنزيل النموذج عند الطلب في المرة الأولى التي يحاول فيها موقع إلكتروني استخدام واجهة برمجة التطبيقات. في Chrome، هذا النموذج صغير جدًا مقارنةً بالنماذج الأخرى. قد يكون النموذج متوفّرًا، لأنّه يُستخدم في ميزات أخرى في Chrome.
لتحديد ما إذا كان النموذج جاهزًا للاستخدام، يمكنك استدعاء الدالة غير المتزامنة
LanguageDetector.availability(). إذا كان الردّ على "availability()" هو "downloadable"، يُرجى الاستماع إلى مستوى التقدُّم في عملية التنزيل وإعلام المستخدم به، لأنّ عملية التنزيل قد تستغرق بعض الوقت.
لبدء عملية التنزيل وإنشاء مثيل لأداة رصد اللغة، تحقَّق من نشاط المستخدم. بعد ذلك، استدعِ الدالة غير المتزامنة LanguageDetector.create().
const detector = await LanguageDetector.create({
monitor(m) {
m.addEventListener('downloadprogress', (e) => {
console.log(`Downloaded ${e.loaded * 100}%`);
});
},
});
تشغيل أداة رصد اللغة
تستخدم Language Detector API نموذج ترتيب لتحديد اللغة التي يُرجَّح استخدامها في نص معيّن. الترتيب هو نوع من أنواع تعلُّم الآلة، ويهدف إلى ترتيب قائمة من العناصر. في هذه الحالة، ترتّب واجهة Language Detector API اللغات من الأعلى إلى الأدنى احتمالاً.
يمكن أن تعرض الدالة detect() النتيجة الأولى أو الإجابة الأكثر احتمالاً أو تكرار المرشحين المصنفين حسب مستوى الثقة.
ويتم عرض ذلك كقائمة من عناصر {detectedLanguage, confidence}. يتم التعبير عن مستوى confidence كقيمة بين 0.0 (أدنى مستوى ثقة) و1.0 (أعلى مستوى ثقة).
const someUserText = 'Hallo und herzlich willkommen!';
const results = await detector.detect(someUserText);
for (const result of results) {
// Show the full list of potential languages with their likelihood, ranked
// from most likely to least likely. In practice, one would pick the top
// language(s) that cross a high enough threshold.
console.log(result.detectedLanguage, result.confidence);
}
// (Output truncated):
// de 0.9993835687637329
// en 0.00038279531872831285
// nl 0.00010798392031574622
// ...
مساحة تجربة واجهة برمجة التطبيقات
يمكنك تجربة واجهة Language Detector API في مساحة تجربة واجهة برمجة التطبيقات. أدخِل نصًا مكتوبًا بلغات مختلفة في مربّع النص.
سياسة الأذونات وإطارات iframe وWeb Workers
لا تتوفّر واجهة Language Detector API تلقائيًا إلا للنوافذ ذات المستوى الأعلى وإطارات iframe من المصدر نفسه. يمكن تفويض الوصول إلى واجهة برمجة التطبيقات إلى إطارات iframe متعدّدة المصادر
باستخدام سمة "سياسة الأذونات" allow="":
<!--
The hosting site at https://main.example.com can grant a cross-origin iframe
at https://cross-origin.example.com/ access to the Language Detector API by
setting the `allow="language-detector"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="language-detector"></iframe>
لا تتوفّر Language Detector API في Web Workers. ويرجع ذلك إلى تعقيد إنشاء مستند مسؤول لكل عامل من أجل التحقّق من حالة سياسة الأذونات.
مشاركة ملاحظاتك
نريد الاطّلاع على ما تنشئه باستخدام Language Detector API. شارِك مواقعك الإلكترونية وتطبيقات الويب معنا على X وYouTube وLinkedIn.
إذا كانت لديك ملاحظات حول تنفيذ Chrome، يمكنك الإبلاغ عن خطأ في Chromium.
انضم إلى برنامج النسخة المبكرة الحصرية لإلقاء نظرة مبكرة على واجهات برمجة التطبيقات الجديدة المستندة إلى الذكاء الاصطناعي المدمج والوصول إلى المناقشات على قائمتنا البريدية.