added say_localized_text method

Author: ikkez

anki_vector/behavior.py

@@ -179,7 +179,8 @@ async def roll_visible_cube(self) -> protocol.RollBlockResponse:
 
     # TODO Make this cancellable with is_cancellable_behavior
     @connection.on_connection_thread()
-    async def say_text(self, text: str, use_vector_voice: bool = True, duration_scalar: float = 1.0) -> protocol.SayTextResponse:
+    async def say_text(self, text: str, use_vector_voice: bool = True,
+                       duration_scalar: float = 1.0) -> protocol.SayTextResponse:
         """Make Vector speak text.
 
         .. testcode::
@@ -201,6 +202,60 @@ async def say_text(self, text: str, use_vector_voice: bool = True, duration_scal
                                                    duration_scalar=duration_scalar)
         return await self.conn.grpc_interface.SayText(say_text_request)
 
+    def say_localized_text(self, text: str, use_vector_voice: bool = True, duration_scalar: float = 1.0,
+                           language: str = 'en') -> protocol.SayTextResponse:
+        """Make Vector speak text with a different localized voice.
+
+                .. testcode::
+
+                    import anki_vector
+                    with anki_vector.Robot() as robot:
+                        robot.behavior.say_localized_text("Hello World",language="de")
+
+                :param text: The words for Vector to say.
+                :param use_vector_voice: Whether to use Vector's robot voice
+                        (otherwise, he uses a generic human male voice).
+                :param duration_scalar: Adjust the relative duration of the
+                        generated text to speech audio.
+                :param language: Adjust the language spoken for this text
+
+                    possible values:
+                        de:         German
+                        en:         English
+                        ja or jp:   Japanese
+                        fr:         French
+
+                :return: object that provides the status and utterance state
+                """
+
+        if language == 'en':
+            locale = 'en_US'
+        if language == 'de':
+            locale = 'de_DE'
+        elif language == 'fr':
+            locale = 'fr_FR'
+        elif language == 'ja' or language == 'jp':
+            locale = 'ja_JP'
+            duration_scalar = duration_scalar / 3
+        else:
+            locale = language
+
+        if self.robot.force_async:
+            # @TODO: make sure requests are sent in conjunction when say_future would be returned -
+            #  currently it's blocking async, to ensure the language is switched back after talking
+            #  because otherwise the persisted different locale would lead to failed cloud requests,
+            #  as on english seems to be supported right now and vector would show network-error on his screen
+            self.change_locale(locale=locale).result()
+            say_future = self.say_text(text, use_vector_voice, duration_scalar)
+            res = say_future.result()
+            self.change_locale(locale='en_US').result()
+            return res
+        else:
+            self.change_locale(locale=locale)
+            say_future = self.say_text(text, use_vector_voice, duration_scalar)
+            self.change_locale(locale='en_US')
+        return say_future
+
     # TODO Make this cancellable with is_cancellable_behavior
     @connection.on_connection_thread()
     async def app_intent(self, intent: str, param: str = None) -> protocol.AppIntentResponse: