تاریخ انتشار: 24 سپتامبر 2024، آخرین به روز رسانی: 20 مه 2025
قبل از ترجمه متن از یک زبان به زبان دیگر، ابتدا باید تعیین کنید که در متن داده شده از چه زبانی استفاده شده است. پیش از این، ترجمه نیاز به آپلود متن در یک سرویس ابری، انجام ترجمه روی سرور و سپس دانلود نتایج داشت.
زبان شناساگر API در سمت مشتری کار می کند، به این معنی که می توانید از حریم خصوصی کاربر محافظت کنید. در حالی که امکان ارسال یک کتابخانه خاص که این کار را انجام می دهد وجود دارد، برای دانلود به منابع بیشتری نیاز دارد.
زمان استفاده از تشخیص زبان
زبان شناساگر API در درجه اول در سناریوهای زیر مفید است:
- زبان متن ورودی را تعیین کنید تا بتوان آن را ترجمه کرد.
- زبان متن ورودی را تعیین کنید تا بتوان مدل صحیح را برای کارهای خاص زبان، مانند تشخیص سمیت، بارگذاری کرد.
- زبان متن ورودی را تعیین کنید تا بتوان آن را به درستی برچسب گذاری کرد، مثلاً در سایت های شبکه اجتماعی آنلاین.
- زبان متن ورودی را تعیین کنید تا رابط برنامه را بتوان بر این اساس تنظیم کرد. به عنوان مثال، در یک سایت بلژیکی فقط رابط مربوط به کاربران فرانسوی را نشان می دهد.
شروع کنید
تشخیص ویژگی را اجرا کنید تا ببینید آیا مرورگر از API آشکارساز زبان پشتیبانی میکند یا خیر.
if ('LanguageDetector' in self) {
// The Language Detector API is available.
}
دانلود مدل
تشخیص زبان به مدلی بستگی دارد که برای کار خاص تشخیص زبان ها به خوبی تنظیم شده باشد. در حالی که API در مرورگر ساخته شده است، اولین باری که یک سایت سعی می کند از API استفاده کند، مدل بر اساس تقاضا دانلود می شود. در کروم، این مدل در مقایسه با مدل های دیگر بسیار کوچک است. ممکن است قبلاً وجود داشته باشد، زیرا این مدل توسط سایر ویژگیهای Chrome استفاده میشود.
برای تعیین اینکه آیا مدل آماده استفاده است، تابع LanguageDetector.availability()
ناهمزمان را فراخوانی کنید. اگر پاسخ به availability()
downloadable
بود، به پیشرفت دانلود گوش دهید و به کاربر اطلاع دهید، زیرا دانلود ممکن است زمان ببرد.
برای شروع دانلود و نمونهسازی آشکارساز زبان، فعالسازی کاربر را بررسی کنید. سپس، تابع LanguageDetector.create()
ناهمزمان را فراخوانی کنید.
const detector = await LanguageDetector.create({
monitor(m) {
m.addEventListener('downloadprogress', (e) => {
console.log(`Downloaded ${e.loaded * 100}%`);
});
},
});
ردیاب زبان را اجرا کنید
زبان شناساگر 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
// ...
زمین بازی API
با زبان شناساگر API در زمین بازی API ما آزمایش کنید. متن نوشته شده به زبان های مختلف را در قسمت متن وارد کنید.
خط مشی مجوز، iframes، و کارگران وب
بهطور پیشفرض، زبان شناساگر API فقط برای پنجرههای سطح بالا و iframeهای همان مبدا در دسترس است. دسترسی به API را می توان با استفاده از ویژگی Permission Policy allow=""
به iframe های متقاطع واگذار کرد:
<!--
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>
زبان شناساگر API در Web Workers در دسترس نیست. این به دلیل پیچیدگی ایجاد یک سند مسئول برای هر کارگر به منظور بررسی وضعیت خط مشی مجوزها است.
بازخورد خود را به اشتراک بگذارید
ما میخواهیم ببینیم که با زبانشناس API چه میسازید. وب سایت ها و برنامه های کاربردی وب خود را با ما در X ، YouTube و LinkedIn به اشتراک بگذارید.
اگر بازخوردی در مورد اجرای Chrome دارید، یک اشکال Chromium را ثبت کنید.