swift tts

swifttts

تحتوي هذه الحزمة على بعض الأغلفة المباشرة للغاية حول TTS جزء من Avfoundation/AvspeechSynthesizer للسماح لك باستخدام النص إلى الكلام بسهولة.

• SwiftTTS باستخدام Swift Concurrency مع async await ، اثنين من AsyncStream
• SwiftTTSDependency غلاف حول المكتبة أعلاه تسهيل التكامل مع مكتبة التبعيات الخالية من النقاط أو مشروع مصنوع من الهندسة المعمارية القابلة للتكامل (TCA).
• SwiftTTSCombine لا تزال مكتبة OG متوفرة في هذه الحزمة

استخدام التزامن الحديث

• speak(String) -> Void - اتصل بهذه الطريقة عندما تريد ببساطة استخدام TTS مع سلسلة بسيطة
  • isSpeaking() -> AsyncStream<Bool> - لمعرفة متى يبدأ الكلام في الاستماع ، وعندما يتم إيقافه
  • speakingProgress() -> AsyncStream<Double> - لمعرفة التقدم ، من 0 إلى 1
• rateRatio() -> Float - اضبط المعدل لإبطاء أو تسريع محرك TTS
• setRateRatio(Float) -> Void - اضبط المعدل لإبطاء أو تسريع محرك TTS
• voice() -> AVSpeechSynthesisVoice? - صوت محرك TTS ، افتراضيًا ، إنه صوت en-GB
• setVoice(AVSpeechSynthesisVoice) -> Void - اضبط صوت محرك TTS

مثال

import SwiftTTS

let tts = SwiftTTS . live

tts . speak ( " Hello World! " )

Task {
    for await isSpeaking in tts . isSpeaking ( ) {
        print ( " TTS is currently ( isSpeaking ? " speaking " : " not speaking " ) " )
    }
}

Task {
    for await progress in tts . speakingProgress ( ) {
        print ( " Progress: ( Int ( progress * 100 ) ) % " )
    }
}

tts . setRateRatio ( 3 / 4 )

tts . speak ( " Hello World! But slower " ) 

استخدام التبعيات الخالية من النقاط

أضف Reducer @Dependency(.tts) var tts

مثال

import ComposableArchitecture
import Foundation
import SwiftTTSDependency

public struct TTS : ReducerProtocol {
    public struct State : Equatable {
        public var text = " "
        public var isSpeaking = false
        public var speakingProgress = 1.0
        public var rateRatio : Float = 1.0

        public init (
            text : String = " " ,
            isSpeaking : Bool = false ,
            speakingProgress : Double = 1.0 ,
            rateRatio : Float = 1.0
        ) {
            self . text = text
            self . isSpeaking = isSpeaking
            self . speakingProgress = speakingProgress
            self . rateRatio = rateRatio
        }
    }

    public enum Action : Equatable {
        case changeRateRatio ( Float )
        case speak
        case startSpeaking
        case stopSpeaking
        case changeSpeakingProgress ( Double )
    }

    @ Dependency (  . tts ) var tts

    public init ( ) { }

    public var body : some ReducerProtocol < State , Action > {
        Reduce { state , action in
            switch action {
            case let . changeRateRatio ( rateRatio ) :
                state . rateRatio = rateRatio
                tts . setRateRatio ( rateRatio )
                return . none
            case . speak :
                tts . speak ( state . text )
                return . run { send in
                    for await isSpeaking in tts . isSpeaking ( ) {
                        if isSpeaking {
                            await send ( . startSpeaking )
                        } else {
                            await send ( . stopSpeaking )
                        }
                    }
                }
            case . startSpeaking :
                state . isSpeaking = true
                return . run { send in
                    for await progress in tts . speakingProgress ( ) {
                        await send ( . changeSpeakingProgress ( progress ) )
                    }
                }
            case . stopSpeaking :
                state . isSpeaking = false
                return . none
            case let . changeSpeakingProgress ( speakingProgress ) :
                state . speakingProgress = speakingProgress
                return . none
            }
        }
    }
} 

الجمع بين الاستخدام

يمكنك إنشاء كائن TTSEngine /حقنه ، له هذا السلوك

• func speak(string: String) : اتصل بهذه الطريقة عندما تريد ببساطة استخدام TTS مع سلسلة بسيطة
  • اشترك في isSpeakingPublisher لمعرفة متى يبدأ الكلام في الاستماع ، وعندما يتم إيقافه
  • اشترك في speakingProgressPublisher لمعرفة التقدم ، من 0 إلى 1
• var rateRatio: Float : اضبط المعدل لإبطاء أو تسريع محرك TTS
• var voice: AVSpeechSynthesisVoice? : اضبط صوت محرك TTS ، بشكل افتراضي ، إنه صوت en-GB

مثال

import Combine
import SwiftTTSCombine

let engine : TTSEngine = SwiftTTSCombine . Engine ( )
var cancellables = Set < AnyCancellable > ( )

engine . speak ( string : " Hello World! " )

engine . isSpeakingPublisher
    . sink { isSpeaking in
        print ( " TTS is currently ( isSpeaking ? " speaking " : " not speaking " ) " )
    }
    . store ( in : & cancellables )

engine . speakingProgressPublisher
    . sink { progress in
        print ( " Progress: ( Int ( progress * 100 ) ) % " )
    }
    . store ( in : & cancellables )

engine . rateRatio = 3 / 4

engine . speak ( string : " Hello World! But slower " ) 

تثبيت

xcode

يمكنك إضافة swifttts libs إلى مشروع Xcode عن طريق إضافته كاعتماد على الحزمة.

1. من قائمة الملفات ، حدد حزم Swift ›إضافة تبعية الحزمة ...
2. أدخل "https://github.com/renaudjenny/swift-tts" في حقل اختبار عنوان URL لمستودع الحزمة
3. حدد واحدة من الحزمة الثلاث التي تهتم بها. انظر أعلاه

كما تبعية الحزمة

قم بتحرير Package.swift الخاصة بك.

 let package = Package (
    ...
    dependencies : [
        . package ( url : " https://github.com/renaudjenny/swift-tts " , from : " 2.0.0 " ) ,
        ...
    ] ,
    targets : [
        . target (
            name : " <Your project name> " ,
            dependencies : [
                . product ( name : " SwiftTTS " , package : " swift-tts " ) , // <-- Modern concurrency
                . product ( name : " SwiftTTSDependency " , package : " swift-tts " ) , // <-- Point-Free Dependencies library wrapper
                . product ( name : " SwiftTTSCombine " , package : " swift-tts " ) , // <-- Combine wrapper
            ] ) ,
        ...
    ]
) 

التطبيق باستخدام هذه المكتبة

• ؟ أخبر الوقت في المملكة المتحدة: https://github.com/renaudjenny/telltime