Methode Ophalen

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

beschrijving

Hiermee worden opgegeven animatiegegevens opgehaald voor het opgegeven teken.

syntaxis

agent**. Tekens ("CharacterID"). Get** Type, Name, [Queue]

Deel	Beschrijving
type	Vereist. Een tekenreekswaarde die het gegevenstype animatie aangeeft dat moet worden geladen. "Animatie" De animatiegegevens van een teken. "State" De statusgegevens van een teken. "WaveFile" Het audiobestand van een teken (voor gesproken uitvoer).
naam	Vereist. Een tekenreeks die de naam van het animatietype aangeeft. "naam" De naam van de animatie of status. Voor animaties is de naam gebaseerd op de naam die is gedefinieerd voor het teken wanneer deze wordt opgeslagen met de Microsoft Agent Character Editor. Voor statussen kunnen de volgende waarden worden gebruikt: "Gesturing" Alle Gesturing statusanimaties ophalen. "GesturingDown" Om de animatie GesturingDown te krijgen. "GesturingLeft" Om de animatie GesturingLeft te krijgen. "GesturingRight" Om de GesturingRight animatie te krijgen. "GesturingUp" De animatie GesturingUp ophalen. "Verbergen" Om de statusanimatie te verbergen. "Horen" Om de statusanimatie te krijgen. "niet-actieve" Om alle niet-actieve statusanimaties op te halen. "IdlingLevel1" Alle IdlingLevel1 animaties ophalen. "IdlingLevel2" Alle IdlingLevel2 animaties ophalen. "IdlingLevel3" Alle IdlingLevel3 animaties ophalen. "Luisteren" Om de statusanimatie te downloaden. "Verplaatsen" Alle Animaties verplaatsen status. "MovingDown" De animatie MovingDown ophalen. "MovingLeft" De animatie MovingLeft ophalen. "MovingRight" De animatie MovingRight ophalen. "MovingUp" De animatie MovingUp ophalen. "weergeven " Om de statusanimatie weer te geven. "Speaking" Om de statusanimatie te krijgen. U kunt meerdere animaties en statussen opgeven door deze te scheiden met komma's. U kunt typen echter niet combineren in dezelfde Get-instructie. "URL offilespec" De specificatie voor het geluid (. WAV of . LWV)-bestand. Als de specificatie niet is voltooid, wordt deze geïnterpreteerd als relatief ten opzichte van de specificatie die wordt gebruikt in de methode Laden.
Wachtrij	Facultatief. Een Boole-expressie die aangeeft of de server de Get-aanvraag in de wachtrij zet. true (standaard) wachtrijen de Get request. Elke animatieaanvraag die volgt op de -aanvraag ophalen (voor hetzelfde teken) wacht totdat de animatiegegevens zijn geladen. False de Get request niet in de wachtrij.

Opmerkingen

Als u een teken laadt met behulp van het HTTP-protocol (een . ACF-bestand), moet u de methode Get gebruiken om animatiegegevens op te halen voordat u de animatie kunt afspelen. U gebruikt deze methode niet als u het teken hebt geladen met behulp van het UNC-protocol (een . ACS-bestand). U kunt ook geen HTTP-gegevens voor een teken ophalen met behulp van Get als u dat teken hebt geladen met behulp van het UNC-protocol (. ACS-tekenbestand).

Als u een objectverwijzing declareert en deze instelt op deze methode, wordt een Request-object geretourneerd. Als de gekoppelde animatie niet kan worden geladen, stelt de server de eigenschap Status van object aanvraag in op Mislukt met het juiste foutnummer. U kunt de gebeurtenis RequestComplete gebruiken om de status te controleren en te bepalen welke actie moet worden ondernomen.

Animatie- of geluidsgegevens die zijn opgehaald met de methode Get worden opgeslagen in de cache van de browser. Volgende aanroepen controleren de cache en als de animatiegegevens er al zijn, worden de gegevens rechtstreeks vanuit de cache geladen. Zodra de animatie- of geluidsgegevens zijn geladen, kunnen de animatie- of geluidsgegevens worden afgespeeld met de methoden Afspelen of Uitspreken.

Zie ook

load-methode