ssml split

انقسام SSML

تقسيم سلاسل SSML إلى دفعات AWS POLLY áND Google to to cleage API يمكن أن تستهلكها.

سمات

• يقسم SSML الكبير الخاص بك إلى دفعات AWS Polly ونص Google إلى API يمكن أن تستهلكها.
• تأكد من البقاء تحت قيود أحرف API من خلال تكوين hardLimit .
• يخلق أقل حجم دفعة ممكنة للحد من طلباتك على النص إلى API.
• سوف تقسيم النص في أقرب . , ، ، ; أو الفضاء. يمكن تكوينها.
• يقوم بتطهير SSML الخاص بك عن طريق إزالة الخطوط الجديدة ، والمساحات البيضاء المفرطة ، والعلامات الفارغة ، مما يؤدي إلى استخدام أحرف أقل.
• يستخدم TypeScript حتى تتمكن من الاستمتاع بنوع السلامة والوثائق التي تأتي معها.

استنادا إلى polly-ssml-split بواسطة eleglegun

الوثائق

• التثبيت - المشي من خلال كيفية تثبيت SSML تقسيم.
• الاستخدام - اقرأ كيف يعمل SSML Split مع الخيارات المتاحة.
• الخيارات الموصى بها - استخدم هذه الخيارات للبدء بسرعة.
• المساهمة - تعرف على كيفية المساهمة مرة أخرى في تقسيم SSML
• مدونة قواعد السلوك - كن مواطنًا صالحًا باتباع قواعد المستودع هذه

تثبيت

تثبيت الحزمة مع:

npm install ssml-split --save

الاستخدام

استيراد الحزمة وتعيين الخيارات. استخدم طريقة .split() لتقسيم سلسلة SSML الخاصة بك. يمكنك تعديل softLimit لمعرفة ما يناسبك. أقترح عليك الحفاظ على hardLimit في الحد الأقصى لواجهة برمجة التطبيقات المعنية:

 import SSMLSplit from 'ssml-split' ;

const ssmlSplit = new SSMLSplit ( {
  // The service you are using: "google" or "aws"
  synthesizer : 'google' ,
  // Finds a possible split moment starting from 4000 characters
  softLimit : 4000 ,
  // Google Text to Speech limitation
  hardLimit : 5000 ,
  // Allow to split large paragraphs, set to false to keep your <p></p> intact
  breakParagraphsAboveHardLimit : true
} ) ;

const batches = ssmlSplit . split ( '<speak>your long ssml here</speak>' ) ;

خيار	يكتب	تقصير	وصف
synthesizer	string	aws	تعيين إلى أي مزج تستخدمه. مفيد عند استخدام breakParagraphsAboveHardLimit . إنها تسمح للمكتبة بتحديد طول الفترة الصحيح ، حيث يختلف ذلك لكل خدمة مزج.
softLimit	number	1500	كمية الأحرف التي سيبدأ البرنامج النصي في محاولة تفتيت SSML في أجزاء متعددة. يمكنك تعديل هذا الرقم لمعرفة ما يناسبك.
hardLimit	number	3000	يجب أن يبقى كمية الأحرف التي يظل البرنامج النصي أقل من الحجم الأقصى لكل جزء من SSML. إذا كان أي حجم دفعة أعلى من هذا ، فإن البرنامج النصي سوف يخطئ. هذا الحد الصعب هو الحد الأقصى لحرف AWS أو Google API التي تستخدمها.
breakParagraphsAboveHardLimit	boolean	false	قم بتعيين true للسماح للنص النصي بتفكيك الفقرات الكبيرة عن طريق إزالة <p> واستبدال < / </p> بـ <break strength="x-strong" /> (for aws ) أو <break strength="x-weak" /> (لـ google ). مما يؤدي إلى نفس الإيقاف المؤقت. يتطلب تعيين synthesizer الخيار.
extraSplitChars	string	,;.	الأحرف التي يمكن استخدامها كعلامات تقسيم للنص العادي.

حول: مزج

باستخدام synthesizer: 'google' حساب أحرف علامات SSML لتحديد أفضل لحظة تقسيم ممكنة. هذا يجعل المكتبة تعمل أيضًا مع نص Google إلى API.

