msedge tts

وصف

هذه المكتبة عبارة عن غلاف من MSEDGE قراءة API بصوت عالٍ . يمكنك استخدامه لتوليف النص لخطاب مع العديد من الأصوات التي قدمتها MS.

كيفية استخدام

1. تحتاج إلى الحصول على SpeechConfig لتكوين صوت النص إلى الكلام.
   يمكنك تحويل Voice إلى SpeechConfig ببساطة. استخدم وظيفة get_voices_list للحصول على جميع الأصوات المتاحة.
   نفذت Voice SpeechConfig serde::Serialize و serde::Deserialize .
   على سبيل المثال:

    use msedge_tts :: voice :: get_voices_list ;
   use msedge_tts :: tts :: SpeechConfig ;
   
   fn main ( ) {
       let voices = get_voices_list ( ) . unwrap ( ) ;
       let speechConfig = SpeechConfig :: from ( & voices [ 0 ] ) ;
   }

   يمكنك أيضًا إنشاء SpeechConfig بنفسك. تأكد من معرفة الاسم الصوتي الصحيح وتنسيق الصوت .
2. إنشاء Client TTS أو Stream . كلاهما لديه نسخة متزامنة ومتزامنة. مثال أدناه الخطوة 3.
3. توليف النص إلى الكلام.

   مزامنة العميل

   استدعاء وظيفة العميل synthesize لتوليف النص إلى الكلام. نوع إرجاع الوظيفة هذا SynthesizedAudio ، يمكنك الحصول على audio_bytes و audio_metadata .

    use msedge_tts :: { tts :: client :: connect , tts :: SpeechConfig , voice :: get_voices_list } ;
   
   fn main ( ) {
       let voices = get_voices_list ( ) . unwrap ( ) ;
       for voice in & voices {
           if voice . name . contains ( "YunyangNeural" ) {
               let config = SpeechConfig :: from ( voice ) ;
               let mut tts = connect ( ) . unwrap ( ) ;
               let audio = tts
                   . synthesize ( "Hello, World! 你好，世界！" , & config )
                   . unwrap ( ) ;
               break ;
           }
       }
   }

   عميل غير متزامن

   استدعاء وظيفة العميل synthesize لتوليف النص إلى الكلام. نوع إرجاع الوظيفة هذا SynthesizedAudio ، يمكنك الحصول على audio_bytes و audio_metadata .

    use msedge_tts :: { tts :: client :: connect_async , tts :: SpeechConfig , voice :: get_voices_list_async } ;
   
   fn main ( ) {
       smol :: block_on ( async {
           let voices = get_voices_list_async ( ) . await . unwrap ( ) ;
           for voice in & voices {
               if voice . name . contains ( "YunyangNeural" ) {
                   let config = SpeechConfig :: from ( voice ) ;
                   let mut tts = connect_async ( ) . await . unwrap ( ) ;
                   let audio = tts
                       . synthesize ( "Hello, World! 你好，世界！" , & config )
                       . await
                       . unwrap ( ) ;
                   break ;
               }
           }
       } ) ;
   }

   دفق المزامنة

   استدعاء وظيفة دفق المرسل send لتوليف النص إلى الكلام. استدعاء وظيفة دفق القارئ read للحصول على البيانات.
   read Option<SynthesizedResponse> ، قد تكون الاستجابة AudioBytes أو AudioMetadata أو لا شيء. وذلك لأن MSEDGE READ API بصوت عال يرجع شريحة بيانات متعددة وبيانات بيانات ومعلومات أخرى بالتتابع.
   تحذير : send واحد يتوافق مع read متعددة. سيتم حظر send التالية حتى لا توجد بيانات للقراءة. سوف read الحظر قبل الاتصال send .

    use msedge_tts :: {
       tts :: stream :: { msedge_tts_split , SynthesizedResponse } ,
       tts :: SpeechConfig ,
       voice :: get_voices_list ,
   } ;
   use std :: {
       sync :: {
           atomic :: { AtomicBool , Ordering } ,
           Arc ,
       } ,
       thread :: spawn ,
   } ;
   
   fn main ( ) {
       let voices = get_voices_list ( ) . unwrap ( ) ;
       for voice in & voices {
           if voice . name . contains ( "YunyangNeural" ) {
               let config = SpeechConfig :: from ( voice ) ;
               let ( mut sender , mut reader ) = msedge_tts_split ( ) . unwrap ( ) ;
   
               let signal = Arc :: new ( AtomicBool :: new ( false ) ) ;
               let end = signal . clone ( ) ;
               spawn ( move || {
                   sender . send ( "Hello, World! 你好，世界！" , & config ) . unwrap ( ) ;
                   println ! ( "synthesizing...1" ) ;
                   sender . send ( "Hello, World! 你好，世界！" , & config ) . unwrap ( ) ;
                   println ! ( "synthesizing...2" ) ;
                   sender . send ( "Hello, World! 你好，世界！" , & config ) . unwrap ( ) ;
                   println ! ( "synthesizing...3" ) ;
                   sender . send ( "Hello, World! 你好，世界！" , & config ) . unwrap ( ) ;
                   println ! ( "synthesizing...4" ) ;
                   end . store ( true , Ordering :: Relaxed ) ;
               } ) ;
   
               loop {
                   if signal . load ( Ordering :: Relaxed ) && !reader . can_read ( ) {
                       break ;
                   }
                   let audio = reader . read ( ) . unwrap ( ) ;
                   if let Some ( audio ) = audio {
                       match audio {
                           SynthesizedResponse :: AudioBytes ( _ ) => {
                               println ! ( "read bytes" )
                           }
                           SynthesizedResponse :: AudioMetadata ( _ ) => {
                               println ! ( "read metadata" )
                           }
                       }
                   } else {
                       println ! ( "read None" ) ;
                   }
               }
           }
       }
   }

   دفق غير متزامن

   استدعاء وظيفة Sender Async send لتوليف النص إلى الكلام. استدعاء دالة القارئ ASYNC read للحصول على البيانات. read Option<SynthesizedResponse> على النحو الوارد أعلاه. send read الكتلة على النحو الوارد أعلاه.

    use msedge_tts :: {
       tts :: {
           stream :: { msedge_tts_split_async , SynthesizedResponse } ,
           SpeechConfig ,
       } ,
       voice :: get_voices_list_async ,
   } ;
   use std :: {
       sync :: {
           atomic :: { AtomicBool , Ordering } ,
           Arc ,
       } ,
   } ;
   
   fn main ( ) {
       smol :: block_on ( async {
           let voices = get_voices_list_async ( ) . await . unwrap ( ) ;
           for voice in & voices {
               if voice . name . contains ( "YunyangNeural" ) {
                   let config = SpeechConfig :: from ( voice ) ;
                   let ( mut sender , mut reader ) = msedge_tts_split_async ( ) . await . unwrap ( ) ;
   
                   let signal = Arc :: new ( AtomicBool :: new ( false ) ) ;
                   let end = signal . clone ( ) ;
                   smol :: spawn ( async move {
                       sender
                           . send ( "Hello, World! 你好，世界！" , & config )
                           . await
                           . unwrap ( ) ;
                       println ! ( "synthesizing...1" ) ;
                       sender
                           . send ( "Hello, World! 你好，世界！" , & config )
                           . await
                           . unwrap ( ) ;
                       println ! ( "synthesizing...2" ) ;
                       sender
                           . send ( "Hello, World! 你好，世界！" , & config )
                           . await
                           . unwrap ( ) ;
                       println ! ( "synthesizing...3" ) ;
                       sender
                           . send ( "Hello, World! 你好，世界！" , & config )
                           . await
                           . unwrap ( ) ;
                       println ! ( "synthesizing...4" ) ;
                       end . store ( true , Ordering :: Relaxed ) ;
                   } )
                   . detach ( ) ;
   
                   loop {
                       if signal . load ( Ordering :: Relaxed ) && !reader . can_read ( ) . await {
                           break ;
                       }
                       let audio = reader . read ( ) . await . unwrap ( ) ;
                       if let Some ( audio ) = audio {
                           match audio {
                               SynthesizedResponse :: AudioBytes ( _ ) => {
                                   println ! ( "read bytes" )
                               }
                               SynthesizedResponse :: AudioMetadata ( _ ) => {
                                   println ! ( "read metadata" )
                               }
                           }
                       } else {
                           println ! ( "read None" ) ;
                       }
                   }
               }
           }
       } ) ;
   }

انظر كل الأمثلة.