swift tts

Swifttts

该软件包包含一些非常简单的包装器，围绕Avoundation/avspeechsynthesizer的TTS部分包装，使您可以轻松地使用文本语音。

• SwiftTTS使用Swift并发与async await ，等待几个AsyncStream
• SwiftTTSDependency在上面的库周围包装器，促进了与无点依赖库的集成，或者由可合转架构（TCA）制成的项目。
• SwiftTTSCombine此软件包中仍然可用的OG库

现代并发用法

• speak(String) -> Void当您只想使用简单字符串的TT时调用此方法
  • 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