Get-Methode
[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht mehr verfügbar.]
-
Beschreibung
-
Ruft die angegebenen Animationsdaten für das angegebene Zeichen ab.
-
Syntax
-
agent**. Zeichen ("**CharacterID*"). Abrufen * von Typ, Name, [ Warteschlange]
Teil Beschreibung Type Erforderlich. Ein Zeichenfolgenwert, der den zu ladenden Animationsdatentyp angibt. "Animation" Die Animationsdaten eines Zeichens.
"State" Die Zustandsdaten eines Zeichens.
"WaveFile" Die 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 Namen, der beim Speichern mit dem Microsoft-Agent-Zeichen-Editor für das Zeichen definiert wurde.
Für Status können die folgenden Werte verwendet werden:
"Gesturing" So erhalten Sie alle Gesturingzustandsanimationen.
"GesturingDown", um die GesturingDown-Animation abzurufen.
"GesturingLeft", um die GesturingLeft-Animation abzurufen.
"GesturingRight", um die GesturingRight-Animation abzurufen.
"GesturingUp", um die GesturingUp-Animation abzurufen.
"Hiding", um die Animation zum Ausblenden des Zustands abzurufen.
"Hearing" To get the Hearing state animation.
"Idling" , um alle Idling-Zustandsanimationen abzurufen.
"IdlingLevel1", um alle IdlingLevel1-Animationen abzurufen.
"IdlingLevel2", um alle IdlingLevel2-Animationen abzurufen.
"IdlingLevel3", um alle IdlingLevel3-Animationen abzurufen.
"Listening", um die Animation des Überwachungszustands abzurufen.
"Moving", um alle Animationen des Zustands "Verschieben" abzurufen.
"MovingDown", um die MovingDown-Animation abzurufen.
"MovingLeft" So erhalten Sie die MovingLeft-Animation.
"MovingRight" , um die MovingRight-Animation abzurufen.
"MovingUp", um die MovingUp-Animation abzurufen.
"Showing" To get the Showing state animation.
"Speaking" Zum Abrufen der Sprechzustandsanimation.
Sie können mehrere Animationen und Zustände angeben, indem Sie sie durch Kommas trennen. Sie können Typen jedoch nicht in derselben Get-Anweisung mischen.
"URL oder Filespec" Die Spezifikation für den Sound (. WAV oder . LWV)-Datei. Wenn die Spezifikation nicht vollständig ist, wird sie als 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 einreiht. True (Standard) reiht die Get-Anforderung in die Warteschlange ein. Jede Animationsanforderung, die auf die Get-Anforderung folgt (für das gleiche Zeichen), wartet, bis die Animationsdaten geladen wurden.
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 (einem ) geladen haben. ACS-Datei). Sie können mit Get auch keine HTTP-Daten für ein Zeichen abrufen, wenn Sie dieses Zeichen mit dem UNC-Protokoll 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 mit einer entsprechenden Fehlernummer auf "failed" fest. Sie können das RequestComplete-Ereignis verwenden, um den Status zu überprüfen und zu bestimmen, welche Aktion ergriffen 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 Methoden Wiedergeben oder Sprechen wiedergegeben werden.