Methode Uitspreken

[Microsoft Agent is afgeschaft vanaf Windows 7 en is mogelijk niet beschikbaar in volgende versies van Windows.]

beschrijving

Spreekt de opgegeven tekst of het opgegeven geluidsbestand voor het opgegeven teken.

syntaxis

agent**. Tekens ("CharacterID"). Uitspreken** [Text], [URL]

Deel	Beschrijving
tekst	Facultatief. Een tekenreeks die aangeeft wat het teken zegt.
URL-	Facultatief. Een tekenreeksexpressie die de locatie van een audiobestand aangeeft (. WAV of . LWV-indeling). De locatie kan worden opgegeven als een bestand (inclusief een UNC-padspecificatie) of URL (wanneer tekenanimatiegegevens ook worden opgehaald via http-protocol).

 

Opmerkingen

Hoewel de parameters Text en URL- optioneel zijn, moet een van deze parameters worden opgegeven. Als u deze methode wilt gebruiken met een teken dat is geconfigureerd om alleen te spreken in de tekstballon of met behulp van een TTS-engine (text-to-speech), geeft u gewoon de parameter Text op. Voeg een spatie tussen woorden toe om de juiste woordeinden in de woordballon te definiëren, zelfs voor talen die traditioneel geen spaties bevatten.

U kunt ook verticale staaftekens (|) opnemen in de parameter Text om alternatieve tekenreeksen aan te wijzen, zodat de server willekeurig een andere tekenreeks kiest telkens wanneer deze de methode verwerkt.

Tekenondersteuning van TTS-uitvoer wordt gedefinieerd wanneer het teken wordt gecompileerd met behulp van de Microsoft Agent Character Editor. Als u TTS-uitvoer wilt genereren, moet er al een compatibele TTS-engine zijn geïnstalleerd voordat u deze methode aanroept. Zie Accessing Speech Servicesvoor meer informatie.

Als u opgenomen geluidsbestand gebruikt (. WAV of . Alleen LWV-indeling) uitvoer voor het teken, geef de locatie van het bestand op in de URL parameter. Deze bestandsspecificatie kan een lokaal (absoluut of relatief) of UNC-pad (Universal Naming Convention) bevatten. De bestandsnaam mag geen tekens bevatten die niet zijn opgenomen in de amerikaanse codepagina 1252. Als u echter het HTTP-protocol gebruikt om toegang te krijgen tot de tekenanimatiegegevens, gebruikt u de methode Get om de animatie te laden voordat u de methode Uitspreken aanroept. Zie Using the Microsoft Linguistic Information Sound Editing Tool for information about creative. LWV-bestanden.

Wanneer u opgenomen geluidsbestandsuitvoer gebruikt, kunt u nog steeds de parameter Text gebruiken om de woorden op te geven die worden weergegeven in de tekstballon van het teken. Als u echter een taalkundig verbeterd geluidsbestand opgeeft (. LWV) voor de parameter URL en geef geen tekst op voor de tekstballon. De parameter Text gebruikt de tekst die in het bestand is opgeslagen.

U kunt ook parameters van de spraakuitvoer variëren met speciale tags die u opneemt in de parameter Text. Zie Speech Output Tags van Microsoft Agentvoor meer informatie.

Als u een objectverwijzing declareert en deze instelt op deze methode, wordt een Request-object geretourneerd. U kunt dit gebruiken om andere onderdelen van uw code te synchroniseren met de gesproken uitvoer van het teken, zoals in het volgende voorbeeld:

   Dim SpeakRequest as Object
...
   Set SpeakRequest = Genie.Speak ("And here it is.")
...
   Sub Agent1_RequestComplete (ByVal Request as Object)
   ' Make certain the request exists
   If SpeakRequest Not Nothing Then
      ' See if it was this request
      If Request = SpeakRequest Then
         ' Display the message box 
         Msgbox "Ta da!"
      End If
   End If
   End Sub

U kunt ook een Aanvraag--object gebruiken om te controleren op bepaalde foutvoorwaarden. Als u bijvoorbeeld de methode Uitspreken gebruikt om te spreken en geen compatibele TTS-engine is geïnstalleerd, stelt de server de eigenschap Request object Status in op Mislukt met de eigenschap Description op Class not registered of Object returned error. Als u wilt bepalen of er een TTS-engine is geïnstalleerd, gebruikt u de eigenschap TTSModeID.

Als u het teken hebt geprobeerd een geluidsbestand te spreken en als het bestand niet is geladen of er een probleem is met het audioapparaat, stelt de server ook de eigenschap Request object Status eigenschap 'mislukt' in met een geschikt foutcodenummer.

U kunt ook bladwijzers toevoegen aan gesproken tekst om uw code te synchroniseren:

   Dim SpeakRequest as Object
...
   Set SpeakRequest = Genie.Speak ("And here \mrk=100\it is.")
...
   Sub Agent1_Bookmark (ByVal BookmarkID As Long)
   If BookmarkID = 100 Then
      ' Display the message box 
         Msgbox "Tada!"
      End If
   End Sub

Zie Speech Output Tagsvoor meer informatie over de bladwijzer voor spraakuitvoertags.

De methode Uitspreken gebruikt de laatste actie die wordt afgespeeld om te bepalen welke spreekanimatie moet worden afgespeeld. Als u bijvoorbeeld de opdracht Uitspreken voorafging met een Play "GestureRight", speelt de server GestureRight en vervolgens de GestureRight spreekanimatie. Als de laatste animatie die is afgespeeld geen gesproken animatie heeft, wordt de animatie die is toegewezen aan de spreekstatus van het teken, afgespeeld.

Als u Uitspreken belt en het audiokanaal bezet is, wordt de audio-uitvoer van het teken niet gehoord, maar wordt de tekst weergegeven in de tekstballon.

De automatische woordbreking van de agent in de tekstballon breekt woorden met spatietekens (bijvoorbeeld spatie of tab). Als het niet mogelijk is, kan het echter een woord breken dat past bij de ballon. In talen zoals Japans, Chinees en Thais, waarbij spaties niet worden gebruikt om woorden te verbreken, voegt u een Unicode-spatieteken met nul breedte (0x200B) in tussen tekens om logische woordeinden te definiëren.

Notitie

De eigenschap Ingeschakeld van de woordballon moet ook True- zijn om tekst weer te geven.

 

Notitie

Stel de taal-id van het teken in (door de LanguageID van het teken in te stellen voordat u de methode Uitspreken gebruikt om ervoor te zorgen dat de juiste tekst wordt weergegeven in de tekstballon.

 

Zie ook

gebeurtenis Bladwijzer, RequestStart-gebeurtenis, RequestComplete-gebeurtenis