IAgentCharacter::Prepare

[Der Microsoft Agent ist seit Windows 7 veraltet und kann in späteren Versionen von Windows nicht mehr verfügbar sein.]

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 einen Charakter ab.

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

dwType

Ein Wert, der den zu ladenden Animationsdatentyp angibt, der einer der folgenden Werte sein muss:

Wert	Beschreibung
const unsigned shortPREPARE_ANIMATION = 0;	Die Animationsdaten eines Charakters.
const unsigned shortPREPARE_STATE = 1;	Die Zustandsdaten eines Charakters.
const unsigned shortPREPARE_WAVE = 2	Die Sounddatei eines Charakters (.WAV oder .LWV) für gesprochene Ausgabe.

bszName

Der Name der Animation oder des Status.

Der Animationsname basiert auf dem Namen, der für den Charakter beim Speichern mit dem Microsoft Agent Character Editor definiert wurde.

Mögliche Statuswerte:

	Beschreibung
„Gesturing“	Zum Abrufen aller Gesturing-Statusanimationen.
„GesturingDown“	Zum Abrufen der GesturingDown-Animationen.
„GesturingLeft“	Zum Abrufen der GesturingLeft-Animationen.
„GesturingRight“	Zum Abrufen der GesturingRight-Animationen.
„GesturingUp“	Zum Abrufen der GesturingUp-Animationen.
„Hiding“	Zum Abrufen der Hiding-Statusanimationen.
„Hearing“	Zum Abrufen der Hearing-Statusanimationen.
„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-Statusanimationen.
„Moving“	Zum Abrufen aller Moving-Statusanimationen.
„MovingDown“	Zum Abrufen aller Moving-Animationen.
„MovingLeft“	Zum Abrufen aller MovingLeft-Animationen.
„MovingRight“	Zum Abrufen aller MovingRight-Animationen.
„MovingUp“	Zum Abrufen aller MovingUp-Animationen.
„Showing“	Zum Abrufen der Showing-Statusanimationen.
„Speaking“	Zum Abrufen der Speaking-Statusanimationen.

Legen Sie für .WAV-Dateien bszName auf die URL oder Dateispezifikation für die .WAV-Datei fest. Wenn die Spezifikation nicht vollständig ist, wird sie als relativ zu der 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 alle darauf folgenden Animationsanforderungen warten, bis die von ihr angegebenen Animationsdaten geladen sind. False ruft die Animationsdaten asynchron ab.

pdwReqID

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

Wenn Sie einen Charakter über das HTTP-Protokoll (eine .ACF-Datei) laden, 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 den Charakter mithilfe des UNC-Protokolls (eine .ACS-Datei) geladen haben. Sie können auch keine HTTP-Daten für einen Charakter mithilfe von Prepare abrufen, wenn Sie diesen Charakter mit dem UNC-Protokoll (.ACS-Charakterdatei) geladen haben.

Animations- oder Sounddaten, die mit der Prepare-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.

Sie können mehrere Animationen und Status angeben, indem Sie sie durch Kommas trennen. Sie können jedoch keine Typen in derselben Prepare-Anweisung kombinieren.