على سبيل المثال: <speak><p>some text</p></speak>

سيحسب السلوك الافتراضي أنه على أنه 9 أحرف ، وهو أمر جيد بالنسبة لـ AWS Polly ، ولكن ليس لنص Google إلى API.

مع synthesizer: 'google' سيتم عدها على أنها 31 حرفًا ، تمامًا مثل Text Text to Week API يحسبها.

هذا يجب أن يمنعك من رؤية هذا الخطأ عند استخدام نص Google إلى واجهة برمجة تطبيقات الكلام:

INVALID_ARGUMENT: 5000 characters limit exceeded.

حول: BreakParaphsabovehardLimit

من خلال إضافة خيار breakParagraphsAboveHardLimit: true ، تسمح للبرنامج النصي بتفكيك الفقرات الكبيرة عن طريق إزالة <p> واستبدال < / </p> بـ <break strength="x-strong" /> لـ AWS أو <break strength="x-weak" /> for Google. مما يؤدي إلى نفس الإيقاف المؤقت. هذا يسمح للمكتبة بتقسيم الفقرات الكبيرة بشكل صحيح.

سيؤدي استخدام هذا الخيار إلى 20 حرفًا إضافيًا ، لكل فقرة ، إلى استخدامك عند استخدام نص Google إلى API.

إذا كنت تعمل مع فقرات كبيرة ولم تستخدم هذا الخيار ، فقد تواجه أخطاء مثل SSML tag appeared to be too long .

يوصى باستخدام هذا الخيار عندما يكون لديك طول SSML أعلى من hardLimit .

الخيارات الموصى بها

AWS

 new SSMLSplit ( {
  synthesizer : 'aws' ,
  softLimit : 2000 ,
  hardLimit : 3000 , // AWS Polly limitation
  breakParagraphsAboveHardLimit : true , // optional, but recommended when you have large <p>'s
} ) 

جوجل

 new SSMLSplit ( {
  synthesizer : 'google' ,
  softLimit : 4000 ,
  hardLimit : 5000 , // Google Text to Speech API limitation
  breakParagraphsAboveHardLimit : true , // optional, but recommended when you have large <p>'s
} ) 

عن

يعالج Polly-SSML-SPLIT بواسطة Library eleglegun بالفعل تقسيم SSML بشكل صحيح لـ AWS Polly ، لكنه لم يكن يعمل بشكل صحيح لنص Google إلى الكلام. لذلك قمت فقط بتعديل الحزمة لتناسب احتياجاتي.

التغييرات مقارنة مع polly-ssml-split :

• تمت إضافة خيار synthesizer لحساب الأحرف استنادًا إلى علامة SSML الكاملة وليس فقط أحرف النص المضمّنة. المطلوب إذا كنت تعمل مع نص Google إلى API.
• أعد كتابة المكتبة لاستخدام TypeScript ، بحيث تحصل على فحص النوع الصحيح في مشروع TypeScript الخاص بك.
• إزالة طريقة .configure واستخدم طريقة مُنشئ الفئة لها بدلاً من ذلك.
• تمت إضافة خيارات breakParagraphsAboveHardLimit لتفكيك الفقرات الكبيرة عن طريق إزالة <p> واستبدال < / </p> مع <break strength="x-strong" /> لـ AWS أو <break strength="x-weak" /> for Google. مما يؤدي إلى نفس الإيقاف المؤقت. يتيح ذلك للمكتبة تقسيم الفقرة بشكل صحيح وإرسال دفعات أقل إلى النص إلى API.
• وأضاف المزيد من الاختبارات باستخدام Jest.

تطوير

أي مساهمة موضع تقدير! يرجى قراءة المساهمة لدينا. md حول كيفية المساهمة.

استخدم نهجًا يحركه الاختبار عند تطوير ميزات جديدة أو إصلاح الأخطاء.

يطور:

$ npm install
$ npm run dev

قم بتشغيل الاختبارات في تغيير الملف:

$ npm test:watch

بناء TypeScript إلى JavaScript:

$ npm run build

قم بتشغيل جميع الاختبارات:

$ npm test