Udostępnij za pośrednictwem

Dodaj mowę do komunikatów przy użyciu API łącznika bota

  • Artykuł

Jeśli tworzysz bota dla kanału obsługującego mowę, możesz utworzyć komunikaty określające tekst, który ma być używany przez bota. Możesz również podjąć próbę wpływania na działanie mikrofonu klienta, określając podpowiedź wejściową, aby wskazać, czy Twój bot akceptuje, oczekuje lub ignoruje wprowadzane dane użytkownika.

Określ tekst, który ma być używany przez bota

Aby określić tekst używany przez bota w kanale obsługującym mowę, ustaw właściwość speak w obiekcie Activity reprezentującym komunikat. Właściwość speak można ustawić na zwykły ciąg tekstowy lub ciąg sformatowany jako Speech Synthesis Markup Language (SSML), język znaczników oparty na formacie XML, który umożliwia kontrolowanie różnych cech mowy bota, takich jak głos, szybkość, głośność, wymowa, skok i nie tylko. Jeśli kanał nie obsługuje, komunikat zostanie dostarczony jako tekst.

Następujące żądanie wysyła komunikat, który określa tekst do wyświetlenia i tekst do wypowiedzi oraz wskazuje, że bot oczekuje danych wejściowych użytkownika. Określa właściwość speak przy użyciu formatu SSML, aby wskazać, że słowo "pewność" powinno być wypowiadane z umiarkowanym naciskiem. W tym przykładowym żądaniu Direct Line reprezentuje podstawowy identyfikator URI; podstawowy identyfikator URI dla żądań wysyłanych przez Twojego bota może być inny. Aby uzyskać szczegółowe informacje na temat ustawiania podstawowego identyfikatora URI, zobacz Dokumentację Interfejsu API pod sekcją .

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

Wskazówki dotyczące danych wejściowych

Podczas wysyłania komunikatu w kanale obsługującym mowę można wyrazić zamierzony stan mikrofonu klienta, uwzględniając również wskazówkę wejściową wskazującą, czy bot akceptuje, oczekuje lub ignoruje dane wejściowe użytkownika. Aby uzyskać więcej informacji, zobacz Dodawanie wskazówek wejściowych do komunikatów.

Dodatkowe zasoby