ترجمہ کی زیادہ تر خصوصیات اسی طرح کام کرتی ہیں۔ جب صارف متن داخل کرتا ہے، تو آپ کی ایپ اسے ترجمہ API کو بھیجتی ہے، اور API ترجمہ کو واپس بھیجتا ہے۔ یہ کام کرتا ہے، لیکن یہ ہر درخواست میں لاگت اور تاخیر کا اضافہ کرتا ہے اور صارف کے متن کو آلہ چھوڑنے کا سبب بنتا ہے۔
کروم اب دو بلٹ ان AI APIs پیش کرتا ہے جو اسے تبدیل کرتے ہیں۔ مترجم API اور زبان کا پتہ لگانے والا API. Chrome ضرورت کے مطابق چھوٹے، خصوصی ماڈلز ڈاؤن لوڈ کرتا ہے اور انہیں صارف کے آلے پر چلاتا ہے۔ آپ ماڈلز کی میزبانی نہیں کرتے، انفرنس سرور نہیں چلاتے، یا فی درخواست ادائیگی نہیں کرتے۔ JavaScript API کو کال کریں۔
اس ٹیوٹوریل میں، ہم Next.js میں درج ذیل مترجم بناتے ہیں:
- صارف کی قسم کے متن کی زبان کا پتہ لگاتا ہے۔
- اپنی پسند کی زبان میں ترجمہ کریں۔
- آپ کے صفحہ پر Chrome کے ذریعے تخلیق کردہ تراجم کو سٹریم کریں۔
- لینگویج پیک ڈاؤن لوڈ کی پیشرفت دکھاتا ہے اور صارف کو منسوخ کرنے کی اجازت دیتا ہے۔
- ترجمہ کاپی کریں، اسے بلند آواز سے پڑھیں، اور پھر دو زبانوں کے درمیان تبادلہ کریں۔
- ایسے براؤزرز کو ہینڈل کرتا ہے جو API کو سپورٹ نہیں کرتے ہیں۔
انڈیکس
- شرطیں
- انٹرنیشنلائزیشن بمقابلہ AI ترجمہ
- کروم کا بلٹ ان AI API کیسے کام کرتا ہے۔
- پہلے، کھیل کے میدان میں API استعمال کرنے کی کوشش کریں۔
- Next.js پروجیکٹ کو کیسے ترتیب دیا جائے۔
- زبان کی تعریف کیسے کی جائے۔
- کروم API کو کیسے لپیٹیں۔
- ترجمہ ہک بنانے کا طریقہ
- انٹرفیس بنانے کا طریقہ
- اپنی ایپ کو چلانے اور جانچنے کا طریقہ
- حدود اور پیداوار کے تحفظات
- نتیجہ
شرطیں
آپ کو اس کے ساتھ آرام دہ ہونا چاہئے:
- جاوا اسکرپٹ یا ٹائپ اسکرپٹ
- رد عمل کی بنیادی باتیں (اجزاء، سہارے،
useState،useEffect) - ٹرمینل میں کمانڈ چلائیں۔
آپ کو ضرورت ہو گی:
- Node.js 20.9 یا اس سے زیادہ۔
- ڈیسک ٹاپ کروم 138 یا اس سے اوپر۔ مترجم اور زبان کا پتہ لگانے والے APIs ڈیسک ٹاپ پر Chrome میں کام کرتے ہیں۔ یہ موبائل آلات پر کام نہیں کرتا ہے، اور Firefox اور Safari اس کی حمایت نہیں کرتے ہیں۔ کروم کے براؤزر سپورٹ ٹیبل میں ایج (148) کی فہرست بھی ہے۔ میں نے میک او ایس پر کروم 156 میں اس ٹیوٹوریل کا تجربہ کیا۔
آپ کو مشین لرننگ کے بارے میں کچھ جاننے کی ضرورت نہیں ہے۔
انٹرنیشنلائزیشن بمقابلہ AI ترجمہ
کوئی بھی کوڈ لکھنے سے پہلے ان دو آسانی سے الجھے ہوئے خیالات کو الگ کریں۔
بین الاقوامی کاری (i18n) متعدد زبانوں اور خطوں کے لیے انٹرفیس تیار کریں، بشمول زبان کا انتخاب، مقام سے آگاہی کی تاریخیں، نمبرز، اور کرنسی، دائیں سے بائیں (RTL) لے آؤٹ، اور انسانوں کے ذریعہ تحریری اور جائزہ لینے والے جامد انٹرفیس کے تار۔
const messages = {
en: { welcome: "Welcome", description: "Explore our platform" },
fr: { welcome: "Bienvenue", description: "Explorez notre plateforme" },
es: { welcome: "Bienvenido", description: "Explora nuestra plataforma" },
};
AI پر مبنی ترجمہ تبصرے، جائزے، امدادی پیغامات اور پوسٹس سمیت کسی نے پہلے سے نہ لکھے ہوئے مواد کے لیے فلائی ترجمہ بنائیں۔
| اصل i18n | AI پر مبنی ترجمہ |
|---|---|
| پہلے سے طے شدہ ترجمہ استعمال کریں۔ | متحرک طور پر ترجمے بنائیں۔ |
| انٹرفیس ٹیکسٹ کے لیے مثالی۔ | صارف کے تیار کردہ مواد کے لیے مثالی۔ |
| عام طور پر ڈویلپر کے زیر انتظام | یہ صوابدیدی متن کو سنبھال سکتا ہے۔ |
| متوقع آؤٹ پٹ | آؤٹ پٹ مختلف ہو سکتا ہے۔ |
AI ترجمہ i18n کی تکمیل کرتا ہے۔ یہ اس کی جگہ نہیں لیتا۔ بٹنوں اور مینوز کو اب بھی کیوریٹڈ تار کی ضرورت ہوتی ہے۔ Translator API ہر چیز میں خلا کو پُر کرتا ہے۔
کروم دستاویزات اچھی مثالیں فراہم کرتی ہیں۔ سپورٹ چیٹ میں، صارف اپنی مادری زبان میں لکھتے ہیں اور سائٹ پیغامات کو ایجنٹ کی زبان میں ترجمہ کرتی ہے۔ اس سے پہلے کہ پیغام آپ کے آلے سے نکل جائے۔.
کروم کا بلٹ ان AI API کیسے کام کرتا ہے۔
دو APIs ہیں اور وہ مل کر کام کرتے ہیں۔
LanguageDetectorمتن لیتا ہے اور 0 اور 1 کے درمیان ہر زبان کے اعتماد کے اسکور کی درجہ بندی کی فہرست لوٹاتا ہے۔Translatorایک زبان کے جوڑے کے لیے بنایا گیا، جیسے انگریزی سے ہسپانوی، اور ان زبانوں کے درمیان متن کا ترجمہ کریں۔
یہ کلاؤڈ API کو کال کرنے یا Transformers.js جیسی لائبریری کا استعمال کرتے ہوئے براہ راست ماڈل چلانے سے مختلف ہے۔
- براؤزر ماڈل کا مالک ہے۔ ہم ماڈل فائلوں کو بنڈل یا میزبانی نہیں کرتے ہیں۔ Chrome انہیں پہلی بار ڈاؤن لوڈ کرتا ہے جب کسی سائٹ کو ان کی ضرورت ہوتی ہے۔
- زبان کے پیک ترجمے کے لیے استعمال کیے جاتے ہیں۔ کروم دستاویزات لینگویج پیک کو "دی گئی زبان کے لیے ڈکشنریوں کی طرح” کے طور پر بیان کرتی ہیں جو ڈیمانڈ پر ڈاؤن لوڈ کی جاتی ہیں۔ ایک جوڑے کے لیے پہلا ترجمہ ڈاؤن لوڈ اور بعد میں اس کا دوبارہ استعمال شروع کرتا ہے۔
- ہر چیز متضاد اور اجازت سے آگاہ ہے۔ تم چیک کرو
availability()پہلے مجھے بلاؤcreate()آپ ڈاؤن لوڈ کی پیشرفت دیکھ سکتے ہیں۔
کے لیے ڈیزائن کرنے کے لیے چاروں رکاوٹیں کروم دستاویزات میں درج ہیں۔
- صارف کی ایکٹیویشن۔ ٹرانسڈیوسر یا ڈیٹیکٹر بنانے کے لیے صارف کی کارروائی کی ضرورت ہوتی ہے، جیسے کہ کلک، جب ماڈل کو ڈاؤن لوڈ کرنے کی ضرورت ہوتی ہے۔
- ویب کارکنوں کے پاس یہ نہیں ہے۔ دونوں APIs کارکنوں پر دستیاب نہیں ہیں، لہذا ہم انہیں مرکزی دھاگے سے کال کرتے ہیں۔ (کال غیر مطابقت پذیر ہے اور ماڈل JavaScript تھریڈ سے باہر چلتا ہے، لہذا UI بلاک نہیں ہوتا ہے۔)
- ترتیب وار پروسیسنگ۔ ترجمے پر باری باری کارروائی کی جاتی ہے۔ بڑی درخواستیں بعد میں آنے والی درخواستوں کو روکتی ہیں، اس لیے چنکنگ کام کرتی ہے اور لوڈنگ انڈیکیٹر دکھاتی ہے۔
- صرف ٹاپ لیول ونڈوز۔ پہلے سے طے شدہ طور پر، API ٹاپ لیول ونڈوز اور ایک ہی اوریجین iframes پر کام کرتا ہے۔ کراس اوریجن iframes کو اجازت کی پالیسیوں کی ضرورت ہوتی ہے۔
allowکی وجہ سے ہوتا ہے۔
کہ availability() دونوں APIs میں طریقے چار میں سے ایک قدر واپس کرتے ہیں، اور UI کو ہر ایک قدر پر کارروائی کرنی چاہیے۔
| قدر | معنی |
|---|---|
unavailable |
آپ کا براؤزر ان اختیارات کو سپورٹ نہیں کرتا ہے۔ |
downloadable |
تعاون یافتہ، لیکن پہلے ماڈل کو ڈاؤن لوڈ کرنے کی ضرورت ہے۔ |
downloading |
یہ تعاون یافتہ ہے اور ڈاؤن لوڈ پہلے ہی جاری ہے۔ |
available |
یہ تعاون یافتہ ہے اور آپ اسے ڈاؤن لوڈ کیے بغیر فوراً استعمال کر سکتے ہیں۔ |
رازداری کی ایک تفصیل: کروم صارف کی رازداری کے تحفظ کے لیے مخصوص زبان کے جوڑوں کے لیے ڈاؤن لوڈ کی حیثیت کو چھپاتا ہے۔ جب تک آپ کی سائٹ مترجمین کا ایک جوڑا تیار نہیں کرتی، تمام جوڑوں کو درج ذیل رپورٹ کیا جائے گا: downloadable.
پہلے، کھیل کے میدان میں API استعمال کرنے کی کوشش کریں۔
کوڈ لکھنے سے پہلے تجربہ کریں۔ بلٹ ان AI پلے گراؤنڈز میں یہ دونوں شامل ہیں، AI صلاحیتیں فراہم کرتے ہیں جنہیں Chrome JavaScript APIs کے طور پر ظاہر کرتا ہے۔ اسے ڈیسک ٹاپ کروم میں کھولیں اور درج ذیل کو آزمائیں:
- لینگویج ڈیٹیکٹر میں مختلف زبانوں میں چند جملے چسپاں کریں اور ان کے اعتماد کے اسکور پڑھیں۔
- ایک لفظ اور پھر پورا جملہ استعمال کرنے کی کوشش کریں۔ کروم دستاویزی متنبہ کرتا ہے کہ مختصر ان پٹ کے نتیجے میں کم درست نتائج برآمد ہوسکتے ہیں، اس لیے اعتماد کی قدروں کا موازنہ کریں۔
- دو زبانوں کے جوڑوں کے درمیان ترجمہ کریں۔ کروم کے لینگویج پیک ڈاؤن لوڈ کرنے کے دوران جوڑے کا پہلا ترجمہ رک سکتا ہے۔
آپ بالکل اسی طرز عمل کو اپنی ایپ میں بنا رہے ہوں گے۔
Next.js پروجیکٹ کو کیسے ترتیب دیا جائے۔
TypeScript اور App Router کا استعمال کرتے ہوئے ایک Next.js ایپ بنائیں۔ آپ کی مرضی کے مطابق باقی اشارے کا جواب دیں۔
npx create-next-app@latest chrome-ai-translator --ts --app --no-tailwind --no-src-dir --import-alias "@/*"
cd chrome-ai-translator
پھر کروم میں بنائے گئے AI API کے لیے TypeScript کی تعریفیں انسٹال کریں۔ TypeScript نہیں جانتا: Translator یا LanguageDetector اس کی وجہ یہ ہے کہ یہ ابھی تک معیاری DOM قسم نہیں ہے۔
npm install -D @types/dom-chromium-ai
پیکیج کا اعلان درج ذیل ہے: Translator، LanguageDetector چونکہ ہم متعلقہ قسم کو عالمی سطح پر استعمال کرتے ہیں، اس لیے کچھ بھی درآمد نہیں کیا جاتا ہے۔ ایڈیٹر اب خودکار تکمیل کرتا ہے۔ Translator.create() اور غلطیوں کی اطلاع دیں۔
حذف کریں app/page.module.css اور غیر استعمال شدہ تصاویر ہیں۔ public/. آپ بدل دیں app/page.tsx، app/layout.tsx اور app/globals.css. ان فولڈرز کو آگے بنائیں: app/:
chrome-ai-translator/
├── app/
│ ├── globals.css
│ ├── layout.tsx
│ └── page.tsx
├── components/
│ ├── language-select.tsx
│ ├── text-panel.tsx
│ ├── translator-app.tsx
│ └── unsupported-notice.tsx
├── hooks/
│ └── use-translation.ts
└── lib/
├── chrome-ai.ts
└── languages.ts
ہر فولڈر میں ایک کام ہوتا ہے۔
lib/اس میں سادہ ٹائپ اسکرپٹ ہے جو کروم کے API سے بات کرتا ہے۔hooks/اسے رد عمل کی حالت میں تبدیل کریں۔components/UI شامل ہے۔app/Next.js صفحات اور لے آؤٹ پر مشتمل ہے۔
زبان کی تعریف کیسے کی جائے۔
بنانا lib/languages.ts. کروم کے مترجم API کے ذریعہ تعاون یافتہ زبانیں درج ہیں (کروم دستاویزات دیکھیں)۔ Translator API درج ذیل BCP 47 کوڈز استعمال کرتا ہے: es یا zh-Hant:
/** Sentinel value for "detect the source language for me". */
export const AUTO = "auto";
export interface Language {
/** BCP 47 code, as expected by the Translator API. */
code: string;
name: string;
rtl?: boolean;
}
export const LANGUAGES: Language[] = [
{ code: "ar", name: "Arabic", rtl: true },
{ code: "de", name: "German" },
{ code: "en", name: "English" },
{ code: "es", name: "Spanish" },
{ code: "fr", name: "French" },
{ code: "he", name: "Hebrew", rtl: true },
// ...the full list of 39 languages is in the repository
{ code: "zh", name: "Chinese (Simplified)" },
{ code: "zh-Hant", name: "Chinese (Traditional)" },
];
export function languageName(code: string): string {
return LANGUAGES.find((language) => language.code === code)?.name ?? code;
}
export function isRtl(code: string): boolean {
return LANGUAGES.find((language) => language.code === code)?.rtl ?? false;
}
ٹیوٹوریل کے لیے سخت کوڈ والی فہرست ٹھیک ہوگی، لیکن کروم کا کہنا ہے کہ فہرست عمل درآمد پر منحصر ہے، تبدیلی کے تابع ہے، اور اس میں ابھی تک متحرک طور پر تلاش کرنے کی صلاحیت نہیں ہے۔ اسی لیے ایپ اب بھی کال کرتی ہے۔ Translator.availability() کسی بھی ترجمہ سے پہلے۔ فہرست صرف اس بات کا تعین کرتی ہے کہ ڈراپ ڈاؤن میں کیا ظاہر ہوتا ہے۔
کہ rtl جھنڈا استعمال کرنے سے آؤٹ پٹ کو عربی اور عبرانی کے لیے دائیں سے بائیں پیش کیا جاتا ہے۔
کروم API کو کیسے لپیٹیں۔
اب آپ بنائیں گے lib/chrome-ai.ts. یہ فائل پروجیکٹ کا بنیادی حصہ ہے۔ یہ کروم کے مترجم اور لینگویج ڈیٹیکٹر APIs کو تمام کالز رکھتا ہے، لہذا باقی ایپ انہیں براہ راست نہیں چھوتی ہے۔
ایک وقت میں ایک ٹکڑا بنائیں، ہر ٹکڑے کو پچھلے ٹکڑے کے نیچے شامل کریں۔ اس فائل میں تمام مواد کلائنٹ کے جزو سے آتا ہے، کیونکہ یہ صرف براؤزر میں چلتا ہے۔
مرحلہ 1: مشترکہ مستقل، اقسام اور غلطیاں شامل کریں۔
ہم فائل کو چند چھوٹی تعریفوں کے ساتھ شروع کرتے ہیں جن پر بعد کے فنکشنز انحصار کرتے ہیں۔
/**
* Thin helpers around Chrome's built-in Translator and Language Detector APIs.
* Everything here runs in the browser only. Import it from Client Components.
*/
/** Below this confidence we ask the user to pick the language instead of guessing. */
export const CONFIDENCE_THRESHOLD = 0.6;
export type DownloadProgress = (fraction: number) => void;
export class LowConfidenceError extends Error {
constructor() {
super("We couldn't tell which language this is. Choose the source language manually.");
}
}
export class UnsupportedPairError extends Error {
constructor(source: string, target: string) {
super(`Chrome can't translate from "${source}" to "${target}" on this device.`);
}
}
ہر حصے کا کردار درج ذیل ہے:
CONFIDENCE_THRESHOLDلینگویج ڈیٹیکٹر کے ذریعہ کم سے کم اعتماد کا اسکور قبول کیا جاتا ہے۔ کھوج ایک امکان ہے، حقیقت نہیں۔ کروم دستاویزی متنبہ کرتا ہے کہ بہت مختصر جملے اور واحد الفاظ کم درستگی کے ساتھ نتائج دیں گے، اور اگر اعتماد بہت کم ہے تو نتائج کو نامعلوم کے طور پر استعمال کرنے کی سفارش کرتا ہے۔ جو ہک ہم بعد میں لکھیں گے وہ ہر نتیجہ کا اس نمبر سے موازنہ کرتا ہے۔0.6یہ ایک نقطہ آغاز ہے جسے آپ اپنے لیے موافقت کر سکتے ہیں۔DownloadProgressکال بیک کی قسم جو ڈاؤن لوڈ کی پیشرفت حاصل کرتی ہے۔ کروم اس کے حصے کے طور پر پیشرفت کی اطلاع دیتا ہے:0کو1تو0.5اس کا مطلب ہے کہ زبان کے آدھے پیک ڈاؤن لوڈ ہو چکے ہیں۔LowConfidenceErrorاس وقت ہوتا ہے جب ڈیٹیکٹر یہ نہیں بتا سکتا کہ متن کس زبان میں ہے۔ اس کی اپنی کلاس فراہم کرنے سے ہک اسے دوسری غلطیوں سے ممتاز کرنے کی اجازت دیتا ہے، اور اس کا پیغام صارف کو بتاتا ہے کہ آگے کیا کرنا ہے۔UnsupportedPairErrorایک خرابی اس وقت ہوتی ہے جب کروم کہتا ہے کہ وہ دو زبانوں کے درمیان ترجمہ نہیں کر سکتا۔ اس میں دونوں زبان کے کوڈ شامل ہیں تاکہ صارف کو معلوم ہو کہ کون سا جوڑا ناکام ہوا۔
مرحلہ 2: چیک کریں کہ آیا آپ کا براؤزر API کو سپورٹ کرتا ہے۔
خصوصیت کا پتہ لگانے کا فنکشن شامل کریں۔
/** Feature detection. Always false on the server, where `self.Translator` doesn't exist. */
export function isBuiltInAISupported(): boolean {
return typeof self !== "undefined" && "Translator" in self && "LanguageDetector" in self;
}
Next.js پہلے جزو کو سرور پر پیش کرتا ہے نہ کہ سرور پر۔ self.Translator. یہ فنکشن تین چیزوں کو چیک کرتا ہے:
typeof self !== "undefined"یقینی بنائیں کہ ہم حالات میں ہیں۔selfچونکہ یہ موجود ہے، فنکشن سرور پر کریش نہیں ہو سکتا۔"Translator" in selfTranslator API کے لیے Chrome دستاویزات میں یہ تجویز کردہ چیک ہے۔"LanguageDetector" in selfلینگویج ڈیٹیکٹر API کے لیے میچ چیکنگ۔ آپ کی ایپ کو دونوں کی ضرورت ہے، اس لیے یہ سپورٹ کی اطلاع صرف اس وقت دیتی ہے جب دونوں موجود ہوں۔
فنکشن واپس آتا ہے۔ true یا false اور میں اسے کبھی نہیں پھینکتا۔ آپ اسے بعد میں یہ فیصلہ کرنے کے لیے استعمال کریں گے کہ آیا اسے مترجم کے سامنے ڈسپلے کرنا ہے یا "غیر تعاون یافتہ” اطلاع ڈسپلے کرنا ہے۔
مرحلہ 3: ایک زبان کا پتہ لگانے والا بنائیں
اگلا، ڈیٹیکٹر بنانے کے لیے کوڈ شامل کریں۔ یہ پہلی جگہ ہے جسے آپ دیکھیں گے۔ monitor کال بیکس اور ڈاؤن لوڈ کی پیشرفت:
let detectorPromise: Promise | null = null;
function getDetector(onProgress?: DownloadProgress) {
detectorPromise ??= LanguageDetector.create({
monitor(monitor) {
monitor.addEventListener("downloadprogress", (event) => onProgress?.(event.loaded));
},
});
// If creation fails (e.g. no user activation), allow a retry on the next click.
detectorPromise.catch(() => {
detectorPromise = null;
});
return detectorPromise;
}
یہ ہے طریقہ: getDetector() فیکٹری:
detectorPromiseماڈیول سطح کا متغیر جو پکڑنے والا رکھتا ہے۔ ہم ہیں وعدہیہ مکمل پتہ لگانے والا نہیں ہے۔ اس طرح، اگر ایپ کے دو حصے بیک وقت ایک ڈیٹیکٹر کی درخواست کرتے ہیں، تو وہ دو شروع کرنے کے بجائے ایک کی تخلیق کا اشتراک کرتے ہیں۔??="اس کا مطلب ہے کہ متغیر صرف اس صورت میں تفویض کیا جاتا ہے جب:nullیاundefined"پہلی کال کی گئی ہے۔LanguageDetector.create()تمام بعد کی کالیں محفوظ کیے گئے وعدے کو دوبارہ استعمال کریں گی۔- کہ
monitorاختیارات کال بیکس ہیں جنہیں کروم اس طرح کال کرتا ہے:CreateMonitorاعتراض ہم اسے سنتے ہیں۔downloadprogressواقعات اور پاسزevent.loaded0 سے 1 حصہ،onProgress. کروم کا پتہ لگانے کا ماڈل چھوٹا ہے اور ہو سکتا ہے پہلے سے ہی ڈیوائس پر ہو، اس لیے ہو سکتا ہے کہ یہ ایونٹ فائر نہ ہو۔ ہم اب بھی اس سے نمٹتے ہیں کیونکہ اسے پہلی بار نکالا جا سکتا ہے۔ - کہ
.catch()دوبارہ ترتیب دیںdetectorPromiseکوnullاگر تخلیق ناکام ہو جائے۔ بصورت دیگر، ناکام کوششیں (مثلاً جب کروم کو کسی ایسے کلک کی توقع ہوتی ہے جو صارف کو نہیں ملی) ہمیشہ کے لیے کیش ہو جائے گی اور صارف دوبارہ کوشش نہیں کر سکے گا۔
مرحلہ 4: کچھ متن کی زبان کا پتہ لگائیں۔
اب آئیے ایک فنکشن شامل کرتے ہیں جو ڈیٹیکٹر استعمال کرتا ہے۔
export interface Detection {
language: string;
confidence: number;
}
export async function detectLanguage(
text: string,
onProgress?: DownloadProgress,
signal?: AbortSignal,
): Promise {
const detector = await getDetector(onProgress);
// Results are ranked from most to least likely. The last entry is always "und" (undetermined).
const [top] = await detector.detect(text, { signal });
if (!top?.detectedLanguage || top.detectedLanguage === "und") return null;
return { language: top.detectedLanguage, confidence: top.confidence ?? 0 };
}
یہاں یہ ہے کہ کوڈ کیا کرتا ہے:
- کہ
Detectionانٹرفیس بیان کرتا ہے کہ ہم کیا لوٹتے ہیں: ایک BCP 47 زبان کا کوڈ، جیسے"es"اعتماد سکور کے درمیان0اور1. detectLanguage()سب سے پہلے، ڈٹیکٹر کے آن ہونے کا انتظار کریں۔getDetector(). پاسonProgressUI کو ڈاؤن لوڈ بار ڈسپلے کرنے کے قابل بناتا ہے۔detector.detect(text, { signal })سب سے زیادہ امکان سے کم سے کم امکان تک درجہ بندی کے اندازوں کی فہرست لوٹاتا ہے۔detectedLanguageاورconfidence. کہsignalچاندیAbortSignalصارف جاری دریافت کو منسوخ کر سکتے ہیں۔- صف کو تباہ
[top]ہم صرف اپنا بہترین اندازہ لگاتے ہیں۔ - کروم کے نتائج میں آخری آئٹم ہمیشہ ہوتا ہے۔
undاس کا مطلب ہے "غیر متعین”۔ اس بات کا امکان کہ متن ماڈل کو معلوم زبان میں نہیں ہے۔ اگر آپ کا بہترین اندازہ غائب ہے یا:undفنکشن واپسیnullاس کا مطلب ہے "کوئی جواب نہیں”۔ - بصورت دیگر یہ زبان اور اعتماد لوٹاتا ہے۔ کہ
?? 0یہ ایک حفاظتی جال ہے کیونکہ ہمارے پاس TypeScript کی اقسام ہیں۔confidenceاختیاری طور پر۔
مرحلہ 5: مترجم بنائیں اور کیش کریں۔
ترجمہ وہ جگہ ہے جہاں زبان کی جوڑی کی منطق موجود ہے۔ اس میں شامل کریں:
// A Translator is tied to one language pair. Creating one is expensive, so we keep them around.
const translators = new Map();
export async function getTranslator(
sourceLanguage: string,
targetLanguage: string,
onProgress?: DownloadProgress,
signal?: AbortSignal,
): Promise {
const key = `${sourceLanguage}>${targetLanguage}`;
const cached = translators.get(key);
if (cached) return cached;
const availability = await Translator.availability({ sourceLanguage, targetLanguage });
if (availability === "unavailable") {
throw new UnsupportedPairError(sourceLanguage, targetLanguage);
}
const translator = await Translator.create({
sourceLanguage,
targetLanguage,
signal,
monitor(monitor) {
monitor.addEventListener("downloadprogress", (event) => onProgress?.(event.loaded));
},
});
translators.set(key, translator);
return translator;
}
یہ خصوصیت کروم دستاویزات میں بیان کردہ چار مراحل کے لائف سائیکل کی پیروی کرتی ہے۔
- اپنا کیش چیک کریں۔ کوئی راستہ نہیں
Translatorیہ بالکل ایک زبان کے جوڑے سے منسلک ہے۔ کیونکہ ایک بنانا مہنگا ہے، ہمMapان میں درج ذیل سٹرنگ ان پٹ ہے۔"en>es". اگر اس جوڑے کے لیے پہلے سے کوئی مترجم موجود ہے، تو یہ فوراً واپس آجاتا ہے۔ اس لیے دوسرے جملے کا ترجمہ تیز تر ہے۔ - دستیابی چیک کریں۔
Translator.availability()یہ آپ کو بتائے گا کہ آیا کروم اس جوڑے کو سنبھال سکتا ہے۔ یہ واپس آتا ہےunavailable،downloadable،downloadingیاavailable. پھرunavailableہم پھینکتے ہیںUnsupportedPairErrorاس سے پہلے کہ آپ کچھ اور آزمائیں، ڈاؤن لوڈ اس جوڑے کے لیے شروع نہیں ہوگا جو کام نہیں کرتا ہے۔ - ایک مترجم بنائیں۔
Translator.create()زبان کا جوڑا وصول کرتا ہے۔signalمنسوخ کرناmonitorیہ ایک ڈیٹیکٹر کی طرح ڈاؤن لوڈ کی پیشرفت کی اطلاع دیتا ہے۔ اگر آپ کو لینگویج پیک ڈاؤن لوڈ کرنے کی ضرورت ہے، تو Chrome اسے خود بخود یہاں سے ڈاؤن لوڈ کرنا شروع کر دے گا۔ اگر ڈاؤن لوڈ کی ضرورت ہے، تو یہ بھی ایک قدم ہے جس کے لیے صارف کے اشارے کی ضرورت ہوتی ہے جیسے کہ کلک۔ - رکھو اور واپس کرو۔ نئے مترجم کو درج ذیل مقام پر محفوظ کریں:
Mapاگلی بار اسے واپس کرنا یقینی بنائیں۔
مرحلہ 6: مکمل ہونے کے بعد، ماڈل جاری کریں۔
مفت میموری میں ایک فنکشن شامل کریں۔
/** Releases the memory held by the models. Call it when the user leaves the feature. */
export async function destroyAll() {
for (const translator of translators.values()) translator.destroy();
translators.clear();
const pending = detectorPromise;
detectorPromise = null;
(await pending?.catch(() => null))?.destroy();
}
MDN کال کرنے کی تجویز کرتا ہے۔ destroy() ایک بار جب آپ ختم کریں۔ Translator یا LanguageDetectorکیونکہ بہت سارے وسائل دستیاب ہیں۔ یہ فنکشن ہر اس چیز کے لیے کرتا ہے جو ہم بناتے ہیں۔
- کہ
forلوپ کالdestroy()تمام کیش شدہ مترجمین میںtranslators.clear()کیشے کو خالی کرنے سے، مستقبل کی درخواستیں ایک نیا کیش بنائیں گی۔ - ڈٹیکٹر زیادہ مشکل ہوتے ہیں کیونکہ وہ خود ڈیٹیکٹر کے بجائے ملاقاتیں محفوظ کرتے ہیں۔ ہم وعدہ نقل کرتے ہیں۔
pendingمشترکہ متغیر کو اس پر ری سیٹ کریں:nullاور اپنی ملاقات کا انتظار کریں۔ pending?.catch(() => null)ہم دو انتہائی معاملات کو سنبھالتے ہیں۔ ہو سکتا ہے کوئی پتہ لگانے والا نہ ہو، یا تخلیق ناکام ہو گئی ہو۔ دونوں صورتوں میں ہمیں ملتا ہے:nullواپسی اور آخری?.destroy()کچھ نہیں کرتا۔
اگلی کال کے لیے لکھنے کے لیے ہک destroyAll() جب کوئی جزو ان ماؤنٹ ہوتا ہے۔
مرحلہ 7: API کی غلطیوں کو مفید پیغامات میں تبدیل کریں۔
آخر میں، ہم صارف کو ناکامی کی وضاحت کرنے کے لیے ایک فنکشن شامل کرتے ہیں۔
/** Turns the DOMExceptions these APIs throw into messages a user can act on. */
export function describeError(error: unknown): string {
if (error instanceof DOMException) {
switch (error.name) {
case "NotAllowedError":
return "Chrome needs a fresh click to start the download. Press Translate again.";
case "NotSupportedError":
// Also thrown on a brand-new Chrome profile while it is still fetching its components.
return "Chrome couldn't prepare this translation. If this is your first use, wait a moment and try again. Otherwise, this language may not be supported on your device.";
case "QuotaExceededError":
return "That text is too long. Try translating a shorter passage.";
case "NetworkError":
return "The language pack couldn't be downloaded. Check your connection and try again.";
}
}
return error instanceof Error ? error.message : "Something went wrong.";
}
بلٹ ان AI API اٹھا کر مسائل کی اطلاع دیتا ہے: DOMExceptionاور استثناء ہے۔ name بولو کیا غلط ہے۔ یہ فیچر ہر نام کو ایک پیغام میں نقش کرتا ہے جس پر لوگ کارروائی کر سکتے ہیں۔
NotAllowedError: ڈاؤن لوڈ شروع کرنے کے لیے کروم کو صارف کی کارروائی کی ضرورت تھی، جیسا کہ کلک، لیکن اسے حاصل نہیں ہوا۔ صارف کو دوبارہ ترجمہ کرنے کو کہنے سے مسئلہ حل ہو جاتا ہے۔NotSupportedError: MDN اسے ایک غلطی کے طور پر دستاویز کرتا ہے جو اس وقت ہوتی ہے جب درخواست کی گئی زبان کی حمایت نہیں کی جاتی ہے۔ ٹیسٹنگ کے دوران، میں نے اپنی پہلی کوشش میں نئے کروم پروفائل میں یہ فیچر بھی دیکھا جب کروم ابھی تک جزو کی تیاری کر رہا تھا۔ اگلی کوشش کامیاب رہی۔ پیغام دونوں صورتوں کا احاطہ کرتا ہے۔QuotaExceededError: MDN اسے ایک غلطی کے طور پر دستاویز کرتا ہے جو اس وقت ہوتی ہے جب ان پٹ دستیاب کوٹہ سے بڑا ہوتا ہے۔ اس کا مطلب ہے کہ متن بہت لمبا ہے۔NetworkError: لینگویج پیک کو ڈاؤن لوڈ نہیں کیا جا سکتا۔
بصورت دیگر، فنکشن عام صورت میں اپنے ہی غلطی کے پیغام پر واپس آجاتا ہے۔ Errorیا باقاعدہ پیغام کے ذریعے۔
آپ کا lib/chrome-ai.ts فائل اب مکمل ہو گئی ہے۔ ہم ان فنکشنز کو ری ایکٹ ہکس میں درج ذیل سیکشنز میں استعمال کریں گے۔
ترجمہ ہک بنانے کا طریقہ
بنانا hooks/use-translation.ts. یہ پورے بہاؤ (پتہ لگانے، تصدیق، ترجمہ) کو چلاتا ہے اور رد عمل کی حالت کو بے نقاب کرتا ہے۔
"use client";
import { useCallback, useEffect, useRef, useState } from "react";
import { AUTO } from "@/lib/languages";
import {
CONFIDENCE_THRESHOLD,
LowConfidenceError,
describeError,
destroyAll,
detectLanguage,
getTranslator,
type Detection,
} from "@/lib/chrome-ai";
export type Phase = "idle" | "detecting" | "preparing" | "translating";
export function useTranslation() {
const [phase, setPhase] = useState("idle");
const [downloadProgress, setDownloadProgress] = useState(null);
const [output, setOutput] = useState("");
const [detected, setDetected] = useState(null);
const [error, setError] = useState(null);
const controllerRef = useRef(null);
// Free the models when the component unmounts.
useEffect(() => {
return () => {
controllerRef.current?.abort();
void destroyAll();
};
}, []);
const translate = useCallback(async (text: string, source: string, target: string) => {
controllerRef.current?.abort();
const controller = new AbortController();
controllerRef.current = controller;
const { signal } = controller;
setError(null);
setOutput("");
setDetected(null);
setDownloadProgress(null);
try {
let from = source;
if (source === AUTO) {
setPhase("detecting");
const result = await detectLanguage(text, setDownloadProgress, signal);
if (!result || result.confidence < CONFIDENCE_THRESHOLD) throw new LowConfidenceError();
setDetected(result);
from = result.language;
}
if (from === target) {
throw new Error("The source and target languages are the same.");
}
setPhase("preparing");
setDownloadProgress(null);
const translator = await getTranslator(from, target, setDownloadProgress, signal);
setPhase("translating");
setDownloadProgress(null);
// Streaming shows text as soon as it's ready, which feels faster for longer input.
const reader = translator.translateStreaming(text, { signal }).getReader();
for (;;) {
const { done, value } = await reader.read();
if (done) break;
setOutput((current) => current + value);
}
} catch (caught) {
if (!signal.aborted) setError(describeError(caught));
} finally {
if (controllerRef.current === controller) {
controllerRef.current = null;
setPhase("idle");
setDownloadProgress(null);
}
}
}, []);
const cancel = useCallback(() => controllerRef.current?.abort(), []);
const reset = useCallback(() => {
setOutput("");
setDetected(null);
setError(null);
}, []);
return { phase, downloadProgress, output, detected, error, translate, cancel, reset };
}
جب صارف ترجمہ پر کلک کرتا ہے تو درج ذیل ہوتا ہے:
- اپنی پرواز کے دوران کچھ بھی منسوخ کریں۔ اور ایک نیا بنائیں
AbortController. کہsignalکیونکہ یہ تمام کالوں میں جاتا ہے۔cancel()پتہ لگانا، ڈاؤن لوڈ کرنا اور ترجمہ کرنا بند کریں۔ - اگر ضروری ہو تو پتہ لگائیں. اگر ذریعہ "Language Detection” ہو تو کہا جاتا ہے۔
detectLanguage(). اگر نتیجہ ہے:nullیا اگر یہ اعتماد کی حد سے نیچے ہے۔LowConfidenceErrorصارفین دیکھیں گے کہ ‘براہ کرم اپنی ماخذ زبان کو دستی طور پر منتخب کریں۔’ - توثیق کریں۔ خود زبان کا ترجمہ کرنے کا کوئی فائدہ نہیں، اس لیے ہم ایک واضح پیغام کے ساتھ بات ختم کرتے ہیں۔
- اپنا مترجم تیار رکھیں۔ یہ وہ مرحلہ ہے جہاں آپ لینگویج پیک ڈاؤن لوڈ کر سکتے ہیں۔
downloadProgressپروگریس بار کو اپ ڈیٹ کرتا ہے۔ - سلسلہ بندی کے ذریعے ترجمہ کریں۔ ہم ہیں
translateStreaming()ہر حصہ کو آؤٹ پٹ میں جوڑتا ہے۔ چار جملوں کے ٹیسٹ میں، کروم نے فی جملہ ایک حصہ واپس کیا۔ دستاویزات میں، طویل متن کو سٹریم کرنا اچھا خیال ہے۔ مختصر جملوں کے لیے، آپ کو ایک حصہ ملتا ہے، لہذا یہ اسی طرح برتاؤ کرتا ہے:translate().
ہم اس سلسلے کو استعمال کرتے ہوئے پڑھتے ہیں: getReader() اس کے بجائے for await. for await مزید ReadableStream ضرورت dom.asynciterable ٹائپ اسکرپٹ لائبریری اور getReader() کہیں بھی کام کرتا ہے۔
کہ finally بلاک صرف UI کو دوبارہ ترتیب دے گا اگر یہ کال اب بھی موجودہ کال ہے۔ اس تصدیق کے بغیر، منسوخ شدہ پچھلی درخواست نئی درخواست کی حیثیت کو دوبارہ ترتیب دے سکتی ہے۔
کہ useEffect کلین اپ زیر التواء کارروائیوں اور کالوں کو روکتا ہے۔ destroyAll() جب جزو ان ماؤنٹ ہوتا ہے اور ماڈل جاری ہوتا ہے۔
انٹرفیس بنانے کا طریقہ
سرور رینڈرنگ کو محفوظ طریقے سے ہینڈل کرنا
بنانا components/translator-app.tsx. پہلا فیصلہ یہ ہے کہ آپ کے سرور کی طرف سے فراہم کردہ ایپ کے لیے براؤزر سپورٹ کو کیسے چیک کیا جائے۔
آپ کال نہیں کر سکتے isBuiltInAISupported() رینڈرنگ۔ سرور جواب دے گا falseبراؤزر جواب دیتا ہے۔ trueری ایکٹ رپورٹس کی اشارے کی زبان میں تضاد۔ useSyncExternalStore یہ سرورز کے لیے الگ الگ سنیپ شاٹس لے کر صفائی کے ساتھ اس مسئلے کو حل کرتا ہے۔
const supported = useSyncExternalStore(
noopSubscribe,
isBuiltInAISupported, // client snapshot
() => null, // server snapshot
);
سرور اور پہلی کلائنٹ رینڈرنگ دونوں کا حوالہ دیتے ہیں: nullتو یہ میل کھاتا ہے۔ جواب دیں پھر کلائنٹ کے اصل جواب پر سوئچ کریں۔ ایپ دکھاتی ہے "براؤزر سپورٹ کی جانچ کر رہا ہے…” nullکے بارے میں نوٹس falseاور مترجم true. صفحہ کھلے رہنے کے دوران کسی بھی چیز کو سبسکرائب نہیں کیا گیا ہے کیونکہ براؤزر سپورٹ تبدیل نہیں ہوتا ہے۔ noopSubscribe کچھ نہیں کرتا۔
اطلاع تعاون یافتہ نہیں ہے۔
API کے بغیر براؤزر ٹوٹے ہوئے فارمیٹنگ کے بجائے واضح وضاحت حاصل کرتے ہیں۔ بنانا components/unsupported-notice.tsx:
export function UnsupportedNotice() {
return (
This browser doesn't support Chrome's built-in translation
The Translator and Language Detector APIs are available in Chrome on desktop (version 138
or later). They aren't available on mobile, Firefox or Safari.
Open this page in desktop Chrome, or read about the APIs in the{" "}
Chrome documentation.
);
}
زبان کا انتخاب کنندہ
بنانا components/language-select.tsx. واقعی سے منسلک ہے htmlFor کنٹرولز کو قابل رسائی بناتا ہے اور انہیں کلک کرنے کے قابل بناتا ہے۔
import { AUTO, LANGUAGES } from "@/lib/languages";
interface Props {
id: string;
label: string;
value: string;
onChange: (code: string) => void;
/** Adds a "Detect language" option (source selector only). */
allowAuto?: boolean;
}
export function LanguageSelect({ id, label, value, onChange, allowAuto }: Props) {
return (
);
}
ٹیکسٹ پینل
بنانا components/text-panel.tsx. ایک جزو ان پٹ اور آؤٹ پٹ دونوں کے طور پر کام کرتا ہے۔ اس میں آپ کے ڈیزائن کے لیے کاپی اور ریڈ آؤٹ لاؤڈ بٹن شامل ہیں۔
"use client";
import { useState } from "react";
interface Props {
id: string;
label: string;
value: string;
/** BCP 47 code of the text, so screen readers and speech use the right voice. */
lang?: string;
rtl?: boolean;
readOnly?: boolean;
placeholder?: string;
onChange?: (value: string) => void;
}
export function TextPanel({ id, label, value, lang, rtl, readOnly, placeholder, onChange }: Props) {
const [copied, setCopied] = useState(false);
async function copy() {
await navigator.clipboard.writeText(value);
setCopied(true);
setTimeout(() => setCopied(false), 1500);
}
function speak() {
// The Web Speech API is separate from the built-in AI APIs, and works in most browsers.
speechSynthesis.cancel();
const utterance = new SpeechSynthesisUtterance(value);
if (lang) utterance.lang = lang;
speechSynthesis.speak(utterance);
}
return (
);
}
کچھ تفصیلات:
- کاپی کلپ بورڈ API استعمال کرتا ہے۔
- بلند آواز سے پڑھیں ویب اسپیچ API کا استعمال کرتا ہے۔
speechSynthesis. یہ بلٹ ان AI API سے الگ براؤزر کی خصوصیت ہے اور زیادہ تر براؤزرز میں کام کرتی ہے۔ ہم نے مقرر کیاutterance.langلہذا براؤزر مماثل آواز کا انتخاب کرتا ہے۔ dir="auto"جیسا کہ آپ ٹائپ کرتے ہیں، براؤزر آپ کے ٹائپ کردہ کسی بھی متن کی سمت کا انتخاب کرسکتا ہے، لہذا عربی ان پٹ بغیر کسی اضافی منطق کے کام کرتا ہے۔- آؤٹ پٹ استعمال کرتا ہے:
langاورdirلہذا اسکرین ریڈر اس کا صحیح تلفظ کرتا ہے اور RTL اسکرپٹ صحیح طریقے سے پیش کرتا ہے۔ - دونوں بٹن
aria-labels، کیونکہ مرئی مواد صرف ایک آئیکن ہے۔
خلاصہ یہ کہ
اہم اجزاء ہیں:
"use client";
import { useState, useSyncExternalStore } from "react";
import { useTranslation } from "@/hooks/use-translation";
import { isBuiltInAISupported } from "@/lib/chrome-ai";
import { AUTO, isRtl, languageName } from "@/lib/languages";
import { LanguageSelect } from "./language-select";
import { TextPanel } from "./text-panel";
import { UnsupportedNotice } from "./unsupported-notice";
const noopSubscribe = () => () => {};
export function TranslatorApp() {
// `null` on the server and during hydration, then the real answer on the client.
// This avoids a hydration mismatch, because the server can't know what the browser supports.
const supported = useSyncExternalStore(
noopSubscribe,
isBuiltInAISupported,
() => null,
);
const { phase, downloadProgress, output, detected, error, translate, cancel, reset } =
useTranslation();
const [source, setSource] = useState(AUTO);
const [target, setTarget] = useState("es");
const [text, setText] = useState("");
if (supported === null) return Checking browser support…
;
if (!supported) return ;
const busy = phase !== "idle";
const sourceLang = source === AUTO ? detected?.language : source;
const statusMessage = (() => {
if (error) return error;
if (phase === "detecting") return "Detecting language…";
if (phase === "preparing") return "Preparing the translator…";
if (phase === "translating") return "Translating…";
if (detected && source === AUTO) {
return `Detected ${languageName(detected.language)} (${Math.round(detected.confidence * 100)}% confidence).`;
}
return "";
})();
function swap() {
if (!sourceLang) return;
setSource(target);
setTarget(sourceLang);
setText(output);
reset();
}
return (
);
}
چند تفصیلات قابل توجہ ہیں۔
اسٹائلائزڈ onSubmit کال ہینڈلر translate(). چونکہ یہ فارم جمع کرانے والے کلک کے اندر چلتا ہے، کروم صارف کی ایکٹیویشن کی تصدیق کرتا ہے۔ یہ کروم کو ماڈل ڈاؤن لوڈ کرنا شروع کرنے کی اجازت دے گا۔ کال کرنا Translator.create() پر useEffect صفحہ لوڈ ہونے پر صارف کی کوئی کارروائی نہیں ہوتی۔
سویپ بٹن دونوں زبانوں کو تبدیل کرتا ہے اور ترجمے کو ان پٹ باکس میں منتقل کرتا ہے۔ اگر ذریعہ "Language Detection” ہے، تو یہ پتہ چلنے والی زبان کا استعمال کرے گا اور زبان کے موجود ہونے تک اسے غیر فعال کر دیا جائے گا۔
اسٹیٹس بار اس طرح دکھتا ہے: . Screen readers announce messages like "Translating…”, the detection result, and errors without moving focus. The progress bar has a visible label.
The page and layout
Finally, wire it into the app. app/page.tsx سرور کا ایک جزو جو کلائنٹ کے اجزاء فراہم کرتا ہے۔
import { TranslatorApp } from "@/components/translator-app";
export default function Home() {
return (
Text is detected and translated on your device by Chrome. It isn't sent to a
translation server.
);
}
اور app/layout.tsx:
import type { Metadata } from "next";
import "./globals.css";
export const metadata: Metadata = {
title: "Translate with Chrome's built-in AI",
description:
"A Next.js app that translates text on-device using Chrome's Translator and Language Detector APIs.",
};
export default function RootLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
{children}
);
}
CSS API کے لیے مخصوص نہیں ہے، اس لیے میں اسے یہاں دوبارہ پیش نہیں کروں گا۔ کاپی app/globals.css مخزن سے۔ بٹنوں اور پروگریس بار کو دو کالم لے آؤٹ میں اسٹائل کریں، چھوٹی اسکرینوں پر ایک کالم میں سمٹ کر۔
اپنی حدود کی جانچ کریں۔ app/page.tsx اور app/layout.tsx یہ سرور کا جزو ہے، translator-app.tsx سے شروع کریں۔ "use client"تو یہ اور اس کی ہر چیز براؤزر میں چلتی ہے۔ یہ ایک پریمیٹر کے لیے ایک اچھی جگہ ہے، کیونکہ کروم کے API کو چھونے والی کوئی بھی چیز کلائنٹ پر چلنی چاہیے۔
اپنی ایپ کو چلانے اور جانچنے کا طریقہ
ڈویلپمنٹ سرور شروع کریں اور URL کھولیں۔ ڈیسک ٹاپ کروم:
npm run dev
پھر درج ذیل منظر نامے کو آزمائیں: یہ ہے جو میں نے MacOS پر کروم 156 میں دیکھا:
| میں نے کیا کیا | کیا ہو رہا ہے |
|---|---|
| "یہ ایک آزمائشی جملہ ہے،” میں نے ٹائپ کیا۔ ذریعہ مقرر کرنے کے ساتھ زبان کا پتہ لگانا اور مقصد ہسپانوی | "انگریزی (100% اعتماد)” کا پتہ لگایا اور اس کا ترجمہ "یہ ایک آزمائشی جملہ ہے۔” |
| آپ نے ایک زبان کا جوڑا منتخب کیا ہے جو آپ نے پہلے استعمال نہیں کیا ہے (انگریزی سے فرانسیسی) | لینگویج پیک ڈاؤن لوڈ ہوتے ہی ایک پروگریس بار ظاہر ہوگا۔ منسلک ہونے میں تقریباً 15 سیکنڈ لگیں گے اور ترجمہ ظاہر ہو جائے گا۔ |
| ہسپانوی جملوں کا انگریزی میں ترجمہ۔ | "ہسپانوی (100% قابل اعتماد)” کا پتہ لگایا اور واپس آیا "ہیلو، آپ کا دن کیسا رہا؟ مجھے امید ہے کہ سب کچھ ٹھیک جا رہا ہے۔” |
| آپ نے ہاؤسا جملہ درج کیا ہے۔ | کروم کے ڈیٹیکٹر نے اسے پہچان لیا (ha)، مترجم نے اطلاع دی کہ ترجمہ کرنا ممکن نہیں ہے: ha انگریزی میں۔ |
ہاؤسا کے نتائج ایک اچھا سبق ہیں۔ زبان پتہ لگانے اور زبان ترجمہ زبانوں کے متنوع سیٹ کو سپورٹ کرتا ہے۔ کروم کے مترجمین کی فہرست میں ہاؤسا، یوروبا، یا ایگبو شامل نہیں ہے، لہذا ان زبانوں کے لیے آپ کو ایک مختلف نقطہ نظر کی ضرورت ہوگی، جیسے کہ سرور سائیڈ ماڈل یا کلاؤڈ ٹرانسلیشن API۔
کچھ انتہائی کیسز بھی آزمائیں۔
- کلک کریں منسوخی جبکہ لینگویج پیک ڈاؤن لوڈ ہو رہا ہے۔
- براہ کرم اس طرح کا ایک لفظ درج کریں: زبان کا پتہ لگانا منتخب مختصر ان پٹ کے لیے کھوج بہت کم قابل اعتماد ہے، اس لیے آپ کو دستی طور پر زبان منتخب کرنے کے لیے کہا جا سکتا ہے۔
- براہ کرم دونوں طرف سے ایک ہی زبان کا انتخاب کریں۔
اگر آپ کے نئے کروم پروفائل میں آپ کی پہلی کوشش ناکام ہو جاتی ہے اور آپ کو یہ پیغام ‘یہ ترجمہ تیار نہیں کیا جا سکتا’ نظر آتا ہے، تو براہ کرم ایک لمحہ انتظار کریں اور دوبارہ کوشش کریں۔ جب آپ پہلی بار نیا پروفائل چلاتے ہیں، تو کروم NotSupportedError اگلی کوشش میں کامیاب ہونے سے پہلے۔ describeError زبان پر تنقید کرنے کی بجائے وضاحت کریں۔
حدود اور پیداوار کے تحفظات
بلٹ ان AI APIs ترجمہ کوڈ کو چھوٹا بنا دیتے ہیں، لیکن اس میں رکاوٹیں ہیں جن کے لیے آپ کو منصوبہ بندی کرنے کی ضرورت ہے۔
براؤزر سپورٹ
کروم (اور ایج) ڈیسک ٹاپ کی خصوصیات کے ساتھ۔ اسے بتدریج بہتری سمجھیں۔
- خصوصیت کا پتہ لگانا
"Translator" in selfاسے استعمال کرنے سے پہلے جیسے آپ نے کیا تھا۔ - یہ کلاؤڈ ٹرانسلیشن API کی طرح ہر کسی کے لیے فال بیک فراہم کرتا ہے، اور صارفین کو یہ بتاتا ہے کہ ٹیکسٹ ان کے آلے کو کب چھوڑے گا۔
- اپنی باقی مصنوعات کو خصوصیات کے پیچھے نہ چھپائیں۔
تنہائی
بالکل واضح کریں کہ "نجی” کا کیا مطلب ہے۔
- ترجمہ اور پتہ لگانا مقامی طور پر چلتا ہے۔ ترجمہ API کو متن نہیں بھیجا جاتا ہے۔
- ماڈل ڈاؤن لوڈ ہوتے رہیں گے۔ جب آپ پہلی بار استعمال کرتے ہیں تو Chrome نیٹ ورک سے لینگویج پیک ڈاؤن لوڈ کرتا ہے۔
- آپ کے اپنے تجزیے اور غلطی کی لاگنگ کو آپ کے ترجمہ کردہ متن کو پکڑنے نہ دیں۔
معیار اور ایمانداری
- زبان کا پتہ لگانے کا امکان ہے۔ اعتماد دکھائیں، حد مقرر کریں، اور صارفین کو ان کو اوور رائیڈ کرنے دیں۔
- کروم دستاویزات نے خبردار کیا ہے کہ ڈیٹیکٹر تمام زبانوں کی مکمل درستگی کے ساتھ شناخت نہیں کر سکتا۔
- قانونی، طبی، مالی، یا دیگر اہم مواد کے لیے مکمل طور پر مشینی ترجمہ پر انحصار نہ کریں۔ مقامی بولنے والوں سے ان زبانوں کے آؤٹ پٹ کا جائزہ لیں جن کی آپ خدمت کرتے ہیں۔
کارکردگی اور وسائل
- ٹکڑا لمبا ان پٹ۔ ترجمہ ترتیب وار عمل کیا جاتا ہے، لہذا طویل متن اس کے بعد آنے والی ہر چیز میں تاخیر کرتا ہے۔ لوڈنگ کی حیثیت دکھائیں اور بڑی دستاویزات کو تقسیم کریں۔
- اپنے کوٹے چیک کریں۔ کچھ نفاذ ان پٹ کے سائز کو محدود کرتے ہیں۔ کوئی راستہ نہیں
Translatorبے نقابinputQuotaاورmeasureInputUsage()آپ ترجمہ کرنے سے پہلے اسے چیک کر سکتے ہیں (یہ MDN کا ایک نمونہ ہے، میں نے اسے اس ڈیمو سے منسلک نہیں کیا ہے)۔
const translator = await getTranslator("en", "es");
const usage = await translator.measureInputUsage(text);
if (usage > translator.inputQuota) {
throw new Error("That text is too long to translate in one go.");
}
- اپنے وسائل کو عوامی بنائیں۔ کال
destroy()مترجمین کے بارے میں آپ کو مزید ضرورت نہیں ہے۔destroyAll()کرو
ایمبیڈنگز اور ورکرز
- API Web Workers میں دستیاب نہیں ہے، لہذا اسے مرکزی دھاگے سے ہٹایا نہیں جا سکتا جیسا کہ آپ Transformers.js جیسی لائبریریوں میں کر سکتے ہیں۔
- کراس اوریجن iframes کو اجازت کی پالیسیوں کی ضرورت ہوتی ہے۔
allowیہ استعمال کرنے کی پراپرٹی ہے۔
نتیجہ
ہم نے ایک Next.js ٹرانسفارمر بنایا ہے جو ڈیوائس پر بغیر کسی ماڈل ہوسٹنگ یا انفرنس بیک اینڈ کے چلتا ہے۔ راستے میں، خصوصیت کا پتہ لگانا مترجم اور زبان کا پتہ لگانے والے APIs کا ایک اہم حصہ ہے۔ availability()، create() جیسے جیسے ڈاؤن لوڈ آگے بڑھتا ہے، detect() قابل اعتماد سکور کے طور پر، translateStreaming()اگلا منسوخ کریں۔ AbortControllerاور destroy().
ہم نے ان چیلنجوں کا بھی ازالہ کیا جو براؤزر پر مبنی AI سرور رینڈرنگ فریم ورک کو متعارف کرواتا ہے۔ Translatorماڈلز آن ڈیمانڈ ڈاؤن لوڈ کیے جاتے ہیں، صارف کی بات چیت کی ضرورت ہوتی ہے، سپورٹ کچھ براؤزرز تک محدود ہے، اور معیار زبان کے لحاظ سے مختلف ہوتا ہے۔
براؤزر پر مبنی AI سرور سائڈ AI کو تبدیل نہیں کرتا ہے۔ یہ لاگت اور تاخیر کو کم کرتا ہے اور آلہ پر صارف کے عارضی متن کو رکھنے کے لیے دوسرا آپشن فراہم کرتا ہے۔ جب Chrome کی طرف سے تعاون کیا جاتا ہے، اب آپ کے پاس کثیر لسانی تجربات بنانے کا ایک چھوٹا، معیار پر مبنی طریقہ ہے۔