تاریخ انتشار: 13 نوامبر 2024، آخرین به روز رسانی: 20 می 2025
توضیح دهنده | وب | برنامه های افزودنی | وضعیت کروم | قصد |
---|---|---|---|---|
MDN | مشاهده کنید | قصد آزمایش |
از Translator API در کروم برای ترجمه متن با مدل های هوش مصنوعی ارائه شده در مرورگر استفاده کنید.
وب سایت شما ممکن است از قبل محتوای وب سایت را به چندین زبان ارائه دهد تا برای مخاطبان جهانی قابل دسترسی باشد. با استفاده از Translator API، کاربران می توانند به زبان اول خود مشارکت کنند. برای مثال، کاربران میتوانند در چتهای پشتیبانی به زبان اول خود شرکت کنند و سایت شما میتواند قبل از خروج از دستگاه کاربر، آن را به زبانی که نمایندگان پشتیبانی شما استفاده میکنند ترجمه کند. این یک تجربه روان، سریع و فراگیر برای همه کاربران ایجاد می کند.
ترجمه محتوا در وب معمولاً نیاز به استفاده از سرویس ابری دارد. ابتدا محتوای مبدأ روی سرور آپلود میشود که ترجمه را به زبان مقصد اجرا میکند، سپس متن به دست آمده دانلود شده و به کاربر بازگردانده میشود. با اجرای ترجمه بر روی مشتری، در زمان مورد نیاز سفرهای سرور و هزینه میزبانی سرویس ترجمه صرفه جویی می کنید.
شروع کنید
Translator API از Chrome 138 stabil در دسترس است. ابتدا تشخیص ویژگی را اجرا کنید تا ببینید آیا مرورگر از Translator API پشتیبانی می کند یا خیر.
if ('Translator' in self) {
// The Translator API is supported.
}
در حالی که همیشه زبان مقصد ترجمه را می دانید، ممکن است همیشه زبان مبدأ را ندانید. در چنین مواردی، می توانید از زبان شناساگر API استفاده کنید.
الزامات سخت افزاری را بررسی کنید
زبان شناساگر و API های مترجم فقط روی دسکتاپ در کروم کار می کنند.
Prompt API، Summarizer API، Writer API، و Rewriter API در Chrome کار میکنند که شرایط زیر رعایت شود:
- سیستم عامل : ویندوز 10 یا 11؛ macOS 13+ (ونتورا و به بعد)؛ یا لینوکس Chrome for Android، iOS و ChromeOS هنوز توسط APIهای ما که توسط Gemini Nano پشتیبانی میشوند، پشتیبانی نمیشوند.
- فضای ذخیره سازی : حداقل 22 گیگابایت در حجمی که نمایه کروم شما را در خود دارد.
- GPU : به طور دقیق بیش از 4 گیگابایت VRAM.
- شبکه : داده های نامحدود یا اتصال نامحدود.
این الزامات برای شما در فرآیند توسعه و کاربرانی که با ویژگی هایی که می سازید کار می کنند وجود دارد.
پشتیبانی از جفت زبان را بررسی کنید
ترجمه با بستههای زبان مدیریت میشود که در صورت تقاضا دانلود میشوند. یک بسته زبان مانند یک فرهنگ لغت برای یک زبان خاص است.
-
sourceLanguage
: زبان فعلی متن. -
targetLanguage
: زبان نهایی که متن باید به آن ترجمه شود.
از کدهای کوتاه زبان BCP 47 به عنوان رشته استفاده کنید. به عنوان مثال، 'es'
برای اسپانیایی یا 'fr'
برای فرانسوی.
const translatorCapabilities = await Translator.availability({
sourceLanguage: 'es',
targetLanguage: 'fr',
});
// 'available'
availability()
availability یک وعده با مقادیر زیر برمی گرداند:
-
"unavailable"
: این پیاده سازی از ترجمه یا تشخیص زبان زبان های داده شده پشتیبانی نمی کند. -
"downloadable"
: پیاده سازی از ترجمه یا تشخیص زبان زبان های داده شده پشتیبانی می کند، اما برای ادامه دانلود نیاز است. دانلود ممکن است مدل مرورگر باشد. -
"downloading"
: پیاده سازی از ترجمه یا تشخیص زبان زبان های داده شده پشتیبانی می کند. مرورگر در حال تکمیل دانلود مداوم است، به عنوان بخشی از ایجاد شی مرتبط. -
"available"
: پیاده سازی از ترجمه یا تشخیص زبان زبان های داده شده پشتیبانی می کند و هر بارگیری مورد نیاز قبلاً کامل شده است.
به پیشرفت دانلود مدل با رویداد downloadprogress
گوش دهید:
const translator = await Translator.create({
sourceLanguage: 'es',
targetLanguage: 'fr',
monitor(m) {
m.addEventListener('downloadprogress', (e) => {
console.log(`Downloaded ${e.loaded * 100}%`);
});
},
});
اگر دانلود ناموفق باشد، رویدادهای downloadprogress
متوقف می شود و وعده ready
رد می شود.
مترجم را ایجاد و اجرا کنید
برای ایجاد یک مترجم، تابع create()
ناهمزمان را فراخوانی کنید. به یک پارامتر گزینه با دو فیلد نیاز دارد، یکی برای sourceLanguage
و دیگری برای targetLanguage
.
// Create a translator that translates from English to French.
const translator = await Translator.create({
sourceLanguage: 'en',
targetLanguage: 'fr',
});
هنگامی که یک مترجم دارید، translate()
ناهمزمان را فراخوانی کنید.
await translator.translate('Where is the next bus stop, please?');
// "Où est le prochain arrêt de bus, s'il vous plaît ?"
ترجمه های متوالی
ترجمه ها به صورت متوالی پردازش می شوند. اگر حجم زیادی از متن را برای ترجمه ارسال کنید، ترجمه های بعدی تا زمانی که ترجمه های قبلی کامل شوند مسدود می شوند.
برای بهترین پاسخ به درخواستهایتان، آنها را با هم تکه تکه کنید و یک رابط بارگذاری ، مانند اسپینر، اضافه کنید تا نشان دهید که ترجمه در حال انجام است.
نسخه ی نمایشی
میتوانید API مترجم را که در ترکیب با API آشکارساز زبان استفاده میشود، در زمین بازی مترجم و زبانشناس API مشاهده کنید.
تلاش برای استانداردسازی
ما در حال کار برای استانداردسازی API مترجم هستیم تا از سازگاری بین مرورگرها اطمینان حاصل کنیم.
پیشنهاد API ما پشتیبانی جامعه را دریافت کرد و برای بحث بیشتر به گروه انجمن انکوباتور وب W3C منتقل شد. تیم کروم از گروه معماری فنی W3C بازخورد درخواست کرد و از موزیلا و WebKit برای موقعیتهای استانداردشان درخواست کرد.
شما می توانید با پیوستن به گروه انجمن انکوباتور وب در تلاش استانداردها شرکت کنید.
بازخورد را به اشتراک بگذارید
ما میخواهیم ببینیم که با زبانشناس API چه میسازید. وب سایت ها و برنامه های کاربردی وب خود را با ما در X ، YouTube و LinkedIn به اشتراک بگذارید.
برای بازخورد در مورد اجرای Chrome، یک گزارش اشکال یا یک درخواست ویژگی ارسال کنید.