1. 初始化语音服务   【所有的使用示例必须放到 script_main(self) 类函数下使用, 语音和发音人的参数在文档的最下方】

    def init_speech_service(self, speech_key: str, speech_region: str) -》 bool:
        """
            初始化语音服务(不支持win7),需要调用 activateSpeechService 激活
            To initialize voice service (win7 is not supported), you need to call activateSpeechService to activate it
            微软密钥注册官网: https://portal.azure.com/#home

            speech_key: 微软语音API密钥
            speech_region: 区域
            return: True或者False

            speech_key: Microsoft voice API key
            speech_region: region
            return: True or False
        """

    # 使用示例 [Demo]
    result = self.init_speech_service("1a7ff773c540921997fdsfsfcvb", "eastasia")
    print(result) 

    

2. 音频文件转文本


    def audio_file_to_text(self, file_path, language: str) -》 str:
        """
            音频文件转文本
            Audio file to text

            file_path: 音频文件路径
            language: 语言,参考开发文档 语言和发音人 zh-cn
            return: 转换后的音频文本或者None

            file_path: the audio file path
            language: language, reference development document language and speaker zh-cn
            return: converted audio text or None
        """

    # 使用示例 [Demo]
    result = self.audio_file_to_text("D://PyAibote.mp3", "zh-cn")
    print(result) 

    

3. 麦克风输入流转换文本

    def microphone_to_text(self, language: str) -》 str:
        """
            麦克风输入流转换文本
            Microphone input stream conversion text

            language: 语言,参考开发文档 语言和发音人 zh-cn
            return: 转换后的音频文本或者None

            language: language, reference development document language and speaker zh-cn
            return: converted audio text or None
        """

    # 使用示例 [Demo]
    result = self.microphone_to_text("zh-cn")
    print(result) 

    

4. 文本合成音频到扬声器


    def text_to_bullhorn(self, ssml_path_or_text: str, language: str, voice_name: str) -》 bool:
        """
            文本合成音频到扬声器
            Text synthesis audio to speakers

            ssml_path_or_text: 要转换语音的文本或者".xml"格式文件路径
            language: 语言,参考开发文档 语言和发音人 zh-cn
            voice_name: 发音人,参考开发文档 语言和发音人  zh-cn-XiaochenNeural
            return: True或者False

            ssml_path_or_text: The path of the text or ".xml" format file to be converted into speech
            language: Language, reference development document language and speaker  zh-cn
            voice_name: Speaker, reference development document language and speaker zh-cn-XiaochenNeural
            return: True or False  
        """

    # 使用示例 [Demo]
    result = self.text_to_bullhorn("人生苦短, 我用Python", "zh-cn", "zh-cn-XiaochenNeural")
    print(result) 

    

5. 文本合成音频并保存到文件


    def text_to_audio_file(self, ssml_path_or_text: str, language: str, voice_name: str, audio_path: str) -》 bool:
        """
            文本合成音频并保存到文件
            Text synthesizes audio and saves it to a file.

            ssml_path_or_text: 要转换语音的文本或者".xml"格式文件路径
            language: 语言,参考开发文档 语言和发音人
            voice_name: 发音人,参考开发文档 语言和发音人
            audio_path: 保存音频文件路径
            return: True或者False

            ssml_path_or_text: the text or file path in ".xml" format to be converted
            language: language, reference development document language and speaker
            voice_name: speaker, refer to the development document language and speaker
            audio_path: the path to save the audio file
            return: True or False
        """

    # 使用示例 [Demo]
    result = self.text_to_audio_file("D://PyAibote.txt", "zh-cn", "zh-cn-XiaochenNeural", "D://Aubido//PyAibote.mp3")
    print(result) 

    

6. 麦克风音频翻译成目标语言文本


    def microphone_translation_text(self, source_language: str, target_language: str) -》 str:
        """
            麦克风音频翻译成目标语言文本
            Microphone audio is translated into target language text

            source_language: 要翻译的语言,参考开发文档 语言和发音人
            target_language: 翻译后的语言,参考开发文档 语言和发音人
            return: 成功返回翻译后的语言文本,失败返回None

            source_language: the language to be translated, refer to the development document language and speaker
            target_language: the translated language, referring to the development document language and speaker
            return: converted audio text or None
        """

    # 使用示例 [Demo]
    result = self.microphone_translation_text("zh-cn", "en-US")
    print(result) 

    

