# -*- coding: utf-8 -*-
from velamentum.android import *

class Spracheingabe(object):
    """Die Klasse Spracheingabe ermöglicht die Umwandlung von Sprache in Text.
    Gesprochener Text wird aufgenommen und mittels einer Spracherkennung in
    Text umgewandelt.
    
    Attribute:
        text (Zeichenkette): Der erkannte Text."""

    def __init__(self):
        """Konstruktor: Initialisiert die Spracheingabe.
        
        Parameter:
            --- keine ---
        """
        self.text = ""

    def nenneText(self):
        """Anfrage. Gibt den erkannten Text zurück.
        
        Parameter:
            --- keine ---
        
        Rückgabe (Zeichenkette): Der erkannte Text.
        """
        return self.text

    def erkenneSprache(self):
        """Auftrag. Der gesprochene Text wird erkannt und im Attribut 'text'
        gespeichert.
        
        Parameter:
            --- keine ---
        """
        self.text = androide.recognizeSpeech("Bitte sprechen!","de-DE",
            "free_form").result