Metodo Get

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

Descrizione

Recupera i dati di animazione specificati per il carattere specificato.

Sintassi

agent**. Caratteri ("CharacterID"). Get** Type, Name, [Queue]

Parte	Descrizione
Tipo	Obbligatorio. Valore stringa che indica il tipo di dati di animazione da caricare. "Animazione" Dati di animazione di un carattere. "Stato" Dati sullo stato di un carattere. File "WaveFile" File audio di un carattere (per l'output parlato).
Nome	Obbligatorio. Stringa che indica il nome del tipo di animazione. "name" Nome dell'animazione o dello stato. Per le animazioni, il nome è basato su quello definito per il carattere quando viene salvato usando l'editor di caratteri di Microsoft Agent. Per gli stati, è possibile usare i valori seguenti: "Gesturing" Per ottenere tutte le animazioni dello stato di gesturing . "GesturingDown" Per ottenere l'animazione GesturingDown . "GesturingLeft" Per ottenere l'animazione GesturingLeft . "GesturingRight" Per ottenere l'animazione GesturingRight . "GesturingUp" Per ottenere l'animazione GesturingUp . "Nascondi" Per ottenere l'animazione Nascondi stato. "Udito" Per ottenere l'animazione stato dell'udito. "Inattiva" Per ottenere tutte le animazioni di stato inattiva . "IdlingLevel1" Per ottenere tutte le animazioni IdlingLevel1 . "IdlingLevel2" Per ottenere tutte le animazioni IdlingLevel2 . "IdlingLevel3" Per ottenere tutte le animazioni IdlingLevel3 . "Ascolto" Per ottenere l'animazione dello stato di ascolto . "Spostamento" Per ottenere tutte le animazioni dello stato di spostamento . "MovingDown" Per ottenere l'animazione MovingDown . "MovingLeft" Per ottenere l'animazione MovingLeft . "MovingRight" Per ottenere l'animazione MovingRight . "MovingUp" Per ottenere l'animazione MovingUp . "Visualizzazione" Per ottenere l'animazione dello stato che mostra . "Parla" Per ottenere l'animazione dello stato parlante . È possibile specificare più animazioni e stati separandoli con virgole. Tuttavia, non è possibile combinare i tipi nella stessa istruzione Get . "URL ofilespec" Specifica per il suono (. WAV o . File LWV). Se la specifica non è completa, viene interpretata come relativa alla specifica utilizzata nel metodo Load .
Coda	Facoltativa. Espressione booleana che specifica se il server accoda la richiesta Get . True (impostazione predefinita) Accoda la richiesta Get . Qualsiasi richiesta di animazione che segue la richiesta Get (per lo stesso carattere) attende fino al caricamento dei dati di animazione. False Non accoda la richiesta Get .

Commenti

Se si carica un carattere usando il protocollo HTTP (un oggetto . File ACF), è necessario usare il metodo Get per recuperare i dati di animazione prima di poter riprodurre l'animazione. Questo metodo non viene usato se è stato caricato il carattere usando il protocollo UNC (un oggetto . File ACS. Non è anche possibile recuperare i dati HTTP per un carattere usando Get se è stato caricato tale carattere usando il protocollo UNC (). File di caratteri ACS.

Se si dichiara un riferimento all'oggetto e lo si imposta su questo metodo, restituisce un oggetto Request . Se l'animazione associata non riesce a caricare, il server imposta la proprietà Status dell'oggetto Request su "failed" con un numero di errore appropriato. È possibile usare l'evento RequestComplete per controllare lo stato e determinare l'azione da eseguire.

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

Vedere anche

Metodo Load