Get-Methode
[Der Microsoft Agent ist seit Windows 7 veraltet und kann in späteren Versionen von Windows nicht mehr verfügbar sein.]
-
Beschreibung
-
Ruft angegebene Animationsdaten für den angegebenen Charakter ab.
-
Syntax
-
agent**.Characters ("CharacterID").Get** Type, Name, [Queue]
Teil Beschreibung Typ Erforderlich. Ein Zeichenfolgenwert, der den zu ladenden Animationsdatentyp angibt. „Animation“ Animationsdaten eines Charakters.
„State“ Die Statusdaten eines Charakters.
„WaveFile“ Die Audiodatei eines Charakters (für gesprochene Ausgabe).Name Erforderlich. Eine Zeichenfolge, die den Namen des Animationstyps angibt. „name“ Der Name der Animation oder des Status.
Bei Animationen basiert der Name auf dem Namen, der für den Charakter beim Speichern mit dem Microsoft Agent Character Editor definiert wurde.
Für Status können folgende Werte verwendet werden:
„Gesturing“ Zum Abrufen aller Gesturing-Statusanimationen.
„GesturingDown“ Zum Abrufen der GesturingDown-Animation.
„GesturingLeft“ Zum Abrufen der GesturingLeft-Animation.
„GesturingRight“ Zum Abrufen der GesturingRight-Animation.
„GesturingUp“ Zum Abrufen der GesturingUp-Animation.
„Hiding“ Zum Abrufen der Hiding-Statusanimation.
„Hearing“ Zum Abrufen der Hearing-Statusanimation.
„Idling“ Zum Abrufen aller Idling-Statusanimationen.
„IdlingLevel1“ Zum Abrufen aller IdlingLevel1-Animationen.
„IdlingLevel2“ Zum Abrufen aller IdlingLevel2-Animationen.
„IdlingLevel3“ Zum Abrufen aller IdlingLevel3-Animationen.
„Listening“ Zum Abrufen der Listening-Statusanimation.
„Moving“ Zum Abrufen aller Moving-Statusanimationen.
„MovingDown“ Zum Abrufen der MovingDown-Animation.
„MovingLeft“ Zum Abrufen der MovingLeft-Animation.
„MovingRight“ Zum Abrufen der MovingRight-Animation.
„MovingUp“ Zum Abrufen der MovingUp-Animation.
„Showing“ Zum Abrufen der Showing-Statusanimation.
„Speaking“ Zum Abrufen der Speaking-Statusanimation.
Sie können mehrere Animationen und Status angeben, indem Sie sie durch Kommas trennen. Sie können jedoch keine Typen in derselben Get-Anweisung kombinieren.
„URL or filespec“ Die Spezifikation für die Sounddatei (.WAV oder .LWV). Wenn die Spezifikation nicht vollständig ist, wird sie als relativ zu der 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 folgt (für denselben Charakter), wartet, bis die Animationsdaten geladen werden.
False Stellt die Get-Anforderung nicht in die Warteschlange.
Hinweise
Wenn Sie einen Charakter mithilfe des HTTP-Protokolls laden (eine .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 den Charakter mithilfe des UNC-Protokolls (eine .ACS-Datei) geladen haben. Sie können auch keine HTTP-Daten für einen Charakter mithilfe von Get abrufen, wenn Sie diesen Charakter mit dem UNC-Protokoll (.ACS-Charakterdatei) geladen haben.
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 ausgeführt werden soll.
Animations- oder Sounddaten, die mit der Get-Methode abgerufen werden, werden im Cache des Browsers gespeichert. Bei nachfolgenden Aufrufen wird der Cache überprüft 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 Play oder Speak wiedergegeben werden.