Play メソッド (従来の Windows 環境機能)
[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]
-
Description
-
指定した文字の指定したアニメーションを再生します。
-
構文
-
agent**.文字 ("CharacterID")。Play** "AnimationName"
パーツ | Description |
---|---|
AnimationName | 必須。 アニメーション シーケンスの名前を指定する文字列。 |
アニメーションの名前は、Microsoft エージェント文字エディターを使用して文字をコンパイルするときに定義されます。 指定したアニメーションを再生する前に、サーバーは前のアニメーションに対して Return アニメーションを再生しようとします (割り当てられている場合)。
従来のファイル プロトコルを使用してキャラクターのアニメーションにアクセスする場合は、アニメーションの名前を指定する Play メソッドを使用するだけです。 ただし、HTTP プロトコルを使用して文字アニメーション データにアクセスする場合は、Play メソッドを呼び出す前に Get メソッドを使用してアニメーションを読み込みます。
詳細については、 Get メソッドを参照してください。
構文を簡略化するために、オブジェクト参照を宣言し、Characters コレクション内の Character オブジェクトを参照するように設定し、その参照を Play ステートメントの一部として使用できます。
Dim Genie
Agent1.Characters.Load "Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf"
Set Genie = Agent1.Characters ("Genie")
Genie.Get "state", "Showing"
Genie.Show
Genie.Get "animation", "Greet, GreetReturn"
Genie.Play "Greet"
Genie.Speak "Hello."
オブジェクト参照を宣言し、このメソッドに設定すると、 Request オブジェクトが返されます。 また、読み込まれていないアニメーションを指定した場合、または文字が正常に読み込まれていない場合、サーバーは Request オブジェクトの Status プロパティを適切なエラー番号で "failed" に設定します。 ただし、アニメーションが存在せず、キャラクターのデータが既に正常に読み込まれている場合、サーバーはエラーを発生させます。
Play メソッドでは、文字が表示されません。 文字が表示されない場合、サーバーはアニメーションを非表示にして再生し、Request オブジェクトの Status プロパティを設定します。