Get-Methode

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Beschreibung

Ruft die angegebenen Animationsdaten für das angegebene Zeichen ab.

Syntax

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

Teil	Beschreibung
Typ	Erforderlich. Ein Zeichenfolgenwert, der den zu ladenden Animationsdatentyp angibt. "Animation" Die Animationsdaten eines Zeichens. Zustandsdaten eines Zeichens. "WaveFile"-Audiodatei eines Zeichens (für gesprochene Ausgabe).
Name	Erforderlich. Eine Zeichenfolge, die den Namen des Animationstyps angibt. "name" Der Name der Animation oder des Zustands. Bei Animationen basiert der Name auf dem für das Zeichen definierten Namen, wenn er mit dem Microsoft Agent-Zeichen-Editor gespeichert wird. Für Zustände können die folgenden Werte verwendet werden: "Gesturing", um alle Gesturing-Statusanimationen abzurufen. "GesturingDown", um die GesturingDown-Animation abzurufen. "GesturingLeft", um die GesturingLeft-Animation abzurufen. "GesturingRight", um die GesturingRight-Animation abzurufen. "GesturingUp", um die GesturingUp-Animation abzurufen. "Ausblenden", um die Animation zum Ausblenden des Zustands abzurufen. "Hören", um die Animation des Hörzustands zu erhalten. "Leerlauf", um alle Animationen im Leerlaufzustand abzurufen. "IdlingLevel1", um alle IdlingLevel1-Animationen abzurufen. "IdlingLevel2", um alle IdlingLevel2-Animationen abzurufen. "IdlingLevel3", um alle IdlingLevel3-Animationen abzurufen. "Zuhören", um die Animation zum Lauschenzustand abzurufen. "Verschieben", um alle Animationen des sich bewegenden Zustands abzurufen. "MovingDown", um die MovingDown-Animation abzurufen. "MovingLeft", um die MovingLeft-Animation abzurufen. "MovingRight", um die MovingRight-Animation abzurufen. "MovingUp", um die MovingUp-Animation abzurufen. "Anzeigen", um die Animation "Anzeigestatus" abzurufen. "Sprechen", um die Animation zum Sprechenden Zustand abzurufen. Sie können mehrere Animationen und Zustände angeben, indem Sie sie durch Kommas trennen. Sie können jedoch keine Typen in derselben Get-Anweisung mischen. "URL oderfilespec" Die Spezifikation für den Sound (. WAV oder . LWV)-Datei. Wenn die Spezifikation nicht vollständig ist, wird sie relativ zur Spezifikation interpretiert, die in der Load-Methode verwendet wird.
Warteschlange	Optional. Ein boolescher Ausdruck, der angibt, ob der Server die Get-Anforderung in die Warteschlange stellt. True (Standard) stellt die Get-Anforderung in die Warteschlange. Jede Animationsanforderung, die auf die Get-Anforderung (für dasselbe Zeichen) folgt, wartet, bis die Animationsdaten geladen werden. FALSE Stellt die Get-Anforderung nicht in die Warteschlange.

Bemerkungen

Wenn Sie ein Zeichen mithilfe des HTTP-Protokolls laden (ein . ACF-Datei), müssen Sie die Get-Methode verwenden, um Animationsdaten abzurufen, bevor Sie die Animation wiedergeben können. Sie verwenden diese Methode nicht, wenn Sie das Zeichen mit dem UNC-Protokoll (ein geladen haben). ACS-Datei). Sie können auch keine HTTP-Daten für ein Zeichen mithilfe von Get abrufen, wenn Sie dieses Zeichen mithilfe des UNC-Protokolls () geladen haben. ACS-Zeichendatei).

Wenn Sie einen Objektverweis deklarieren und auf diese Methode festlegen, wird ein Request-Objekt zurückgegeben. Wenn die zugeordnete Animation nicht geladen werden kann, legt der Server die Status-Eigenschaft des Request-Objekts auf "failed" mit einer entsprechenden Fehlernummer fest. Sie können das RequestComplete-Ereignis verwenden, um die status zu überprüfen und zu bestimmen, welche Aktion ausgeführt werden soll.

Mit der Get-Methode abgerufene Animations- oder Sounddaten werden im Cache des Browsers gespeichert. Nachfolgende Aufrufe überprüfen den Cache, und wenn die Animationsdaten bereits vorhanden sind, lädt das Steuerelement die Daten direkt aus dem Cache. Nach dem Laden können die Animations- oder Sounddaten mit den Play - oder Speak-Methoden wiedergegeben werden.

Weitere Informationen

Load-Methode