Get メソッド

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]

Description

指定した文字の指定したアニメーション データを取得します。

構文

agent**。文字 ("CharacterID")。Get** Type, Name, [Queue]

パーツ 説明
Type 必須。 読み込むアニメーション データ型を示す文字列値。 "アニメーション" キャラクターのアニメーション データ。
"State" 文字の状態データ。
"WaveFile" 文字のオーディオ (音声出力用) ファイル。
Name 必須です。 アニメーションの種類の名前を示す文字列。 "name" アニメーションまたは状態の名前。
アニメーションの場合、名前は、Microsoft エージェント文字エディターを使用して保存するときに、文字に対して定義された 名前に基づいています。
状態の場合は、次の値を使用できます。
"Gesturing" すべての ゲスリング 状態アニメーションを取得します。
"GesturingDown" GesturingDown アニメーションを取得します。
"GesturingLeft" GesturingLeft アニメーションを取得します。
"GesturingRight" GesturingRight アニメーションを取得します。
"GesturingUp" GesturingUp アニメーションを取得します。
"非表示" 非表示 状態アニメーションを取得します。
"ヒアリング" 聴覚 状態アニメーションを取得します。
"Idling" すべての アイドリング 状態アニメーションを取得します。
"IdlingLevel1" すべての IdlingLevel1 アニメーションを取得します。
"IdlingLevel2" すべての IdlingLevel2 アニメーションを取得します。
"IdlingLevel3" すべての IdlingLevel3 アニメーションを取得します。
"Listening" リッスン状態のアニメーション 取得します。
"移動" すべての 移動 状態アニメーションを取得します。
"MovingDown" MovingDown アニメーションを取得します。
"MovingLeft" MovingLeft アニメーションを取得します。
"MovingRight" MovingRight アニメーションを取得します。
"MovingUp" MovingUp アニメーションを取得します。
"表示" 表示状態 アニメーションを取得します。
"話す" 話す状態のアニメーション 取得します。
複数のアニメーションと状態は、コンマで区切ることで指定できます。 ただし、同じ Get ステートメントに型を混在させることはできません。
"URL またはfilespec" サウンドの仕様 (.WAV または 。LWV) ファイル。 仕様が完全でない場合は、 Load メソッドで使用される仕様に対して相対的であると解釈されます。
キュー 省略可能。 サーバーが Get 要求をキューに入れるかどうかを指定するブール式。 True (既定値) Get 要求をキューに 入れますGet 要求に続くアニメーション要求 (同じ文字の場合) は、アニメーション データが読み込まれるまで待機します。
FalseGet 要求をキューに入れていません。

解説

HTTP プロトコル () を使用して文字を読み込む場合。ACF ファイル) では、アニメーションを再生する前に 、Get メソッドを使用してアニメーション データを取得する必要があります。 UNC プロトコル () を使用して文字を読み込んだ場合、このメソッドは使用しません。ACS ファイル)。 UNC プロトコル () を使用して文字を読み込んだ場合、 Get を 使用して文字の HTTP データを取得することもできません。ACS 文字ファイル)。

オブジェクト参照を宣言し、このメソッドに設定すると、 Request オブジェクトが返されます。 関連付けられたアニメーションの読み込みに失敗した場合、サーバーは Request オブジェクトの Status プロパティを適切なエラー番号で "failed" に設定します。 RequestComplete イベントを使用して、状態をチェックし、実行するアクションを決定できます。

Get メソッドで取得したアニメーションまたはサウンド データは、ブラウザーのキャッシュに格納されます。 後続の呼び出しはキャッシュをチェックし、アニメーション データが既に存在する場合、コントロールはキャッシュから直接データを読み込みます。 読み込まれた後は、Play メソッドまたは Speak メソッドを使用してアニメーションまたはサウンド データを再生できます。

参照

Load メソッド