IAgentCharacter::P repare

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

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
);

Recupera i dati di animazione per un carattere.

• Restituisce S_OK per indicare che l'operazione è stata completata correttamente. Quando la funzione restituisce il risultato, pdwReqID contiene l'ID della richiesta.

dwType

Valore che indica il tipo di dati di animazione da caricare che deve essere uno dei seguenti:

Valore	Descrizione
const unsigned short PREPARE_ANIMATION = 0;	Dati di animazione di un carattere.
const unsigned short PREPARE_STATE = 1;	Dati sullo stato di un carattere.
const unsigned short PREPARE_WAVE = 2	File audio di un carattere (. WAV o . LWV) per l'output parlato.

bszName

Nome dell'animazione o dello stato.

Il nome dell'animazione è basato su quello definito per il carattere quando è stato salvato usando l'Editor caratteri di Microsoft Agent.

Per gli stati, il valore può essere uno dei seguenti:

	Descrizione
"Gesturing"	Per recuperare tutte le animazioni dello stato di gestizione .
"GesturingDown"	Per recuperare le animazioni GesturingDown .
"GesturingLeft"	Per recuperare le animazioni GesturingLeft .
"GesturingRight"	Per recuperare le animazioni GesturingRight .
"GesturingUp"	Per recuperare le animazioni GesturingUp .
"Nascondi"	Per recuperare le animazioni nascondi stato.
"Udito"	Per recuperare le animazioni dello stato dell'udito.
"Idling"	Per recuperare tutte le animazioni dello stato di inattività .
"IdlingLevel1"	Per recuperare tutte le animazioni IdlingLevel1 .
"IdlingLevel2"	Per recuperare tutte le animazioni IdlingLevel2 .
"IdlingLevel3"	Per recuperare tutte le animazioni IdlingLevel3 .
"Ascolto"	Per recuperare le animazioni dello stato di ascolto .
"Spostamento"	Per recuperare tutte le animazioni dello stato di spostamento .
"MovingDown"	Per recuperare tutte le animazioni in movimento .
"MovingLeft"	Per recuperare tutte le animazioni MovingLeft .
"MovingRight"	Per recuperare tutte le animazioni MovingRight .
"MovingUp"	Per recuperare tutte le animazioni MovingUp .
"Visualizzazione"	Per recuperare le animazioni dello stato mostrate .
"Parlare"	Per recuperare le animazioni dello stato di pronuncia .

Per. File WAV, impostare bszName sull'URL o specifica del file per . File WAV. Se la specifica non è completa, viene interpretata come relativa alla specifica usata nel metodo Load.

bQueue

Valore booleano che specifica se il server accoda la richiesta di preparazione. True accoda la richiesta e fa in modo che qualsiasi richiesta di animazione che lo segue attenda fino a quando non vengono caricati i dati di animazione specificati. False recupera i dati di animazione in modo asincrono.

pdwReqID

Indirizzo di una variabile che riceve l'ID richiesta di preparazione .

Se si carica un carattere usando il protocollo HTTP (. File ACF), devi usare il metodo Prepare per recuperare i dati di animazione prima di poter riprodurre l'animazione. Non è possibile utilizzare questo metodo se il carattere è stato caricato usando il protocollo UNC (. File ACS). Non è inoltre possibile recuperare i dati HTTP per un carattere usando Prepare se il carattere è stato caricato usando il protocollo UNC (. File di caratteri ACS).

I dati audio o di animazione recuperati con il metodo Prepare vengono archiviati nella cache del browser. Le chiamate successive verificheranno la cache e, se i dati di animazione sono già presenti, il controllo carica i dati direttamente dalla cache. Dopo il caricamento, è possibile riprodurre i dati audio o di animazione con i metodi Play o Speak.

È possibile specificare più animazioni e stati separandoli con virgole. Tuttavia, non è possibile combinare tipi nella stessa istruzione Prepare.