Hämta metod

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

Beskrivning

Hämtar angivna animeringsdata för det angivna tecknet.

syntax

agent**. Tecken ("CharacterID"). Get** type, Name, [Queue]

Del	Beskrivning
typ	Krävs. Ett strängvärde som anger vilken typ av animeringsdata som ska läsas in. "Animation" Ett teckens animeringsdata. "State" A-teckens tillståndsdata. "WaveFile" Ett teckens ljudfil (för talade utdata).
namn	Krävs. En sträng som anger namnet på animeringstypen. "namn" Namnet på animeringen eller tillståndet. För animeringar baseras namnet på det som definierats för tecknet när det sparas med hjälp av Microsoft Agent Character Editor. För tillstånd kan följande värden användas: "Gesturing" To get all Gesturing state animations. "GesturingDown" För att få GesturingDown animering. "GesturingLeft" För att få GesturingLeft animering. "GesturingRight" För att få GesturingRight animation. "GesturingUp" För att få GesturingUp animering. "Hiding" För att hämta animeringen Hiding state. "Hearing" För att få Hearing state animation. "Tomgång" För att få alla Tomgång tillståndsanimationer. "IdlingLevel1" För att få alla IdlingLevel1 animationer. "IdlingLevel2" För att få alla IdlingLevel2 animationer. "IdlingLevel3" För att få alla IdlingLevel3 animationer. "Listening" To get the Listening state animation . "Moving" To get all Moving state animations . "MovingDown" För att hämta animeringen MovingDown. "MovingLeft" För att hämta animeringen MovingLeft. "MovingRight" För att få animeringen MovingRight. "MovingUp" För att hämta animeringen MovingUp. "Showing" To get the Showing state animation . "Speaking" To get the Speaking state animation. Du kan ange flera animeringar och tillstånd genom att avgränsa dem med kommatecken. Du kan dock inte blanda typer i samma Get-instruktion. "URL ellerfilespec" Specifikationen för ljudet (. WAV eller . LWV)-fil. Om specifikationen inte är fullständig tolkas den som relativ till den specifikation som används i metoden Load.
kö	Valfri. Ett booleskt uttryck som anger om servern köar Hämta begäran. True (standard) köar Hämta begäran. Alla animeringsbegäranden som följer Hämta begäran (för samma tecken) väntar tills animeringsdata har lästs in. False Köar inte Hämta begäran.

Anmärkningar

Om du läser in ett tecken med hjälp av HTTP-protokollet (en . ACF-fil) måste du använda metoden Hämta för att hämta animeringsdata innan du kan spela upp animeringen. Du använder inte den här metoden om du har läst in tecknet med hjälp av UNC-protokollet (en . ACS-fil). Du kan inte heller hämta HTTP-data för ett tecken med hjälp av Hämta om du läste in det tecknet med hjälp av UNC-protokollet (. ACS-teckenfil).

Om du deklarerar en objektreferens och anger den till den här metoden returneras ett begärandeobjekt objekt. Om den associerade animeringen inte kan läsas in anger servern egenskapen Request object's Status till "failed" med ett lämpligt felnummer. Du kan använda händelsen RequestComplete för att kontrollera statusen och avgöra vilken åtgärd som ska vidtas.

Animerings- eller ljuddata som hämtats med metoden Get lagras i webbläsarens cacheminne. Efterföljande anrop kontrollerar cachen och om animeringsdata redan finns där läser kontrollen in data direkt från cachen. När animeringen eller ljuddata har lästs in kan de spelas upp med metoderna Play eller Speak.

Se även

Load-metoden