a ýÞ{bÙã@sdZGdd„dƒZdS)aù Speech to Text ============== .. versionadded:: 1.4.0 Speech Recognition facade. In order to check that your device supports voice recognition use method `exist`. Variable `language` indicates which language will be used to match words from voice. Use `start` to start voice recognition immediately and `stop` to stop. .. note:: Needed permissions for Android: `RECORD_AUDIO` (and `INTERNET` if you want online voice recognition API to be used) .. note:: On Android platform, after execute `start` method you can hear BEEP! Mute sound in order to disable it. .. note:: For Android implementation to work there has to be an application with `android.speech.RecognitionService` implementation present in the system. Mostly it's `com.google.android.googlequicksearchbox` or "Google" application (the search bar with the launcher widget). Offline Speech Recognition on Android ------------------------------------- Requires any application that provides an `android.speech.RecognitionService` implementation to the other apps. One of such applications is on a lot of devices preinstalled Google (quick search box). The API prefers offline recognition, but should be able to switch to online alternative in case you don't have a language package installed (`INTERNET` permission necessary). You can enable offline speech recognition this way (Android 8.1): * open the `Settings` app * choose `Language & Input` / `Language & Keyboard` (Samsung might include it in the `General` category) * choose `On-Screen keyboard` or `Voice search` * choose `Google Keyboard` * choose `Offline Speech recognition` * download language package if you don't have one already Simple Examples --------------- To start listening:: >>> from plyer import stt >>> stt.start() To retrieve partial results while listening:: >>> assert stt.listening >>> print(stt.partial_results) To stop listening:: >>> stt.stop() To retrieve results after the listening stopped:: >>> print(stt.results) c@s†eZdZdZdZddgZgZgZgZdZ dZ e dd„ƒZ e dd „ƒZ e jd d „ƒZ d d „Zd d„Zdd„Zdd„Zdd„Zdd„ZdS)ÚSTTz Speech to text facade. zen-USzpl-PLTFcCs|jS)zI Return list of supported languages used in recognition. )Ú_supported_languages©Úself©rúa/Users/vegardjervell/Documents/master/model/venv/lib/python3.9/site-packages/plyer/facades/stt.pyÚsupported_languagesxszSTT.supported_languagescCs|jS)z* Return current language. )Ú _languagerrrrÚlanguage€sz STT.languagecCs||jvr||_dS)aè Set current language. Value can not be set if it's not supported. See `supported_languages` to get what language you can set. .. note:: We obviously can't check each language, therefore if you find that a specific language is available to you and the only limitation is our check for the internally defined `supported_languages`, feel free to open a pull request for adding your language to the list. N)rr)rÚlangrrrr ˆs cCsg|_g|_| ¡d|_dS)z" Start listening. TN)ÚresultsÚpartial_resultsÚ_startÚ listeningrrrrÚstart›sz STT.startcCs| ¡d|_dS)z! Stop listening. FN)Ú_stoprrrrrÚstop¥szSTT.stopcCs| ¡S)zH Returns a boolean for speech recognition availability. )Ú_existrrrrÚexist­sz STT.existcCst‚dS©N©ÚNotImplementedErrorrrrrr µsz STT._startcCst‚dSrrrrrrr¸sz STT._stopcCst‚dSrrrrrrr»sz STT._existN)Ú__name__Ú __module__Ú __qualname__Ú__doc__rrr Úerrorsr Zprefer_offlinerÚpropertyrr Úsetterrrrr rrrrrrrLs,þ    rN)rrrrrrÚsK