//是否正在语音播放
open var isSpeaking: Bool { get }

//是否停止语音播放
open var isPaused: Bool { get }

//播放语音
open func speak(_ utterance: AVSpeechUtterance)

//停止语音播放
open func stopSpeaking(at boundary: AVSpeechBoundary) -> Bool

//暂停语音播放
open func pauseSpeaking(at boundary: AVSpeechBoundary) -> Bool

//继续语音播放
open func continueSpeaking() -> Bool

//(iOS10以上, 输出通道)
open var outputChannels: [AVAudioSessionChannelDescription]?

case immediate
//表示发言应该暂停或立即停止。

case word
//说完整个词语之后再暂停或者停止

//使用的声音
open var voice: AVSpeechSynthesisVoice?

//文本属性    
open var speechString: String { get }

//富文本属性
@available(iOS 10.0, *)
open var attributedSpeechString: NSAttributedString { get }

//说话的速度    
open var rate: Float 
//提供了两个语速 AVSpeechUtteranceMinimumSpeechRate和 AVSpeechUtteranceMaximumSpeechRate和AVSpeechUtteranceDefaultSpeechRate

//说话的基线音高, [0.5 - 2] Default = 1   
open var pitchMultiplier: Float 

//说话音量, [0-1] Default = 1
open var volume: Float 

//开始一段语音之前等待的时间
open var preUtteranceDelay: TimeInterval 

//语音合成器在当前语音结束之后处理下一个排队的语音之前需要等待的时间, 默认0.0 
open var postUtteranceDelay: TimeInterval

public init(string: String)

@available(iOS 10.0, *)
public init(attributedString string: NSAttributedString)

//获得当前的语言
open var language: String { get }

//返回用户当前语言环境的代码
@available(iOS 9.0, *)
open var identifier: String { get }

@available(iOS 9.0, *)
open var name: String { get }

@available(iOS 9.0, *)
open var quality: AVSpeechSynthesisVoiceQuality { get }

init?(language: String?)
//返回指定语言和语言环境的语音对象。

class func speechVoices()
//返回所有可用的语音。


class func currentLanguageCode()
//返回用户当前语言环境的代码。

//开始播放
optional public func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, didStart utterance: AVSpeechUtterance)

//播放完成
optional public func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, didFinish utterance: AVSpeechUtterance)

//暂停播放
optional public func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, didPause utterance: AVSpeechUtterance)

//继续播放
optional public func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, didContinue utterance: AVSpeechUtterance)

//取消播放
optional public func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, didCancel utterance: AVSpeechUtterance)

//将要播放某一段话  
optional public func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, willSpeakRangeOfSpeechString characterRange: NSRange, utterance: AVSpeechUtterance)

//MARK: 开始/停止转换
extension TextToVoiceController{
    //开始转换
    fileprivate func startTranslattion(){
        //1. 创建需要合成的声音类型
        let voice = AVSpeechSynthesisVoice(language: "zh-CN")
        
        //2. 创建合成的语音类
        let utterance = AVSpeechUtterance(string: textView.text)
        utterance.rate = AVSpeechUtteranceDefaultSpeechRate
        utterance.voice = voice
        utterance.volume = 1
        utterance.postUtteranceDelay = 0.1
        utterance.pitchMultiplier = 1
        //开始播放
        avSpeech.speak(utterance)
    }
    
    //暂停播放
    fileprivate func pauseTranslation(){
        avSpeech.pauseSpeaking(at: .immediate)
    }
    
    //继续播放
    fileprivate func continueSpeek(){
        avSpeech.continueSpeaking()
    }
    
    //取消播放
    fileprivate func cancleSpeek(){
        avSpeech.stopSpeaking(at: .immediate)
    }
}

//这个初始化方法将默认以设备当前的语言环境作为语音识别的语言环境
public convenience init?() 

//根据支持的语言初始化
public init?(locale: Locale) 
//示例
let recognize = SFSpeechRecognizer(locale: Locale(identifier: "zh-CN"))

//获取所有支持的语言
open class func supportedLocales() -> Set<Locale>

//获取当前用户权限状态
open class func authorizationStatus() -> SFSpeechRecognizerAuthorizationStatus

//申请语音识别用户权限
open class func requestAuthorization(_ handler: @escaping (SFSpeechRecognizerAuthorizationStatus) -> Swift.Void)

var isAvailable: Bool
//指示语音识别器是否可用

var locale: Locale
//当前语音识别器的语言环境

class func supportedLocales()
//获取语音识别所有支持的语言

var queue: OperationQueue
//语音识别器用于识别任务处理程序和委托消息的队列

//识别与指定请求关联的音频来源的语音，使用指定的协议返回结果
open func recognitionTask(with request: SFSpeechRecognitionRequest, resultHandler: @escaping (SFSpeechRecognitionResult?, Error?) -> Swift.Void) -> SFSpeechRecognitionTask

//识别与指定请求关联的音频源的语音, 使用闭包结果
open func recognitionTask(with request: SFSpeechRecognitionRequest, delegate: SFSpeechRecognitionTaskDelegate) -> SFSpeechRecognitionTask

weak var delegate: SFSpeechRecognizerDelegate? { get set }

//代理方法: 监视语音识别器的可用性
func speechRecognizer(SFSpeechRecognizer, availabilityDidChange: Bool)

var contextualStrings: [String]
//一系列应该被识别的语言种类

var shouldReportPartialResults: Bool
//是否获取每个语句的最终结果。

var taskHint: SFSpeechRecognitionTaskHint
//正在执行的语音识别的类型

var interactionIdentifier: String?
//标识与请求关联的识别请求对象的字符串

//创建一个语音识别请求，使用指定的URL进行初始化
public init(url URL: URL)

//获取当前的usl路径    
open var url: URL { get }

func append(AVAudioPCMBuffer)
//将PCM格式的音频追加到识别请求的末尾。

func appendAudioSampleBuffer(CMSampleBuffer)
//将音频附加到识别请求的末尾。

func endAudio()
//完成输入

var nativeAudioFormat: AVAudioFormat
//用于最佳语音识别的首选音频格式。

func cancel()
//取消当前的语音识别任务。

var isCancelled: Bool
//语音识别任务是否已被取消。

func finish()
//停止接受新的音频，并完成已接受的音频输入处理

var isFinishing: Bool
//音频输入是否已停止。

var state: SFSpeechRecognitionTaskState
//获取语音识别任务的当前状态。

var error: Error?
//在语音识别任务期间发生的错误的错误对象。

//当开始检测音频源中的语音时首先调用此方法
optional public func speechRecognitionDidDetectSpeech(_ task: SFSpeechRecognitionTask)

//当识别出一条可用的信息后 会调用
//apple的语音识别服务会根据提供的音频源识别出多个可能的结果 每有一条结果可用 都会调用此方法
optional public func speechRecognitionTask(_ task: SFSpeechRecognitionTask, didHypothesizeTranscription transcription: SFTranscription)

//当识别完成所有可用的结果后调用
optional public func speechRecognitionTask(_ task: SFSpeechRecognitionTask, didFinishRecognition recognitionResult: SFSpeechRecognitionResult)

//当不再接受音频输入时调用 即开始处理语音识别任务时调用   
optional public func speechRecognitionTaskFinishedReadingAudio(_ task: SFSpeechRecognitionTask)

//当语音识别任务被取消时调用    
optional public func speechRecognitionTaskWasCancelled(_ task: SFSpeechRecognitionTask)

//语音识别任务完成时被调用    
optional public func speechRecognitionTask(_ task: SFSpeechRecognitionTask, didFinishSuccessfully successfully: Bool)

//返回了一条表达语音译文的字符数据
open var formattedString: String { get }

//所有的可能的识别数据
open var segments: [SFTranscriptionSegment] { get }

//当前节点识别后的文本信息
open var substring: String { get }

//当前节点识别后的文本信息在整体识别语句中的位置
open var substringRange: NSRange { get }

//当前节点的音频时间戳
open var timestamp: TimeInterval { get }

//当前节点音频的持续时间
open var duration: TimeInterval { get }

//可信度/准确度 0-1之间
open var confidence: Float { get }

//关于此节点的其他可能的识别结果 
open var alternativeSubstrings: [String] { get }

//准确性最高的识别实例
@NSCopying open var bestTranscription: SFTranscription { get }

//识别到的多套语音转换信息数组 其会按照准确度进行排序
open var transcriptions: [SFTranscription] { get }

//是否已经完成 如果YES 则所有所有识别信息都已经获取完成
open var isFinal: Bool { get }

Privacy - Speech Recognition Usage Description
//语音识别权限

Privacy - Microphone Usage Description
//麦克风使用权限

///语音识别权限认证
fileprivate func addSpeechRecordLimit(){
    SFSpeechRecognizer.requestAuthorization { (state) in
        var isEnable = false
        switch state {
        case .authorized:
            isEnable = true
            print("已授权语音识别")
        case .notDetermined:
            isEnable = false
            print("没有授权语音识别")
        case .denied:
            isEnable = false
            print("用户已拒绝访问语音识别")
        case .restricted:
            isEnable = false
            print("不能在该设备上进行语音识别")
        }
        DispatchQueue.main.async {
            self.recordBtn.isEnabled = isEnable
            self.recordBtn.backgroundColor = isEnable ? UIColor(red: 255/255.0, green: 64/255.0, blue: 64/255.0, alpha: 1) : UIColor.lightGray
        }
    }
}

         ar-SA  沙特阿拉伯（阿拉伯文）

         en-ZA, 南非（英文）

         nl-BE, 比利时（荷兰文）

         en-AU, 澳大利亚（英文）

         th-TH, 泰国（泰文）

         de-DE, 德国（德文）

         en-US, 美国（英文）

         pt-BR, 巴西（葡萄牙文）

         pl-PL, 波兰（波兰文）

         en-IE, 爱尔兰（英文）
         
         el-GR, 希腊（希腊文）

         id-ID, 印度尼西亚（印度尼西亚文）

         sv-SE, 瑞典（瑞典文）

         tr-TR, 土耳其（土耳其文）

         pt-PT, 葡萄牙（葡萄牙文）

         ja-JP, 日本（日文）

         ko-KR, 南朝鲜（朝鲜文）

         hu-HU, 匈牙利（匈牙利文）

         cs-CZ, 捷克共和国（捷克文）

         da-DK, 丹麦（丹麦文）

         es-MX, 墨西哥（西班牙文）

         fr-CA, 加拿大（法文）

         nl-NL, 荷兰（荷兰文）

         fi-FI, 芬兰（芬兰文）
         
         es-ES, 西班牙（西班牙文）

         it-IT, 意大利（意大利文）

         he-IL, 以色列（希伯莱文，阿拉伯文）

         no-NO, 挪威（挪威文）

         ro-RO, 罗马尼亚（罗马尼亚文）

         zh-HK, 香港（中文）

         zh-TW, 台湾（中文）

         sk-SK, 斯洛伐克（斯洛伐克文）

         zh-CN, 中国（中文）

         ru-RU, 俄罗斯（俄文）

         en-GB, 英国（英文）

         fr-FR, 法国（法文）
         
         hi-IN  印度（印度文）