7. 音频文件翻译成目标语言文本


    def audio_file_translation_text(self, audio_path: str, source_language: str, target_language: str) -》 str:
        """
            音频文件翻译成目标语言文本
            The audio file is translated into the target language text

            audio_path: 要翻译的音频文件路径
            source_language: 要翻译的语言,参考开发文档 语言和发音人
            target_language: 翻译后的语言,参考开发文档 语言和发音人
            return: 转换后的音频文本或者None

            audio_path: the path of the audio file to be translated
            source_language: the language to be translated, refer to the development document language and speaker
            target_language: the translated language, referring to the development document language and speaker
            return: converted audio text or None
        """

    # 使用示例 [Demo]
    result = self.audio_file_translation_text("PyAibote.mp3", "zh-cn", "en-US")
    print(result) 


语音和发音人


    语言:
    * 中文(普通话,简体):"zh-cn"
    * 中文(粤语,简体):"yue-CN"
    * 英语(美国):"en-US"
    * 英语(英国):"en-GB"

    发音人:
    * 中文(普通话,简体):
    * 晓辰:zh-cn-XiaochenNeural(女)
    * 晓涵:zh-cn-XiaohanNeural(女)

    * 语音风格:
    * 常规    General
    * 平静    Calm
    * 可怕    Fearful
    * 开朗    Cheerful
    * 怏怏    Disgruntled
    * 严重    Serious
    * 生气    Angry
    * 伤心    Sad
    * 温柔    Gentle
    * 深情    Affectionate
    * 尴尬    Embarrassed

    * 晓梦:zh-cn-XiaomengNeural(女)
       * 语音风格:
       * 常规    General
       * 聊天    Chat

    * 晓墨:zh-cn-XiaomoNeural(女)
       * 语音风格:
       * 常规    General
       * 尴尬    Embarrassed
       * 平静    Calm
       * 可怕    Fearful
       * 开朗    Cheerful
       * 怏怏    Disgruntled
       * 严重    Serious
       * 生气    Angry
       * 伤心    Sad
       * 沮丧    Depressed
       * 深情    Affectionate
       * 温柔    Gentle
       * 羡慕    Envious

    * 晓秋:zh-cn-XiaoqiuNeural(女)
    * 晓睿:zh-cn-XiaoruiNeural(女)
       * 语音风格:
       * 常规  General
       * 平静  Calm
       * 可怕    Fearful
       * 生气    Angry
       * 伤心    Sad

    * 晓双:zh-cn-XiaoshuangNeural(女)
       * 语音风格:
       * 常规  General
       * 聊天    Chat

    * 晓晓:zh-cn-XiaoxiaoNeural(女)
       * 语音风格:
       * 常规 General
       * 助理 Assistant
       * 聊天    Chat
       * 顾客服务    Customer Service
       * 新闻    Newscast
       * 深情    Affectionate
       * 生气    Angry
       * 平静    Calm
       * 开朗    Cheerful
       * 怏怏    Disgruntled
       * 可怕    Fearful
       * 温柔    Gentle
       * 抒情    Lyrical
       * 伤心    Sad
       * 严重    Serious
       * 诗歌朗诵    Poetry-reading
       * 友好    Friendly

    * 晓萱:zh-cn-XiaoxuanNeural(女)
       * 语音风格:
       * 常规  General
       * 平静    Calm
       * 可怕    Fearful
       * 开朗    Cheerful
       * 怏怏    Disgruntled
       * 严重    Serious
       * 生气    Angry
       * 温柔    Gentle
       * 沮丧    Depressed

    * 晓颜:zh-cn-XiaoyanNeural(女)
    * 晓伊:zh-cn-XiaoyiNeural(女)
       * 语音风格:
       * 常规  General
       * 生气    Angry
       * 怏怏    Disgruntled
       * 深情    Affectionate
       * 开朗    Cheerful
       * 可怕    Fearful
       * 伤心    Sad
       * 尴尬    Embarrassed
       * 严重    Serious
       * 温柔    Gentle

    * 晓悠:zh-cn-XiaoyouNeural(女)
    * 晓甄:zh-cn-XiaozhenNeural(女)
       * 语音风格:
       * 常规  General
       * 生气    Angry
       * 怏怏    Disgruntled
       * 开朗    Cheerful
       * 可怕    Fearful
       * 伤心    Sad
       * 严重    Serious

    * 云枫:zh-cn-YunfengNeural(男)
       * 语音风格:
       * 常规     General
       * 生气    Angry
       * 怏怏    Disgruntled
       * 开朗    Cheerful
       * 可怕    Fearful
       * 伤心    Sad
       * 严重    Serious
       * 沮丧    Depressed

    * 云皓:zh-cn-YunhaoNeural(男)
       * 语音风格:
       * 常规     General
       * 广告乐观    Advertisement-upbeat

    * 云健:zh-cn-YunjianNeural(男)
       * 语音风格:
       * 常规     General
       * 旁白放松    Narration-relaxed
       * 体育评论    Sports-commentary
       * 体育评论兴奋    Sports-commentary-excited

    * 云夏:zh-cn-YunxiaNeural(男)
       * 语音风格:
       * 常规 General
       * 平静    Calm
       * 可怕    Fearful
       * 开朗    Cheerful
       * 生气    Angry
       * 伤心    Sad

    * 云希:zh-cn-YunxiNeural(男)
       * 语音风格:
       * 常规  General
       * 旁白放松    Narration-relaxed
       * 尴尬    Embarrassed
       * 可怕    Fearful
       * 开朗    Cheerful
       * 怏怏    Disgruntled
       * 严重    Serious
       * 生气    Angry
       * 伤心    Sad
       * 沮丧    Depressed
       * 聊天    Chat
       * 助理    Assistant
       * 新闻    Newscast

    * 云扬:zh-cn-YunyangNeural男)
       * 语音风格:
       * 常规     General
       * 顾客服务    Customer Service
       * 旁白-专业 Narration-professional
       * 新闻广播-休闲 Newscast-casual

    * 云野:zh-cn-YunyeNeural(男)
       * 语音风格:
       * 常规     General
       * 尴尬    Embarrassed
       * 平静    Calm
       * 可怕    Fearful
       * 开朗    Cheerful
       * 怏怏    Disgruntled
       * 严重    Serious
       * 生气    Angry
       * 伤心    Sad

    * 云泽:zh-cn-YunzeNeural(男)
       * 语音风格:
       * 常规     General
       * 平静    Calm
       * 可怕    Fearful
       * 开朗    Cheerful
       * 怏怏    Disgruntled
       * 严重    Serious
       * 生气    Angry
       * 伤心    Sad
       * 沮丧    Depressed
       * 纪录片旁白  Documentary-narration

    * 中文(粤语,简体):
    * 晓敏:yue-CN-XiaoMinNeural(女)
    * 云松:yue-CN-YunSongNeural(男)

    * 英语(美国):
    * AI1:en-US-AIGenerate1Neural(男)
    * AI2:en-US-AIGenerate2Neural(女)
    * en-US-AmberNeural(女)
    * 安娜:en-US-AnaNeural(女)
    * 阿丽亚:en-US-AriaNeural(女)
    * 阿什莉:en-US-AshleyNeural(女)
    * 布兰登:en-US-BrandonNeural(男)
    * 克里斯托弗:en-US-ChristopherNeural(男)
    * 科拉:en-US-CoraNeural(女)
    * 戴维斯:en-US-DavisNeural(男)
    * 伊丽莎白:en-US-ElizabethNeural(女)
    * 埃里克:en-US-EricNeural(男)
    * 盖伊:en-US-GuyNeural(男)
    * 雅各布:en-US-JacobNeural(男)
    * 简:en-US-JaneNeural(女)
    * 杰森:en-US-JasonNeural(男)
    * 珍妮(多种语言):en-US-JennyMultilingualNeural(女)
    * 珍妮:en-US-JennyNeural(女)
    * 米歇尔:en-US-MichelleNeural(女)
    * 莫妮卡:en-US-MonicaNeural(女)
    * 南茜:en-US-NancyNeural(女)
    * 罗杰:en-US-RogerNeural(男)
    * 莎拉:en-US-SaraNeural(女)
    * 史蒂芬:en-US-SteffanNeural(男)
    * 托尼:en-US-TonyNeural(男)
    
    * 英语(英国):
    * 阿比:en-GB-AbbiNeural(女)
    * 阿尔菲:en-GB-AlfieNeural(男)
    * 贝拉:en-GB-BellaNeural(女)
    * 艾略特:en-GB-ElliotNeural(男)
    * 伊桑:en-GB-EthanNeural(男)
    * 霍莉:en-GB-HollieNeural(女)
    * 利比:en-GB-LibbyNeural(女)
    * 梅西:en-GB-MaisieNeural(女)
    * 诺亚:en-GB-NoahNeural(男)
    * 奥利弗:en-GB-OliverNeural(男)
    * 奥利维亚:en-GB-OliviaNeural(女)
    * 莱恩:en-GB-RyanNeural(男)
    * 索尼娅:en-GB-SoniaNeural(女)
    * 托马斯:en-GB-ThomasNeural(男)