Freigeben über

Hinzufügen von Spracherkennung zu Nachrichten mit der Bot Connector-API

  • Artikel

Wenn Sie einen Bot für einen sprachfähigen Kanal erstellen, können Sie Nachrichten erstellen, die den von Ihrem Bot zu sprechenden Text angeben. Sie können auch versuchen, den Status des Mikrofons des Clients zu beeinflussen, indem Sie einen Eingabehinweis angeben, um anzugeben, ob Ihr Bot Benutzereingaben akzeptiert, erwartet oder ignoriert.

Angeben von Text, der von Ihrem Bot gesprochen werden soll

Wenn Sie Text angeben möchten, der von Ihrem Bot in einem sprachfähigen Kanal gesprochen werden soll, legen Sie die eigenschaft speak innerhalb des Activity-Objekts fest, das Ihre Nachricht darstellt. Sie können die speak-Eigenschaft entweder auf eine Nur-Text-Zeichenfolge oder eine Zeichenfolge festlegen, die als Speech Synthesis Markup Language (SSML)-formatiert ist, eine XML-basierte Markupsprache, mit der Sie verschiedene Merkmale der Spracherkennung Ihres Bots steuern können, z. B. Sprache, Rate, Lautstärke, Aussprache, Pitch usw. Wenn der Kanal nicht unterstützt wird, wird die Nachricht als Text übermittelt.

Die folgende Anforderung sendet eine Nachricht, die Text angibt, der angezeigt werden soll, und Text, der gesprochen werden soll, und gibt an, dass der Bot benutzereingabe erwartet. Es gibt die speak-Eigenschaft im SSML--Format an, um anzugeben, dass das Wort "sicher" mit moderater Hervorhebung gesprochen werden sollte. In dieser Beispielanforderung stellt Direct Line den Basis-URI dar; Der Basis-URI für Anforderungen, die Ihr Bot ausgibt, kann unterschiedlich sein. Ausführliche Informationen zum Festlegen des Basis-URI finden Sie unter API Reference.

POST https://smba.trafficmanager.net/teams/v3/conversations/abcd1234/activities/5d5cdc723
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
    "type": "message",
    "from": {
        "id": "12345678",
        "name": "sender's name"
    },
    "conversation": {
        "id": "abcd1234",
        "name": "conversation's name"
   },
   "recipient": {
        "id": "1234abcd",
        "name": "recipient's name"
    },
    "text": "Are you sure that you want to cancel this transaction?",
    "speak": "<speak version=\"1.0\" xmlns=\"http://www.w3.org/2001/10/synthesis\" xml:lang=\"en-US\">Are you <emphasis level=\"moderate\">sure</emphasis> that you want to cancel this transaction?</speak>",
    "inputHint": "expectingInput",
    "replyToId": "5d5cdc723"
}

Eingabehinweise

Wenn Sie eine Nachricht in einem sprachfähigen Kanal senden, können Sie den beabsichtigten Status des Mikrofons des Clients ausdrücken, indem Sie auch einen Eingabehinweis einschließen, um anzugeben, ob Ihr Bot Benutzereingaben akzeptiert, erwartet oder ignoriert. Weitere Informationen finden Sie unter Hinzufügen von Eingabehinweisen zu Nachrichten.

Weitere Ressourcen