IAgentCharacter::P repare

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

HRESULT Prepare(
   long dwType,     // type of animation data to load
   BSTR bszName,    // name of the animation 
   long bQueue,     // queue the request
   long * pdwReqID  // address of request ID
);

Ruft Animationsdaten für ein Zeichen ab.

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war. Wenn die Funktion zurückgibt, enthält pdwReqID die ID der Anforderung.

dwType

Ein -Wert, der den zu ladenden Animationsdatentyp angibt, der einer der folgenden Sein muss:

Wert	BESCHREIBUNG
const unsigned shortPREPARE_ANIMATION = 0;	Animationsdaten eines Zeichens.
const unsigned shortPREPARE_STATE = 1;	Statusdaten eines Zeichens.
const unsigned shortPREPARE_WAVE = 2	Die Sounddatei eines Zeichens (. WAV oder . LWV) für die gesprochene Ausgabe.

bszName

Der Name der Animation oder des Zustands.

Der Animationsname basiert auf dem, der für das Zeichen definiert wurde, als es mit dem Microsoft-Agent-Zeichen-Editor gespeichert wurde.

Für Zustände kann der Wert einer der folgenden Sein:

	BESCHREIBUNG
"Gestikt"	So rufen Sie alle Gesturingzustandsanimationen ab.
"GesturingDown"	So rufen Sie GesturingDown-Animationen ab.
"GesturingLeft"	So rufen Sie GesturingLeft-Animationen ab.
"GesturingRight"	So rufen Sie GesturingRight-Animationen ab.
"GesturingUp"	So rufen Sie GesturingUp-Animationen ab.
"Ausblenden"	So rufen Sie die Animationen zum Ausblenden des Zustands ab.
"Hören"	So rufen Sie die Animationen des Hörzustands ab.
"Leerlauf"	So rufen Sie alle Animationen im Leerlaufzustand ab.
"IdlingLevel1"	So rufen Sie alle IdlingLevel1-Animationen ab.
"IdlingLevel2"	So rufen Sie alle IdlingLevel2-Animationen ab.
"IdlingLevel3"	So rufen Sie alle IdlingLevel3-Animationen ab.
"Lauschen"	So rufen Sie die Animationen des Lauschzustands ab.
"Verschieben"	So rufen Sie alle Animationen zum Verschieben des Zustands ab.
"MovingDown"	So rufen Sie alle Bewegungsanimationen ab.
"MovingLeft"	So rufen Sie alle MovingLeft-Animationen ab.
"MovingRight"	So rufen Sie alle MovingRight-Animationen ab.
"MovingUp"	So rufen Sie alle MovingUp-Animationen ab.
"Wird angezeigt"	So rufen Sie die Anzeige von Zustandsanimationen ab.
"Sprechen"	So rufen Sie die Animationen des sprechenden Zustands ab.

Für. WAV-Dateien, legen Sie bszName auf die URL oder Dateispezifikation für fest. WAV-Datei. Wenn die Spezifikation nicht vollständig ist, wird sie relativ zur Spezifikation interpretiert, die in der Load-Methode verwendet wird.

bQueue

Ein boolescher Wert, der angibt, ob der Server die Prepare-Anforderung in die Warteschlange stellt. True stellt die Anforderung in die Warteschlange und bewirkt, dass jede darauf folgende Animationsanforderung wartet, bis die von ihr angegebenen Animationsdaten geladen werden. False ruft die Animationsdaten asynchron ab.

pdwReqID

Adresse einer Variablen, die die Prepare-Anforderungs-ID empfängt.

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

Mit der Prepare-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.

Sie können mehrere Animationen und Zustände angeben, indem Sie sie durch Kommas trennen. Sie können jedoch keine Typen in derselben Prepare-Anweisung mischen.