من التسجيلات
إلى صوت.

دمج Piper في مشروع Node.js باستخدام pipertts

يتيح pipertts استخدام Piper في Node.js، مع كتابة الملفات أو إرجاع الصوت في الذاكرة. الوضع الموصى به هو PiperNativeTTS: استدلال أصلي بالكامل داخل العملية (ONNX مع جسر espeak مترجم)، دون Python، أسرع بنحو 10 مرات من الغلاف. تبقى الأصوات (.onnx مع .onnx.json) ملفات منفصلة.

1. 01

   تثبيت الاعتماديات

   يذكر التوثيق Node.js 18+ وTypeScript 5+. لا يحتاج الوضع الأصلي إلى شيء آخر: تكفي عملية npm install. يتطلب وضع الغلاف التقليدي (PiperTTS عبر python3 -m piper) لغة Python ووحدة Piper إضافة إلى ذلك. قد يؤدي الاختيار بمعرف الفهرس إلى تنزيل النموذج وإعداده في models/.

   npm install pipertts
   # mode wrapper uniquement : python3 -m pip install piper-tts

2. 02

   بداية سريعة مع صوت من الفهرس

   import { PiperNativeTTS, resolveModelPathFromOptions } from "pipertts";
   import * as fs from "node:fs";
   
   const modelPath = await resolveModelPathFromOptions({
     model: "en_US-lessac-medium",
     modelsDir: "./models",
   });
   const tts = await PiperNativeTTS.load({ modelPath });
   
   const { audio } = await tts.synthesize("Hello from Piper.");
   fs.writeFileSync("./hello.wav", audio);

3. 03

   استخدام نموذج محلي

   لصوت نزلته يدويا، مرر مسار ملف ONNX. يجب وضع ملف .onnx.json المرافق بجانبه؛ ويمكنك تحديد configPath إذا كان موضعه مختلفا.

   import { PiperNativeTTS } from "pipertts";
   
   const tts = await PiperNativeTTS.load({
     modelPath: "./models/my-voice.onnx",
   });
   const { audio, sampleRate } = await tts.synthesize("Hello.", { speakerId: 0 });

4. 04

   الواجهة والصيغ

   ترجع synthesize() القيم audio (Buffer) وsampleRate وtext؛ ويكتب outputFile على القرص أيضا. الخيارات: speakerId (متعدد الأصوات والأنماط)، وlengthScale (أكبر من 1 يبطئ الكلام وأصغر من 1 يسرعه)، وnoiseScale وnoiseWScale وsentenceSilence وnormalizeAudio وvolume وoutputFormat (wav أو raw أو mp3 أو ogg أو opus). يملك mp3 وopus حلولا JS خالصة؛ ويتطلب ogg أداة FFmpeg. تتيح phonemize() وsynthesizeChunks() الوصول منخفض المستوى، جملة بجملة.

5. 05

   الغلاف القديم (PiperTTS)

   يطلق PiperTTS الأمر python3 -m piper، عملية لكل تركيب: أبطأ بنحو 10 مرات، ويخصص للبيئات التي لا يعمل فيها المحرك الأصلي. يتطلب Python ووحدة Piper.

   import { PiperTTS } from "pipertts";
   
   const tts = await PiperTTS.create({
     modelPath: "./models/en_US-lessac-medium.onnx",
   });
   await tts.synthesizeToFile("Hello from the legacy wrapper.", "./hello.wav");

   صفحة pipertts على npm ↗مستودع pipertts على GitHub ↗توثيق pipertts وأمثلته ↗