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]

In parte Descrizione
Tipo Obbligatorio. Valore stringa che indica il tipo di dati di animazione da caricare. "Animazione" Dati di animazione di un carattere.
"State" Dati sullo stato di un carattere.
"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 caratteri di Microsoft Agent.
Per gli stati, è possibile usare i valori seguenti:
"Gesturing" Per ottenere tutte le animazioni dello stato di gestizione .
"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 dello stato dell'udito.
"Inattiva" Per ottenere tutte le animazioni dello stato di inattività .
"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 Stato di visualizzazione .
"Parlare" Per ottenere l'animazione dello stato di pronuncia .
È possibile specificare più animazioni e stati separandoli con virgole. Tuttavia, non è possibile combinare tipi nella stessa istruzione Get .
"URL o filespec" Specifica per il suono (. WAV o . File LWV). Se la specifica non è completa, viene interpretata come relativa alla specifica usata nel metodo Load.
Coda Facoltativo. 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 .

Osservazioni:

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

Se si dichiara un riferimento all'oggetto e lo si imposta su questo metodo, viene restituito un oggetto Request. Se l'animazione associata non viene caricata, 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 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.

Vedi anche

Metodo Load