Megosztás a következőn keresztül:

Beszéd hozzáadása üzenetekhez a Bot Connector API-val

  • Cikk

Ha beszédalapú csatornához készít robotot, létrehozhat olyan üzeneteket, amelyek meghatározzák a robot által elhangzandó szöveget. Az ügyfél mikrofonjának állapotát egy bemeneti tipp megadásával is megpróbálhatja befolyásolni, amely jelzi, hogy a robot fogadja-e, várja-e vagy figyelmen kívül hagyja-e a felhasználói bemenetet.

A robotot úgy konfigurálhatja, hogy az ügyfélalkalmazások Direct Line Speech-csatornán keresztül kommunikálhassanak vele.

A robot által elhangzandó szöveg megadása

Ha beszédalapú csatornán szeretné megadni a robot által kimondandó szöveget, állítsa be az speak üzenetet képviselő Tevékenység objektumon belüli tulajdonságot. A tulajdonságot beállíthatja speak egyszerű szöveges sztringre, vagy egy beszédszintézis-jelölőnyelvként (SSML) formázott sztringre, amely egy XML-alapú korrektúranyelv, amely lehetővé teszi a robot beszédének különböző jellemzőit, például a hangot, a sebességet, a hangerőt, a kiejtést, a hangmagasságot és egyebeket. Ha a csatorna nem támogatja, az üzenet szövegként lesz kézbesítve.

A következő kérés egy üzenetet küld, amely megadja a megjelenítendő szöveget és a kimondandó szöveget, és jelzi, hogy a robot felhasználói bemenetet vár. A tulajdonságot SSML-formátummal adja meg speak annak jelzésére, hogy a "sure" szót közepesen nagy hangsúlyt kell fektetni. Ebben a példában a Direct Line az alap URI-t jelöli; a robot problémáit okozó kérések alap URI-ja eltérő lehet. Az alap URI beállításával kapcsolatos részletekért lásd: API-referencia.

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"
}

Beviteli tippek

Amikor üzenetet küld egy beszédalapú csatornán, kifejezheti az ügyfél mikrofonjának kívánt állapotát úgy, hogy egy beviteli tippet is tartalmaz, amely jelzi, hogy a robot fogadja-e, várja-e vagy figyelmen kívül hagyja-e a felhasználói bemenetet. További információ: Beviteli tippek hozzáadása az üzenetekhez.

További források