شارك المقالة
تحويل النص إلى صوت في Flutter بالعربية باستخدام flutter_tts

تحويل النص إلى صوت في Flutter بالعربية باستخدام flutter_tts

تحويل النص إلى صوت في Flutter باستخدام flutter_tts مع فحص توفر اللغة العربية، وترتيب الإعدادات وإيقاف القراءة والتخلص من الموارد.

تحويل النص إلى صوت في Flutter باستخدام flutter_tts مع فحص توفر اللغة العربية، وترتيب الإعدادات وإيقاف القراءة والتخلص من الموارد.

النص إلى صوت ليس OCR أو ترجمة

Text to Speech يقرأ نصًا موجودًا؛ لا يستخرج حروف الصورة ولا يترجم الجملة إلى لغة جديدة. إذا جاء النص من OCR فراجع أخطاءه أولًا، وحدد لغة القراءة التي تتوافق مع النص ومحرك النظام. دعم flutter_tts لمنصة معينة لا يضمن وجود صوت عربي مثبت أو متاح offline على كل جهاز. اعرض اللغة المتاحة للمستخدم ولا تستبدل صوتًا لم توفره المنصة بوعد أن ar يعمل دائمًا.

متطلبات الحزمة والمنصة

أضف flutter_tts بإصدار متوافق، وراجع إعداد queries لخدمة TTS على Android حيث تطلبه وثائق الحزمة. قد تحتاج أصواتًا أو إعدادات محرك النظام وفق الجهاز، وتختلف بعض الخصائص بين الويب وAndroid وiOS وبقية المنصات المعلنة. لا تستورد dart:ffi أو مكتبة بطاقات ائتمان أو image_picker لمجرد استعمال الصوت؛ كانت واردات غير مرتبطة في المثال القديم. تطبيق النص إلى صوت لا يحتاج إذن الميكروفون لأنه لا يسجل كلام المستخدم.

ترتيب الإعدادات قبل النطق

await على setLanguage وsetVolume وsetSpeechRate وsetPitch يجعل طلب النطق يبدأ بعد تطبيق الإعدادات بدل سباق بين callbacks. افحص isLanguageAvailable للرمز المطلوب، ثم عالج نتيجة غير متاحة أو استثناء الخدمة برسالة مفيدة. معدل القراءة والحدة مجالان يختلف تفسيرهما بين المحركات، فلا تجعل كل slider من صفر إلى واحد مناسبًا تلقائيًا لكل خاصية. ابدأ بقيم توضحها الوثائق واختبر صوتًا فعليًا.

الإيقاف وتداخل الطلبات

إذا ضغط المستخدم قراءة نص جديد أثناء النطق فحدد هل توقف القديم أم تضعه في طابور؛ لا تترك السياسة ضمنية. عند استعمال awaitSpeakCompletion قد يبقى Future حتى انتهاء القراءة حسب المنصة وإعداداتها. وفّر زر stop يعمل أثناء الانشغال ولا تعطل واجهة الصفحة كلها. لا تنتظر Future القراءة في مسار يمنع المستخدم من إيقافها. عند خروج الصفحة أوقف ما تملكه من قراءة وألغِ المستمعات التي أنشأتها، وتخلص من TextEditingController في موضع ملكيته.

فشل اللغة والمحتوى

ارفض النص الفارغ بعد trim، وضع حدًا لطول النص أو اقسمه وفق احتياجات المنتج دون قطع كلمات أو إرباك مسار الإلغاء. قد يحتوي نص واحد كلمات بلغات متعددة، واختيار صوت واحد لا يضمن نطقًا صحيحًا لكل جزء. لا تطبع نصًا خاصًا في logs عند فشل المحرك، ولا تحول فشل التهيئة إلى نجاح صامت. يمكن عرض حالة جاهز أو جارٍ أو فشل مع تمكين محاولة أخرى، والاحتفاظ بمسودة النص بدل مسحها عند كل خطأ.

اختبارات الخدمة والجهاز

اختبر ترتيب الاستدعاءات والإلغاء واللغة غير المتاحة والنص الفارغ بخدمة منصة وهمية، ثم اختبر جهازًا فعليًا لسماع النطق. mock لا يثبت جودة الصوت أو وجود العربية أو طريقة التعامل مع مستوى صوت النظام. جرّب الخلفية والعودة ومقطعًا طويلًا حسب المنصات المطلوبة، وحدد ما إذا كانت القراءة يجب أن تستمر خارج الصفحة. المثال التالي طبقة خدمة صغيرة؛ المالك مسؤول عن عرض الحالات ومنع التكرار والتخلص من مورد النص في الواجهة التي تستعملها.

واجهة قراءة قابلة لإعادة الاستخدام

يمكن فصل حقل النص واختيار اللغة وزري قراءة وإيقاف في مكون يستقبل خدمة الصوت بدل إنشاء محرك مختلف داخل كل زر. يبقى النص في controller يملكه State، وتبقى إعدادات اللغة ومعدل الكلام في نموذج واضح يمرر للخدمة. اختبر أن النقر السريع لا يبدأ عمليتين وأن زر الإيقاف يظل متاحًا أثناء انتظار النطق، ثم أن الفشل لا يحذف المسودة. عند تغيير اللغة لا تَعِد القراءة تلقائيًا بلا طلب المستخدم، فقد ينتهي به الأمر إلى تشغيل صوت في وقت غير متوقع. بعض المحركات تحتاج تثبيت صوت أو اتصالًا لبعض الأصوات؛ تحقق من خصائص الصوت الفعلية بدل تسمية كل شيء offline. اختبار الاستدعاءات لا يغني عن الاستماع إلى العربية على نظامي الجهاز المستهدفين ومراجعة الفواصل والتشكيل والأرقام في محتوى تجريبي.

مثال الشفرة وحدوده

import 'package:flutter_tts/flutter_tts.dart';
class SpeechReader {
 SpeechReader(this.tts);
 final FlutterTts tts;
 bool _busy=false;
 Future<void> read(String raw,{String locale='ar-EG'}) async {
  final text=raw.trim();
  if(text.isEmpty)throw const FormatException('Text required');
  if(_busy)throw StateError('A read request is active');
  _busy=true;
  try{
   await tts.stop();
   if(await tts.isLanguageAvailable(locale)!=true){
    throw StateError('Requested voice language unavailable');
   }
   await tts.setLanguage(locale);
   await tts.setVolume(1.0);
   await tts.setPitch(1.0);
   await tts.setSpeechRate(0.5);
   await tts.awaitSpeakCompletion(true);
   await tts.speak(text);
  }finally{_busy=false;}
 }
 Future<void> stop() async {await tts.stop();}
}
// Dependency: flutter_tts, e.g. 4.2.5 after compatibility checks.
// Owner calls stop on exit and manages its UI/controller lifecycle.
// Available voices and pronunciation must be tested on the real platform.

الصور والفيديو من الشرح

قد تعرض المواد إصدارًا أقدم من المكتبات؛ اعتمد النص المصحح عند اختلاف الإعدادات أو الكود.

How to Add TS_SERVICE in manifestHow to convert text to sound in Flutter

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع